src/share/classes/javax/security/auth/x500/X500Principal.java

Print this page




 297      * using the specified format. Valid values for the format are
 298      * "RFC1779", "RFC2253", and "CANONICAL" (case insensitive).
 299      *
 300      * <p> If "RFC1779" is specified as the format,
 301      * this method emits the attribute type keywords defined in
 302      * RFC 1779 (CN, L, ST, O, OU, C, STREET).
 303      * Any other attribute type is emitted as an OID.
 304      *
 305      * <p> If "RFC2253" is specified as the format,
 306      * this method emits the attribute type keywords defined in
 307      * RFC 2253 (CN, L, ST, O, OU, C, STREET, DC, UID).
 308      * Any other attribute type is emitted as an OID.
 309      * Under a strict reading, RFC 2253 only specifies a UTF-8 string
 310      * representation. The String returned by this method is the
 311      * Unicode string achieved by decoding this UTF-8 representation.
 312      *
 313      * <p> If "CANONICAL" is specified as the format,
 314      * this method returns an RFC 2253 conformant string representation
 315      * with the following additional canonicalizations:
 316      *
 317      * <p><ol>
 318      * <li> Leading zeros are removed from attribute types
 319      *          that are encoded as dotted decimal OIDs
 320      * <li> DirectoryString attribute values of type
 321      *          PrintableString and UTF8String are not
 322      *          output in hexadecimal format
 323      * <li> DirectoryString attribute values of types
 324      *          other than PrintableString and UTF8String
 325      *          are output in hexadecimal format
 326      * <li> Leading and trailing white space characters
 327      *          are removed from non-hexadecimal attribute values
 328      *          (unless the value consists entirely of white space characters)
 329      * <li> Internal substrings of one or more white space characters are
 330      *          converted to a single space in non-hexadecimal
 331      *          attribute values
 332      * <li> Relative Distinguished Names containing more than one
 333      *          Attribute Value Assertion (AVA) are output in the
 334      *          following order: an alphabetical ordering of AVAs
 335      *          containing standard keywords, followed by a numeric
 336      *          ordering of AVAs containing OID keywords.
 337      * <li> The only characters in attribute values that are escaped are




 297      * using the specified format. Valid values for the format are
 298      * "RFC1779", "RFC2253", and "CANONICAL" (case insensitive).
 299      *
 300      * <p> If "RFC1779" is specified as the format,
 301      * this method emits the attribute type keywords defined in
 302      * RFC 1779 (CN, L, ST, O, OU, C, STREET).
 303      * Any other attribute type is emitted as an OID.
 304      *
 305      * <p> If "RFC2253" is specified as the format,
 306      * this method emits the attribute type keywords defined in
 307      * RFC 2253 (CN, L, ST, O, OU, C, STREET, DC, UID).
 308      * Any other attribute type is emitted as an OID.
 309      * Under a strict reading, RFC 2253 only specifies a UTF-8 string
 310      * representation. The String returned by this method is the
 311      * Unicode string achieved by decoding this UTF-8 representation.
 312      *
 313      * <p> If "CANONICAL" is specified as the format,
 314      * this method returns an RFC 2253 conformant string representation
 315      * with the following additional canonicalizations:
 316      *
 317      * <ol>
 318      * <li> Leading zeros are removed from attribute types
 319      *          that are encoded as dotted decimal OIDs
 320      * <li> DirectoryString attribute values of type
 321      *          PrintableString and UTF8String are not
 322      *          output in hexadecimal format
 323      * <li> DirectoryString attribute values of types
 324      *          other than PrintableString and UTF8String
 325      *          are output in hexadecimal format
 326      * <li> Leading and trailing white space characters
 327      *          are removed from non-hexadecimal attribute values
 328      *          (unless the value consists entirely of white space characters)
 329      * <li> Internal substrings of one or more white space characters are
 330      *          converted to a single space in non-hexadecimal
 331      *          attribute values
 332      * <li> Relative Distinguished Names containing more than one
 333      *          Attribute Value Assertion (AVA) are output in the
 334      *          following order: an alphabetical ordering of AVAs
 335      *          containing standard keywords, followed by a numeric
 336      *          ordering of AVAs containing OID keywords.
 337      * <li> The only characters in attribute values that are escaped are