com.entrust.toolkit.archive

Class GraphicString

java.lang.Object

iaik.asn1.ASN1Object

com.entrust.toolkit.archive.GraphicString

public class GraphicString
extends ASN1Object

This class implements the native ASN.1 type "GraphicString". GraphicString is a simple ASN.1 string type identified by the UNIVERSAL TAG number 25.

Attention: This class is present only because the GraphicString type is required by the Entrust Archive format. It makes no checks to see if the value it is initialized with actually contains graphically displayable characters. This class should not be used by applications.

Since:

7.0

Field Summary

Fields

Modifier and Type	Field and Description
static ASN	asnGraphicString Global ASN.1 type GraphicString

Fields inherited from class iaik.asn1.ASN1Object

asnType, constructed, encode_listener, indefinite_length, isStringType, stream_mode

Constructor Summary

Constructors

Constructor and Description
GraphicString() Creates an empty GraphicString object.
GraphicString(java.lang.String value) Creates a new GraphicString object for the given String value.

Method Summary

Modifier and Type	Method and Description
protected void	decode(int length, java.io.InputStream is) Decodes a GraphicString value from the given InputStream.
protected void	encode(java.io.OutputStream os) DER encodes this GraphicString ASN1Object and writes the result to the given output stream.
java.lang.Object	getValue() Returns the value of this GraphicString as a String object.
void	setValue(java.lang.Object object) Sets the value of this GraphicString.
java.lang.String	toString() Returns a String that represents the contents of this GraphicString.

Methods inherited from class iaik.asn1.ASN1Object

addComponent, addEncodeListener, countComponents, encodeObject, getAsnType, getComponentAt, indefiniteLength, isA, isConstructed, isStringType, setAutomaticRepair, setAutomaticRepairRecursive, setIndefiniteLength, setIndefiniteRecursive

Methods inherited from class java.lang.Object

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

Field Detail

asnGraphicString

public static final ASN asnGraphicString

Global ASN.1 type GraphicString

Constructor Detail

GraphicString

public GraphicString()

Creates an empty GraphicString object.

GraphicString

public GraphicString(java.lang.String value)

Creates a new GraphicString object for the given String value.

Attention: No check is performed if the supplied String value actually is composed only of graphically displayable characters.

Parameters:

value - the String value this GraphicString object should be initialized with

Method Detail

getValue

public java.lang.Object getValue()

Returns the value of this GraphicString as a String object.

Specified by:

getValue in class ASN1Object

Returns:

the value of this GraphicString as a String object

setValue

public void setValue(java.lang.Object object)

Sets the value of this GraphicString.

The supplied value has to be a Java object of type String.

Attention: No check is performed if the supplied String value actually is composed only of graphically displayable characters.

Specified by:

setValue in class ASN1Object

Parameters:

object - the String value to be set for this GraphicString

encode

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

DER encodes this GraphicString ASN1Object and writes the result to the given output stream.

Applications should call one of the encode methods of the DerCoder class for performing the encoding.

Specified by:

encode in class ASN1Object

Parameters:

os - the output stream to which to write the data

Throws:

java.io.IOException - if an I/O error occurs while writing to the stream

decode

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

Decodes a GraphicString value from the given InputStream. The given input stream carries DER encoded data, and the next length bytes to be read represent the value of an ASN.1 object of type GraphicString.

Application should call one of the decode methods of the DerCoder class for performing the decoding.

No check is performed if the received value actually is composed only of characters belonging to the GraphicString character set!

Specified by:

decode in class ASN1Object

Parameters:

length - the already decoded length, i.e. number of the bytes representing the value of the GraphicString 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 GraphicString.

Overrides:

toString in class ASN1Object

Returns:

a String representation

See Also:

ASN1Object.toString()