anon.infoservice

Class PerformanceInfo

java.lang.Object

anon.infoservice.AbstractDatabaseEntry

anon.infoservice.AbstractCertifiedDatabaseEntry

anon.infoservice.PerformanceInfo

All Implemented Interfaces:

ICertifiedDatabaseEntry, IXMLEncodable

public class PerformanceInfo
extends AbstractCertifiedDatabaseEntry
implements IXMLEncodable

A PerformanceInfo object holds all PerformanceEntry objects retrieved by a certain Info Service through the /performanceinfo command. It is stored in the JAP client database using the id of the Info Service. To access the data the static method getAverageEntry should be used rather accessing the database directly! This way it is ensured that the entry is derived from all available Info Services.

Author:

Christian Banse

See Also:

getLowestCommonBoundEntry(String)

Field Summary

Fields

Modifier and Type	Field and Description
static int	PERFORMANCE_INFO_TTL
static java.lang.String	XML_ATTR_ID
static java.lang.String	XML_ELEMENT_CONTAINER_NAME
static java.lang.String	XML_ELEMENT_NAME

Fields inherited from class anon.infoservice.AbstractDatabaseEntry

XML_ATTR_LAST_UPDATE, XML_LAST_UPDATE

Fields inherited from interface anon.util.IXMLEncodable

FIELD_XML_ELEMENT_CONTAINER_NAME, FIELD_XML_ELEMENT_NAME, XML_ATTR_LANGUAGE, XML_ATTR_VERSION

Constructor Summary

Constructors

Constructor and Description
PerformanceInfo(org.w3c.dom.Element a_info) Creates a new PerformanceInfo object from an XML element which is usually either retrieved from the Info Service or stored in the configuration file and loaded at startup.

Method Summary

Modifier and Type	Method and Description
MultiCertPath	getCertPath()
java.lang.String	getId() Returns a unique ID for a database entry.
long	getLastUpdate() Returns the time in milliseconds when this db entry was created from the origin instance.
static PerformanceEntry	getLowestCommonBoundEntry(java.lang.String a_cascadeId) Loops through all PerformanceInfo objects from the different Info Services and returns a new PerformanceEntry for the given cascade with the lowest common boundary
XMLSignature	getSignature()
long	getVersionNumber() Returns version number which is used to determine the more recent infoservice entry, if two entries are compared (higher version number -> more recent entry).
boolean	isValid()
boolean	isVerified() Returns if this entry has been verified with a certificate chain.
org.w3c.dom.Element	toXmlElement(org.w3c.dom.Document a_doc) Returns an XML Node of the current PerformanceInfo using the stored XML data

Methods inherited from class anon.infoservice.AbstractCertifiedDatabaseEntry

checkId

Methods inherited from class anon.infoservice.AbstractDatabaseEntry

deletePersistence, getCreationTime, getExpireTime, isNewerThan, isPersistanceDeletionAllowed, isUserDefined, resetCreationTime, setExpireTime

Methods inherited from class java.lang.Object

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

Field Detail

XML_ATTR_ID

public static final java.lang.String XML_ATTR_ID

See Also:

Constant Field Values

XML_ELEMENT_NAME

public static final java.lang.String XML_ELEMENT_NAME

See Also:

Constant Field Values

XML_ELEMENT_CONTAINER_NAME

public static final java.lang.String XML_ELEMENT_CONTAINER_NAME

See Also:

Constant Field Values

PERFORMANCE_INFO_TTL

public static final int PERFORMANCE_INFO_TTL

See Also:

Constant Field Values

Constructor Detail

PerformanceInfo

public PerformanceInfo(org.w3c.dom.Element a_info)
                throws XMLParseException

Creates a new PerformanceInfo object from an XML element which is usually either retrieved from the Info Service or stored in the configuration file and loaded at startup.

Parameters:

a_info - The XML data

Throws:

XMLParseException

Method Detail

getSignature

public XMLSignature getSignature()

Specified by:

getSignature in interface ICertifiedDatabaseEntry

Specified by:

getSignature in class AbstractCertifiedDatabaseEntry

getCertPath

public MultiCertPath getCertPath()

Specified by:

getCertPath in interface ICertifiedDatabaseEntry

Specified by:

getCertPath in class AbstractCertifiedDatabaseEntry

isVerified

public boolean isVerified()

Description copied from class: AbstractCertifiedDatabaseEntry

Returns if this entry has been verified with a certificate chain.

Specified by:

isVerified in interface ICertifiedDatabaseEntry

Specified by:

isVerified in class AbstractCertifiedDatabaseEntry

Returns:

if this entry has been verified with a certificate chain

isValid

public boolean isValid()

Specified by:

isValid in interface ICertifiedDatabaseEntry

getId

public java.lang.String getId()

Description copied from class: AbstractDatabaseEntry

Returns a unique ID for a database entry.

Specified by:

getId in class AbstractDatabaseEntry

Returns:

The ID of this database entry.

getLastUpdate

public long getLastUpdate()

Description copied from class: AbstractDatabaseEntry

Returns the time in milliseconds when this db entry was created from the origin instance. Never (!) insert the local creation time here, as this will DoS the InfoServices in an endless loop.

Specified by:

getLastUpdate in class AbstractDatabaseEntry

Returns:

the time in milliseconds when this db entry was created from the origin instance

getVersionNumber

public long getVersionNumber()

Description copied from class: AbstractDatabaseEntry

Returns version number which is used to determine the more recent infoservice entry, if two entries are compared (higher version number -> more recent entry). Never (!) insert the local creation time here, as this will DoS the InfoServices in an endless loop.

Specified by:

getVersionNumber in class AbstractDatabaseEntry

Returns:

The version number for this entry.

getLowestCommonBoundEntry

public static PerformanceEntry getLowestCommonBoundEntry(java.lang.String a_cascadeId)

Loops through all PerformanceInfo objects from the different Info Services and returns a new PerformanceEntry for the given cascade with the lowest common boundary

Parameters:

a_cascadeId - Id of the cascade

Returns:

PerformanceEntry with lowest common boundary values for the given cascade

toXmlElement

public org.w3c.dom.Element toXmlElement(org.w3c.dom.Document a_doc)

Returns an XML Node of the current PerformanceInfo using the stored XML data

Specified by:

toXmlElement in interface IXMLEncodable

Parameters:

a_doc - a document

Returns:

the XML node