anon.infoservice

Class PerformanceEntry

java.lang.Object

anon.infoservice.AbstractDatabaseEntry

anon.infoservice.PerformanceEntry

All Implemented Interfaces:

IXMLEncodable

public class PerformanceEntry
extends AbstractDatabaseEntry
implements IXMLEncodable

A PerformanceEntry stores various performance-related data such as average speed or delay about a certain MixCascade.

Author:

Christian Banse

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PerformanceEntry.Bound
static class	PerformanceEntry.PerformanceAttributeEntry An entry that holds values of performance attributes.
static class	PerformanceEntry.StabilityAttributes

Field Summary

Fields

Modifier and Type	Field and Description
static int[][]	BOUNDARIES The boundaries used to calculate the speed and delay bounds.
static int	DELAY Delay attribute.
static long	LAST_TEST_DATA_TTL Time-to-live of the last-test-data display.
static long	ONE_DAY_TIMEOUT
static int	PACKETS Current users attribute.
static int	SPEED Speed attribute.
static int	USERS Current users attribute.
static long	WEEK_SEVEN_DAYS_TIMEOUT
static java.lang.String	XML_ELEMENT_CONTAINER_NAME The entry's container XML element name.
static java.lang.String	XML_ELEMENT_NAME The 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
PerformanceEntry(org.w3c.dom.Element a_entry) Constructs a new PerformanceEntry from its XML representation.
PerformanceEntry(java.lang.String a_strCascadeId) Constructs a new PerformanceEntry for the given MixCascade.
PerformanceEntry(java.lang.String a_strCascadeId, boolean a_bPassive) Constructs a new PerformanceEntry for the given MixCascade.

Method Summary

Modifier and Type	Method and Description
int	addData(int a_attribute, java.util.Hashtable a_data) Adds a hashtable of values into the entry array.
java.lang.String	delayToHTML(int day) Returns the delay values of a specified day as HTML table.
int	getAverage(int a_attribute) Returns the average value of the give attribute.
int	getBestBound(int a_attribute) Calculates (if used by the info service) and returns the best bound value of the given attribute.
PerformanceEntry.Bound	getBound(int a_attribute) Calculates (if used by the info service) and returns the bound value of the given attribute.
java.lang.String	getId() Returns a unique ID for a database entry.
int	getLastTestAverage(int a_attribute) Returns the average value from the last performed test.
long	getLastTestTime() Returns the time of the last test.
long	getLastUpdate() Returns the time in milliseconds when this db entry was created from the origin instance.
PerformanceEntry.StabilityAttributes	getStabilityAttributes() Returns errors resets, unknown requests and total requests for floating entries.
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).
PerformanceEntry.PerformanceAttributeEntry	importValue(int a_attribute, long a_timestamp, int a_value) Imports a value into the entry array.
void	setBestBound(int a_attribute, int a_lValue) Sets the best bound value.
void	setBound(int a_attribute, PerformanceEntry.Bound a_lValue) Sets the bound value.
void	setStabilityAttributes(PerformanceEntry.StabilityAttributes a_attributes)
java.lang.String	speedToHTML(int day) Returns the speed values of a specified day as HTML table.
org.w3c.dom.Element	toXmlElement(org.w3c.dom.Document a_doc) Return an element that can be appended to the document.
PerformanceEntry	update(PerformanceEntry a_entry)
java.util.Vector	updateHourlyPerformanceAttributeEntries(long a_timestamp)
java.lang.String	usersToHTML(int day) Returns the users values of a specified day as HTML table.

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

WEEK_SEVEN_DAYS_TIMEOUT

public static final long WEEK_SEVEN_DAYS_TIMEOUT

See Also:

Constant Field Values

ONE_DAY_TIMEOUT

public static final long ONE_DAY_TIMEOUT

See Also:

Constant Field Values

XML_ELEMENT_CONTAINER_NAME

public static final java.lang.String XML_ELEMENT_CONTAINER_NAME

The entry's container XML element name.

See Also:

Constant Field Values

XML_ELEMENT_NAME

public static final java.lang.String XML_ELEMENT_NAME

The XML element name.

See Also:

Constant Field Values

LAST_TEST_DATA_TTL

public static final long LAST_TEST_DATA_TTL

Time-to-live of the last-test-data display.

See Also:

Constant Field Values

SPEED

public static final int SPEED

Speed attribute.

See Also:

Constant Field Values

DELAY

public static final int DELAY

Delay attribute.

See Also:

Constant Field Values

USERS

public static final int USERS

