com.objsys.asn1j.runtime

Class Asn1StringOID

java.lang.Object

com.objsys.asn1j.runtime.Asn1Type

com.objsys.asn1j.runtime.Asn1StringOID

All Implemented Interfaces:

Asn1TypeIF, java.io.Serializable, java.lang.Cloneable

Direct Known Subclasses:

Asn1StringRelativeOID

public class Asn1StringOID
extends Asn1Type

This represents an ASN.1 object identifier value.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAXSUBIDS The MAXSUBIDS constant specifies the maximum number of subidentifiers that can appear in an OID value (128).
static Asn1Tag	TAG The TAG constant describes the universal tag for this data type (UNIVERSAL 6).
java.lang.String	value The OID as a dotted number string (e.g. "0.5.34.77").

Fields inherited from class com.objsys.asn1j.runtime.Asn1Type

BIT_STRING, BMPString, BOOLEAN, DATE, DATE_TIME, DURATION, ENUMERATED, EOC, EXTERNAL, GeneralString, GeneralTime, GraphicString, IA5String, INTEGER, mNonParameterizedTypeName, NULL, NumericString, OBJECT_IDENTIFIER, ObjectDescriptor, OCTET_STRING, OID_IRI, OpenType, PrintableString, REAL, RELATIVE_OID_IRI, RelativeOID, SEQUENCE, SET, T61String, TeletexString, TIME, TIME_OF_DAY, UniversalString, UTCTime, UTF8String, VideotexString, VisibleString

Constructor Summary

Constructors

Constructor and Description
Asn1StringOID() This constructor creates an empty object identifier that can be used in a decode method call to receive an OID value.
Asn1StringOID(java.math.BigInteger[] value) This constructor initializes the object identifier from the given array of subidentifier values.
Asn1StringOID(int[] value_) This constructor initializes the object identifier from the given array of integer subidentifier values.
Asn1StringOID(java.lang.String value) Create an Asn1StringOID having the given OID value.

Method Summary

Modifier and Type	Method and Description
void	decode(Asn1BerDecodeBuffer buffer, boolean explicit, int implicitLength) This method decodes an ASN.1 object identifier value including the UNIVERSAL tag value and length if explicit tagging is specified.
void	decode(Asn1JsonDecodeBuffer buffer) Decode ASN.1 OBJECT-IDENTIFIER from JSON.
void	decode(Asn1OerDecodeBuffer buffer) Decode an ASN.1 OBJECT IDENTIFIER that was encoded according to the Octet Encoding Rules (OER).
void	decode(Asn1PerDecodeBuffer buffer) This method decodes an ASN.1 object identifier value using the packed encoding rules (PER).
void	decodeXER(java.lang.String buffer, java.lang.String attrs) This method decodes an ASN.1 object identifier value using the XML encoding rules (XER).
void	decodeXML(java.lang.String buffer, java.lang.String attrs) This method decodes an ASN.1 object identifier value using the XML schema encoding rules.
int	encode(Asn1BerEncodeBuffer buffer, boolean explicit) This method encodes an ASN.1 object identifier value including the UNIVERSAL tag value and length if explicit tagging is specified.
void	encode(Asn1BerOutputStream out, boolean explicit) This method encodes and writes to the stream an ASN.1 object identifier value including the UNIVERSAL tag value and length if explicit tagging is specified.
void	encode(Asn1JsonOutputStream outstream) Encode this object identifier to JSON.
void	encode(Asn1OerEncodeBuffer buffer) This method encodes an ASN.1 OBJECT IDENTIFIER according to Octet Encoding Rules (OER).
void	encode(Asn1PerEncodeBuffer buffer) This method encodes an ASN.1 object identifier value using the packed encoding rules (PER).
void	encode(Asn1XerEncoder buffer, java.lang.String elemName) This method encodes an ASN.1 object identifier value using the XML encoding rules (XER).
void	encode(Asn1XmlEncoder buffer, java.lang.String elemName, java.lang.String nsPrefix) This method encodes an ASN.1 object identifier value using the XML Encoding as specified in the XML schema standard(asn2xsd).
static void	encodeIdentifier(Asn1Writable os, java.math.BigInteger ident) This method writes the BER contents octets for a single identifier, such as those use in tags and object identifiers, to the given writable.
boolean	equals(java.lang.Object oid_) This method compares this object identifier to the given one for equality.
boolean	equals(java.lang.String oid_) This method compares this object identifier to the given dotted number string.
java.lang.String	getAsn1TypeName() Returns the ASN.1 type name.
protected java.math.BigInteger[]	getComponents() Update components, if necessary for it to match value, and return it.
int	hashCode() This method returns the hash code for the Asn1ObjectIdentifier.
protected void	setComponents(java.math.BigInteger[] components) Set value from given components and set the components field.
java.lang.String	toString() This method will return a string representation of the OID value.
java.lang.String	toXMLValue() Return the XML value representation (defined in X.680) for this object identifier.
protected void	validate() Do some minimal validation.

