|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--jade.wrapper.ContainerController
This class is a Proxy class, allowing access to a JADE agent
container. Invoking methods on instances of this class, it is
possible to request services from createContainer()
method in class
Runtime
.
NOT available in MIDP
Runtime.createAgentContainer(Profile)
Field Summary | |
protected PlatformController |
myPlatformController
|
Constructor Summary | |
ContainerController(ContainerProxy cp,
AgentContainer impl,
java.lang.String platformName)
This constructor requires a concrete implementation of a JADE agent container, which cannot be instantiated by applications, so it cannot be meaningfully called from application code. |
Method Summary | |
AgentController |
acceptNewAgent(java.lang.String nickname,
Agent anAgent)
Add an Agent to this container. |
AgentController |
createNewAgent(java.lang.String nickname,
java.lang.String className,
java.lang.Object[] args)
Creates a new JADE agent, running within this container, |
AgentController |
getAgent(java.lang.String localAgentName)
Get agent proxy to local agent given its name. |
java.lang.String |
getContainerName()
Retrieve the name of the wrapped container. |
PlatformController |
getPlatformController()
Retrieve a controller for the platform the container wrapped by this ContainerController belongs to and acts as the Main Container. |
java.lang.String |
getPlatformName()
Retrieve the name of the platform the container wrapped by this ContainerController belongs to. |
protected void |
initPlatformController()
|
void |
installMTP(java.lang.String address,
java.lang.String className)
Installs a new message transport protocol, that will run within this container. |
void |
kill()
Shuts down this container, terminating all the agents running within it. |
void |
uninstallMTP(java.lang.String address)
Removes a message transport protocol, previously running within this container. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected PlatformController myPlatformController
Constructor Detail |
public ContainerController(ContainerProxy cp, AgentContainer impl, java.lang.String platformName)
Runtime.createContainer()
method.
impl
- A concrete implementation of a JADE agent container.platformName
- the name of the platformRuntime.createAgentContainer(Profile)
Method Detail |
public AgentController getAgent(java.lang.String localAgentName) throws ControllerException
localAgentName
- The short local name of the desired agent.
ControllerException
- If any probelms occur obtaining this proxy.public AgentController createNewAgent(java.lang.String nickname, java.lang.String className, java.lang.Object[] args) throws StaleProxyException
nickname
- A platform-unique nickname for the newly created
agent. The agent will be given a FIPA compliant agent identifier
using the nickname and the ID of the platform it is running on.className
- The fully qualified name of the class that
implements the agent.args
- An object array, containing initialization parameters
to pass to the new agent.
StaleProxyException
public AgentController acceptNewAgent(java.lang.String nickname, Agent anAgent) throws StaleProxyException
nickname
- A platform-unique nickname for the newly created agent.
The agent will be given a FIPA compliant agent identifier using the nickname and
the ID of the platform it is running on.anAgent
- The agent to be added to this agent container.
StaleProxyException
public void kill() throws StaleProxyException
StaleProxyException
public void installMTP(java.lang.String address, java.lang.String className) throws jade.mtp.MTPException, StaleProxyException
address
- The transport address exported by the new MTP, in
string format.className
- The fully qualified name of the Java class that
implements the transport protocol.
jade.mtp.MTPException
- If something goes wrong during transport
protocol activation.
StaleProxyException
public void uninstallMTP(java.lang.String address) throws jade.mtp.MTPException, NotFoundException, StaleProxyException
address
- The transport address exported by the new MTP, in
string format.
jade.mtp.MTPException
- If something goes wrong during transport
protocol activation.
NotFoundException
- If no protocol with the given
address is currently installed on this container.
StaleProxyException
public java.lang.String getPlatformName()
public java.lang.String getContainerName() throws ControllerException
ControllerException
public PlatformController getPlatformController() throws ControllerException
PlatfromController
for the platform
the container wrapped by this ContainerController
belongs to.
ControllerException
- If the container wrapped by this
ContainerController
is not valid or is not the
platform Main Container.protected void initPlatformController() throws ControllerException
ControllerException
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |