X500Principal

CANONICAL

String CANONICAL

专有名称的规范字符串格式。

常数值：“CANONICAL”

RFC1779

String RFC1779

专有名称的RFC 1779字符串格式。

常量值：“RFC1779”

RFC2253

String RFC2253

可分辨名称的RFC 2253字符串格式。

常数值：“RFC2253”

X500Principal

X500Principal (String name)

从X.500可分辨名称（例如：“CN = Duke，OU = JavaSoft，O = Sun Microsystems，C = US”）的字符串表示形式创建X500Principal 。 专有名称必须使用RFC 1779或RFC 2253中定义的语法来指定（两种格式均可接受）。

此构造函数可识别RFC 1779和RFC 2253（以及getName(String format)列出）中定义的属性类型关键字，以及在RFC中定义OID的T，DNQ或DNQUALIFIER，SURNAME，GIVENNAME，INITIALS，GENERATION，EMAILADDRESS和SERIALNUMBER关键字3280及其继任者。 任何其他属性类型都必须指定为OID。

X500Principal

X500Principal (String name, 
                Map<String, String> keywordMap)

从X.500可分辨名称（例如：“CN = Duke，OU = JavaSoft，O = Sun Microsystems，C = US”）的字符串表示形式创建X500Principal 。 专有名称必须使用RFC 1779或RFC 2253中定义的语法来指定（两种格式均可接受）。

此构造函数可识别X500Principal(String)指定的属性类型关键字，还可识别keywordMap参数中具有条目的其他关键字。 keywordMap中的关键字条目优先于由X500Principal(String)识别的默认关键字。 关键字必须全部大写，否则它们将被忽略。 不正确指定的关键字将被忽略; 但是，如果名称中的关键字映射到不正确指定的OID， IllegalArgumentException引发IllegalArgumentException 。 允许映射到相同OID的2个不同关键字是允许的。

X500Principal

X500Principal (byte[] name)

从ASN.1 DER编码形式的专有名称创建X500Principal 。 该结构的ASN.1表示法如下。

 Name ::= CHOICE {
   RDNSequence }

 RDNSequence ::= SEQUENCE OF RelativeDistinguishedName

 RelativeDistinguishedName ::=
   SET SIZE (1 .. MAX) OF AttributeTypeAndValue

 AttributeTypeAndValue ::= SEQUENCE {
   type     AttributeType,
   value    AttributeValue }

 AttributeType ::= OBJECT IDENTIFIER

 AttributeValue ::= ANY DEFINED BY AttributeType
 ....
 DirectoryString ::= CHOICE {
       teletexString           TeletexString (SIZE (1..MAX)),
       printableString         PrintableString (SIZE (1..MAX)),
       universalString         UniversalString (SIZE (1..MAX)),
       utf8String              UTF8String (SIZE (1.. MAX)),
       bmpString               BMPString (SIZE (1..MAX)) }
 

X500Principal

X500Principal (InputStream is)

创建一个X500Principal从InputStream包含ASN.1 DER编码形式的标识名。 此结构的ASN.1表示法在X500Principal(byte[] name)的文档中提供。

输入流的读取位置位于编码的可分辨名称之后的下一个可用字节。

equals

boolean equals (Object o)

将指定的 Object与此 X500Principal进行比较 X500Principal相等。

具体而言，此方法返回 true如果 Object O是 X500Principal以及如果相应的规范的字符串表示（通过所获得的 getName(X500Principal.CANONICAL)此对象和 邻的方法）是相等的。

该实现符合RFC 3280的要求。

getEncoded

byte[] getEncoded ()

以ASN.1 DER编码形式返回专有名称。 此结构的ASN.1表示法在X500Principal(byte[] name)的文档中提供。

请注意，返回的字节数组被克隆以防止后续修改。

getName

String getName (String format)

使用指定的格式返回X.500专有名称的字符串表示形式。 格式的有效值是“RFC1779”，“RFC2253”和“典型”（不区分大小写）。

如果将“RFC1779”指定为格式，则此方法将发出RFC 1779（CN，L，ST，O，OU，C，STREET）中定义的属性类型关键字。 任何其他属性类型都以OID形式发出。

如果将“RFC2253”指定为格式，则此方法将发出在RFC 2253（CN，L，ST，O，OU，C，STREET，DC，UID）中定义的属性类型关键字。 任何其他属性类型都以OID形式发出。 在严格的阅读条件下，RFC 2253仅指定了UTF-8字符串表示。 此方法返回的字符串是通过解码此UTF-8表示形式实现的Unicode字符串。

如果将“CANONICAL”指定为格式，则此方法将返回符合RFC 2253的字符串表示形式，并带有以下附加的规范化形式：

1. Leading zeros are removed from attribute types that are encoded as dotted decimal OIDs
2. DirectoryString attribute values of type PrintableString and UTF8String are not output in hexadecimal format
3. DirectoryString attribute values of types other than PrintableString and UTF8String are output in hexadecimal format
4. Leading and trailing white space characters are removed from non-hexadecimal attribute values (unless the value consists entirely of white space characters)
5. Internal substrings of one or more white space characters are converted to a single space in non-hexadecimal attribute values
6. Relative Distinguished Names containing more than one Attribute Value Assertion (AVA) are output in the following order: an alphabetical ordering of AVAs containing standard keywords, followed by a numeric ordering of AVAs containing OID keywords.
7. The only characters in attribute values that are escaped are those which section 2.4 of RFC 2253 states must be escaped (they are escaped using a preceding backslash character)
8. The entire name is converted to upper case using String.toUpperCase(Locale.US)
9. The entire name is converted to lower case using String.toLowerCase(Locale.US)
10. The name is finally normalized using normalization form KD, as described in the Unicode Standard and UAX #15

其他标准格式可能会在未来推出。

getName

String getName ()

使用RFC 2253中定义的格式返回X.500专有名称的字符串表示形式。

这种方法相当于调用 getName(X500Principal.RFC2253) 。

getName

String getName (String format, 
                Map<String, String> oidMap)

使用指定的格式返回X.500专有名称的字符串表示形式。 格式的有效值是“RFC1779”和“RFC2253”（不区分大小写）。 不允许使用“CANONICAL”，并且会抛出IllegalArgumentException 。

此方法以getName(String)指定的格式返回字符串，并且还为包含oidMap参数中的条目的OID发出其他属性类型关键字。 oidMap中的OID条目优先于由getName(String)识别的默认OID。 不正确指定的OID将被忽略; 但是，如果名称中的OID映射到不正确指定的关键字， IllegalArgumentException引发IllegalArgumentException 。

其他标准格式可能会在未来推出。

警告：其他属性类型关键字可能无法被其他实现识别; 因此如果您不确定这些关键字是否会被其他实现识别，请不要使用此方法。

hashCode

int hashCode ()

返回此 X500Principal的哈希码。

哈希码通过以下方式计算： getName(X500Principal.CANONICAL).hashCode()

toString

String toString ()

返回此 X500Principal的用户友好字符串表示 X500Principal 。