com.cometway.om
Interface AgentServerInterface

All Known Implementing Classes:

AgentServer

public interface AgentServerInterface

A standard server interface for managing agents in a agent kernel using an object manager for the agent Props storage.

Method Summary

java.lang.String	createAgent(ObjectID agentPropsID) Creates an agent instance using the Props information referenced by the specified ObjectID.
boolean	destroyAgent(java.lang.String agentName) Calls the agent's destroy method, then destroys the agent instance.
boolean	startAgent(java.lang.String agentName) Starts the specified agent instance by calling agent's start method.
boolean	stopAgent(java.lang.String agentName) Signals the specified agent to stop by calling the agent's stop method.

Method Detail

createAgent

java.lang.String createAgent(ObjectID agentPropsID)

Creates an agent instance using the Props information referenced by the specified ObjectID. If the ObjectID refers to a valid Props object, and the agent kernel was able to instantiate a agent instance based on the information it contains, a String reference will be returned containing the agentName; it returns null otherwise. The agentName should be unique among agents referenced by the agent kernel.

destroyAgent

boolean destroyAgent(java.lang.String agentName)

Calls the agent's destroy method, then destroys the agent instance.

Returns:

true if successful; false otherwise.

startAgent

boolean startAgent(java.lang.String agentName)

Starts the specified agent instance by calling agent's start method.

Returns:

true if successful; false otherwise.

stopAgent

boolean stopAgent(java.lang.String agentName)

Signals the specified agent to stop by calling the agent's stop method.

Returns:

true if successful; false otherwise.