com.unboundid.util
Class OID

java.lang.Object
  extended by com.unboundid.util.OID
All Implemented Interfaces:
java.io.Serializable, java.lang.Comparable<OID>

@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class OID
extends java.lang.Object
implements java.io.Serializable, java.lang.Comparable<OID>

This class provides a data structure that may be used for representing object identifiers. Since some directory servers support using strings that aren't valid object identifiers where OIDs are required, this implementation supports arbitrary strings, but some methods may only be available for valid OIDs.

See Also:
Serialized Form

Constructor Summary
OID(int... components)
          Creates a new OID object from the provided set of numeric components.
OID(java.util.List<java.lang.Integer> components)
          Creates a new OID object from the provided set of numeric components.
OID(java.lang.String oidString)
          Creates a new OID object from the provided string representation.
 
Method Summary
 int compareTo(OID oid)
          Indicates the position of the provided object relative to this OID in a sorted list.
 boolean equals(java.lang.Object o)
          Indicates whether the provided object is equal to this OID.
 java.util.List<java.lang.Integer> getComponents()
          Retrieves the numeric components that comprise this OID.
 int hashCode()
          Retrieves a hash code for this OID.
 boolean isValidNumericOID()
          Indicates whether this object represents a valid numeric OID.
static java.util.List<java.lang.Integer> parseComponents(java.lang.String oidString)
          Parses the provided string as a numeric OID and extracts the numeric components from it.
 java.lang.String toString()
          Retrieves a string representation of this OID.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

OID

public OID(java.lang.String oidString)
Creates a new OID object from the provided string representation.

Parameters:
oidString - The string to use to create this OID.

OID

public OID(int... components)
Creates a new OID object from the provided set of numeric components. At least one component must be provided for a valid OID.

Parameters:
components - The numeric components to include in the OID.

OID

public OID(java.util.List<java.lang.Integer> components)
Creates a new OID object from the provided set of numeric components. At least one component must be provided for a valid OID.

Parameters:
components - The numeric components to include in the OID.
Method Detail

parseComponents

public static java.util.List<java.lang.Integer> parseComponents(java.lang.String oidString)
Parses the provided string as a numeric OID and extracts the numeric components from it.

Parameters:
oidString - The string to parse as a numeric OID.
Returns:
The numeric components extracted from the provided string, or null if the provided string does not represent a valid numeric OID.

isValidNumericOID

public boolean isValidNumericOID()
Indicates whether this object represents a valid numeric OID.

Returns:
true if this object represents a valid numeric OID, or false if not.

getComponents

public java.util.List<java.lang.Integer> getComponents()
Retrieves the numeric components that comprise this OID. This will only return a non-null value if isValidNumericOID() returns true.

Returns:
The numeric components that comprise this OID, or null if this object does not represent a valid numeric OID.

hashCode

public int hashCode()
Retrieves a hash code for this OID.

Overrides:
hashCode in class java.lang.Object
Returns:
A hash code for this OID.

equals

public boolean equals(java.lang.Object o)
Indicates whether the provided object is equal to this OID.

Overrides:
equals in class java.lang.Object
Parameters:
o - The object for which to make the determination.
Returns:
true if the provided object is equal to this OID, or false if not.

compareTo

public int compareTo(OID oid)
Indicates the position of the provided object relative to this OID in a sorted list.

Specified by:
compareTo in interface java.lang.Comparable<OID>
Parameters:
oid - The OID to compare against this OID.
Returns:
A negative value if this OID should come before the provided OID in a sorted list, a positive value if this OID should come after the provided OID in a sorted list, or zero if the two OIDs represent equivalent values.

toString

public java.lang.String toString()
Retrieves a string representation of this OID.

Overrides:
toString in class java.lang.Object
Returns:
A string representation of this OID.