Methods inherited from class com.objsys.asn1j.runtime.Asn1Type

_setKey, _setLicLocation, clone, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, encode, encode, encode, encode, encode, encode, encodeAsOpenType, equals, getLength, getNonParameterizedTypeName, getTypeName, indent, indent, isOpenType, matchTag, matchTag, pdiag, print, print, print, setNonParameterizedTypeName, setOpenType

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final Asn1Tag TAG

The TAG constant describes the universal tag for this data type (UNIVERSAL 6).

MAXSUBIDS

public static final int MAXSUBIDS

The MAXSUBIDS constant specifies the maximum number of subidentifiers that can appear in an OID value (128).

See Also:

Constant Field Values

value

public java.lang.String value

The OID as a dotted number string (e.g. "0.5.34.77").

Constructor Detail

Asn1StringOID

public Asn1StringOID()

This constructor creates an empty object identifier that can be used in a decode method call to receive an OID value.

Asn1StringOID

public Asn1StringOID(java.lang.String value)

Create an Asn1StringOID having the given OID value.

Parameters:

value - Must be a dotted number string.

Asn1StringOID

public Asn1StringOID(int[] value_)

This constructor initializes the object identifier from the given array of integer subidentifier values.

Parameters:

value_ - Array of subidentifiers

Asn1StringOID

public Asn1StringOID(java.math.BigInteger[] value)

This constructor initializes the object identifier from the given array of subidentifier values.

Parameters:

value -

Method Detail

getAsn1TypeName

public java.lang.String getAsn1TypeName()

Returns the ASN.1 type name.

Overrides:

getAsn1TypeName in class Asn1Type

Returns:

The ASN.1 type name OBJECT IDENTIFIER.

decode

public void decode(Asn1BerDecodeBuffer buffer,
                   boolean explicit,
                   int implicitLength)
            throws Asn1Exception,
                   java.io.IOException

This method decodes an ASN.1 object identifier value including the UNIVERSAL tag value and length if explicit tagging is specified.

Specified by:

decode in interface Asn1TypeIF

Overrides:

decode in class Asn1Type

Parameters:

buffer - Decode message buffer object

explicit - Flag indicating element is explicitly tagged

implicitLength - Length of contents if implicit

Throws:

Asn1Exception

java.io.IOException

encode

public int encode(Asn1BerEncodeBuffer buffer,
                  boolean explicit)
           throws Asn1Exception

This method encodes an ASN.1 object identifier value including the UNIVERSAL tag value and length if explicit tagging is specified.

Specified by:

encode in interface Asn1TypeIF

Overrides:

encode in class Asn1Type

Parameters:

buffer - Encode message buffer object

explicit - Flag indicating explicit tagging should be done

Returns:

Length of encoded component in octets

Throws:

Asn1Exception

decode

public void decode(Asn1PerDecodeBuffer buffer)
            throws Asn1Exception,
                   java.io.IOException

This method decodes an ASN.1 object identifier value using the packed encoding rules (PER).

Specified by:

decode in interface Asn1TypeIF

Overrides:

decode in class Asn1Type

Parameters:

buffer - Decode message buffer object

Throws:

Asn1Exception

java.io.IOException

encode

public void encode(Asn1PerEncodeBuffer buffer)
            throws Asn1Exception,
                   java.io.IOException

This method encodes an ASN.1 object identifier value using the packed encoding rules (PER). The value to be encoded is stored in the value public member variable within this class.

Specified by:

encode in interface Asn1TypeIF

Overrides:

encode in class Asn1Type

Parameters:

buffer - Encode message buffer object

Throws:

Asn1Exception

java.io.IOException

decode

public void decode(Asn1OerDecodeBuffer buffer)
            throws java.io.IOException

Decode an ASN.1 OBJECT IDENTIFIER that was encoded according to the Octet Encoding Rules (OER).

Overrides:

decode in class Asn1Type

Parameters:

buffer -

Throws:

java.io.IOException

encode

public void encode(Asn1OerEncodeBuffer buffer)
            throws java.io.IOException

This method encodes an ASN.1 OBJECT IDENTIFIER according to Octet Encoding Rules (OER).

Overrides:

encode in class Asn1Type

Parameters:

buffer - Encode message buffer object

Throws:

java.io.IOException

encode

public void encode(Asn1XerEncoder buffer,
                   java.lang.String elemName)
            throws java.io.IOException,
                   Asn1Exception

This method encodes an ASN.1 object identifier value using the XML encoding rules (XER).

