iaik.asn1

Class UNKNOWN

java.lang.Object

iaik.asn1.ASN1Object

iaik.asn1.ConstructedType

iaik.asn1.UNKNOWN

All Implemented Interfaces:

java.lang.Cloneable

public class UNKNOWN
extends ConstructedType

This class is used to decode unknown PRIVATE or APPLICATION ASN.1 types.

This class only supports decoding facilities for properly handling any DER encoded ASN.1 objects with an unknown tag specification.

Whenever the DerCoder parses a tag it does not know of, it creates a UNKNOWN object and supplies it with the content octets read from the decoding. In this way, an application may ask for the pure content bytes by means of the getValue() method.

Version:

File Revision 22

Field Summary

Fields inherited from class iaik.asn1.ConstructedType

content_count, content_data

Fields inherited from class iaik.asn1.ASN1Object

asnType, constructed, encode_listener, indefinite_length, isStringType, stream_mode

Constructor Summary

Constructors

Constructor and Description
UNKNOWN() Creates an empty UNKNOWN ASN.1 type.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Returns a clone of this UNKNOWN.
protected void	decode(int length, java.io.InputStream is) Decodes the value of an UMKNOWN ASN.1 object from the given input stream.
protected void	encode(java.io.OutputStream os) Tries to encode this UNKOWN ASN.1 object.
ASN	getBaseAsnType() Returns the base ASN.1 type of this UNKNOWN ASN.1 object.
java.lang.Object	getValue() Returns the value of this UNKNOWN ASN.1 object as a byte array.
void	setValue(java.lang.Object object) Sets the value of this object to value.
java.lang.String	toString() Returns a string that represents the contents of this UNKNOWN ASN.1 type.

Methods inherited from class iaik.asn1.ConstructedType

addComponent, addComponent, addEncodeListener, countComponents, getComponentAt, getComponents, removeComponent, removeComponent, setComponent

Methods inherited from class iaik.asn1.ASN1Object

addEncodeListener, encodeObject, getAsnType, indefiniteLength, isA, isConstructed, isStringType, setIndefiniteLength

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UNKNOWN

public UNKNOWN()

Creates an empty UNKNOWN ASN.1 type.

Method Detail

clone

public java.lang.Object clone()

Returns a clone of this UNKNOWN.

Overrides:

clone in class ConstructedType

Returns:

a clone of this UNKNOWN

setValue

public void setValue(java.lang.Object object)

Sets the value of this object to value.

Overrides:

setValue in class ConstructedType

Parameters:

object - the new value as a byte array

getValue

public java.lang.Object getValue()

Returns the value of this UNKNOWN ASN.1 object as a byte array.

Overrides:

getValue in class ConstructedType

Returns:

the value of this UNKNOWN ASN.1 object

getBaseAsnType

public ASN getBaseAsnType()

Returns the base ASN.1 type of this UNKNOWN ASN.1 object.

This method may be used to query for the ASN.1 type (tag class and tag value) of the base ASN1Object this UNKNOWN represents. Note that the DerCoder creates an UNKNOWN object for any ASN.1 object it does not know of (i.e. has no registered implementation for the corresponding ASN.1 type). An UNKNOWN object is allocated the tag value 0 since it is not used in ASN.1 at all. Therefore, when calling method getAsnType of an UNKNOWN object you anytime will get an ASN1 type representing tag class UNIVERSAL with tag number 0 (since this is the ASN.1 type of the UNKNOWN implementation). To get the ASN.1 type of the base ASN.1 object you may call this getBaseAsnType method.

Returns:

the ASN.1 type of the base ASN.1 object this UNKNOWN represents

See Also:

ASN

encode

protected void encode(java.io.OutputStream os)
               throws java.io.IOException

Tries to encode this UNKOWN ASN.1 object.

Overrides:

encode in class ConstructedType

Parameters:

os - the output stream to which to write the encoded object

Throws:

java.io.IOException - if the UNKOWN type cannot be encoded

decode

protected void decode(int length,
                      java.io.InputStream is)
               throws java.io.IOException

Decodes the value of an UMKNOWN ASN.1 object from the given input stream. An UNKNOWN ASN.1 object is an ASN.1 object of unknown tag. When during the decoding procedure the DerCoder parses a tag it does not know of, it creates an UNKNOWN object and uses this decode method for reading the raw content octets from the decoding stream.

Overrides:

decode in class ConstructedType

Parameters:

length - the already decoded length, i.e. number of the bytes occupied by the value of the UNKNOWN ASN.1 object to be decoded

is - the input stream from which the der encoded data is read in

Throws:

java.io.IOException - if there is a problem with the InputStream

toString

public java.lang.String toString()

Returns a string that represents the contents of this UNKNOWN ASN.1 type.

Overrides:

toString in class ASN1Object

Returns:

the string representation

See Also:

ASN1Object.toString()