anon.infoservice
Class InfoServiceDBEntry

java.lang.Object
  anon.infoservice.AbstractDatabaseEntry
      anon.infoservice.AbstractDistributableDatabaseEntry
          anon.infoservice.AbstractDistributableCertifiedDatabaseEntry
              anon.infoservice.InfoServiceDBEntry

All Implemented Interfaces:

anon.crypto.IVerifyable, IBoostrapable, ICertifiedDatabaseEntry, IDistributable, anon.util.IXMLEncodable

public class InfoServiceDBEntry
extends AbstractDistributableCertifiedDatabaseEntry
implements anon.crypto.IVerifyable, IBoostrapable

Holds the information for an infoservice.

Nested Class Summary

Nested classes/interfaces inherited from class anon.infoservice.AbstractDistributableDatabaseEntry

AbstractDistributableDatabaseEntry.SerialDBEntry, AbstractDistributableDatabaseEntry.Serials

Field Summary

static int	DEFAULT_GET_XML_CONNECTION_TIMEOUT
static java.lang.String	XML_ELEMENT_CONTAINER_NAME
static java.lang.String	XML_ELEMENT_NAME

Fields inherited from class anon.infoservice.AbstractDistributableDatabaseEntry

XML_ATTR_LAST_UPDATE, XML_ATTR_SERIAL, XML_ATTR_VALID, XML_ATTR_VERIFIED

Fields inherited from class anon.infoservice.AbstractDatabaseEntry

XML_LAST_UPDATE

Fields inherited from interface anon.infoservice.IDistributable

FIELD_HTTP_REQUEST_STRING, FIELD_HTTP_SERIALS_REQUEST_STRING

Fields inherited from interface anon.util.IXMLEncodable

FIELD_XML_ELEMENT_CONTAINER_NAME, FIELD_XML_ELEMENT_NAME, XML_ATTR_ID, XML_ATTR_VERSION

Constructor Summary

InfoServiceDBEntry(org.w3c.dom.Element a_infoServiceNode)
Creates a new InfoService from XML description (InfoService node).

InfoServiceDBEntry(org.w3c.dom.Element a_infoServiceNode, long a_timeout)
Creates a new InfoService from XML description (InfoService node).

InfoServiceDBEntry(java.lang.String a_host, int a_port)
This is a JAP-only constructor needed to initialise JAP with default InfoServices.

InfoServiceDBEntry(java.lang.String a_strName, java.lang.String a_id, java.util.Vector a_listeners, boolean a_primaryForwarderList, boolean a_japClientContext, long a_creationTime, long a_serialNumber, boolean a_bPerfServerEnabled)
Creates a new InfoServiceDBEntry.

Method Summary

