com.objsys.asn1j.runtime

Class Asn1Enumerated

java.lang.Object

com.objsys.asn1j.runtime.Asn1Type

com.objsys.asn1j.runtime.Asn1Enumerated

All Implemented Interfaces:

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

public abstract class Asn1Enumerated
extends Asn1Type

This class represents the ASN.1 ENUMERATED built-in type. It is declared to be an abstract class and therefore cannot be used on its own. It must be extended by a specific enumerated type class.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Asn1Tag	TAG The TAG constant describes the universal tag for this data type (UNIVERSAL 10).
static int	UNDEFINED The UNDEFINED constant is stored in the value member variable when the value of this enumerated type is undetermined.
protected int	value This public member variable is where the enumerated value is stored.

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
Asn1Enumerated() The default constructor sets the enumerated value to undefined.
Asn1Enumerated(int value_) This constructor creates an enumerated object from a integer value.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Returns a "clone" of this object.
int	encode(Asn1BerEncodeBuffer buffer, boolean explicit) This method encodes an ASN.1 enumerated 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 enumerated value including the UNIVERSAL tag value and length if explicit tagging is specified.
void	encode(Asn1JsonOutputStream outstream) Encode the enumerated value to JSON.
void	encode(Asn1OerEncodeBuffer buffer) Encode enumerated value according to OER.
void	encode(Asn1PerEncodeBuffer buffer, long lower, long upper) This method encodes an ASN.1 enumerated value using the Packed Encoding Rules (PER).
void	encode(Asn1PerOutputStream out, long lower, long upper) This method encodes an ASN.1 enumerated value using the Packed Encoding Rules (PER).
void	encode(Asn1XerEncodeBuffer buffer) This method encodes an ASN.1 enumerated value using the XML encoding rules (XER).
void	encode(Asn1XerEncoder buffer, java.lang.String elemName) This method encodes an ASN.1 enumerated 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 enumerated value using the Obj-Sys XML Encoding rules.
void	encode(Asn1XmlEncoder buffer, java.lang.String elemName, java.lang.String nsPrefix, boolean asText) This method encodes an ASN.1 enumerated value.
boolean	equals(int ivalue) This method compares this enumerated value to the given value for equality.
boolean	equals(java.lang.Object o) This method compares this enumerated value to the given value for equality.
java.lang.String	getAsn1TypeName() Returns the ASN.1 type name.
int	getValue() This method returns the underlying integer value that is associated with this enumerated object.
int	hashCode() This method returns the hash code for the enumerated value.
static int	parseValue(java.lang.String value) This method will parse the given enumeration text and return the associated integer value.

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

_setKey, _setLicLocation, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decode, decodeXML, encode, 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, toString, wait, wait, wait

Field Detail

TAG

public static final Asn1Tag TAG

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

UNDEFINED

public static final int UNDEFINED

The UNDEFINED constant is stored in the value member variable when the value of this enumerated type is undetermined.

See Also:

Constant Field Values

value

protected transient int value

This public member variable is where the enumerated value is stored. This is the value that is encoded when one of the encode methods is called. It is also where the decoded result is stored when a decode method is called.

Constructor Detail

Asn1Enumerated

public Asn1Enumerated()

The default constructor sets the enumerated value to undefined.

Asn1Enumerated

public Asn1Enumerated(int value_)

This constructor creates an enumerated object from a integer value.

Parameters:

value_ - Integer 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 ENUMERATED.

getValue

public final int getValue()

This method returns the underlying integer value that is associated with this enumerated object. The integer value is protected to enforce consistency with the static singletons in generated enumerated types.

encode

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

This method encodes an ASN.1 enumerated 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:

buffer - Encode message buffer object

explicit - Flag indicating explicit tagging should be done

Returns:

Length of component or negative status value

Throws:

Asn1Exception

encode

public void encode(Asn1PerEncodeBuffer buffer,
                   long lower,
                   long upper)
            throws Asn1Exception

This method encodes an ASN.1 enumerated value using the Packed Encoding Rules (PER).

Parameters:

buffer - PER Encode message buffer object

lower - Smallest enumerated value in the set

upper - Largest enumerated value in the set

Throws:

Asn1Exception

encode

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

Encode enumerated value according to OER.

Overrides:

encode in class Asn1Type

Parameters:

buffer -

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 enumerated 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.

encode

public void encode(Asn1XerEncodeBuffer buffer)
            throws Asn1Exception

This method encodes an ASN.1 enumerated value using the XML encoding rules (XER). This method does not add start and end tags (<tag> and </tag>), only value is encoded (<val1/> or <val2/>).

Parameters:

buffer - Encode message buffer object

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 enumerated value using the Obj-Sys XML Encoding rules. It encodes the value as XML text.

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.

encode

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

This method encodes an ASN.1 enumerated value. It is for use with extended-XER.

Parameters:

buffer - Encode message buffer object

elemName - Element name

nsPrefix - XML element name space prefix

asText - If true, encode the value as XML text, otherwise encode as an empty element.

Throws:

java.io.IOException

Asn1Exception

encode

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

Encode the enumerated value to JSON.

Overrides:

encode in class Asn1Type

Parameters:

outstream -

Throws:

java.io.IOException

equals

public boolean equals(int ivalue)

This method compares this enumerated value to the given value for equality.

Parameters:

ivalue - Enumerated test value

equals

public boolean equals(java.lang.Object o)

This method compares this enumerated value to the given value for equality.

Overrides:

equals in class java.lang.Object

Parameters:

o - Asn1Enumerated object to compare to this object

hashCode

public int hashCode()

This method returns the hash code for the enumerated value.

Overrides:

hashCode in class Asn1Type

parseValue

public static int parseValue(java.lang.String value)
                      throws Asn1Exception

This method will parse the given enumeration text and return the associated integer value. This method simply returns -1; it must be overridden by a subclass to be useful. An appropriate override is generated only when generating code for XER or XML encodings.

Returns:

The integer corresponding to the given enumeration text. This can be used with the generated valueOf method to obtain the corresponding instance of the subclass.

Throws:

Asn1Exception

encode

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

This method encodes and writes to the stream an ASN.1 enumerated 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.

encode

public void encode(Asn1PerOutputStream out,
                   long lower,
                   long upper)
            throws Asn1Exception,
                   java.io.IOException

This method encodes an ASN.1 enumerated value using the Packed Encoding Rules (PER).

Parameters:

out - PER Output Stream object

lower - Smallest enumerated value in the set

upper - Largest enumerated value in the set

Throws:

java.io.IOException - Any exception thrown by the Asn1PerOutputStream.

Asn1Exception - Thrown, if operation is failed.

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Returns a "clone" of this object. Because enumerated types are immutable, this implementation returns this object.

Overrides:

clone in class Asn1Type

Returns:

a clone of this instance.

Throws:

java.lang.CloneNotSupportedException - if the object's class does not support the Cloneable interface. Subclasses that override the clone method can also throw this exception to indicate that an instance cannot be cloned.

See Also:

Cloneable