Package i5.las2peer.security

Class MonitoringAgent

java.lang.Object

i5.las2peer.security.AgentImpl

i5.las2peer.security.PassphraseAgentImpl

i5.las2peer.security.MonitoringAgent

All Implemented Interfaces:

Agent, PassphraseAgent, MessageReceiver, XmlAble, Cloneable

public class MonitoringAgent
extends PassphraseAgentImpl

A MonitoringAgent is responsible for sending monitoring information collected at the MonitoringObserver. It should only be used for this task.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROCESSING_SERVICE_CLASS_NAME

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MonitoringAgent(KeyPair pair, String passphrase, byte[] salt)	Creates a new MonitoringAgent.
protected	MonitoringAgent(PublicKey pubKey, byte[] encodedPrivate, byte[] salt)	Creates a new MonitoringAgent with a locked private key.

Method Summary

Modifier and Type	Method	Description
static MonitoringAgent	createFromXml(String xml)	Sets the state of the object from a string representation resulting from a previous toXmlString() call.
static MonitoringAgent	createFromXml(Element rootElement)	Sets the state of the object from a string representation resulting from a previous toXmlString() call.
static MonitoringAgent	createMonitoringAgent(String passphrase)	Create a new MonitoringAgent protected by the given passphrase.
void	notifyUnregister()	Does nothing.
void	receiveMessage(Message message, AgentContext context)	This method is called by the node this agent is running at.
String	toXmlString()	Can be used to return a XML representation of the MonitoringAgent.

Methods inherited from class i5.las2peer.security.PassphraseAgentImpl

changePassphrase, getPassphrase, getSalt, lockPrivateKey, unlock, unlockPrivateKey

Methods inherited from class i5.las2peer.security.AgentImpl

cloneLocked, createFromXml, createFromXml, createSignature, decryptSymmetricKey, encryptPrivateKey, equals, getEncodedPrivate, getIdentifier, getPublicKey, getResponsibleForAgentSafeId, getRunningAtNode, isLocked, notifyRegistrationTo, signContent, unlockPrivateKey

Methods inherited from class java.lang.Object

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

Methods inherited from interface i5.las2peer.api.security.Agent

getIdentifier, isLocked

Field Details

PROCESSING_SERVICE_CLASS_NAME

public static final String PROCESSING_SERVICE_CLASS_NAME

See Also:

• Constant Field Values

Constructor Details

MonitoringAgent

protected MonitoringAgent(KeyPair pair,
 String passphrase,
 byte[] salt)
                   throws AgentOperationFailedException,
CryptoException

Creates a new MonitoringAgent.

Parameters:

pair -

passphrase -

salt -

Throws:

AgentOperationFailedException

CryptoException

MonitoringAgent

protected MonitoringAgent(PublicKey pubKey,
 byte[] encodedPrivate,
 byte[] salt)

Creates a new MonitoringAgent with a locked private key. Used within createFromXml(java.lang.String).

Parameters:

pubKey -

encodedPrivate -

salt -

Method Details

createMonitoringAgent

public static MonitoringAgent createMonitoringAgent(String passphrase)
                                             throws CryptoException,
AgentOperationFailedException

Create a new MonitoringAgent protected by the given passphrase.

Parameters:

passphrase - passphrase for the secret key of the new agent

Returns:

a new UserAgent

Throws:

CryptoException

AgentOperationFailedException

receiveMessage

public void receiveMessage(Message message,
 AgentContext context)
                    throws MessageException

This method is called by the node this agent is running at. In this context, it is used to receive monitoring messages send by the MonitoringObservers of the monitored nodes to the central processing service. Every other type of communication (to agents not resided at the monitoring node, other types of content than MonitoringMessages will result in an Exception.

Specified by:

receiveMessage in interface MessageReceiver

Specified by:

receiveMessage in class AgentImpl

Parameters:

message -

context -

Throws:

MessageException

toXmlString

public String toXmlString()

Can be used to return a XML representation of the MonitoringAgent.

Returns:

a XML representation of the MonitoringAgent

Throws:

RuntimeException - thrown, if problems with the serialization came up

createFromXml

public static MonitoringAgent createFromXml(String xml)
                                     throws MalformedXMLException

Sets the state of the object from a string representation resulting from a previous toXmlString() call. Usually, a standard constructor is used to get a fresh instance of the class and to set the complete state via this method.

Parameters:

xml - a String

Returns:

Returns a new agent instance

Throws:

MalformedXMLException

createFromXml

public static MonitoringAgent createFromXml(Element rootElement)
                                     throws MalformedXMLException

Sets the state of the object from a string representation resulting from a previous toXmlString() call.

Parameters:

rootElement - parsed XML document

Returns:

Returns a new agent instance

Throws:

MalformedXMLException

notifyUnregister

public void notifyUnregister()

Does nothing.

Specified by:

notifyUnregister in interface MessageReceiver

Overrides:

notifyUnregister in class AgentImpl