org.bouncycastle.asn1

Class DERNumericString

java.lang.Object

org.bouncycastle.asn1.ASN1Object

org.bouncycastle.asn1.ASN1Primitive

org.bouncycastle.asn1.DERNumericString

All Implemented Interfaces:

ASN1Encodable, ASN1String, Encodable

public class DERNumericString
extends ASN1Primitive
implements ASN1String

DER NumericString object - this is an ascii string of characters {0,1,2,3,4,5,6,7,8,9, }. ASN.1 NUMERIC-STRING object.

This is an ASCII string of characters {0,1,2,3,4,5,6,7,8,9} + space.

See X.680 section 37.2.

Explicit character set escape sequences are not allowed.

Constructor Summary

Constructors

Constructor and Description
DERNumericString(java.lang.String string) Basic constructor - without validation..
DERNumericString(java.lang.String string, boolean validate) Constructor with optional validation.

Method Summary

Modifier and Type	Method and Description
static DERNumericString	getInstance(ASN1TaggedObject obj, boolean explicit) Return an Numeric String from a tagged object.
static DERNumericString	getInstance(java.lang.Object obj) Return a Numeric string from the passed in object
byte[]	getOctets()
java.lang.String	getString() Return a Java String representation of this STRING type's content.
int	hashCode()
static boolean	isNumericString(java.lang.String str) Return true if the string can be represented as a NumericString ('0'..'9', ' ')
java.lang.String	toString()

Methods inherited from class org.bouncycastle.asn1.ASN1Primitive

encodeTo, encodeTo, equals, equals, equals, fromByteArray, toASN1Primitive

Methods inherited from class org.bouncycastle.asn1.ASN1Object

getEncoded, getEncoded, hasEncodedTagValue

Methods inherited from class java.lang.Object

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

Constructor Detail

DERNumericString

public DERNumericString(java.lang.String string)

Basic constructor - without validation..

DERNumericString

public DERNumericString(java.lang.String string,
                        boolean validate)

Constructor with optional validation.

Parameters:

string - the base string to wrap.

validate - whether or not to check the string.

Throws:

java.lang.IllegalArgumentException - if validate is true and the string contains characters that should not be in a NumericString.

Method Detail

getInstance

public static DERNumericString getInstance(java.lang.Object obj)

Return a Numeric string from the passed in object

Parameters:

obj - a DERNumericString or an object that can be converted into one.

Returns:

a DERNumericString instance, or null

Throws:

java.lang.IllegalArgumentException - if the object cannot be converted.

getInstance

public static DERNumericString getInstance(ASN1TaggedObject obj,
                                           boolean explicit)

Return an Numeric String from a tagged object.

Parameters:

obj - the tagged object holding the object we want

explicit - true if the object is meant to be explicitly tagged false otherwise.

Returns:

a DERNumericString instance, or null.

Throws:

java.lang.IllegalArgumentException - if the tagged object cannot be converted.

getString

public java.lang.String getString()

Description copied from interface: ASN1String

Return a Java String representation of this STRING type's content.

Specified by:

getString in interface ASN1String

Returns:

a Java String representation of this STRING.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getOctets

public byte[] getOctets()

hashCode

public int hashCode()

Specified by:

hashCode in class ASN1Primitive

isNumericString

public static boolean isNumericString(java.lang.String str)

Return true if the string can be represented as a NumericString ('0'..'9', ' ')

Parameters:

str - string to validate.

Returns:

true if numeric, fale otherwise.