JavaTM 2 Platform
Standard Ed. 5.0

java.net
クラス Inet6Address

java.lang.Object
  上位を拡張 java.net.InetAddress
      上位を拡張 java.net.Inet6Address
すべての実装されたインタフェース:
Serializable

public final class Inet6Address
extends InetAddress

このクラスは Internet Protocol バージョン 6 (IPv6) アドレスを表します。定義については、「RFC 2373: IP Version 6 Addressing Architecture」を参照してください。

IP アドレスのテキスト表現

メソッドの入力として使用される Ipv6 アドレスのテキスト表現は、次のいずれかの形式になります。
  1. 推奨される形式は x:x:x:x:x:x:x:x です。ここで、x は 8 つの 16 ビットアドレスの 16 進数値です。これが完全な形式です。次に例を示します。

    1080:0:0:0:8:800:200C:417A

    個々のフィールドのゼロ埋め込みは必要ありません。ただし、次に説明する場合を除いて、各フィールドには少なくとも 1 つの数値が必要です。

  2. 特定のスタイルの IPv6 アドレスを割り当てる一部のメソッドのために、0 ビットの長い文字列を含むアドレスが一般的です。0 ビットを含むアドレスの書き込みを簡単にするために、特別な構文を使用して 0 を圧縮できます。「::」の使用は、複数のグループの 16 ビットの 0 を示します。「::」はアドレス内に 1 度だけ使用できます。また、「::」を使用して、アドレス内の先頭または末尾の 0 を圧縮することもできます。次に例を示します。

    1080::8:800:200C:417A
  3. IPv4 および IPv6 ノードが混在する環境に対応する場合にさらに便利な代替形式が x:x:x:x:x:x:d.d.d.d です。ここで、x は上位 6 つの 16 ビットアドレスの 16 進数値で、d は下位 4 つの 8 ビット標準 IPv4 表現アドレスの十進数値です。次に例を示します。

    ::FFFF:129.144.52.38
    ::129.144.52.38

    「::FFFF:d.d.d.d」と「::d.d.d.d」は、それぞれ IPv4 マップの IPv6 アドレスと IPv4 互換 IPv6 アドレスの一般的な形式です。IPv4 部分は「d.d.d.d」形式でなければなりません。次の形式は無効です。

    ::FFFF:d.d.d
    ::FFFF:d.d
    ::d.d.d
    ::d.d

    次の形式は有効です。

    ::FFFF:d

    ただし、これは IPv4 互換の IPv6 アドレス (下記) の規則に従っていない表現です。

    ::255.255.0.d

    ここで、「::d」は一般的な IPv6 アドレス「0:0:0:0:0:0:0:d」に対応します。

テキスト表現を出力値として返すメソッドの場合は、完全な形式が使用されます。Inet6Addres は、ほかのテキストデータと組み合わせて使用すると明確なので、完全な形式を返します。

特殊な IPv6 アドレス

IPv4 マップのアドレス ::ffff:w.x.y.z という形式の IPv6 アドレスは、IPv4 アドレスを表すのに使用されます。このアドレスにより、IPv4 と IPv6 の両方のノードと通信するときに、ネイティブプログラムは同じアドレスデータ構造を使用することができ、同じソケットを使用することもできます。

InetAddress と Inet6Address では、このアドレスは内部表現に使用され、機能上の役割はありません。Java は IPv4 マップのアドレスを返しません。これらのクラスは、IPv4 マップのアドレスをバイト配列とテキスト表現の両方で入力として使用できます。ただし、IPv4 マップのアドレスは IPv4 アドレスに変換されます。

IPv6 スコープアドレスのテキスト表現

IPv6 アドレスのテキスト表現を上記のように拡張して、IPv6 スコープアドレスを指定できます。このような基本アドレス指定アーキテクチャの拡張については、「draft-ietf-ipngwg-scoping-arch-04.txt」を参照してください。

