モジュール java.base

パッケージ java.net.spi

クラスInetAddressResolver.LookupPolicy

java.lang.Object

java.net.spi.InetAddressResolver.LookupPolicy

含まれているインタフェース:

InetAddressResolver

public static final class InetAddressResolver.LookupPolicy extends Object

LookupPolicyオブジェクトは、ルックアップ操作に適用できる特性を表します。 特に、「ホスト・アドレスの検索」の場合に順序と実行するフィルタリングを指定するために使用されます。

デフォルトのプラットフォーム全体のルックアップ・ポリシーは、IPv4およびIPv6アドレスの返却方法に影響を与える「システム・プロパティ」を調べることによって構築されます。

導入されたバージョン:

18

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	IPV4	検索時にIPv4アドレスを問い合せる必要があるかどうかを示す特性値。
static final int	IPV4_FIRST	IPv4アドレスをInetAddressResolverで最初に返す必要があるかどうかを示す特性値。
static final int	IPV6	検索時にIPv6アドレスを問い合せる必要があるかどうかを示す特性値。
static final int	IPV6_FIRST	IPv6アドレスをInetAddressResolverで最初に返す必要があるかどうかを示す特性値。

メソッドのサマリー

修飾子と型	メソッド	説明
int	characteristics()	このルックアップ・ポリシーの特性セットを返します。
static InetAddressResolver.LookupPolicy	of(int characteristics)	このファクトリ・メソッドは、指定されたcharacteristics値を持つLookupPolicyインスタンスを作成します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールド詳細

IPV4

@Native public static final int IPV4

検索時にIPv4アドレスを問い合せる必要があるかどうかを示す特性値。

関連項目:

• 定数フィールド値

IPV6

@Native public static final int IPV6

検索時にIPv6アドレスを問い合せる必要があるかどうかを示す特性値。

関連項目:

• 定数フィールド値

IPV4_FIRST

@Native public static final int IPV4_FIRST

IPv4アドレスをInetAddressResolverで最初に返す必要があるかどうかを示す特性値。

関連項目:

• 定数フィールド値

IPV6_FIRST

@Native public static final int IPV6_FIRST

IPv6アドレスをInetAddressResolverで最初に返す必要があるかどうかを示す特性値。

関連項目:

• 定数フィールド値

メソッドの詳細

of

public static InetAddressResolver.LookupPolicy of(int characteristics)

このファクトリ・メソッドは、指定されたcharacteristics値を持つLookupPolicyインスタンスを作成します。

characteristics値は、フォワード・ルックアップ操作のパラメータを定義する整数ビット・マスクです。 これらのパラメータは、少なくとも次のものを定義します:

• 返されるアドレスのファミリ・タイプ
• リゾルバ実装が結果を返す順序

特定のファミリ・タイプのアドレスをリクエストするには、次のビット・マスクを組み合わせることができます:

• IPV4: IPv4アドレスをリクエスト
• IPV6: IPv6アドレスをリクエスト

IPV4もIPV6も設定されていない場合、エラーになります。

結果の特定の順序をリクエストするには:

• IPV4_FIRST: IPv6アドレスの前にIPv4アドレスを返す
• IPV6_FIRST: IPv4アドレスの前にIPv6アドレスを返す

IPV4_FIRSTもIPV6_FIRSTも設定されていない場合は、アドレスの"system"順になります。 IPV4_FIRSTとIPV6_FIRSTの両方をリクエストするとエラーになります。

パラメータ:

characteristics - ルックアップ特性のセットを表す値

戻り値:

InetAddressResolver.LookupPolicyのインスタンス

例外:

IllegalArgumentException - 不正な特性ビット・マスクが指定されている場合

関連項目:

• InetAddressResolver.lookupByName(String, LookupPolicy)

characteristics

public int characteristics()

このルックアップ・ポリシーの特性セットを返します。

戻り値:

特性値

関連項目:

• InetAddressResolver.lookupByName(String, LookupPolicy)