package org.bouncycastle.asn1;
import java.io.IOException;
import org.bouncycastle.util.Arrays;
import org.bouncycastle.util.Strings;
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.
/**
* 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.
* <p>
* This is an ASCII string of characters {0,1,2,3,4,5,6,7,8,9} + space.
* <p>
* See X.680 section 37.2.
* <p>
* Explicit character set escape sequences are not allowed.
*/
public class DERNumericString
extends ASN1Primitive
implements ASN1String
{
private final byte[] string;
Return a Numeric string from the passed in object
Params: - obj – a DERNumericString or an object that can be converted into one.
Throws: - IllegalArgumentException – if the object cannot be converted.
Returns: a DERNumericString instance, or null
/**
* Return a Numeric string from the passed in object
*
* @param obj a DERNumericString or an object that can be converted into one.
* @exception IllegalArgumentException if the object cannot be converted.
* @return a DERNumericString instance, or null
*/
public static DERNumericString getInstance(
Object obj)
{
if (obj == null || obj instanceof DERNumericString)
{
return (DERNumericString)obj;
}
if (obj instanceof byte[])
{
try
{
return (DERNumericString)fromByteArray((byte[])obj);
}
catch (Exception e)
{
throw new IllegalArgumentException("encoding error in getInstance: " + e.toString());
}
}
throw new IllegalArgumentException("illegal object in getInstance: " + obj.getClass().getName());
}
Return an Numeric String from a tagged object.
Params: - obj – the tagged object holding the object we want
- explicit – true if the object is meant to be explicitly
tagged false otherwise.
Throws: - IllegalArgumentException – if the tagged object cannot
be converted.
Returns: a DERNumericString instance, or null.
/**
* Return an Numeric String from a tagged object.
*
* @param obj the tagged object holding the object we want
* @param explicit true if the object is meant to be explicitly
* tagged false otherwise.
* @exception IllegalArgumentException if the tagged object cannot
* be converted.
* @return a DERNumericString instance, or null.
*/
public static DERNumericString getInstance(
ASN1TaggedObject obj,
boolean explicit)
{
ASN1Primitive o = obj.getObject();
if (explicit || o instanceof DERNumericString)
{
return getInstance(o);
}
else
{
return new DERNumericString(ASN1OctetString.getInstance(o).getOctets());
}
}
Basic constructor - with bytes.
/**
* Basic constructor - with bytes.
*/
DERNumericString(
byte[] string)
{
this.string = string;
}
Basic constructor - without validation..
/**
* Basic constructor - without validation..
*/
public DERNumericString(
String string)
{
this(string, false);
}
Constructor with optional validation.
Params: - string – the base string to wrap.
- validate – whether or not to check the string.
Throws: - IllegalArgumentException – if validate is true and the string
contains characters that should not be in a NumericString.
/**
* Constructor with optional validation.
*
* @param string the base string to wrap.
* @param validate whether or not to check the string.
* @throws IllegalArgumentException if validate is true and the string
* contains characters that should not be in a NumericString.
*/
public DERNumericString(
String string,
boolean validate)
{
if (validate && !isNumericString(string))
{
throw new IllegalArgumentException("string contains illegal characters");
}
this.string = Strings.toByteArray(string);
}
public String getString()
{
return Strings.fromByteArray(string);
}
public String toString()
{
return getString();
}
public byte[] getOctets()
{
return Arrays.clone(string);
}
boolean isConstructed()
{
return false;
}
int encodedLength()
{
return 1 + StreamUtil.calculateBodyLength(string.length) + string.length;
}
void encode(
ASN1OutputStream out)
throws IOException
{
out.writeEncoded(BERTags.NUMERIC_STRING, string);
}
public int hashCode()
{
return Arrays.hashCode(string);
}
boolean asn1Equals(
ASN1Primitive o)
{
if (!(o instanceof DERNumericString))
{
return false;
}
DERNumericString s = (DERNumericString)o;
return Arrays.areEqual(string, s.string);
}
Return true if the string can be represented as a NumericString ('0'..'9', ' ')
Params: - str – string to validate.
Returns: true if numeric, fale otherwise.
/**
* Return true if the string can be represented as a NumericString ('0'..'9', ' ')
*
* @param str string to validate.
* @return true if numeric, fale otherwise.
*/
public static boolean isNumericString(
String str)
{
for (int i = str.length() - 1; i >= 0; i--)
{
char ch = str.charAt(i);
if (ch > 0x007f)
{
return false;
}
if (('0' <= ch && ch <= '9') || ch == ' ')
{
continue;
}
return false;
}
return true;
}
}