anon.infoservice
Class AbstractCascadeIDEntry

java.lang.Object
  anon.infoservice.AbstractDatabaseEntry
      anon.infoservice.AbstractCascadeIDEntry

All Implemented Interfaces:

IXMLEncodable

Direct Known Subclasses:

BlacklistedCascadeIDEntry, CascadeIDEntry, NewCascadeIDEntry, PreviouslyKnownCascadeIDEntry

public abstract class AbstractCascadeIDEntry
extends AbstractDatabaseEntry
implements IXMLEncodable

This database class stores the IDs of all mixes in a cascade in a single string. It may be used to determine previously known cascades.

Author:

Rolf Wendolsky

Field Summary

private java.lang.String	m_cascadeID
private java.lang.String	m_ID
private long	m_version
private static java.lang.String	XML_ATTR_EXPIRE_TIME
private static java.lang.String	XML_ATTR_UPDATE_TIME
private static java.lang.String	XML_CASCADE_ID
private static java.lang.String	XML_ID

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_ID, XML_ATTR_LANGUAGE, XML_ATTR_VERSION

Constructor Summary

AbstractCascadeIDEntry(AbstractCascadeIDEntry a_entry, long a_expireTime)
Creates a new CascadeIDEntry from the mix IDs of a given cascade.

AbstractCascadeIDEntry(org.w3c.dom.Element a_xmlElement)

AbstractCascadeIDEntry(MixCascade a_cascade, long a_expireTime)
Creates a new CascadeIDEntry from the mix IDs of a given cascade.

Method Summary

java.lang.String	getCascadeId() The cascade ID, that means the ID of the first mix in the cascade.
java.lang.String	getId() The concatenated ID of all mixes in the cascade.
long	getLastUpdate() Returns the time in milliseconds when this db entry was created from the origin instance.
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).
org.w3c.dom.Element	toXmlElement(org.w3c.dom.Document a_doc) Return an element that can be appended to the document.

Methods inherited from class anon.infoservice.AbstractDatabaseEntry

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

Methods inherited from class java.lang.Object

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

Field Detail

XML_ID

private static final java.lang.String XML_ID

See Also:

Constant Field Values

XML_CASCADE_ID

private static final java.lang.String XML_CASCADE_ID

See Also:

Constant Field Values

XML_ATTR_UPDATE_TIME

private static final java.lang.String XML_ATTR_UPDATE_TIME

See Also:

Constant Field Values

XML_ATTR_EXPIRE_TIME

private static final java.lang.String XML_ATTR_EXPIRE_TIME

See Also:

Constant Field Values

m_ID

private java.lang.String m_ID

m_version

private long m_version

m_cascadeID

private java.lang.String m_cascadeID

Constructor Detail

AbstractCascadeIDEntry

public AbstractCascadeIDEntry(MixCascade a_cascade,
                              long a_expireTime)
                       throws java.lang.IllegalArgumentException

Creates a new CascadeIDEntry from the mix IDs of a given cascade.

Parameters:

a_cascade - MixCascade

a_expireTime - the time in ms when this databse entry expires

Throws:

java.lang.IllegalArgumentException - if the given cascade is null

AbstractCascadeIDEntry

public AbstractCascadeIDEntry(AbstractCascadeIDEntry a_entry,
                              long a_expireTime)
                       throws java.lang.IllegalArgumentException

Creates a new CascadeIDEntry from the mix IDs of a given cascade.

Parameters:

a_entry - MixCascade

a_expireTime - the time in ms when this databse entry expires

Throws:

java.lang.IllegalArgumentException - if the given AbstractCascadeIDEntry is null

AbstractCascadeIDEntry

public AbstractCascadeIDEntry(org.w3c.dom.Element a_xmlElement)
                       throws XMLParseException

Throws:

XMLParseException

Method Detail

getCascadeId

public final java.lang.String getCascadeId()

The cascade ID, that means the ID of the first mix in the cascade.

Returns:

the ID of the first mix in the cascade

getId

public final java.lang.String getId()

The concatenated ID of all mixes in the cascade.

Specified by:

getId in class AbstractDatabaseEntry

Returns:

the concatenated ID of all mixes in the cascade

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 final 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).

Specified by:

getVersionNumber in class AbstractDatabaseEntry

Returns:

The version number for this entry.

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