Package jason.runtime

Interface RuntimeServices

All Superinterfaces:

Remote

All Known Implementing Classes:

BaseRuntimeServices, DelegatedRuntimeServices, JadeRuntimeServices, LocalRuntimeServices

public interface RuntimeServices
extends Remote

This interface is implemented by the infrastructure (Jade/Local/...) to provide concrete runtime services.

Method Summary

Modifier and Type	Method	Description
default void	clone(Agent source, List<String> archClasses, String agName)	Clones an agent and starts it
String	createAgent(String agName, String agSource, String agClass, List<String> archClasses, ClassParameters bbPars, Settings stts, Agent father)	Creates a new agent with agName from source agSource, using agClass as agent class (default value is "jason.asSemantics.Agent"), archClasses as agent architecture classes, bbPars as the belief base class (default value is "DefaultBeliefBase"), stts as Settings (default value is new Settings()), and father is the agent creating this agent (null is none).
default void	dfDeRegister(String agName, String service, String type)
default void	dfRegister(String agName, String service, String type)
default Collection<String>	dfSearch(String service, String type)
default void	dfSubscribe(String agName, String service, String type)
Collection<String>	getAgentsName()	Returns a set of all agents' name
default Agent	getAgentSnapshot(String agName)	gets a copy of some agent (BB, PL, ...)
int	getAgentsQty()	Gets the number of agents in the MAS.
default Map<String,Object>	getAgStatus(String agName)
default Collection<String>	getDefaultAgArchs()
default Map<String,Set<String>>	getDF()
default String	getMASName()
String	getNewAgentName(String baseName)
default Map<String,Map<String,Object>>	getWP()
boolean	isRunning()
boolean	killAgent(String agName, String byAg, int deadline)	Kills the agent named agName as a requested by byAg.
default String	loadASL(String agName, String code, String sourceId, boolean replace)	loads some ASL code into some agent, if replace is true, the previous plans from the sourceID will be removed
default void	registerDefaultAgArch(String agArch)	register a class to be included as new agents archs
default String	runAsAgent(String agName, String code)	agent agName executes the code (in a new intention)
void	startAgent(String agName)	starts an agent (e.g.
default void	stopMAS()
void	stopMAS(int deadline, boolean stopJVM, int exitValue)	Stops all MAS (the agents, the environment, the controller, ...)

Method Details

getMASName

default String getMASName()
                   throws RemoteException

Throws:

RemoteException

createAgent

String createAgent(String agName,
 String agSource,
 String agClass,
 List<String> archClasses,
 ClassParameters bbPars,
 Settings stts,
 Agent father)
            throws Exception,
RemoteException

Creates a new agent with agName from source agSource, using agClass as agent class (default value is "jason.asSemantics.Agent"), archClasses as agent architecture classes, bbPars as the belief base class (default value is "DefaultBeliefBase"), stts as Settings (default value is new Settings()), and father is the agent creating this agent (null is none). if no archClasses is informed (null value), if fathers is informed use father's ag archs else use default ag archs (see registerDefaultAgArch)

Example: createAgent("bob", "bob.asl", "mypkg.MyAgent", null, null, null); Returns the name of the agent

Throws:

Exception

RemoteException

getNewAgentName

String getNewAgentName(String baseName)
                throws RemoteException

Throws:

RemoteException

registerDefaultAgArch

default void registerDefaultAgArch(String agArch)
                            throws RemoteException

register a class to be included as new agents archs

Throws:

RemoteException

getDefaultAgArchs

default Collection<String> getDefaultAgArchs()
                                      throws RemoteException

Throws:

RemoteException

startAgent

void startAgent(String agName)
         throws RemoteException

starts an agent (e.g. create thread for it)

Throws:

RemoteException

clone

default void clone(Agent source,
 List<String> archClasses,
 String agName)
            throws RemoteException,
JasonException

Clones an agent and starts it

Parameters:

source - : the agent used as source for beliefs, plans, ...

archClasses - : agent architectures that will be used

agName - : the name of the clone return the agent arch created

Throws:

JasonException

RemoteException

killAgent

boolean killAgent(String agName,
 String byAg,
 int deadline)
           throws RemoteException

Kills the agent named agName as a requested by byAg. Agent.stopAg() method is called before the agent is removed.

Throws:

RemoteException

getAgentsName

Collection<String> getAgentsName()
                          throws RemoteException

Returns a set of all agents' name

Throws:

RemoteException

getAgentsQty

int getAgentsQty()
          throws RemoteException

Gets the number of agents in the MAS.

Throws:

RemoteException

isRunning

boolean isRunning()
           throws RemoteException

Throws:

RemoteException

getAgStatus

default Map<String,Object> getAgStatus(String agName)
                                throws RemoteException

Throws:

RemoteException

getAgentSnapshot

default Agent getAgentSnapshot(String agName)
                        throws RemoteException

gets a copy of some agent (BB, PL, ...)

Throws:

RemoteException

loadASL

default String loadASL(String agName,
 String code,
 String sourceId,
 boolean replace)
                throws RemoteException

loads some ASL code into some agent, if replace is true, the previous plans from the sourceID will be removed

Throws:

RemoteException

runAsAgent

default String runAsAgent(String agName,
 String code)
                   throws RemoteException

agent agName executes the code (in a new intention)

Throws:

RemoteException

stopMAS

void stopMAS(int deadline,
 boolean stopJVM,
 int exitValue)
      throws RemoteException,
Exception

Stops all MAS (the agents, the environment, the controller, ...)

Throws:

RemoteException

Exception

stopMAS

default void stopMAS()
              throws Exception

Throws:

Exception

dfRegister

default void dfRegister(String agName,
 String service,
 String type)
                 throws RemoteException

Throws:

RemoteException

dfDeRegister

default void dfDeRegister(String agName,
 String service,
 String type)
                   throws RemoteException

Throws:

RemoteException

dfSearch

default Collection<String> dfSearch(String service,
 String type)
                             throws RemoteException

Throws:

RemoteException

dfSubscribe

default void dfSubscribe(String agName,
 String service,
 String type)
                  throws RemoteException

Throws:

RemoteException

getDF

default Map<String,Set<String>> getDF()
                               throws RemoteException

Throws:

RemoteException

getWP

default Map<String,Map<String,Object>> getWP()
                                      throws RemoteException

Throws:

RemoteException