kaos.core.service.util
Interface KAoSAgentHelper

All Known Implementing Classes:

CommSpeedTestReceiver, CommSpeedTestSender, Kaa, KAoSAgent, KAoSAgentMsgForwarder, KAoSGuardedUsecase1, KAoSmyGridEventHandlerWrapper, KAoSmyGridRepositoryWrapper, KAoSUsecase10New, KAoSUsecase20New, TestClassifier, TestRobot

public interface KAoSAgentHelper

Defines operations to retrieve the KAoSAgentDescription contained by this KAoSAgentHelper, to lookup other agents in KAoS Directory Service, to create TransportMessages and send those messages to other agents.

Method Summary

void	checkPermission(java.lang.String action, java.util.HashMap properties) Check permission for the specified action with given parameters.
TransportMessage	createTransportMessage()
KAoSAgentDescription	findAgentDescriptionForID(java.lang.String agentID)
KAoSAgentDescription	findAgentDescriptionForNickname(java.lang.String nickname)
java.lang.String	getAgentID()
KAoSAgentDescription	getKAoSAgentDescription() Returns the KAoSAgentDescription created by this helper.
void	sendMessage(TransportMessage message)

Method Detail

getKAoSAgentDescription

KAoSAgentDescription getKAoSAgentDescription()

Returns the KAoSAgentDescription created by this helper.

Returns:

an KAoSAgentDescription for this KAoSAgentHelper.

checkPermission

void checkPermission(java.lang.String action,
                     java.util.HashMap properties)
                     throws KAoSSecurityException,
                            java.lang.NullPointerException,
                            ServiceFailure

Check permission for the specified action with given parameters. The actor of the action is KAoSAgentHelper.

Parameters:

action - Ontological name of the policy action.

properties - HashMap containing the names of properties as defined in ontologies and their values.

Throws:

KAoSSecurityException - if the permission is not granted.

java.lang.NullPointerException - if the specified action or properties are null.

ServiceFailure - if some of the security services are not available.

getAgentID

java.lang.String getAgentID()

findAgentDescriptionForNickname

KAoSAgentDescription findAgentDescriptionForNickname(java.lang.String nickname)

findAgentDescriptionForID

KAoSAgentDescription findAgentDescriptionForID(java.lang.String agentID)

createTransportMessage

TransportMessage createTransportMessage()

sendMessage

void sendMessage(TransportMessage message)
                 throws NotLocatableException,
                        TransportFailure

Throws:

NotLocatableException

TransportFailure