kaos.core.csi.request
Class ObligationRequestReceiverImpl

java.lang.Object
  kaos.core.csi.KAoSActorImpl
      kaos.core.csi.request.ObligationRequestReceiverImpl

All Implemented Interfaces:

KAoSActor, ObligationRequestReceiver

Direct Known Subclasses:

NotifyAgent, ObligationActorForNotificationAction

public abstract class ObligationRequestReceiverImpl
extends KAoSActorImpl
implements ObligationRequestReceiver

Defines the operations to process an obligation request described by the given obligation ActionInstanceDescription. In addition, the obligation trigger is given as well to provide more information about the context, in which the trigger action has occurred.

Author:

KAoS Team

Field Summary

Fields inherited from class kaos.core.csi.KAoSActorImpl

_actorDesc, _autoCommit, _lctr, _logger, _preferredTransportName, _propertiesToModify, _registered, _registration, _transports, _transportSupport

Constructor Summary

ObligationRequestReceiverImpl(java.lang.String[] args)
Instantiates a new KAoS-aware agent using JAS services for transport, naming and agent directory.

Method Summary

void	processObligationRequest(ActionInstanceDescription obligationAID, ActionInstanceDescription triggerAID) This method accepts an obligation request to execute by the ObligationRequestReceiver.
void	receiveMessage(TransportMessage tmsg) Implements the receiveMessage method mandated by the MessageListener interface.

Methods inherited from class kaos.core.csi.KAoSActorImpl

addCapability, addOntologicalType, addOntologicalType, addProperty, addProperty, addPropertyValue, addTransport, commitPropertyValues, deregisterFromKAoS, equals, getAgentDescription, getCapabilities, getConceptMappingName, getDomainNames, getEntityOntologicalTypeNames, getEntityOntologicalTypes, getGUID, getName, getProperties, getProperty, getPropertyValue, getTransport, getTransports, hashCode, initialize, initialize, initialize, isAutoPropertyValueCommit, isGuarded, isRegistered, logMessage, logMessage, main, printTransportMessage, receiveMessage, registerWithKAoS, removeCapability, removeOntologicalType, removeProperty, removePropertyValue, removeTransport, sendMessage, sendMessage, setAutoPropertyValueCommit, setCapabilities, setConceptMappingName, setGUID, setMyDescription, setName, setOntologicalTypes, setProperties, setPropertyValue, setRegistered

Methods inherited from class java.lang.Object

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

Constructor Detail

ObligationRequestReceiverImpl

public ObligationRequestReceiverImpl(java.lang.String[] args)
                              throws java.lang.Exception

Instantiates a new KAoS-aware agent using JAS services for transport, naming and agent directory.

Throws:

java.lang.Exception

Method Detail

processObligationRequest

public void processObligationRequest(ActionInstanceDescription obligationAID,
                                     ActionInstanceDescription triggerAID)
                              throws ActionFailureException

Description copied from interface: ObligationRequestReceiver

This method accepts an obligation request to execute by the ObligationRequestReceiver. The obligation is described by the given ActionInstanceDescription. Also the trigger ActionInstanceDescription is given for the contextual information of the trigger action.

Specified by:

processObligationRequest in interface ObligationRequestReceiver

Parameters:

obligationAID - is an ActionInstanceDescription containing the obligation action name and its properties.

triggerAID - is an ActionInstanceDescription containing the trigger action name and its properties.

Throws:

ActionFailureException - containing the reason for failure. See ontology to determine specific reasons available for a given action

See Also:

ObligationRequestReceiver

receiveMessage

public void receiveMessage(TransportMessage tmsg)

Implements the receiveMessage method mandated by the MessageListener interface. Sends a reply, if requested, back to the receiver.

Overrides:

receiveMessage in class KAoSActorImpl