クラスSNIHostName

java.lang.Object

javax.net.ssl.SNIServerName

javax.net.ssl.SNIHostName

public final class SNIHostName extends SNIServerName

このクラスのインスタンスは、Server Name Indication (SNI)拡張のhost_nameタイプのサーバー名を表します。

TLS拡張(RFC 6066)のセクション3「Server Name Indication」で説明されているように、「HostName」には、クライアントが理解できるサーバーの完全修飾DNSホスト名が含まれます。 ホスト名のエンコードされたサーバー名の値は、ASCIIエンコーディングを使用したドットで終わらないバイト文字列として表現されます。 これにより、RFC 5890で規定されたA-label(Internationalized Domain Names for Applications (IDNA)の有効な文字列のASCII互換エンコーディング(ACE)形式)の使用による国際化ドメイン名(IDN)のサポートが可能となります。

SNIHostNameオブジェクトは不変です。

導入されたバージョン:

1.8

外部仕様

• RFC 5890: アプリケーションの国際化ドメイン名 (IDNA): 定義とドキュメント・フレー� ワーク
• RFC 6066: トランスポート層セキュリティ(TLS)拡張機能: 拡張定義

関連� �目:

• SNIServerName
• StandardConstants.SNI_HOST_NAME

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
SNIHostName(byte[] encoded)	指定されたエンコード値を使用してSNIHostNameを作成します。
SNIHostName(String hostname)	指定されたホスト名を使用してSNIHostNameを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
static SNIMatcher	createSNIMatcher(String regex)	SNIHostNameのSNIMatcherオブジェクトを作成します。
boolean	equals(Object other)	このサーバー名を指定されたオブジェクトと比較します。
String	getAsciiName()	このSNIHostNameオブジェクトのStandardCharsets.US_ASCII準� のホスト名を返します。
int	hashCode()	このSNIHostNameのハッシュ・コード値を返します。
String	toString()	このオブジェクトの文字列表現(このSNIHostNameオブジェクトのDNSホスト名を含む)を返します。

クラスjavax.net.ssl.SNIServerNameで宣言されたメソッド

getEncoded, getType

クラスjava.lang.Objectで宣言されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

SNIHostName

public SNIHostName(String hostname)

指定されたホスト名を使用してSNIHostNameを作成します。

RFC 6066により、ホスト名のエンコードされたサーバー名の値はStandardCharsets.US_ASCIIに準� します。 このメソッドでは、hostnameにユーザー・フレンドリな国際化ドメイン名(IDN)を指定できます。 ホスト名のASCII文字に関する制限(RFC 3490、RFC 1122、RFC 1123を参照)を強制的に適用し、hostnameをASCII互換エンコーディング(ACE)に変換するには、次のようにIDN.toASCII(String, int)が使用されます。

     IDN.toASCII(hostname, IDN.USE_STD3_ASCII_RULES);
 

hostname引数が不正になるのは次の� �合です。

• hostnameが空である。
• hostnameがドットで終わっている。
• hostnameが、RFC 3490仕様に準� した有効な国際化ドメイン名(IDN)でない。

パラメータ:

hostname - このサーバー名のホスト名

スロー:

NullPointerException - hostnameがnullの� �合

IllegalArgumentException - hostnameが不正である� �合

外部仕様

• RFC 1122: インターネット・ホストの要件 - 通信レイヤー
• RFC 1123: インターネット・ホストの要件 - アプリケーションとサポート
• RFC 3490: アプリケーションでのドメイン名の国際化 (IDNA)
• RFC 6066: トランスポート層セキュリティ(TLS)拡張機能: 拡張定義

SNIHostName

public SNIHostName(byte[] encoded)

指定されたエンコード値を使用してSNIHostNameを作成します。

このメソッドは通常、要求されたSNI拡張のエンコードされた名前の値を解析するために使用されます。

RFC 6066により、ホスト名のエンコードされた名前の値はStandardCharsets.US_ASCIIに準� します。 た� し、SNI拡張の以前のバージョン(RFC 4366)では、エンコードされたホスト名はUTF-8エンコーディングを使用したバイト文字列として表現されます。 このメソッドではバージョンの許容範囲を拡げるため、encoded引数の文字セットとして、StandardCharsets.US_ASCII� けでなくStandardCharsets.UTF_8も使用できるようになっています。 encoded引数をASCII互換エンコーディング(ACE)のホスト名に変換するには、IDN.toASCII(String)が使用されます。