リンクローカルのアドレスやサイトローカルのアドレスは非グローバルです。このため、複数のホストが同じ宛先アドレスを共有し、その結果、これらのホストに同じ送信元システム上の複数のインタフェースを介して到達できる可能性があります。この場合、送信元システムは同じスコープの複数のゾーンに接続されていることになります。どれが目的のゾーンであるか明確にするため、IPv6 アドレスにゾーン識別子 (scope_id) を追加できます。

scope_id は、通常、次のように指定します。

IPv6-address%scope_id

IPv6 アドレスは、上記の説明のように、リテラル IPv6 アドレスです。scope_id は、ローカルシステム上のインタフェースを参照します。次の 2 通りの方法で指定できます。

  1. 数値識別子として指定。システムによって認識される特定のインタフェースおよびスコープを識別する正の整数。通常、この数値は、システム上の管理ツールによって判定可能。単一のインタフェースが複数の値 (スコープごとに 1 つずつ) を持つことができる。スコープが指定されていない場合は、デフォルト値 0 が使用される
  2. 文字列として指定。該当するインタフェースの NetworkInterface.getName() によって返される文字列。この方法で Inet6Address を作成する場合、数値の scope-id は、オブジェクトの作成時に、関連する NetworkInterface を照会することによって判定される

数値の scope_id は、NetworkInterface クラスから返される Inet6Address インスタンスから取得することもできます。これを使って、システム上で設定されている現在のスコープ ID を確認できます。

関連項目:
直列化された形式

メソッドの概要
 boolean equals(Object obj)
          このオブジェクトと指定されたオブジェクトとを比較します。
 byte[] getAddress()
          この InetAddress オブジェクトの IP アドレスをそのまま返します。
static Inet6Address getByAddress(String host, byte[] addr, int scope_id)
          InetAddress.getByAddress(String,byte[]) と同様にして Inet6Address を作成します。
static Inet6Address getByAddress(String host, byte[] addr, NetworkInterface nif)
          InetAddress.getByAddress(String,byte[]) と同様にして Inet6Address を作成します。
 String getHostAddress()
          IP アドレスのテキスト表現を返します。
 NetworkInterface getScopedInterface()
          このインスタンスがスコープインタフェースで作成された場合、このスコープインタフェースを返します。
 int getScopeId()
          このインスタンスにインタフェースが関連付けられている場合、数値の scopeId を返します。
 int hashCode()
          この IP アドレスのハッシュコードを返します。
 boolean isAnyLocalAddress()
          InetAddress がワイルドカードアドレスかどうかを調べるユーティリティルーチンです。
 boolean isIPv4CompatibleAddress()
          InetAddress が IPv4 互換の IPv6 アドレスかどうかを調べるユーティリティルーチンです。
 boolean isLinkLocalAddress()
          InetAddress がリンクローカルアドレスかどうかを調べるユーティリティルーチンです。
 boolean isLoopbackAddress()
          InetAddress がループバックアドレスかどうかを調べるユーティリティルーチンです。
 boolean isMCGlobal()
          マルチキャストアドレスにグローバルスコープがあるかどうかを調べるユーティリティルーチンです。
 boolean isMCLinkLocal()
          マルチキャストアドレスにリンクスコープがあるかどうかを調べるユーティリティルーチンです。
 boolean isMCNodeLocal()
          マルチキャストアドレスにノードスコープがあるかどうかを調べるユーティリティルーチンです。
 boolean isMCOrgLocal()
          マルチキャストアドレスに組織スコープがあるかどうかを調べるユーティリティルーチンです。
 boolean isMCSiteLocal()
          マルチキャストアドレスにサイトスコープがあるかどうかを調べるユーティリティルーチンです。
 boolean isMulticastAddress()
          InetAddress が IP マルチキャストアドレスかどうかを調べるユーティリティルーチンです。
 boolean isSiteLocalAddress()
          InetAddress がサイトローカルアドレスかどうかを調べるユーティリティルーチンです。
 
クラス java.net.InetAddress から継承されたメソッド
getAllByName, getByAddress, getByAddress, getByName, getCanonicalHostName, getHostName, getLocalHost, isReachable, isReachable, toString
 
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

