Home » geronimo-2.2-source-release » org.apache.geronimo.crypto.asn1.x509 » [javadoc | source]

org.apache.geronimo.crypto.asn1.x509
abstract public class: X509NameEntryConverter [javadoc | source]

java.lang.Object
   org.apache.geronimo.crypto.asn1.x509.X509NameEntryConverter

Direct Known Subclasses:
    X509DefaultEntryConverter

It turns out that the number of standard ways the fields in a DN should be encoded into their ASN.1 counterparts is rapidly approaching the number of machines on the internet. By default the X509Name class will produce PrintableStrings if the field value will decode to that, next UTF8Strings if the field value will decode to that, and finally BMPStrings if 16 bit characters are required.

The way this is done is with a default encoder which is implemented as follows:

public class X509DefaultEntryConverter
    extends X509NameEntryConverter
{
    public DERObject getConvertedValue(
        DERObjectIdentifier  oid,
        String               value)
    {
        if (str.length() != 0 && str.charAt(0) == '#')
        {
            return convertHexEncoded(str, 1);
        }
        if (oid.equals(EmailAddress))
        {
            return new DERIA5String(str);
        }
        else if (canBePrintable(str))
        {
            return new DERPrintableString(str);
        }
        else if (canBeUTF8(str))
        {
            return new DERUTF8String(str);
        }
        else
        {
            return new DERBMPString(str);
        }
    }
}








    







    












    









    
Method from org.apache.geronimo.crypto.asn1.x509.X509NameEntryConverter Summary:

canBePrintable,   canBeUTF8,   convertHexEncoded,   getConvertedValue
Methods from java.lang.Object:

clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.apache.geronimo.crypto.asn1.x509.X509NameEntryConverter Detail:
 protected boolean canBePrintable(String str) 
{
        for (int i = str.length() - 1; i  >= 0; i--)
        {
            char    ch = str.charAt(i);
            if (str.charAt(i)  > 0x007f)
            {
                return false;
            }
            if ('a' < = ch && ch < = 'z')
            {
                continue;
            }
            if ('A' < = ch && ch < = 'Z')
            {
                continue;
            }
            if ('0' < = ch && ch < = '9')
            {
                continue;
            }
            switch (ch)
            {
            case ' ':
            case '\'':
            case '(':
            case ')':
            case '+':
            case '-':
            case '.':
            case ':':
            case '=':
            case '?':
                continue;
            }
            return false;
        }
        return true;
}
return true if the passed in String can be represented without
loss as a PrintableString, false otherwise.
 protected boolean canBeUTF8(String str) 
{
        for (int i = str.length() - 1; i  >= 0; i--)
        {
            if (str.charAt(i)  > 0x00ff)
            {
                return false;
            }
        }
        return true;
}
return true if the passed in String can be represented without
loss as a UTF8String, false otherwise.
 protected DERObject convertHexEncoded(String str,
    int off) throws IOException 
{
        str = str.toLowerCase();
        byte[]    data = new byte[str.length() / 2];
        for (int index = 0; index != data.length; index++)
        {
            char left = str.charAt((index * 2) + off);
            char right = str.charAt((index * 2) + off + 1);
            if (left <  'a')
            {
                data[index] = (byte)((left - '0') < <  4);
            }
            else
            {
                data[index] = (byte)((left - 'a' + 10) < <  4);
            }
            if (right <  'a')
            {
                data[index] |= (byte)(right - '0');
            }
            else
            {
                data[index] |= (byte)(right - 'a' + 10);
            }
        }
        ASN1InputStream aIn = new ASN1InputStream(
                                            new ByteArrayInputStream(data));
        return aIn.readObject();
}
Convert an inline encoded hex string rendition of an ASN.1
object back into its corresponding ASN.1 object.
 abstract public DERObject getConvertedValue(DERObjectIdentifier oid,
    String value)
Convert the passed in String value into the appropriate ASN.1
encoded object.