anon.transport.address

Class Endpoint

java.lang.Object

anon.transport.address.Endpoint

public class Endpoint
extends java.lang.Object

An Endpoint is the interface between an IAddress and its URN representation.

It provides the mechanisms to parse a URN and allow structured access to it, and to transform an IAddress back into a URN.

See Also:

Endpoint

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Hashtable	m_parameters A map of the parameters, extracted from the URN.
protected java.lang.String	m_transportIdentifier The transport identifier as extracted from the URN.

Constructor Summary

Constructors

Constructor and Description
Endpoint(java.lang.String a_theURN) Tries to create a new instance of Endpoint, by extracting the transport identifier and parameters from the URN.

Method Summary

Modifier and Type	Method and Description
AddressParameter[]	getAllParameters() Returns an array of all AddressParameter objects associated with this Endpoint.
java.lang.String	getParameter(java.lang.String a_name) Returns the parameter with the given name.
java.lang.String	getTransportIdentifier() Returns the transport identifier of the URN.
static java.lang.String	toURN(IAddress a_address) Transforms a given IAddress into its URN representation.

Methods inherited from class java.lang.Object

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

Field Detail

m_transportIdentifier

protected java.lang.String m_transportIdentifier

The transport identifier as extracted from the URN.

m_parameters

protected java.util.Hashtable m_parameters

A map of the parameters, extracted from the URN. In the form of String:AddressParameter.

Constructor Detail

Endpoint

public Endpoint(java.lang.String a_theURN)
         throws MalformedURNException

Tries to create a new instance of Endpoint, by extracting the transport identifier and parameters from the URN.

Parameters:

a_theURN - The URN to create the Endpoint object from.

Throws:

MalformedURNException - If the URN is not in the expected format.

Method Detail

getTransportIdentifier

public java.lang.String getTransportIdentifier()

Returns the transport identifier of the URN.

toURN

public static java.lang.String toURN(IAddress a_address)

Transforms a given IAddress into its URN representation. The transformation follows the following rules:

   EndpointURN ::= "urn:endpoint:"  Identifier ParameterGroup
   Identifier == TransportIdentifier
   ParameterGroup = Parameter | Parameter ParamterGroup
   Parameter = ":"  ParamterName "(" ParamterValue  ")"
 

Identifier describes the transport identifier of the IAddress. ParameterName and ParameterValue describe the name and value of a parameter of the IAddress, all of which are inserted into the resulting URN.

Parameters:

a_address - The address to be transformed into a URN.

getParameter

public java.lang.String getParameter(java.lang.String a_name)

Returns the parameter with the given name.

Parameters:

a_name - The name of the parameter.

Returns:

The value for the given name if it exists or null.

getAllParameters

public AddressParameter[] getAllParameters()

Returns an array of all AddressParameter objects associated with this Endpoint.

Returns:

An array of Key-Value pairs.