iaik.asn1

Class ASN1String

java.lang.Object

iaik.asn1.ASN1Object

iaik.asn1.ASN1String

Direct Known Subclasses:

BMPString, GeneralString, IA5String, NumericString, PrintableString, T61String, UNIString, UTF8String, VisibleString

public abstract class ASN1String
extends ASN1Object

Abstract super class for all ASN.1 String types.

This class extends ASN1Object for grouping all ASN.1 String type implementing classes.

See Also:

BMPString, GeneralString, IA5String, NumericString, PrintableString, T61String, UNIString, UTF8String, VisibleString

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	value The value as byte material representing the String value encoding.

Fields inherited from class iaik.asn1.ASN1Object

asnType, constructed, encode_listener, indefinite_length, isStringType, stream_mode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ASN1String() Creates an empty ASN1String.

Method Summary

Modifier and Type	Method and Description
protected void	decode(int length, java.io.InputStream is) Decodes a ASN1String value from the given InputStream.
protected void	encode(java.io.OutputStream os) DER encodes this ASN1String and writes the result to the given output stream.
boolean	equals(java.lang.Object obj) Compares two ASN.1 Strings.
int	hashCode() Returns a hash code for this object.
java.lang.String	toString() Returns a string that represents the contents of this ASN1String.

Methods inherited from class iaik.asn1.ASN1Object

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

Methods inherited from class java.lang.Object

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

Field Detail

value

protected byte[] value

The value as byte material representing the String value encoding.

Constructor Detail

ASN1String

protected ASN1String()

Creates an empty ASN1String.

Method Detail

encode

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

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

This is a protected method and will not be used by an application for DER encoding a ASN1String object. An application will call one of the encode methods of the DerCoder class for performing the encoding, and the DerCoder internally will call this encode method.

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

This is a protected method and will not be used by an application for decoding a DER encoded ASN1String. An application will call one of the decode methods of the DerCoder class for performing the decoding. The DerCoder then determines the number of bytes (length) occupied by the value of this ASN1String object and internally calls this decode method for actually reading the value. No check is performed if the received value actually is composed only of characters belonging to the ASN1String typical 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 ASN1String 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 ASN1String.

Overrides:

toString in class ASN1Object

Returns:

the string representation

See Also:

ASN1Object.toString()

equals

public boolean equals(java.lang.Object obj)

Compares two ASN.1 Strings.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the other ASN.1 String

Returns:

true, if the two ASN1Strings are equal, false otherwise

hashCode

public int hashCode()

Returns a hash code for this object.

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code