jadex.runtime
Interface IPlatform

public interface IPlatform

Interface that can be used to create, destroy and access agents from external Java code.

This interface must not be used inside agent implementations, conceptually, because it violates the autonomy principle and technically, because it easily leads to deadlocks!

Method Summary

AgentIdentifier	createAgent(String name, String model, String state, Object[] args) Create a new agent.
void	destroyAgent(AgentIdentifier id) Destroy an agent.
IExternalAccess	getAgentInterface(AgentIdentifier id) Get an accessor object for an agent represented by a given agent id.
AgentIdentifier[]	getAgents() Get the agents on the platform.

Method Detail

createAgent

AgentIdentifier createAgent(String name,
                            String model,
                            String state,
                            Object[] args)

Create a new agent.

Parameters:

name - The agent's name.

model - The agent model filename.

state - The initial state (uses default if null).

args - Arguments for the agent (if any).

Returns:

The id of the created agent.

destroyAgent

void destroyAgent(AgentIdentifier id)

Destroy an agent.

Parameters:

id - The id of the agent to destroy.

getAgents

AgentIdentifier[] getAgents()

Get the agents on the platform.

Returns:

The ids of the agents.

getAgentInterface

IExternalAccess getAgentInterface(AgentIdentifier id)

Get an accessor object for an agent represented by a given agent id. The accessor object allows to manipulate an agent in an object-oriented way.

Parameters:

id - The id of the agent to destroy.

Returns:

The accessor object.