Current users attribute.

See Also:

Constant Field Values

PACKETS

public static final int PACKETS

Current users attribute.

See Also:

Constant Field Values

BOUNDARIES

public static final int[][] BOUNDARIES

The boundaries used to calculate the speed and delay bounds.

Constructor Detail

PerformanceEntry

public PerformanceEntry(java.lang.String a_strCascadeId)

Constructs a new PerformanceEntry for the given MixCascade.

Parameters:

a_strCascadeId - The id of the mix cascade.

PerformanceEntry

public PerformanceEntry(java.lang.String a_strCascadeId,
                        boolean a_bPassive)

Constructs a new PerformanceEntry for the given MixCascade.

Parameters:

a_strCascadeId - The id of the mix cascade.

a_bInfoService - Specifies if the caller of this method is an InfoService or the JAP client.

PerformanceEntry

public PerformanceEntry(org.w3c.dom.Element a_entry)
                 throws XMLParseException

Constructs a new PerformanceEntry from its XML representation.

Parameters:

a_entry - The XML data.

Throws:

XMLParseException - If the XML data is invalid.

Method Detail

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.

getLastTestTime

public long getLastTestTime()

Returns the time of the last test.

Returns:

The time of the last test.

importValue

public PerformanceEntry.PerformanceAttributeEntry importValue(int a_attribute,
                                                              long a_timestamp,
                                                              int a_value)

Imports a value into the entry array.

Parameters:

a_attribute - The performance attribute.

a_timestamp - The time stamp of the value.

a_value - The value itself.

update

public PerformanceEntry update(PerformanceEntry a_entry)

updateHourlyPerformanceAttributeEntries

public java.util.Vector updateHourlyPerformanceAttributeEntries(long a_timestamp)

addData

public int addData(int a_attribute,
                   java.util.Hashtable a_data)

Adds a hashtable of values into the entry array.

Parameters:

a_attribute - The performance attribute.

a_data - The data hashtable.

Returns:

The average value of the hashtable.

getLastTestAverage

public int getLastTestAverage(int a_attribute)

Returns the average value from the last performed test.

Parameters:

a_attribute - The performance attribute.

Returns:

The average value from the last performed test.

setStabilityAttributes

public void setStabilityAttributes(PerformanceEntry.StabilityAttributes a_attributes)

setBound

public void setBound(int a_attribute,
                     PerformanceEntry.Bound a_lValue)

Sets the bound value. This should only be used by the PerformanceInfo class in the JAP client.

Parameters:

a_attribute - The performance attribute.

a_lValue - The bound value.

See Also:

PerformanceInfo.getLowestCommonBoundEntry(String)

setBestBound

public void setBestBound(int a_attribute,
                         int a_lValue)

Sets the best bound value. This should only be used by the PerformanceInfo class in the JAP client.

Parameters:

a_attribute - The performance attribute.

a_lValue - The best bound value.

See Also:

PerformanceInfo.getLowestCommonBoundEntry(String)

getBound

public PerformanceEntry.Bound getBound(int a_attribute)

Calculates (if used by the info service) and returns the bound value of the given attribute.

Parameters:

a_attribute - The performance attribute.

Returns:

The bound value of the given attribute.

getStabilityAttributes

public PerformanceEntry.StabilityAttributes getStabilityAttributes()

Returns errors resets, unknown requests and total requests for floating entries.

Returns:

getBestBound

public int getBestBound(int a_attribute)

Calculates (if used by the info service) and returns the best bound value of the given attribute.

Parameters:

a_attribute - The performance attribute.

Returns:

The best bound value of the given attribute.

getAverage

public int getAverage(int a_attribute)

Returns the average value of the give attribute.

Parameters:

a_attribute - The performance attribute.

Returns:

The average value of given attribute.

delayToHTML

public java.lang.String delayToHTML(int day)

Returns the delay values of a specified day as HTML table.

Parameters:

day - The day.

Returns:

The HTML table.

speedToHTML

public java.lang.String speedToHTML(int day)

Returns the speed values of a specified day as HTML table.

Parameters:

day - The day.

Returns:

The HTML table.

usersToHTML

public java.lang.String usersToHTML(int day)

Returns the users values of a specified day as HTML table.

Parameters:

day - The day.

Returns:

The HTML table.

toXmlElement

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

Description copied from interface: IXMLEncodable

Return an element that can be appended to the document. This Method must not change the document in any way!

Specified by:

toXmlElement in interface IXMLEncodable

Parameters:

a_doc - a document

Returns:

the interface as xml element