boolean	checkId() Checks if the ID is valid.
boolean	equals(java.lang.Object a_object) Compares this object to another one.
anon.crypto.MultiCertPath	getCertPath()
static int	getConnectionTimeout()
java.lang.Object	getExitAddresses()
org.w3c.dom.Element	getForwarder() Downloads a forwarder entry from the infoservice.
java.lang.String	getId() Returns the ID of the infoservice.
java.util.Hashtable	getInfoServices() Get a Vector of all infoservices the infoservice knows.
java.util.Hashtable	getInfoServices(boolean a_bJAPClientContext)
java.util.Hashtable	getInfoServiceSerials()
JAPVersionInfo	getJAPVersionInfo(int a_japVersionType) Returns the JAPVersionInfo for the specified type.
long	getLastUpdate() Returns the time in milliseconds when this db entry was created from the origin instance.
java.util.Hashtable	getLatestJava() Get the latest java versions the infoservice knows ordered by vendors.
java.util.Hashtable	getLatestJavaSerials()
java.util.Vector	getListenerInterfaces() Returns a snapshot of all listener interfaces of this infoservice.
java.util.Hashtable	getMessages()
java.util.Hashtable	getMessageSerials()
MixCascade	getMixCascadeInfo(java.lang.String a_cascadeID) Gets information about a specific cascade from the InfoService.
java.util.Hashtable	getMixCascades() Get a Vector of all mixcascades the infoservice knows.
java.util.Hashtable	getMixCascades(boolean a_bJAPClientContext)
java.util.Hashtable	getMixCascadeSerials()
java.util.Hashtable	getMixes(boolean a_bJAPClientContext)
MixInfo	getMixInfo(java.lang.String mixId) Get the MixInfo for the mix with the given ID.
byte[]	getMixminionNodesList() Get the list with the mixminion nodes from the infoservice.
java.lang.String	getName() Returns the name of the infoservice.
JAPMinVersion	getNewVersionNumber() Get the version String of the currently minimum required JAP version from the infoservice.
anon.pay.PaymentInstanceDBEntry	getPaymentInstance(java.lang.String a_piID)
java.util.Hashtable	getPaymentInstances() Get a Vector of all payment instances the infoservice knows.
java.util.Hashtable	getPaymentInstances(boolean a_bJAPClientContext)
PerformanceInfo	getPerformanceInfo() Sends a /performanceinfo request to the Info Service, retrieves the data and creates a new PerformanceInfo object.
java.lang.String	getPostFile() This returns the filename (InfoService command), where this InfoServerDBEntry is posted at other InfoServices.
anon.crypto.XMLSignature	getSignature()
StatusInfo	getStatusInfo(MixCascade a_cascade) Get the StatusInfo for the cascade with the given ID.
StatusInfo	getStatusInfo(MixCascade a_cascade, long a_timeout) Get the StatusInfo for the cascade with the given ID.
TermsAndConditionsFramework	getTCFramework(java.lang.String a_id) Get the MixInfo for the mix with the given ID.
java.util.Hashtable	getTermsAndConditions()
java.util.Hashtable	getTermsAndConditionSerials()
byte[]	getTorNodesList() Get the list with the tor nodes from the infoservice.
long	getVersionNumber() Returns the time when this infoservice entry was created by the origin infoservice or by the JAP client (if it is a user-defined entry).
org.w3c.dom.Element	getXmlStructure() Returns the XML structure for this db entry.
int	hashCode() Returns a hashcode for this instance of InfoServiceDBEntry.
boolean	hasPrimaryForwarderList() Returns, whether this infoservice keeps a list of JAP forwarders (true) or not (false).
boolean	isBootstrap()
boolean	isNeighbour() Returns whether this infoservice is a neighbour of our one.
boolean	isPerfServerEnabled()
boolean	isUserDefined() Returns whether this InfoServiceDBEntry was generated by a user within the JAP client (true) or was generated by the InfoService itself (false).
boolean	isValid() Returns if the object is valid at this time
boolean	isVerified() Returns if this entry has been verified with a certificate chain.
void	markAsBootstrap()
org.w3c.dom.Element	postNewForwarder(org.w3c.dom.Element a_japForwarderNode) Posts a new forwarder to an infoservice with a JAP forwarder list.
org.w3c.dom.Element	postRenewForwarder(org.w3c.dom.Element a_japForwarderNode) Posts the renew message for a forwarder to an infoservice with a JAP forwarder list.
static void	setConnectionTimeout(int a_timeoutMS)
static void	setJVMNetworkErrorHandling(java.lang.Runnable a_threadRestartAfterJVMSocketError, long a_timeRestartAfterJVMSocketError) Sets the options for handling a JVM socket error that cannot be recovered.
static void	setMutableProxyInterface(IMutableProxyInterface a_proxyInterface)
void	setNeighbour(boolean a_bNeighbour) Forces this InfoService to be a neighbour or not.
void	setUserDefined(boolean b)
java.lang.String	toString() Returns a String representation for this InfoService object.

Methods inherited from class anon.infoservice.AbstractDistributableDatabaseEntry

getHttpRequestString, getHttpSerialsRequestString, getPostData, getPostEncoding, toXmlElement

Methods inherited from class anon.infoservice.AbstractDatabaseEntry

getCreationTime, getExpireTime, isNewerThan, resetCreationTime

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

XML_ELEMENT_CONTAINER_NAME

public static final java.lang.String XML_ELEMENT_CONTAINER_NAME

See Also:

Constant Field Values

XML_ELEMENT_NAME

public static final java.lang.String XML_ELEMENT_NAME

See Also:

Constant Field Values

DEFAULT_GET_XML_CONNECTION_TIMEOUT

public static final int DEFAULT_GET_XML_CONNECTION_TIMEOUT

See Also:

Constant Field Values

Constructor Detail

InfoServiceDBEntry

public InfoServiceDBEntry(org.w3c.dom.Element a_infoServiceNode)
                   throws anon.util.XMLParseException

