sun.security.util

Class ObjectIdentifier

java.lang.Object

sun.security.util.ObjectIdentifier

All Implemented Interfaces:

java.io.Serializable

public final class ObjectIdentifier
extends java.lang.Object
implements java.io.Serializable

Represent an ISO Object Identifier.

Object Identifiers are arbitrary length hierarchical identifiers. The individual components are numbers, and they define paths from the root of an ISO-managed identifier space. You will sometimes see a string name used instead of (or in addition to) the numerical id. These are synonyms for the numerical IDs, but are not widely used since most sites do not know all the requisite strings, while all sites can parse the numeric forms.

So for example, JavaSoft has the sole authority to assign the meaning to identifiers below the 1.3.6.1.4.1.42.2.17 node in the hierarchy, and other organizations can easily acquire the ability to assign such unique identifiers.

Author:

David Brownell, Amit Kapoor, Hemma Prafullchandra

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ObjectIdentifier(DerInputStream in) Constructs an object ID from an ASN.1 encoded input stream.
ObjectIdentifier(int[] values) Constructs an object ID from an array of integers.
ObjectIdentifier(java.lang.String oid) Constructs an object identifier from a string.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Compares this identifier with another, for equality.
boolean	equals(ObjectIdentifier other) Deprecated. Use equals((Object)oid)
int	hashCode()
static ObjectIdentifier	newInternal(int[] values) Create a new ObjectIdentifier for internal use.
boolean	precedes(ObjectIdentifier other) Compares this identifier with another, for sorting purposes.
java.lang.String	toString() Returns a string form of the object ID.

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectIdentifier

public ObjectIdentifier(java.lang.String oid)
                 throws java.io.IOException

Constructs an object identifier from a string. This string should be of the form 1.23.34.45.56 etc.

Throws:

java.io.IOException

ObjectIdentifier

public ObjectIdentifier(int[] values)
                 throws java.io.IOException

Constructs an object ID from an array of integers. This is used to construct constant object IDs.

Throws:

java.io.IOException

ObjectIdentifier

public ObjectIdentifier(DerInputStream in)
                 throws java.io.IOException

Constructs an object ID from an ASN.1 encoded input stream. The encoding of the ID in the stream uses "DER", a BER/1 subset. In this case, that means a triple { typeId, length, data }.

NOTE: When an exception is thrown, the input stream has not been returned to its "initial" state.

Parameters:

in - DER-encoded data holding an object ID

Throws:

java.io.IOException - indicates a decoding error

Method Detail

newInternal

public static ObjectIdentifier newInternal(int[] values)

Create a new ObjectIdentifier for internal use. The values are neither checked nor cloned.

precedes

public boolean precedes(ObjectIdentifier other)

Compares this identifier with another, for sorting purposes. An identifier does not precede itself.

Parameters:

other - identifer that may precede this one.

Returns:

true iff other precedes this one in a particular sorting order.

equals

@Deprecated
public boolean equals(ObjectIdentifier other)

Deprecated. Use equals((Object)oid)

equals

public boolean equals(java.lang.Object obj)

Compares this identifier with another, for equality.

Overrides:

equals in class java.lang.Object

Returns:

true iff the names are identical.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Returns a string form of the object ID. The format is the conventional "dot" notation for such IDs, without any user-friendly descriptive strings, since those strings will not be understood everywhere.

Overrides:

toString in class java.lang.Object