iaik.asn1

Class UNIString

java.lang.Object

iaik.asn1.ASN1Object

iaik.asn1.ASN1String

iaik.asn1.UNIString

All Implemented Interfaces:

java.lang.Cloneable

public class UNIString
extends ASN1String

This class implements the native ASN.1 type "UniveralString". UNIString is a simple ASN.1 string type identified by the UNIVERSAL TAG number 28.

UniversalString is defined in ASN.1:1993.

When creating a new UNIString object the value to be represented has to be supplied as Java String type:

 String s = ...;
 UNIString uniString = new UNIString(s);
 

Attention: When supplying the string value to be represented, no check is performed if it actually is composed only of characters belonging to UniversalString character set! An application itself has to take care for supplying a proper UniversalString value.

When calling the getValue method for getting the inherent string value from an ASN.1 UNIString instance, a Java object of type String is returned:

 String s = (String)uniString.getValue();
 

DER en/decoding generally is done by means of the several methods of the DerCoder class; decoding alternatively may be performed by using the DerInputStream utility.

Attention! Since Java characters are UNICODE (16 bit), but UNIVERSAL STRING uses 32 bit, wrong (de)coding results may occur when characters occupy more than 16 bits!

Version:

File Revision 25

See Also:

ASN1Object, ASN

Field Summary

Fields inherited from class iaik.asn1.ASN1String

value

Fields inherited from class iaik.asn1.ASN1Object

asnType, constructed, encode_listener, indefinite_length, isStringType, stream_mode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UNIString() Creates an empty UNIString.
	UNIString(java.lang.String value) Creates a new ASN.1 UNIString object for the given String value.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	getValue() Returns the value of this UNIString as a String object.
void	setValue(java.lang.Object object) Sets the value of this UNIString.

Methods inherited from class iaik.asn1.ASN1String

clone, decode, encode, equals, getByteValue, hashCode, setIgnoreConstructedEncodingForSimpleTypes, setIndefiniteLength, toString

Methods inherited from class iaik.asn1.ASN1Object

addComponent, addEncodeListener, countComponents, encodeObject, getAsnType, getComponentAt, indefiniteLength, isA, isConstructed, isStringType

Methods inherited from class java.lang.Object

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

Constructor Detail

UNIString

protected UNIString()

Creates an empty UNIString.

UNIString

public UNIString(java.lang.String value)

Creates a new ASN.1 UNIString object for the given String value.

Attention: No check is performed if the supplied String value actually is composed only of characters belonging to the UniversalString character set! An application itself has to take care for supplying a proper UniversalString value.

Parameters:

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

Method Detail

getValue

public java.lang.Object getValue()

Returns the value of this UNIString as a String object.

Specified by:

getValue in class ASN1Object

Returns:

the value of this UNIString as a String object

setValue

public void setValue(java.lang.Object object)

Sets the value of this UNIString.

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 characters belonging to UniversalString character set! An application itself has to take care for supplying a proper UniversalString value.

Specified by:

setValue in class ASN1Object

Parameters:

object - the Java String value to be set for this UNIString