Creates a new InfoService from XML description (InfoService node). The new entry will be created within the context of the JAP client (the timeout for infoservice entries within the JAP client is used).

Parameters:

a_infoServiceNode - The InfoService node from an XML document.

Throws:

anon.util.XMLParseException - if an error in the xml structure occurs

InfoServiceDBEntry

public InfoServiceDBEntry(org.w3c.dom.Element a_infoServiceNode,
                          long a_timeout)
                   throws anon.util.XMLParseException

Creates a new InfoService from XML description (InfoService node).

Parameters:

a_infoServiceNode - The InfoService node from an XML document.

a_timeout - The timeout of the new InfoServiceDBEntry within the database of all InfoServices, see System.currentTimeMillis().

Throws:

anon.util.XMLParseException - if an error in the xml structure occurs

InfoServiceDBEntry

public InfoServiceDBEntry(java.lang.String a_host,
                          int a_port)
                   throws java.lang.IllegalArgumentException

This is a JAP-only constructor needed to initialise JAP with default InfoServices.

Parameters:

a_host - host name of this info service

a_port - the port where this IS is reachable

Throws:

java.lang.IllegalArgumentException

InfoServiceDBEntry

public InfoServiceDBEntry(java.lang.String a_strName,
                          java.lang.String a_id,
                          java.util.Vector a_listeners,
                          boolean a_primaryForwarderList,
                          boolean a_japClientContext,
                          long a_creationTime,
                          long a_serialNumber,
                          boolean a_bPerfServerEnabled)
                   throws java.lang.IllegalArgumentException

Creates a new InfoServiceDBEntry. The ID is set to a generic value derived from the host and the port of the first listener interface. If you supply a name for the infoservice then it will get that name, if you supply null, the name will be of the type "hostname:port". If the new infoservice entry is created within the context of the JAP client, the software info is set to a dummy value. If it is created within the context of the infoservice, the software info is set to the current infoservice version (see Constants.INFOSERVICE_VERSION).

Parameters:

a_strName - The name of the infoservice or null, if a generic name shall be used.

a_listeners - The listeners the infoservice is (virtually) listening on.

a_primaryForwarderList - Whether the infoservice holds a primary forwarder list.

a_japClientContext - Whether the new entry will be created within the context of the JAP client (true) or the context of the InfoService (false). This setting influences the timeout of the created entry within the database of all infoservices.

a_serialNumber - the serial number that indicates if the document has changed since the last time it was updated

Throws:

java.lang.IllegalArgumentException - if invalid listener interfaces are given

Method Detail

setConnectionTimeout

public static void setConnectionTimeout(int a_timeoutMS)

getConnectionTimeout

public static int getConnectionTimeout()

setMutableProxyInterface

public static void setMutableProxyInterface(IMutableProxyInterface a_proxyInterface)

setJVMNetworkErrorHandling

public static void setJVMNetworkErrorHandling(java.lang.Runnable a_threadRestartAfterJVMSocketError,
                                              long a_timeRestartAfterJVMSocketError)

Sets the options for handling a JVM socket error that cannot be recovered.

Parameters:

a_threadRestartAfterJVMSocketError - Runnable

a_timeRestartAfterJVMSocketError - long

getId

public java.lang.String getId()

Returns the ID of the infoservice.

Specified by:

getId in interface IDistributable

Specified by:

getId in class AbstractDatabaseEntry

Returns:

The ID of this infoservice.

getXmlStructure

public org.w3c.dom.Element getXmlStructure()

Description copied from class: AbstractDistributableDatabaseEntry

Returns the XML structure for this db entry.

Specified by:

getXmlStructure in class AbstractDistributableDatabaseEntry

Returns:

The XML node of this db entry

getName

public java.lang.String getName()

Returns the name of the infoservice.

Returns:

The name of this infoservice.

isVerified

public boolean isVerified()

Description copied from class: AbstractDistributableCertifiedDatabaseEntry

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

Specified by:

isVerified in interface anon.crypto.IVerifyable

Specified by:

isVerified in interface ICertifiedDatabaseEntry

Specified by:

isVerified in class AbstractDistributableCertifiedDatabaseEntry

Returns:

if this entry has been verified with a certificate chain

isValid

public boolean isValid()

Description copied from interface: anon.crypto.IVerifyable