Specified by:

encode in interface Asn1TypeIF

Overrides:

encode in class Asn1Type

Parameters:

buffer - Encode message buffer object

elemName - Element name

Throws:

java.io.IOException - Any exception thrown by the underlying stream.

Asn1Exception - Thrown, if operation is failed.

decodeXER

public void decodeXER(java.lang.String buffer,
                      java.lang.String attrs)
               throws Asn1Exception

This method decodes an ASN.1 object identifier value using the XML encoding rules (XER).

Parameters:

buffer - String containing data to be decoded

attrs - Attributes string from element tag

Throws:

Asn1Exception

encode

public void encode(Asn1XmlEncoder buffer,
                   java.lang.String elemName,
                   java.lang.String nsPrefix)
            throws java.io.IOException,
                   Asn1Exception

This method encodes an ASN.1 object identifier value using the XML Encoding as specified in the XML schema standard(asn2xsd).

Overrides:

encode in class Asn1Type

Parameters:

buffer - Encode message buffer object

elemName - Element name

nsPrefix - XML element name space prefix

Throws:

java.io.IOException - Any exception thrown by the underlying stream.

Asn1Exception - Thrown, if operation is failed.

decodeXML

public void decodeXML(java.lang.String buffer,
                      java.lang.String attrs)
               throws Asn1Exception

This method decodes an ASN.1 object identifier value using the XML schema encoding rules.

Specified by:

decodeXML in interface Asn1TypeIF

Overrides:

decodeXML in class Asn1Type

Parameters:

buffer - String containing data to be decoded

attrs - Attributes string from element tag

Throws:

Asn1Exception

decode

public void decode(Asn1JsonDecodeBuffer buffer)
            throws java.io.IOException

Decode ASN.1 OBJECT-IDENTIFIER from JSON.

Overrides:

decode in class Asn1Type

Parameters:

buffer -

Throws:

java.io.IOException

encode

public void encode(Asn1JsonOutputStream outstream)
            throws java.io.IOException

Encode this object identifier to JSON.

Overrides:

encode in class Asn1Type

Parameters:

outstream - JSON output stream

Throws:

java.io.IOException

equals

public boolean equals(java.lang.Object oid_)

This method compares this object identifier to the given one for equality.

Overrides:

equals in class java.lang.Object

Parameters:

oid_ - Object identifier value

equals

public boolean equals(java.lang.String oid_)

This method compares this object identifier to the given dotted number string. Note: this functionality is not implemented in equals(Object) because equals is supposed to be symmetric.

Parameters:

oid_ - Object identifier value

hashCode

public int hashCode()

This method returns the hash code for the Asn1ObjectIdentifier.

Overrides:

hashCode in class Asn1Type

validate

protected void validate()

Do some minimal validation. Subclasses may override this to adjust for their validation rules (e.g. Asn1RelativeOID overrides this to be more lax). Minimally, the implementation should enforce that value is not null and that there is at least one arc.

toXMLValue

public java.lang.String toXMLValue()

Return the XML value representation (defined in X.680) for this object identifier.

Throws:

Asn1InvalidObjectIDException - if this object does not represent a valid object identifier (only some basic validation is done).

toString

public java.lang.String toString()

This method will return a string representation of the OID value. The format is the ASN.1 value format for this type. Note that textual subidentifiers are not used, only numeric values..

Overrides:

toString in class java.lang.Object

Returns:

Stringified representation of the value

encodeIdentifier

public static void encodeIdentifier(Asn1Writable os,
                                    java.math.BigInteger ident)
                             throws java.io.IOException

This method writes the BER contents octets for a single identifier, such as those use in tags and object identifiers, to the given writable.

Parameters:

os - The writable to write to.

ident - The identifier to be encoded.

Throws:

java.io.IOException - Any exception thrown by the underlying OutputStream.

encode

public void encode(Asn1BerOutputStream out,
                   boolean explicit)
            throws Asn1Exception,
                   java.io.IOException

This method encodes and writes to the stream an ASN.1 object identifier value including the UNIVERSAL tag value and length if explicit tagging is specified. This overloaded version uses the Basic Encoding Rules (BER).

Specified by:

encode in interface Asn1TypeIF

Overrides:

encode in class Asn1Type

Parameters:

out - BER Output Stream object

explicit - Flag indicating explicit tagging should be done

Throws:

java.io.IOException - Any exception thrown by the underlying OutputStream.

Asn1Exception - Thrown, if operation is failed.

getComponents

protected java.math.BigInteger[] getComponents()

Update components, if necessary for it to match value, and return it.

Returns:

setComponents

protected void setComponents(java.math.BigInteger[] components)

Set value from given components and set the components field. The passed array is not copied and should not be modified after being passed to this function.

Parameters:

components -