メソッドの詳細

getByAddress

public static Inet6Address getByAddress(String host,
                                        byte[] addr,
                                        NetworkInterface nif)
                                 throws UnknownHostException
InetAddress.getByAddress(String,byte[]) と同様にして Inet6Address を作成します。ただし、IPv6 の scope_id には、addr に指定されたアドレス型のインタフェースに対応する値を設定します。このインタフェースに、指定のアドレス型 (リンクローカルまたはサイトローカル) の数値の scope_id が割り当てられていない場合、呼び出しは失敗し、UnkinownHostException が発生します。IPv6 スコープアドレスの説明は、ここにあります。

パラメータ:
host - 指定されたホスト
addr - ネットワークバイト順序の IP アドレス
nif - このアドレスに関連付ける必要があるインタフェース
戻り値:
IP アドレスから作成された Inet6Address オブジェクト
例外:
UnknownHostException - IP アドレスの長さが不正な場合、またはインタフェースに指定のアドレス型の数値の scope_id が割り当てられていない場合
導入されたバージョン:
1.5

getByAddress

public static Inet6Address getByAddress(String host,
                                        byte[] addr,
                                        int scope_id)
                                 throws UnknownHostException
InetAddress.getByAddress(String,byte[]) と同様にして Inet6Address を作成します。ただし、IPv6 scope_id には指定の数値を設定します。scope_id がシステム上のインタフェースに対応しているかどうかはチェックされません。IPv6 スコープアドレスの説明は、ここにあります。

パラメータ:
host - 指定されたホスト
addr - ネットワークバイト順序の IP アドレス
scope_id - アドレスの数値の scope_id
戻り値:
IP アドレスから作成された Inet6Address オブジェクト
例外:
UnknownHostException - IP アドレスの長さが不正の場合
導入されたバージョン:
1.5

isMulticastAddress

public boolean isMulticastAddress()
InetAddress が IP マルチキャストアドレスかどうかを調べるユーティリティルーチンです。アドレス開始点の 11111111 によって、アドレスがマルチキャストアドレスであることが識別されます。

オーバーライド:
クラス InetAddress 内の isMulticastAddress
戻り値:
InetAddress が IP マルチキャストアドレスかどうかを示す boolean
導入されたバージョン:
JDK1.1

isAnyLocalAddress

public boolean isAnyLocalAddress()
InetAddress がワイルドカードアドレスかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isAnyLocalAddress
戻り値:
InetAddress がワイルドカードアドレスかどうかを示す boolean
導入されたバージョン:
1.4

isLoopbackAddress

public boolean isLoopbackAddress()
InetAddress がループバックアドレスかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isLoopbackAddress
戻り値:
InetAddress がループバックアドレスかどうかを示す boolean。ループバックアドレスでない場合は false
導入されたバージョン:
1.4

isLinkLocalAddress

public boolean isLinkLocalAddress()
InetAddress がリンクローカルアドレスかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isLinkLocalAddress
戻り値:
InetAddress がリンクローカルアドレスかどうかを示す boolean。アドレスがリンクローカルユニキャストアドレスでない場合は false
導入されたバージョン:
1.4

isSiteLocalAddress

public boolean isSiteLocalAddress()
InetAddress がサイトローカルアドレスかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isSiteLocalAddress
戻り値:
InetAddress がサイトローカルアドレスかどうかを示す boolean。アドレスがサイトローカルユニキャストアドレスでない場合は false
導入されたバージョン:
1.4

isMCGlobal

public boolean isMCGlobal()
マルチキャストアドレスにグローバルスコープがあるかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isMCGlobal
戻り値:
アドレスがグローバルスコープのマルチキャストアドレスであるかどうかを示す boolean。アドレスがグローバルスコープでない場合、あるいはマルチキャストアドレスでない場合は false
導入されたバージョン:
1.4

isMCNodeLocal

