org.bouncycastle.asn1.DERPrintableString Maven / Gradle / Ivy

package org.bouncycastle.asn1;

/**
 * DER PrintableString object.
 * 
 * X.680 section 37.4 defines PrintableString character codes as ASCII subset of following characters:
 * 
 * 
 * Latin capital letters: 'A' .. 'Z'
 * Latin small letters: 'a' .. 'z'
 * Digits: '0'..'9'
 * Space
 * Apostrophe: '\''
 * Left parenthesis: '('
 * Right parenthesis: ')'
 * Plus sign: '+'
 * Comma: ','
 * Hyphen-minus: '-'
 * Full stop: '.'
 * Solidus: '/'
 * Colon: ':'
 * Equals sign: '='
 * Question mark: '?'
 * 
 * 
 * Explicit character set escape sequences are not allowed.
 * 
 */
public class DERPrintableString
    extends ASN1PrintableString
{
    /**
     * Return a printable string from the passed in object.
     *
     * @param obj a DERPrintableString or an object that can be converted into one.
     * @exception IllegalArgumentException if the object cannot be converted.
     * @return a DERPrintableString instance, or null.
     * 
     * @deprecated Use {@link ASN1PrintableString#getInstance(Object)} instead.
     */
    public static DERPrintableString getInstance(
        Object  obj)
    {
        if (obj == null || obj instanceof DERPrintableString)
        {
            return (DERPrintableString)obj;
        }
        if (obj instanceof ASN1PrintableString)
        {
            return new DERPrintableString(((ASN1PrintableString)obj).contents, false);
        }
        if (obj instanceof byte[])
        {
            try
            {
                return (DERPrintableString)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 a Printable 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 DERPrintableString instance, or null.
     * 
     * @deprecated Use
     *             {@link ASN1PrintableString#getInstance(ASN1TaggedObject, boolean)}
     *             instead.
     */
    public static DERPrintableString getInstance(
        ASN1TaggedObject obj,
        boolean          explicit)
    {
        ASN1Primitive o = obj.getObject();

        if (explicit || o instanceof DERPrintableString)
        {
            return getInstance(o);
        }
        else
        {
            return new DERPrintableString(ASN1OctetString.getInstance(o).getOctets(), true);
        }
    }

    /**
     * Basic constructor - this does not validate the string
     */
    public DERPrintableString(
        String   string)
    {
        this(string, false);
    }

    /**
     * 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 PrintableString.
     */
    public DERPrintableString(
        String   string,
        boolean  validate)
    {
        super(string, validate);
    }

    DERPrintableString(byte[] contents, boolean clone)
    {
        super(contents, clone);
    }
}