fipaos.platform.df
Class DFListenerTask

fipaos.agent.task.Task
  |
  +--fipaos.platform.df.DFListenerTask

public class DFListenerTask
extends Task

This Task provides a mechanism for listening to events occuring to a particular DF.

Currently this Task (and its counterpart) only support intra-platform communication over a transport which maintains message content as objects (i.e. RMI).


Constructor Summary
DFListenerTask(DFListener listener, AgentID df)
          Creates a DFListenerTask - once the Task has started, it will attempt to subscribe to events from the given DF and forward them to the given DFListener

Method Summary
 voidhandleInform(Conversation conv)
          Invoked when an inform is received - either indicates that the subscription has been setup OK, or indicates an event has occured that meets the requirements of the original subscription request
 voidhandleNotUnderstood(Conversation conv)
          Deal with not-understood messages here
 voidhandleRefuse(Conversation conv)
          Invoked when the DF refuses subscription
 voidstartTask()
          Invoked when the Task starts - sends subscription message to target DF
 voidstopListening()
          When invoked, causes the subscription with the DF to be cancelled
 booleansubscribedOK()
          Indicates if this DFListenerTask has been succesfull in subscribing

Methods inherited from class fipaos.agent.task.Task
doneDFSearchTask, errorDFSearchTask, getState, handleFailure, handleRequest, notify, timeoutDFSearchTask

Constructor Detail

DFListenerTask

public DFListenerTask(DFListener listener, AgentID df)
Creates a DFListenerTask - once the Task has started, it will attempt to subscribe to events from the given DF and forward them to the given DFListener
Parameters:
listener - Object to receive DF event notification
df - DF to monitor
Method Detail

handleInform

public void handleInform(Conversation conv)
Invoked when an inform is received - either indicates that the subscription has been setup OK, or indicates an event has occured that meets the requirements of the original subscription request
Parameters:
conv

handleNotUnderstood

public void handleNotUnderstood(Conversation conv)
Deal with not-understood messages here

handleRefuse

public void handleRefuse(Conversation conv)
Invoked when the DF refuses subscription
Parameters:
conv

startTask

public void startTask()
Invoked when the Task starts - sends subscription message to target DF

stopListening

public void stopListening()
When invoked, causes the subscription with the DF to be cancelled

subscribedOK

public boolean subscribedOK()
Indicates if this DFListenerTask has been succesfull in subscribing

Association Links

to Class fipaos.platform.df.DFListener

Object that is listening for DF events

to Class fipaos.ont.fipa.fipaman.AgentID

DF that is being monitored

to Class java.lang.String

Conversation ID associated with our subscription messages