java.net.InetAddress
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Object
public class InetAddress
IP (Internet Protocol) アドレスを表すクラスです。
IP アドレスは、IP によって使用される 32 ビットまたは 128 ビットの符号なしの数値です。IP は、UDP や TCP などのプロトコルの構築基盤となる下位レベルのプロトコルです。IP アドレスのアーキテクチャーについては、「RFC 790: Assigned Numbers」、「RFC 1918: Address Allocation for Private Internets」、「RFC 2365: Administratively Scoped IP Multicast」、および「RFC 2373: IP Version 6 Addressing Architecture」で定義されています。InetAddress のインスタンスは、IP アドレスと、場合によってはそれに対応するホスト名から構成されます。ホスト名が含まれるかどうかは、そのインスタンスがホスト名を使って構築されているかどうか、またはそのインスタンスがホスト名の逆解決をすでに実行したかどうかによって決まります。
ユニキャスト 単一インタフェースの識別子。ユニキャストアドレスに送信されたパケットは、そのアドレスによって識別されるインタフェースに配信されます。 未指定のアドレス -- 任意ローカルアドレスまたはワイルドカードアドレスとも呼ばれます。これはどのノードにも割り当てないでください。これはアドレスがないことを示します。このアドレスを使った例としてバインドの対象があります。これを使うと、あるサーバーホストに複数のインタフェースがある場合に、そのサーバーが任意のインタフェース上でクライアントの接続を受け入れることができます。
「未指定」のアドレスは、IP パケットの転送先アドレスとして使用してはいけません。
「ループバック」アドレス -- これはループバックインタフェースに割り当てられるアドレスです。この IP アドレスに送信された内容はすべてループして元に戻され、ローカルホストの IP 入力となります。このアドレスは、クライアントのテスト時によく使用されます。
マルチキャスト 一連のインタフェース (通常は別のノードに属している) の識別子。マルチキャストアドレスに送信されたパケットは、そのアドレスによって識別されるすべてのインタフェースに配信されます。
「リンクローカル」アドレスは、自動アドレス構成、隣接アドレスの発見などを目的として、あるいはルーターが存在しない場合に、単一リンクのアドレス指定に使うために設計されています。
「サイトローカル」アドレスは、グローバル接頭辞を必要としないサイト内のアドレス指定に使うために設計されています。
「グローバル」アドレスは、インターネット全体で一意です。
IPv4 のアドレス形式については、「Inet4Address」を参照してください。IPv6 のアドレス形式については、「Inet6Address」を参照してください。
「逆名前解決」では、任意の IP アドレスについて、その IP アドレスに関連するホスト名が返されます。
InetAddress クラスは、ホスト名からその IP アドレスへの解決、およびその逆の解決のメソッドを提供します。
デフォルトでは、セキュリティーマネージャーがインストールされている場合は、DNS なりすまし攻撃から身を守るため、成功したホスト名解決の結果が永続的にキャッシュされます。セキュリティーマネージャーがインストールされていない場合のデフォルト動作では、ある限られた期間 (実装に依存する) だけエントリがキャッシュされます。失敗したホスト名解決の結果は、パフォーマンスの向上のために短時間 (10 秒) だけキャッシュされます。
デフォルト動作が要求に合わない場合は、ポジティブキャッシュ用の Java セキュリティープロパティーを異なる有効期間 (TTL) 値に設定することができます。同様に、システム管理者は、異なるネガティブキャッシュ TTL 値を必要に応じて設定することができます。
2 つの Java セキュリティープロパティーにより、ポジティブおよびネガティブのホスト名解決のキャッシュに使用する TTL 値を制御します。
- networkaddress.cache.ttl
- ネームサービスによる成功した名前検索に対するキャッシングポリシーを示します。指定する値は、成功した検索結果をキャッシュする秒数を示す整数です。デフォルト設定は、実装に固有の期間キャッシュすることです。
-1 の値は、「ずっとキャッシュする」という意味です。
- networkaddress.cache.negative.ttl (デフォルト: 10)
- ネームサービスによる失敗した名前検索に対するキャッシングポリシーを示します。指定する値は、失敗した検索結果をキャッシュする秒数を示す整数です。
0 の値は、「キャッシュしない」という意味です。-1 の値は、「ずっとキャッシュする」という意味です。
getByAddress(byte[]),
getByAddress(java.lang.String, byte[]),
getAllByName(java.lang.String),
getByName(java.lang.String),
getLocalHost(),
直列化された形式| メソッドの概要 | |
|---|---|
boolean |
equals(Object obj)
オブジェクトと指定されたオブジェクトを比較します。 |
byte[] |
getAddress()
この InetAddress オブジェクトの生の IP アドレスを返します。 |
static InetAddress[] |
getAllByName(String host)
ホスト名を指定すると、システムに設定されているネームサービスに基づいてその IP アドレスの配列を返します。 |
static InetAddress |
getByAddress(byte[] addr)
指定された生の IP アドレスを表す InetAddress オブジェクトを返します。 |
static InetAddress |
getByAddress(String host,
byte[] addr)
指定されたホスト名および IP アドレスに基づいて InetAddress を作成します。 |
static InetAddress |
getByName(String host)
指定されたホスト名を持つホストの IP アドレスを取得します。 |
String |
getCanonicalHostName()
この IP アドレスに対応する完全修飾ドメイン名を取得します。 |
String |
getHostAddress()
テキスト表現の IP アドレス文字列を返します。 |
String |
getHostName()
この IP アドレスに対応するホスト名を取得します。 |
static InetAddress |
getLocalHost()
ローカルホストを返します。 |
int |
hashCode()
この IP アドレスのハッシュコードを返します。 |
boolean |
isAnyLocalAddress()
InetAddress がワイルドカードアドレスかどうかを調べるユーティリティールーチンです。 |
boolean |
isLinkLocalAddress()
InetAddress がリンクローカルアドレスかどうかを調べるユーティリティールーチンです。 |
boolean |
isLoopbackAddress()
InetAddress がループバックアドレスかどうかを調べるユーティリティールーチンです。 |
boolean |
isMCGlobal()
マルチキャストアドレスにグローバルスコープがあるかどうかを調べるユーティリティールーチンです。 |
boolean |
isMCLinkLocal()
マルチキャストアドレスにリンクスコープがあるかどうかを調べるユーティリティールーチンです。 |
boolean |
isMCNodeLocal()
マルチキャストアドレスにノードスコープがあるかどうかを調べるユーティリティールーチンです。 |
boolean |
isMCOrgLocal()
マルチキャストアドレスに組織スコープがあるかどうかを調べるユーティリティールーチンです。 |
boolean |
isMCSiteLocal()
マルチキャストアドレスにサイトスコープがあるかどうかを調べるユーティリティールーチンです。 |
boolean |
isMulticastAddress()
InetAddress が IP マルチキャストアドレスかどうかを調べるユーティリティールーチンです。 |
boolean |
isReachable(int timeout)
そのアドレスに到達可能かどうかをテストします。 |
boolean |
isReachable(NetworkInterface netif,
int ttl,
int timeout)
そのアドレスに到達可能かどうかをテストします。 |
boolean |
isSiteLocalAddress()
InetAddress がサイトローカルアドレスかどうかを調べるユーティリティールーチンです。 |
String |
toString()
この IP アドレスを String に変換します。 |
| クラス java.lang.Object から継承されたメソッド |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| メソッドの詳細 |
|---|
public boolean isMulticastAddress()
booleanpublic boolean isAnyLocalAddress()
booleanpublic boolean isLoopbackAddress()
boolean。ループバックアドレスでない場合は falsepublic boolean isLinkLocalAddress()
boolean。アドレスがリンクローカルユニキャストアドレスでない場合は falsepublic boolean isSiteLocalAddress()
boolean。アドレスがサイトローカルユニキャストアドレスでない場合は falsepublic boolean isMCGlobal()
boolean。それがグローバルスコープのアドレスでないかマルチキャストアドレスでない場合は falsepublic boolean isMCNodeLocal()
boolean。それがノードローカルスコープのアドレスでないかマルチキャストアドレスでない場合は falsepublic boolean isMCLinkLocal()
boolean。それがリンクローカルスコープのアドレスでないかマルチキャストアドレスでない場合は falsepublic boolean isMCSiteLocal()
boolean。それがサイトローカルスコープのアドレスでないかマルチキャストアドレスでない場合は falsepublic boolean isMCOrgLocal()
boolean。それが組織ローカルスコープのアドレスでないかマルチキャストアドレスでない場合は false
public boolean isReachable(int timeout)
throws IOException
タイムアウト値 (ミリ秒) は、この試行の最大所要時間を示します。応答が得られる前に操作がタイムアウトした場合、そのホストは到達不可能とみなされます。値が負の場合、IllegalArgumentException がスローされます。
timeout - 呼び出しが中止されるまでのミリ秒単位の時間
boolean
IOException - ネットワークエラーが発生した場合
IllegalArgumentException - timeout が負の場合
public boolean isReachable(NetworkInterface netif,
int ttl,
int timeout)
throws IOException
ネットワークインタフェースパラメータと ttl パラメータを使えば、呼び出し元は、テストの実行経路となるネットワークインタフェースと、パケットの最大ホップ数を指定できます。ttl の値が負の場合、IllegalArgumentException がスローされます。
タイムアウト値 (ミリ秒) は、この試行の最大所要時間を示します。応答が得られる前に操作がタイムアウトした場合、そのホストは到達不可能とみなされます。値が負の場合、IllegalArgumentException がスローされます。
netif - テストの実行経路となる NetworkInterface。どのインタフェースでもかまわない場合は nullttl - 試みるべきホップの最大数。デフォルトは 0timeout - 呼び出しが中止されるまでのミリ秒単位の時間
boolean
IllegalArgumentException - timeout または ttl が負の場合
IOException - ネットワークエラーが発生した場合public String getHostName()
この InetAddress がホスト名を指定して作成されたものである場合は、記憶されているそのホスト名が返されます。そうでない場合は、システムで設定された名前検索サービスに基づいて逆名前検索が実行され、その結果が返されます。ネームサービスの検索が必要になった場合は、getCanonicalHostName を呼び出します。
セキュリティーマネージャーが存在する場合、最初にセキュリティーマネージャーの checkConnect メソッドが、引数としてホスト名と -1 を指定して呼び出され、この操作が許可されていることを確認します。操作が許可されていない場合、IP アドレスのテキスト表現を返します。
getCanonicalHostName(),
SecurityManager.checkConnect(java.lang.String, int)public String getCanonicalHostName()
セキュリティーマネージャーが存在する場合、このメソッドはまず、ホスト名と -1 を引数に指定してその checkConnect メソッドを呼び出し、呼び出し元のコードがこの IP アドレスのホスト名を知ること (つまり、そのホストに接続すること) を許可されているかどうかを確認します。操作が許可されていない場合、IP アドレスのテキスト表現を返します。
SecurityManager.checkConnect(java.lang.String, int)public byte[] getAddress()
InetAddress オブジェクトの生の IP アドレスを返します。その結果はネットワークバイト順序になります。アドレスの最上位順序バイトは getAddress()[0] 内に存在します。
public String getHostAddress()
public int hashCode()
Object 内の hashCodeObject.equals(java.lang.Object),
Hashtablepublic boolean equals(Object obj)
null ではなく、その引数がこのオブジェクトと同じ IP アドレスを表す場合にだけ、結果が true になります。
getAddress によって返されるバイト配列の長さが同じであり、バイト配列の各要素が同じである場合、2 つの InetAddress のインスタンスは同じ IP アドレスを表しています。
Object 内の equalsobj - 比較対象のオブジェクト
true、
そうでない場合は falsegetAddress()public String toString()
String に変換します。返される文字列の形式は、「ホスト名 / リテラル IP アドレス」になります。
ホスト名が未解決の場合、逆ネームサービス検索は実行されません。ホスト名の部分は空の文字列で表現されます。
Object 内の toString
public static InetAddress getByAddress(String host,
byte[] addr)
throws UnknownHostException
ホスト名は、「java.sun.com」などのマシン名か、またはその IP アドレスのテキスト表現です。
ホスト名の有効性チェックも一切実行されません。
addr に IPv4 アドレスを指定すると、Inet4Address のインスタンスが返されます。そうでない場合は、Inet6Address のインスタンスが返されます。
IPv4 アドレスのバイト配列は 4 バイト長、IPv6 のバイト配列は 16 バイト長でなければなりません。
host - 指定されたホストaddr - ネットワークバイト順序の IP アドレス
UnknownHostException - IP アドレスの長さが不正の場合
public static InetAddress getByName(String host)
throws UnknownHostException
ホスト名は、「java.sun.com」などのマシン名か、またはその IP アドレスのテキスト表現です。リテラル IP アドレスが指定された場合、アドレス形式の有効性のみがチェックされます。
リテラル IPv6 アドレスで指定される host については、RFC 2732 で定義されている形式か、RFC 2373 で定義されているリテラル IPv6 アドレス形式が可能です。IPv6 スコープアドレスもサポートされています。IPv6 スコープアドレスについては、ここを参照してください。
host が null の場合、ループバックインタフェースのアドレスを表す InetAddress が返されます。RFC 3330 のセクション 2 および RFC 2373 のセクション 2.5.3 を参照してください。
host - 指定されたホストまたは null
UnknownHostException - host の IP アドレスが見つからなかった場合、またはグローバル IPv6 アドレスでスコープ ID が指定された場合
SecurityException - セキュリティーマネージャーが存在し、その checkConnect メソッドがこの操作を許可しない場合
public static InetAddress[] getAllByName(String host)
throws UnknownHostException
ホスト名は、「java.sun.com」などのマシン名か、またはその IP アドレスのテキスト表現です。リテラル IP アドレスが指定された場合、アドレス形式の有効性のみがチェックされます。
リテラル IPv6 アドレスで指定される host については、RFC 2732 で定義されている形式か、RFC 2373 で定義されているリテラル IPv6 アドレス形式が可能です。リテラル IPv6 アドレスは修飾することも可能です。それにはスコープゾーン識別子、つまり スコープ ID を末尾に追加します。スコープ ID の構文や使用方法については、ここを参照してください。
host が null の場合、ループバックインタフェースのアドレスを表す InetAddress が返されます。RFC 3330 のセクション 2 および RFC 2373 のセクション 2.5.3 を参照してください。
セキュリティーマネージャーが存在する場合、host が null ではなく、host.length() の値がゼロではないときは、セキュリティーマネージャーの checkConnect メソッドが、引数としてホスト名と -1 を指定して呼び出され、この操作が許可されていることを確認します。
host - ホスト名、または null
UnknownHostException - host の IP アドレスが見つからなかった場合、またはグローバル IPv6 アドレスでスコープ ID が指定された場合
SecurityException - セキュリティーマネージャーが存在し、その checkConnect メソッドがこの操作を許可しない場合SecurityManager.checkConnect(java.lang.String, int)
public static InetAddress getByAddress(byte[] addr)
throws UnknownHostException
InetAddress オブジェクトを返します。引数はネットワークバイト順序になります。アドレスの最上位順序バイトは getAddress()[0] 内に存在します。
このメソッドはブロックしません。つまり、逆ネームサービス検索は実行されません。
IPv4 アドレスのバイト配列は 4 バイト長、IPv6 のバイト配列は 16 バイト長でなければなりません。
addr - ネットワークバイト順序の IP アドレス
UnknownHostException - IP アドレスの長さが不正の場合
public static InetAddress getLocalHost()
throws UnknownHostException
セキュリティーマネージャーが存在する場合、セキュリティーマネージャーの checkConnect メソッドが、引数としてローカルホスト名および -1 を指定して呼び出され、この操作が許可されていることを確認します。この操作が許可されない場合は、ループバックアドレスを表す InetAddress が返されます。
UnknownHostException - host の IP アドレスが見つからなかった場合SecurityManager.checkConnect(java.lang.String, int)
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。