|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--jade.core.Agent | +--jade.gui.GuiAgent | +--jade.domain.df
Standard Directory Facilitator agent. This class implements
FIPA DF agent. JADE applications
cannot use this class directly, but interact with it through
ACL message passing. The DFService
class provides
a number of static methods that facilitate this task.
More DF agents can be created
by application programmers to divide a platform into many
Agent Domains.
A DF agent accepts a number of optional configuration parameters that can be set either as command line options or within a properties file (to be passed to the DF as an argument).
jade_domain_df_maxleasetime
Indicates the maximum lease
time (in millisecond) that the DF will grant for agent description registrations (defaults
to infinite).
jade_domain_df_maxresult
Indicates the maximum number of items found
in a search operation that the DF will return to the requester (defaults
to 100).
jade_domain_df_db-url
Indicates the JDBC URL of the database
the DF will store its catalogue into. If this parameter is not specified
the DF will keep its catalogue in memory.
jade_domain_df_db-driver
Indicates the JDBC driver to be used
to access the DF database (defaults to the ODBC-JDBC bridge). This parameter
is ignored if jade_domain_df_db-url
is not set.
jade_domain_df_db-username
, jade_domain_df_db-password
Indicate the username and password to be used to access the DF database
(default to null). These parameters are ignored if
jade_domain_df_db-url
is not set.
java jade.Boot -gui -jade_domain_df_db-url jdbc:odbc:dfdb -jade_domain_df_maxleasetime 3600000
Each DF has a GUI but, by default, it is not visible. The GUI of the
agent platform includes a menu item that allows to show the GUI of the
default DF.
In order to show the GUI, you should simply send the following message
to each DF agent: (request :content (action DFName (SHOWGUI))
:ontology JADE-Agent-Management :protocol fipa-request)
DFService
, Serialized FormFields inherited from class jade.core.Agent |
AP_ACTIVE,
AP_DELETED,
AP_IDLE,
AP_INITIATED,
AP_MAX,
AP_MIN,
AP_SUSPENDED,
AP_TRANSIT,
AP_WAITING,
currentBehaviour,
currentMessage,
D_ACTIVE,
D_MAX,
D_MIN,
D_RETIRED,
D_SUSPENDED,
D_UNKNOWN |
Fields inherited from interface jade.domain.DFGUIAdapter |
CLOSEGUI,
DEREGISTER,
EXIT,
FEDERATE,
MODIFY,
REFRESHAPPLET,
REGISTER,
SEARCH |
Constructor Summary | |
df()
|
Method Summary | |
void |
addParent(AID dfName,
DFAgentDescription dfd)
This method can be used to add a parent (a DF with which the this DF is federated). |
protected void |
deregisterFromAction(Action a,
ACLMessage request)
|
protected void |
federateWithAction(Action a,
ACLMessage request)
|
DFAgentDescription |
getDescriptionOfThisDF()
This method returns the current description of this DF |
DFAgentDescription |
getDescriptionOfThisDF(AID parent)
This method returns the description of this df used to federate with the given parent |
protected ACLMessage |
getDescriptionOfThisDFAction(Action a,
ACLMessage request)
|
protected ACLMessage |
getDescriptionUsedAction(Action a,
ACLMessage request)
|
DFAgentDescription |
getDFAgentDsc(AID name)
This method returns the descriptor of an agent registered with the df. |
protected ACLMessage |
getParentAction(Action a,
ACLMessage request)
|
protected void |
modifyOnAction(Action a,
ACLMessage request)
|
protected void |
onGuiEvent(GuiEvent ev)
|
protected void |
registerWithAction(Action a,
ACLMessage request)
|
void |
removeParent(AID dfName)
this method can be used to remove a parent (a DF with which this DF is federated). |
protected void |
searchOnAction(Action a,
ACLMessage request)
|
void |
setDescriptionOfThisDF(DFAgentDescription dfd)
This method set the description of the df according to the DFAgentDescription passed. |
protected void |
setup()
This method starts all behaviours needed by DF agent to perform its role within JADE agent platform. |
boolean |
showGui()
This method make visible the GUI of the DF. |
protected void |
showGuiAction(Action a)
|
protected void |
takeDown()
Cleanup DF on exit. |
Methods inherited from class jade.gui.GuiAgent |
postGuiEvent |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public df()
Method Detail |
protected void showGuiAction(Action a) throws FailureException
protected ACLMessage getParentAction(Action a, ACLMessage request) throws FailureException
protected ACLMessage getDescriptionOfThisDFAction(Action a, ACLMessage request) throws FailureException
protected void federateWithAction(Action a, ACLMessage request)
protected ACLMessage getDescriptionUsedAction(Action a, ACLMessage request) throws FailureException
protected void deregisterFromAction(Action a, ACLMessage request)
protected void registerWithAction(Action a, ACLMessage request)
protected void modifyOnAction(Action a, ACLMessage request)
protected void searchOnAction(Action a, ACLMessage request)
protected void setup()
Agent.addBehaviour(Behaviour b)
,
Behaviour
protected void takeDown()
public boolean showGui()
protected void onGuiEvent(GuiEvent ev)
public DFAgentDescription getDFAgentDsc(AID name) throws FIPAException
public void setDescriptionOfThisDF(DFAgentDescription dfd)
public DFAgentDescription getDescriptionOfThisDF()
public DFAgentDescription getDescriptionOfThisDF(AID parent)
public void addParent(AID dfName, DFAgentDescription dfd)
dfName
- the parent df (the df with which this df has been registered)dfd
- the description used by this df to register with the parent.public void removeParent(AID dfName)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |