public interface InetAddressResolver
このインタフェースは、ホスト名およびIPアドレスを検索するための操作を定義します。
InetAddressは、すべてのルックアップ操作を「システム全体のリゾルバ」に委任します。
「システム全体のリゾルバ」は、InetAddressResolverProviderの「実装のデプロイ」でカスタマイズできます。
- 導入されたバージョン:
- 18
-
ネストされたクラスのサマリー
ネストされたクラス修飾子と型インタフェース説明static final classLookupPolicyオブジェクトは、ルックアップ操作に適用できる特性を表します。 -
メソッドのサマリー
修飾子と型メソッド説明lookupByAddress(byte[] addr) 指定されたraw IPアドレスに対応するホスト名をルックアップします。lookupByName(String host, InetAddressResolver.LookupPolicy lookupPolicy) ホストの名前を指定すると、指定されたホスト名に関連付けられたリクエストされたアドレス・ファミリのIPアドレスのストリームを返します。
-
メソッドの詳細
-
lookupByName
Stream<InetAddress> lookupByName(String host, InetAddressResolver.LookupPolicy lookupPolicy) throws UnknownHostException ホストの名前を指定すると、指定されたホスト名に関連付けられたリクエストされたアドレス・ファミリのIPアドレスのストリームを返します。hostは、IPアドレスのテキスト表現ではなく、"www.example.com"などのマシン名である必要があります。 指定されたhost名に対して検証は実行されません: テキスト表現が指定されている場合、名前解決が失敗し、UnknownHostExceptionがスローされる可能性があります。アドレス・ファミリのタイプとアドレスの順序は、
LookupPolicyインスタンスによって指定されます。 ルックアップ操作の特性は、InetAddressResolver.LookupPolicy.characteristics()で取得できます。InetAddressResolver.LookupPolicy.IPV4およびInetAddressResolver.LookupPolicy.IPV6特性が指定されている場合、このメソッドはIPV4およびIPV6ファミリの両方のアドレスを返します。- パラメータ:
host- 指定されたホスト名lookupPolicy- アドレス・ルック・アップ・ポリシー- 戻り値:
- リクエストされたホストのIPアドレスのストリーム
- 例外:
NullPointerException- いずれかのパラメータがnullの場合UnknownHostException-hostのIPアドレスが見つからない場合- 関連項目:
-
lookupByAddress
指定されたraw IPアドレスに対応するホスト名をルックアップします。addr引数はネットワーク・バイト順です: アドレスの最大順序バイトはaddr[0]です。IPv4アドレスのバイト配列は4バイト長、IPv6のバイト配列は16バイト長である必要があります。
- パラメータ:
addr- raw IPアドレスを表すバイト配列- 戻り値:
- ホスト名マッピングを表す
String - 例外:
UnknownHostException- 指定されたIPアドレスのホスト名が見つからない場合IllegalArgumentException- 指定されたバイト配列の長さが有効なIPアドレス長と一致しない場合NullPointerException- addrがnullの場合
-