Returns if the object is valid at this time

Specified by:

isValid in interface anon.crypto.IVerifyable

Returns:

if the object is valid at this time

isPerfServerEnabled

public boolean isPerfServerEnabled()

checkId

public boolean checkId()

Description copied from class: AbstractDistributableCertifiedDatabaseEntry

Checks if the ID is valid.

Specified by:

checkId in interface ICertifiedDatabaseEntry

Overrides:

checkId in class AbstractDistributableCertifiedDatabaseEntry

Returns:

boolean

getSignature

public anon.crypto.XMLSignature getSignature()

Specified by:

getSignature in interface ICertifiedDatabaseEntry

Specified by:

getSignature in class AbstractDistributableCertifiedDatabaseEntry

getCertPath

public anon.crypto.MultiCertPath getCertPath()

Specified by:

getCertPath in interface anon.crypto.IVerifyable

Specified by:

getCertPath in interface ICertifiedDatabaseEntry

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()

Returns the time when this infoservice entry was created by the origin infoservice or by the JAP client (if it is a user-defined entry).

Specified by:

getVersionNumber in class AbstractDatabaseEntry

Returns:

A version number which is used to determine the more recent infoservice entry, if two entries are compared (higher version number -> more recent entry).

hasPrimaryForwarderList

public boolean hasPrimaryForwarderList()

Returns, whether this infoservice keeps a list of JAP forwarders (true) or not (false).

Returns:

Whether this infoservice keeps a list of JAP forwarders.

getListenerInterfaces

public java.util.Vector getListenerInterfaces()

Returns a snapshot of all listener interfaces of this infoservice.

Returns:

A Vector with all listener interfaces of this infoservice.

isUserDefined

public boolean isUserDefined()

Returns whether this InfoServiceDBEntry was generated by a user within the JAP client (true) or was generated by the InfoService itself (false).

Overrides:

isUserDefined in class AbstractDatabaseEntry

Returns:

Whether this InfoServiceDBEntry is user-defined.

setUserDefined

public void setUserDefined(boolean b)

markAsBootstrap

public void markAsBootstrap()

isBootstrap

public boolean isBootstrap()

Specified by:

isBootstrap in interface IBoostrapable

toString

public java.lang.String toString()

Returns a String representation for this InfoService object. It's just the name of the infoservice.

Overrides:

toString in class java.lang.Object

Returns:

The name of this infoservice.

equals

public boolean equals(java.lang.Object a_object)

Compares this object to another one. This method returns only true, if the other object is also an InfoServiceDBEntry and has the same ID as this InfoServiceDBEntry.

Overrides:

equals in class java.lang.Object

Parameters:

a_object - The object with which to compare.

Returns:

True, if the object with which to compare is also an InfoServiceDBEntry which has the same ID as this instance. In any other case, false is returned.

hashCode

public int hashCode()

Returns a hashcode for this instance of InfoServiceDBEntry. The hashcode is calculated from the ID, so if two instances of InfoServiceDBEntry have the same ID, they will have the same hashcode.

Overrides:

hashCode in class java.lang.Object

Returns:

The hashcode for this InfoServiceDBEntry.

getPostFile

public java.lang.String getPostFile()

This returns the filename (InfoService command), where this InfoServerDBEntry is posted at other InfoServices. It's always '/infoservice'.

Specified by:

getPostFile in interface IDistributable

Returns:

The filename where the information about this InfoServerDBEntry is posted at other InfoServices when this entry is forwarded.

isNeighbour

public boolean isNeighbour()

Returns whether this infoservice is a neighbour of our one. This is only meaningful within the context of an infoservice. We send all messages only to neighbours, so we have less traffic. For now, every remote infoservice is a neighbour and it is only false for the local one.

Returns:

Whether this infoservice is a neighbour of our one or not.

setNeighbour

public void setNeighbour(boolean a_bNeighbour)

Forces this InfoService to be a neighbour or not.

Parameters:

a_bNeighbour - if this IS should be a neighbour

getMixCascadeInfo

public MixCascade getMixCascadeInfo(java.lang.String a_cascadeID)
                             throws java.lang.Exception

Gets information about a specific cascade from the InfoService.

Parameters:

a_cascadeID - String

Returns:

MixCascade

Throws:

java.lang.Exception

getMixCascades