このコンストラクタを使用するのは、要求されたSNI拡張のエンコードされた名前の値を解析する� �合のみにすることを強くお薦めします。 それ以外の� �合は、RFC 6066に準� するために、encoded引数で常にStandardCharsets.US_ASCII準� の文字セットを使用し、ホスト名のASCII文字に関する制限(RFC 3490、RFC 1122、RFC 1123を参照)を強制的に適用するか、かわりにSNIHostName(String)を使用してく� さい。

encoded引数が不正になるのは次の� �合です。

• encodedが空である。
• encodedがドットで終わっている。
• encodedがStandardCharsets.US_ASCIIまたはStandardCharsets.UTF_8に準� した文字セットでエンコードされていない。
• encodedが、RFC 3490仕様に準� した有効な国際化ドメイン名(IDN)でない。

以降の変更から保護するために、encodedバイト配列のクローンが作成されます。

パラメータ:

encoded - このサーバー名のエンコードされたホスト名

スロー:

NullPointerException - encodedがnullの� �合

IllegalArgumentException - encodedが不正である� �合

外部仕様

• RFC 1122: インターネット・ホストの要件 - 通信レイヤー
• RFC 1123: インターネット・ホストの要件 - アプリケーションとサポート
• RFC 3490: アプリケーションでのドメイン名の国際化 (IDNA)
• RFC 4366: トランスポート層セキュリティ(TLS)拡張機能
• RFC 6066: トランスポート層セキュリティ(TLS)拡張機能: 拡張定義

メソッドの詳細

getAsciiName

public String getAsciiName()

このSNIHostNameオブジェクトのStandardCharsets.US_ASCII準� のホスト名を返します。

RFC 6066によれば、返されるホスト名は、A-labelを含む国際化ドメイン名である可能性があります。 A-labelの仕様の詳細は、RFC 5890を参照してく� さい。

戻り値:

このSNIHostNameオブジェクトのStandardCharsets.US_ASCII準� のホスト名

外部仕様

• RFC 5890: アプリケーションの国際化ドメイン名 (IDNA): 定義とドキュメント・フレー� ワーク
• RFC 6066: トランスポート層セキュリティ(TLS)拡張機能: 拡張定義

equals

public boolean equals(Object other)

このサーバー名を指定されたオブジェクトと比較します。

RFC 6066によれば、DNSホスト名では大文字と小文字は区別されません。 2つのサーバー・ホスト名が等しくなるのは、両者の名前タイプが同じであり、かつ大文字と小文字を区別せずに比較してホスト名が等しくなる� �合のみです。

オーバーライド:

equals、クラスSNIServerName

パラメータ:

other - 比較する他のサーバー名オブジェクト。

戻り値:

otherがこのインスタンスと等しいとみなされた� �合にのみtrue

外部仕様

• RFC 6066: トランスポート層セキュリティ(TLS)拡張機能: 拡張定義

関連� �目:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

このSNIHostNameのハッシュ・コード値を返します。

ハッシュ・コード値は、このSNIHostNameのホスト名(大文字と小文字を区別しない)を使用して生成されます。

オーバーライド:

hashCode、クラスSNIServerName

戻り値:

このSNIHostNameのハッシュ・コード値。

関連� �目:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

toString

public String toString()

このオブジェクトの文字列表現(このSNIHostNameオブジェクトのDNSホスト名を含む)を返します。

この表現の厳密な詳細は未指定であり変更される可能性がありますが、典型的な表現は次のようになります。

     "type=host_name (0), value=<hostname>"
 

"<hostname>"は、Aラベルを含むホスト名のASCII表現です。 たとえば、擬似ホスト名の戻り値は次のようになります:

     "type=host_name (0), value=www.example.com"
 

or

     "type=host_name (0), value=xn--fsqu00a.xn--0zwm56d"
 

この表現の厳密な詳細は未指定であり、変更される可能性があります。

オーバーライド:

toString、クラスSNIServerName

戻り値:

このオブジェクトの文字列表現

createSNIMatcher

public static SNIMatcher createSNIMatcher(String regex)

SNIHostNameのSNIMatcherオブジェクトを作成します。

サーバーはこのメソッドを使用することで、受入れ可能なSNIHostNameを検証できます。 たとえば、

     SNIMatcher matcher =
         SNIHostName.createSNIMatcher("www\\.example\\.com");
 

この� �合、ホスト名「www.example.com」が受け入れられます。

     SNIMatcher matcher =
         SNIHostName.createSNIMatcher("www\\.example\\.(com|org)");
 

この� �合、ホスト名「www.example.com」と「www.example.org」が受け入れられます。

パラメータ:

regex - 一致させるthehostname(s)を表す「正規表現パターン」

戻り値:

SNIHostNameのSNIMatcherオブジェクト

スロー:

NullPointerException - regexがnullである� �合

PatternSyntaxException - 正規表現の構文が無効な� �合