SNIHostName 构造函数

[Android.Runtime.Register(".ctor", "([B)V", "", ApiSince=24)]
public SNIHostName(byte[]? encoded);

[<Android.Runtime.Register(".ctor", "([B)V", "", ApiSince=24)>]
new Javax.Net.Ssl.SNIHostName : byte[] -> Javax.Net.Ssl.SNIHostName

参数

属性

RegisterAttribute

注解

使用指定的编码值创建一个 SNIHostName 。

此方法通常用于分析所请求的 SNI 扩展中的编码名称值。

根据 RFC 6066，主机名的编码名称值符合 StandardCharsets#US_ASCII要求。 但是，在早期版本的 SNI 扩展（ RFC 4366）中，编码的主机名使用 UTF-8 编码表示为字节字符串。 出于版本容错的目的，此方法允许参数StandardCharsets#UTF_8的encoded字符集以及 StandardCharsets#US_ASCII。 IDN#toASCII(String) 用于将 encoded 参数转换为 ASCII 兼容编码 （ACE） 主机名。

强烈建议使用此构造函数来分析所请求的 SNI 扩展中的编码名称值。 否则，若要符合 RFC 6066，请始终使用StandardCharsets#US_ASCII合规的字符集，并强制对主机名中的 ASCII 字符实施限制（请参阅 RFC 3490、RFC 1122、RFC 1123），encoded或改用SNIHostName#SNIHostName(String)。

encoded如果参数是非法的：<ul<>li>encoded 为空，</li li>><encoded 以尾随点结尾，</li<>li>encoded 未编码StandardCharsets#US_ASCII或StandardCharsets#UTF_8符合字符集，</li li<>>encoded 不是符合 RFC 3490 规范的有效国际化域名（IDN）。</li></ul>

请注意， encoded 将克隆字节数组，以防止后续修改。

适用于 . 的 javax.net.ssl.SNIHostName.SNIHostName(byte[])Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "", ApiSince=24)]
public SNIHostName(string? hostname);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "", ApiSince=24)>]
new Javax.Net.Ssl.SNIHostName : string -> Javax.Net.Ssl.SNIHostName

参数

属性

RegisterAttribute

注解

使用指定的主机名创建一个 SNIHostName 。

请注意，根据 RFC 6066，主机名的编码服务器名称值符合 StandardCharsets#US_ASCII要求。 在此方法中， hostname 可以是用户友好的国际化域名（IDN）。 IDN#toASCII(String, int) 用于对主机名中的 ASCII 字符强制实施限制（请参阅 RFC 3490、 RFC 1122、 RFC 1123），并将其转换为 hostname ASCII 兼容编码（ACE），如下所示：

IDN.toASCII(hostname, IDN.USE_STD3_ASCII_RULES);

hostname如果参数是非法的：<ul<>li>hostname 为空，</li li>>hostname< 以尾随点结尾，</li li<>>hostname 不是符合 RFC 3490 规范的有效国际化域名（IDN）。</li></ul>

适用于 . 的 javax.net.ssl.SNIHostName.SNIHostName(java.lang.String)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。