iaik.asn1
Class VisibleString

java.lang.Object
  |
  +--iaik.asn1.ASN1Object
        |
        +--iaik.asn1.ASN1String
              |
              +--iaik.asn1.VisibleString

All Implemented Interfaces:

Cloneable

public class VisibleString

extends ASN1String

This class implements the native ASN.1 type "VisibleString" (ISO646String). VisibleString is a simple ASN.1 string type identified by the UNIVERSAL TAG number 26.

The ASN.1 character string type VisibleString encompasses all visible characters of the IA5 (International Alphabet 5) character set.

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

 String s = ...;
 VisibleString visibleString = new VisibleString(s);
 

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

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

 String s = (String)visibleString.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.

Version:

File Revision 20

See Also:

ASN1Object, ASN

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

protected	VisibleString() Creates an empty VisibleString.
	VisibleString(String value) Creates a new ASN.1 VisibleString object for the given String value.

Method Summary

Object	getValue() Returns the value of this VisibleString as a String.
void	setValue(Object object) Sets the value of this VisibleString.

Methods inherited from class iaik.asn1.ASN1String

clone, decode, encode, equals, hashCode, toString

Methods inherited from class iaik.asn1.ASN1Object

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

Methods inherited from class java.lang.Object

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

Constructor Detail

VisibleString

protected VisibleString()

Creates an empty VisibleString.

VisibleString

public VisibleString(String value)

Creates a new ASN.1 VisibleString 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 VisibleString character set! An application itself has to take care for supplying a proper VisibleString value.

Parameters:

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

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

Method Detail

getValue

public Object getValue()

Returns the value of this VisibleString as a String.

Overrides:

getValue in class ASN1Object

Returns:

the value of this VisibleString as a String object

setValue

public void setValue(Object object)

Sets the value of this VisibleString.

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

Overrides:

setValue in class ASN1Object

Parameters:

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