public boolean isMCNodeLocal()
マルチキャストアドレスにノードスコープがあるかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isMCNodeLocal
戻り値:
アドレスがノードローカルスコープのマルチキャストアドレスであるかどうかを示す boolean。アドレスがノードローカルスコープでない場合、あるいはマルチキャストアドレスでない場合は false
導入されたバージョン:
1.4

isMCLinkLocal

public boolean isMCLinkLocal()
マルチキャストアドレスにリンクスコープがあるかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isMCLinkLocal
戻り値:
アドレスがリンクローカルスコープのマルチキャストアドレスであるかどうかを示す boolean。アドレスがリンクローカルスコープでない場合、あるいはマルチキャストアドレスでない場合は false
導入されたバージョン:
1.4

isMCSiteLocal

public boolean isMCSiteLocal()
マルチキャストアドレスにサイトスコープがあるかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isMCSiteLocal
戻り値:
アドレスがサイトローカルスコープのマルチキャストアドレスであるかどうかを示す boolean。アドレスがサイトローカルスコープでない場合、あるいはマルチキャストアドレスでない場合は false
導入されたバージョン:
1.4

isMCOrgLocal

public boolean isMCOrgLocal()
マルチキャストアドレスに組織スコープがあるかどうかを調べるユーティリティルーチンです。

オーバーライド:
クラス InetAddress 内の isMCOrgLocal
戻り値:
アドレスが組織ローカルスコープのマルチキャストアドレスであるかどうかを示す boolean。アドレスが組織ローカルスコープでない場合、あるいはマルチキャストアドレスでない場合は false
導入されたバージョン:
1.4

getAddress

public byte[] getAddress()
この InetAddress オブジェクトの IP アドレスをそのまま返します。結果は、ネットワークバイト順序に従って返されます。アドレスの最上位バイトが getAddress()[0] になります。

オーバーライド:
クラス InetAddress 内の getAddress
戻り値:
このオブジェクトの IP アドレス

getScopeId

public int getScopeId()
このインスタンスにインタフェースが関連付けられている場合、数値の scopeId を返します。scoped_id が設定されていない場合、戻り値はゼロです。

戻り値:
scopeId。設定されていない場合はゼロ
導入されたバージョン:
1.5

getScopedInterface

public NetworkInterface getScopedInterface()
このインスタンスがスコープインタフェースで作成された場合、このスコープインタフェースを返します。

戻り値:
スコープインタフェース。設定されていない場合は null
導入されたバージョン:
1.5

getHostAddress

public String getHostAddress()
IP アドレスのテキスト表現を返します。インスタンスがスコープ識別子を指定することによって作成された場合、IP アドレスの末尾に、「%」に続いてスコープ ID が追加されます。このスコープ ID は、インスタンスの作成時に使用された数値または文字列になります。

オーバーライド:
クラス InetAddress 内の getHostAddress
戻り値:
IP アドレスの文字列形式

hashCode

public int hashCode()
この IP アドレスのハッシュコードを返します。

オーバーライド:
クラス InetAddress 内の hashCode
戻り値:
この IP アドレスのハッシュコード値
関連項目:
Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)
このオブジェクトと指定されたオブジェクトとを比較します。引数が null ではなく、このオブジェクトと同じ IP アドレスを表すオブジェクトの場合にだけ、結果が true になります。

getAddress によって返されるバイト配列の長さが同じであり、バイト配列の各要素が同じである場合、2 つの InetAddress のインスタンスは同じ IP アドレスを表しています。

オーバーライド:
クラス InetAddress 内の equals
パラメータ:
obj - 比較対象のオブジェクト
戻り値:
オブジェクトが同じである場合は true、そうでない場合は false
関連項目:
InetAddress.getAddress()

isIPv4CompatibleAddress

public boolean isIPv4CompatibleAddress()
InetAddress が IPv4 互換の IPv6 アドレスかどうかを調べるユーティリティルーチンです。

戻り値:
InetAddress が IPv4 互換の IPv6 アドレスであるかどうかを示す boolean。アドレスが IPv4 アドレスの場合は false
導入されたバージョン:
1.4

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。