org.eclipse.ecf.core.identity

Class StringID

java.lang.Object

org.eclipse.ecf.core.identity.BaseID

org.eclipse.ecf.core.identity.StringID

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable, java.security.Principal, ID

Direct Known Subclasses:

GUID

public class StringID
extends BaseID

A string-based identity

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StringID.StringIDNamespace

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	value

Fields inherited from class org.eclipse.ecf.core.identity.BaseID

namespace

Constructor Summary

Constructors

Modifier	Constructor and Description
	StringID()
protected	StringID(Namespace n, java.lang.String s) Protected constructor for factory-based construction

Method Summary

Modifier and Type	Method and Description
int	compareTo(java.lang.Object o)
boolean	equals(java.lang.Object o)
java.lang.String	getName() Get the unique name of this identity.
Namespace	getNamespace() Get the Namespace instance associated with this identity
int	hashCode()
protected int	namespaceCompareTo(BaseID obj) Called by Namespace.getCompareToForObject(BaseID, BaseID).
protected boolean	namespaceEquals(BaseID obj) Called by Namespace.testIDEquals(BaseID, BaseID).
protected java.lang.String	namespaceGetName() Called by Namespace.getNameForID(BaseID).
protected int	namespaceHashCode() Called by Namespace.getHashCodeForID(BaseID).
protected void	setEmptyNamespace()
java.lang.String	toExternalForm() Get this ID instance in String form.
java.lang.String	toString()

Methods inherited from class org.eclipse.ecf.core.identity.BaseID

getAdapter, namespaceToExternalForm

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.security.Principal

implies

Field Detail

value

protected java.lang.String value

Constructor Detail

StringID

public StringID()

Since:

3.9

StringID

protected StringID(Namespace n,
                   java.lang.String s)

Protected constructor for factory-based construction

Parameters:

n - the Namespace this identity will belong to

s - the String defining this StringID

Method Detail

compareTo

public int compareTo(java.lang.Object o)

Specified by:

compareTo in interface java.lang.Comparable

Overrides:

compareTo in class BaseID

equals

public boolean equals(java.lang.Object o)

Specified by:

equals in interface java.security.Principal

Specified by:

equals in interface ID

Overrides:

equals in class BaseID

getName

public java.lang.String getName()

Description copied from interface: ID

Get the unique name of this identity.

Specified by:

getName in interface java.security.Principal

Specified by:

getName in interface ID

Overrides:

getName in class BaseID

Returns:

String unique name for this identity. Will not be null, and must be a unique String within the Namespace returned by getNamespace()

hashCode

public int hashCode()

Specified by:

hashCode in interface java.security.Principal

Specified by:

hashCode in interface ID

Overrides:

hashCode in class BaseID

getNamespace

public Namespace getNamespace()

Description copied from interface: ID

Get the Namespace instance associated with this identity

Specified by:

getNamespace in interface ID

Overrides:

getNamespace in class BaseID

Returns:

Namespace the Namespace corresponding to this identity. Will not return null.

toExternalForm

public java.lang.String toExternalForm()

Description copied from interface: ID

Get this ID instance in String form. Will not return null.

Specified by:

toExternalForm in interface ID

Overrides:

toExternalForm in class BaseID

Returns:

String that is external representation of this ID

toString

public java.lang.String toString()

Specified by:

toString in interface java.security.Principal

Overrides:

toString in class java.lang.Object

namespaceCompareTo

protected int namespaceCompareTo(BaseID obj)

Description copied from class: BaseID

Called by Namespace.getCompareToForObject(BaseID, BaseID).

Specified by:

namespaceCompareTo in class BaseID

Parameters:

obj - the other ID to compare to. Will not be null.

Returns:

the appropriate value as per Comparable contract.

namespaceEquals

protected boolean namespaceEquals(BaseID obj)

Description copied from class: BaseID

Called by Namespace.testIDEquals(BaseID, BaseID).

Specified by:

namespaceEquals in class BaseID

Parameters:

obj - the other ID to test against. May be null.

Returns:

true if this ID is equal to the given ID. false otherwise.

namespaceGetName

protected java.lang.String namespaceGetName()

Description copied from class: BaseID

Called by Namespace.getNameForID(BaseID).

Specified by:

namespaceGetName in class BaseID

Returns:

String name for this ID. Must not be null. Value returned should be unique within this Namespace.

namespaceHashCode

protected int namespaceHashCode()

Description copied from class: BaseID

Called by Namespace.getHashCodeForID(BaseID).

Specified by:

namespaceHashCode in class BaseID

Returns:

int hashCode for this ID. Returned value must be unique within this process.

setEmptyNamespace

protected void setEmptyNamespace()