Package jade.domain

Class RequestFIPAServiceBehaviour

java.lang.Object

jade.core.behaviours.Behaviour

jade.core.behaviours.SimpleBehaviour

jade.proto.SimpleAchieveREInitiator

jade.domain.RequestFIPAServiceBehaviour

All Implemented Interfaces:

Serializable, Serializable

public class RequestFIPAServiceBehaviour
extends SimpleAchieveREInitiator

This class extends the FipaRequestIntiatorBehaviour in order to request an agent, e.g. DF or AMS to perform a specific action.
This class implements all the abstract method of the super classes, therefore the behaviour can be immediately added to an agent.
In some cases, it might be usefull to extend this class to override some of its methods and react to the received messages in an application-specific manner.
The class has two constructor. The first generic constructor can be used for all the action an agent can perform. In the case of a a search action the default search constraints are used.
The second constructor is specific for a search action and it allows to specify additional search constraints.

Version:

$Date$ $Revision$

Author:

Fabio Bellifemine (CSELT S.p.A.)

See Also:

DFService, AMSService, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RequestFIPAServiceBehaviour.NotYetReady	Exception class for timeouts.

Nested classes/interfaces inherited from class jade.core.behaviours.Behaviour

Behaviour.RunnableChangedEvent

Field Summary

Fields inherited from class jade.proto.SimpleAchieveREInitiator

ALL_RESPONSES_KEY, ALL_RESULT_NOTIFICATIONS_KEY, REQUEST_KEY, REQUEST_SENT_KEY, SECOND_REPLY_KEY

Fields inherited from class jade.core.behaviours.Behaviour

myAgent, myEvent, NOTIFY_DOWN, NOTIFY_UP, parent, STATE_BLOCKED, STATE_READY, STATE_RUNNING

Constructor Summary

Constructors

Constructor	Description
RequestFIPAServiceBehaviour(Agent a, AID receiver, String actionName, Object agentDescription)	Create a behaviour to request an agent to perform a specific action.
RequestFIPAServiceBehaviour(Agent a, AID receiver, String actionName, Object agentDescription, SearchConstraints constraints)	Create a behaviour to request an agent to perform a specific action.

Method Summary