public java.util.Hashtable getMixCascades()
                                   throws java.lang.Exception

Get a Vector of all mixcascades the infoservice knows. If we can't get a connection with the infoservice, an Exception is thrown.

Returns:

The Vector of all mixcascades.

Throws:

java.lang.Exception

getPaymentInstances

public java.util.Hashtable getPaymentInstances()
                                        throws java.lang.Exception

Get a Vector of all payment instances the infoservice knows. If we can't get a connection with the infoservice, an Exception is thrown.

Returns:

The Vector of all payment instances.

Throws:

java.lang.Exception

getPaymentInstance

public anon.pay.PaymentInstanceDBEntry getPaymentInstance(java.lang.String a_piID)
                                                   throws java.lang.Exception

Throws:

java.lang.Exception

getInfoServices

public java.util.Hashtable getInfoServices(boolean a_bJAPClientContext)
                                    throws java.lang.Exception

Throws:

java.lang.Exception

getMixCascades

public java.util.Hashtable getMixCascades(boolean a_bJAPClientContext)
                                   throws java.lang.Exception

Throws:

java.lang.Exception

getTCFramework

public TermsAndConditionsFramework getTCFramework(java.lang.String a_id)
                                           throws java.lang.Exception

Get the MixInfo for the mix with the given ID. If we can't get a connection with the infoservice, an Exception is thrown.

Parameters:

mixId - The ID of the mix to get the MixInfo for.

Returns:

The MixInfo for the mix with the given ID.

Throws:

java.lang.Exception

getPaymentInstances

public java.util.Hashtable getPaymentInstances(boolean a_bJAPClientContext)
                                        throws java.lang.Exception

Throws:

java.lang.Exception

getMixes

public java.util.Hashtable getMixes(boolean a_bJAPClientContext)
                             throws java.lang.Exception

Throws:

java.lang.Exception

getInfoServices

public java.util.Hashtable getInfoServices()
                                    throws java.lang.Exception

Get a Vector of all infoservices the infoservice knows. If we can't get a connection with the infoservice, an Exception is thrown.

Returns:

The Vector of all infoservices.

Throws:

java.lang.Exception

getMixCascadeSerials

public java.util.Hashtable getMixCascadeSerials()
                                         throws java.lang.Exception

Throws:

java.lang.Exception

getInfoServiceSerials

public java.util.Hashtable getInfoServiceSerials()
                                          throws java.lang.Exception

Throws:

java.lang.Exception

getMixInfo

public MixInfo getMixInfo(java.lang.String mixId)
                   throws java.lang.Exception

Get the MixInfo for the mix with the given ID. If we can't get a connection with the infoservice, an Exception is thrown.

Parameters:

mixId - The ID of the mix to get the MixInfo for.

Returns:

The MixInfo for the mix with the given ID.

Throws:

java.lang.Exception

getStatusInfo

public StatusInfo getStatusInfo(MixCascade a_cascade)
                         throws java.lang.Exception

Get the StatusInfo for the cascade with the given ID. If we can't get a connection with the infoservice, an Exception is thrown.

Parameters:

cascadeId - The ID of the mixcascade to get the StatusInfo for.

cascadeLength - The length of the mixcascade (number of mixes). We need this for calculating the AnonLevel in the StatusInfo.

Returns:

The current StatusInfo for the mixcascade with the given ID.

Throws:

java.lang.Exception

getExitAddresses

public java.lang.Object getExitAddresses()
                                  throws java.lang.Exception

Throws:

java.lang.Exception

getStatusInfo

public StatusInfo getStatusInfo(MixCascade a_cascade,
                                long a_timeout)
                         throws java.lang.Exception

Get the StatusInfo for the cascade with the given ID. If we can't get a connection with the infoservice, an Exception is thrown.

Parameters:

cascadeId - The ID of the mixcascade to get the StatusInfo for.

cascadeLength - The length of the mixcascade (number of mixes). We need this for calculating the AnonLevel in the StatusInfo.

Returns:

The current StatusInfo for the mixcascade with the given ID.

Throws:

java.lang.Exception

getNewVersionNumber

public JAPMinVersion getNewVersionNumber()
                                  throws java.lang.Exception

Get the version String of the currently minimum required JAP version from the infoservice. This method is called to check, whether connection to the mixcascades are possible with the currently used JAP version. If we can't get a connection with the infoservice, an Exception is thrown.

