モジュール java.base
パッケージ java.net.spi

インタフェースInetAddressResolver

public interface InetAddressResolver
このインタフェースは、ホスト名およびIPアドレスを検索するための操作を定義します。 InetAddressは、すべてのルックアップ操作を「システム全体のリゾルバ」に委任します。

「システム全体のリゾルバ」は、InetAddressResolverProviderの「実装のデプロイ」でカスタマイズできます。

導入されたバージョン:
18

  • ネストされたクラスのサマリー

    ネストされたクラス
    修飾子と型
    インタフェース
    説明
    static final class 
    InetAddressResolver.LookupPolicy
    LookupPolicyオブジェクトは、ルックアップ操作に適用できる特性を表します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    String
    lookupByAddress(byte[] addr)
    指定されたraw IPアドレスに対応するホスト名をルックアップします。
    Stream<InetAddress>
    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

      String lookupByAddress(byte[] addr) throws UnknownHostException
      指定されたraw IPアドレスに対応するホスト名をルックアップします。

      addr引数はネットワーク・バイト順です: アドレスの最大順序バイトはaddr[0]です。

      IPv4アドレスのバイト配列は4バイト長、IPv6のバイト配列は16バイト長である必要があります。

      パラメータ:
      addr - raw IPアドレスを表すバイト配列
      戻り値:
      ホスト名マッピングを表すString
      例外:
      UnknownHostException - 指定されたIPアドレスのホスト名が見つからない場合
      IllegalArgumentException - 指定されたバイト配列の長さが有効なIPアドレス長と一致しない場合
      NullPointerException - addrがnullの場合