Modifier and Type	Method	Description
ACLMessage	getLastMsg()	This public method allows to get the INFORM message received in the final state of this FIPA-Request protocol.
List	getSearchResult()	Deprecated. Use getSearchResults() instead.
Object[]	getSearchResults()	This public method allows to get the results of a search operation.
protected void	handleAgree(ACLMessage reply)	Method to handle agree replies.
protected void	handleAllResponses(Vector reply)	This method handle is called after receiving all the responses and when the timeout is expired( in this case no reply has been received.
protected void	handleFailure(ACLMessage reply)	Method to handle failure replies.
protected void	handleInform(ACLMessage reply)	Method to handle inform replies.
protected void	handleNotUnderstood(ACLMessage reply)	Method to handle not-understood replies.
protected void	handleOutOfSequence(ACLMessage reply)	Method to handle out of sequence replies.
protected void	handleRefuse(ACLMessage reply)	Method to handle refuse replies.

Methods inherited from class jade.proto.SimpleAchieveREInitiator

action, done, handleAllResultNotifications, onStart, prepareRequest, reset, reset

Methods inherited from class jade.core.behaviours.Behaviour

actionWrapper, block, block, getAgent, getBehaviourName, getDataStore, getExecutionState, getParent, getRestartCounter, handle, handleBlockEvent, handleRestartEvent, isRunnable, onEnd, restart, root, setAgent, setBehaviourName, setDataStore, setExecutionState

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RequestFIPAServiceBehaviour

public RequestFIPAServiceBehaviour(Agent a,
                                   AID receiver,
                                   String actionName,
                                   Object agentDescription,
                                   SearchConstraints constraints)
                            throws FIPAException

Create a behaviour to request an agent to perform a specific action. Using this constructor, is possible to pass all information necessary to request a search operation.

Parameters:

a - The agent this behaviour belongs to, i.e. the agent who is interested in the search result.

receiver - The agent who will be requested to perform the action.

agentDescription - An agent descriptor used according to the action required.

constraints - The search contraints for the search action.

Throws:

FIPAException - A suitable exception can be thrown when the method locally discovers that the passed parameters are not valid.

See Also:

SearchConstraints

RequestFIPAServiceBehaviour

public RequestFIPAServiceBehaviour(Agent a,
                                   AID receiver,
                                   String actionName,
                                   Object agentDescription)
                            throws FIPAException

Create a behaviour to request an agent to perform a specific action. The default search constraints are used.

Parameters:

a - The agent this behaviour belongs to, i.e the agent who is interested in the action.

dfName - The DF who will perform the action.

dfAction - The action requested to the DF.

dfd - An agent descriptor that will be use according to the action required to the DF.

Throws:

FIPAException

See Also:

RequestFIPAServiceBehaviour(Agent a, AID receiver, String actionName, Object agentDescription, SearchConstraints constraints)

Method Detail

handleNotUnderstood

protected void handleNotUnderstood(ACLMessage reply)

Method to handle not-understood replies.

Overrides:

handleNotUnderstood in class SimpleAchieveREInitiator

Parameters:

reply - The actual ACL message received. It is of not-understood type and matches the conversation template.

handleRefuse

protected void handleRefuse(ACLMessage reply)

Method to handle refuse replies.

Overrides:

handleRefuse in class SimpleAchieveREInitiator

Parameters:

reply - The actual ACL message received. It is of refuse type and matches the conversation template.

handleAgree

protected void handleAgree(ACLMessage reply)

Method to handle agree replies.

Overrides:

handleAgree in class SimpleAchieveREInitiator

Parameters:

reply - The actual ACL message received. It is of agree type and matches the conversation template.

handleFailure

protected void handleFailure(ACLMessage reply)

Method to handle failure replies.

Overrides:

handleFailure in class SimpleAchieveREInitiator

Parameters:

reply - The actual ACL message received. It is of failure type and matches the conversation template.

handleInform

protected void handleInform(ACLMessage reply)

Method to handle inform replies.

Overrides:

handleInform in class SimpleAchieveREInitiator

Parameters:

reply - The actual ACL message received. It is of inform type and matches the conversation template.

handleOutOfSequence

protected void handleOutOfSequence(ACLMessage reply)

Method to handle out of sequence replies.

Overrides:

handleOutOfSequence in class SimpleAchieveREInitiator

Parameters:

reply - The actual ACL message received.

handleAllResponses

protected void handleAllResponses(Vector reply)

This method handle is called after receiving all the responses and when the timeout is expired( in this case no reply has been received.

Overrides:

handleAllResponses in class SimpleAchieveREInitiator

getLastMsg

public ACLMessage getLastMsg()
                      throws FIPAException,
                             RequestFIPAServiceBehaviour.NotYetReady

This public method allows to get the INFORM message received in the final state of this FIPA-Request protocol.

Returns:

the ACLMessage received

Throws:

FIPAException - A suitable exception can be thrown when the protocol was finished with a FAILURE/REFUSE or NOT-UNDERSTOOD performative.

RequestFIPAServiceBehaviour.NotYetReady - is thrown if the protocol is not yet finished.

getSearchResult

public List getSearchResult()
                     throws FIPAException,
                            RequestFIPAServiceBehaviour.NotYetReady

Deprecated.

Use getSearchResults() instead.

This public method allows to get the results of a search operation.

Returns:

the List of Objects received an a result of the search.

Throws:

FIPAException - A suitable exception can be thrown when the protocol was finished with a FAILURE/REFUSE or NOT-UNDERSTOOD performative.

RequestFIPAServiceBehaviour.NotYetReady - is thrown if the protocol is not yet finished.

getSearchResults

public Object[] getSearchResults()
                          throws FIPAException,
                                 RequestFIPAServiceBehaviour.NotYetReady

This public method allows to get the results of a search operation.

Returns:

An array of Objects containing the items found as the result of the search.

Throws:

FIPAException - A suitable exception can be thrown when the protocol was finished with a FAILURE/REFUSE or NOT-UNDERSTOOD performative.

RequestFIPAServiceBehaviour.NotYetReady - is thrown if the protocol is not yet finished.