Returns:

The version String (fromat: nn.nn.nnn) of the current JAP version.

Throws:

java.lang.Exception

getMessages

public java.util.Hashtable getMessages()
                                throws java.lang.Exception

Throws:

java.lang.Exception

getMessageSerials

public java.util.Hashtable getMessageSerials()
                                      throws java.lang.Exception

Throws:

java.lang.Exception

getTermsAndConditions

public java.util.Hashtable getTermsAndConditions()
                                          throws java.lang.Exception

Throws:

java.lang.Exception

getTermsAndConditionSerials

public java.util.Hashtable getTermsAndConditionSerials()
                                                throws java.lang.Exception

Throws:

java.lang.Exception

getPerformanceInfo

public PerformanceInfo getPerformanceInfo()
                                   throws java.lang.Exception

Sends a /performanceinfo request to the Info Service, retrieves the data and creates a new PerformanceInfo object.

Returns:

a PerformanceInfo object

Throws:

java.lang.Exception - if the Signature can't be verified, the Info Service doesn't have the information available or can't be reached.

getLatestJava

public java.util.Hashtable getLatestJava()
                                  throws java.lang.Exception

Get the latest java versions the infoservice knows ordered by vendors.

Returns:

the latest java versions

Throws:

java.lang.Exception - If we can't get a connection to the infoservice

getLatestJavaSerials

public java.util.Hashtable getLatestJavaSerials()
                                         throws java.lang.Exception

Throws:

java.lang.Exception

getJAPVersionInfo

public JAPVersionInfo getJAPVersionInfo(int a_japVersionType)
                                 throws java.lang.Exception

Returns the JAPVersionInfo for the specified type. The JAPVersionInfo is generated from the JNLP files received from the infoservice. If we can't get a connection with the infoservice, an Exception is thrown.

Parameters:

a_japVersionType - Selects the JAPVersionInfo (release / development). See the constants in JAPVersionInfo.

Returns:

The JAPVersionInfo of the specified type.

Throws:

java.lang.Exception

getTorNodesList

public byte[] getTorNodesList()
                       throws java.lang.Exception

Get the list with the tor nodes from the infoservice. If we can't get a connection with the infoservice or the infoservice doesn't support the tor nodes list download, an Exception is thrown.

Returns:

The raw tor nodes list as it is distributed by the tor directory servers.

Throws:

java.lang.Exception

getMixminionNodesList

public byte[] getMixminionNodesList()
                             throws java.lang.Exception

Get the list with the mixminion nodes from the infoservice. If we can't get a connection with the infoservice or the infoservice doesn't support the tor nodes list download, an Exception is thrown.

Returns:

The raw mixminion nodes list as it is distributed by the tor directory servers.

Throws:

java.lang.Exception

postNewForwarder

public org.w3c.dom.Element postNewForwarder(org.w3c.dom.Element a_japForwarderNode)
                                     throws java.lang.Exception

Posts a new forwarder to an infoservice with a JAP forwarder list. If we can't reach the infoservice or if it has not a forwarder list, an Exception is thrown.

Parameters:

a_japForwarderNode - The JapForwarder node of the "post forwarder to infoservice" XML structure.

Returns:

The JapForwarder node of the answer of the infoservice's addforwarder command.

Throws:

java.lang.Exception

postRenewForwarder

public org.w3c.dom.Element postRenewForwarder(org.w3c.dom.Element a_japForwarderNode)
                                       throws java.lang.Exception

Posts the renew message for a forwarder to an infoservice with a JAP forwarder list. If we can't reach the infoservice or if it has not a forwarder list, an Exception is thrown.

Parameters:

a_japForwarderNode - The JapForwarder node of the "renew forwarder" XML structure.

Returns:

The JapForwarder node of the answer of the infoservice's renewforwarder command.

Throws:

java.lang.Exception

getForwarder

public org.w3c.dom.Element getForwarder()
                                 throws java.lang.Exception

Downloads a forwarder entry from the infoservice. If this infoservice has no forwarder list, it will ask an infoservice with such a list and returns the answer to us. If we can't reach the infoservice or if this infoservice doesn't know a forwarder, an Exception is thrown.

Returns:

The JapForwarder node of the answer of the infoservice's getforwarder command.

Throws:

java.lang.Exception