java命名空间javax.security.auth.x500类x500principal的类成员方法:
getname定义及介绍
本文导语:
getname
public string getname(string format)
返回使用指定格式的 x.500 标识名的字符串表示形式。该格式的有效值是 "rfc1779"、"rfc2253" 和 "canonical"(不区分大小写)。
如果将格式指定为 "rfc1779",则此方法指定 rfc 1779(cn、l、st、o、ou...
getname
public string getname(string format)
- 返回使用指定格式的 x.500 标识名的字符串表示形式。该格式的有效值是 "rfc1779"、"rfc2253" 和 "canonical"(不区分大小写)。
如果将格式指定为 "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 字符串表示形式。此方法返回的 string 是通过解码此 utf-8 表示形式得到的 unicode 字符串。
如果将格式指定为 "canonical",则此方法返回遵循 rfc 2253 的字符串表示形式,该表示形式具有如下的附加规范要求:
- 从
iis7站长之家为点号分隔的十进制 oid 的属性类型中移除前导零。
- 类型 printablestring 和 utf8string 的 directorystring 属性值不是以十六进制形式输出的
- 除了类型 printablestring 和 utf8string 以外的其他类型的 directorystring 属性值是以十六进制形式输出的
- 从非十六进制属性值(除非该值完全由空白字符组成)中移除前导和尾部空白字符
- 一个或多个空白字符的内部子字符串被转换成非十六进制属性值中的单个空格。
- 包括一个以上的 attribute value assertion (ava) 的相对标识名是按如下顺序输出的:包含标准关键字的 ava 的字母排序,后跟包含 oid 关键字的 ava 的数字排序
- 属性值中的唯一被转义字符是 rfc 2253 的 2.4 小节中声明必须被转义的那些字符(使用正斜杠字符将它们转义)。
- 可以使用
string.touppercase(locale.us)
将整个名称转换为大写的。
- 可以使用
string.tolowercase(locale.us)
将整个名称转换为小写的。
- 最后使用标准化形式 kd 将名称标准化,unicode standard 和 uax #15 中描述了该形式
其他标准格式可能在以后引入。
- 参数:
format
- 要使用的格式
- 返回:
- 使用特定格式的此
x500principal
的字符串表示形式
- 抛出:
illegalargumentexception
- 如果指定格式无效或者为 null