java.net.Inet6Address

すべての実装されたインタフェース:: Serializable

public final class Inet6Address extends InetAddress

このクラスは、インターネット・プロトコル・バージョン6 (IPv6)アドレスを表します。 RFC 2373: IP Version 6 Addressing Architectureによって規定されています。

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

メソッドの入力として使用されるIPv6アドレスのテキスト表現は、次のいずれかの形式になります。

推奨の形式はx:x:x:x:x:x:x:xです。ここで、「x」は、アドレスを8つの16ビット部分に分けて16進数で表した値です。これは完全な形式です。たとえば、
- 1080:0:0:0:8:800:200C:417A
各フィールド内の先頭部分のゼロは記述する必要がない点に注意してください。ただし、次に説明する場合を除いて、各フィールドには少なくとも1つの数値が必要です。
特定スタイルのIPv6アドレスを割り当てるためのいくつかの方式が原因となり、アドレス内にゼロ・ビットの長い列が含まれることがよくあります。ゼロ・ビットを含むアドレスを記述しやすくするため、ゼロを圧縮する特殊な構文が利用できます。「::」の使用は、ゼロだけから成る16ビットのグループが複数存在することを示します。「::」は、1つのアドレス内で1回しか使えません。また、「::」を使えば、アドレス内の先頭のゼロまたは末尾のゼロ、あるいはその両方を圧縮することもできます。たとえば、
- 1080::8:800:200C:417A
IPv4およびIPv6ノードが混在する環境に対応する場合にさらに便利な代替形式がx:x:x:x:x:x:d.d.d.dです。ここで、xは上位6つの16ビット・アドレスの16進数値で、dは下位4つの8ビット標準IPv4表現アドレスの10進数値です。たとえば、
- ::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」に対応します。

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

特殊なIPv6アドレス

IPv4マップ・アドレス

::ffff:w.x.y.zの形式では、このIPv6アドレスはIPv4アドレスを表すために使用されます。このアドレスを利用すると、ネイティブ・プログラムでは、IPv4ノードとIPv6ノードの両方と通信する際に、同じアドレス・データ構造と、さらには同じソケットを使用できます。
InetAddressとInet6Addressでは、これは内部の表現に使用され、機能上の役割はありません。 JavaからIPv4マップ・アドレスが返されることはありません。これらのクラスは、バイト配列とテキスト表現の両方で、IPv4マップ・アドレスを入力として取ることができます。ただし、そのアドレスはIPv4アドレスに変換されます。

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

前述したIPv6アドレスのテキスト表現を拡張して、IPv6スコープ・アドレスを指定できます。基本的なアドレス指定アーキテクチャに対するこの拡張については、「RFC 4007: IPv6スコープ付きアドレスのアーキテクチャ」を参照してください。

リンク・ローカル・アドレスとサイト・ローカル・アドレスはグローバルではありません。このため、複数のホストが同一の送信先アドレスを持ち、同一の送信元システム上の異なるインタフェース経由でそれらのホストに到達できる可能性があります。この場合、その送信元システムは、同一スコープの複数のゾーンに接続されています。どれが目的の送信先ゾーンであるかを明確にするために、ゾーン識別子(scope_id)をIPv6アドレスの末尾に追加することができます。

scope_idの一般的な指定形式は、次のとおりです。

IPv6-address%scope_id

IPv6-addressは、前述のリテラルIPv6アドレスです。 scope_idはローカル・システム上のあるインタフェースを参照します。これを指定するには次の2つの方法があります。

数値識別子として指定。 これは、システムが認識できる特定のインタフェースとスコープを識別する正の整数である必要があります。この数値は通常、システム上の管理ツールを使用することで決定できます。各インタフェースは、スコープごとに1つずつ、複数の値を持つことができます。スコープが未指定の場合、使用されるデフォルト値はゼロです。
文字列として指定する。 これは、対象となる特定のインタフェースに対してNetworkInterface.getName()から返された文字列と正確に一致しなければいけません。 Inet6Addressがこの方法で作成される場合は、そのオブジェクトを生成するときに関連するNetworkInterfaceに問い合わせることで、数値のスコープIDが決定されます。

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

メソッド入力としてのIPv6アドレスのテキスト表現

IPv6アドレスのテキスト表現を受け入れるInetAddressおよびInet6Addressのメソッドを使用すると、その表現を大カッコで囲むことができます。たとえば、

 // The full IPv6 form
 InetAddress.getByName("1080:0:0:0:8:800:200C:417A");   // ==> /1080:0:0:0:8:800:200c:417a
 InetAddress.getByName("[1080:0:0:0:8:800:200C:417A]"); // ==> /1080:0:0:0:8:800:200c:417a

 // IPv6 scoped address with scope-id as string
 Inet6Address.ofLiteral("fe80::1%en0");   // ==> /fe80:0:0:0:0:0:0:1%en0
 Inet6Address.ofLiteral("[fe80::1%en0]"); // ==> /fe80:0:0:0:0:0:0:1%en0

導入されたバージョン:

1.4

外部仕様

関連項目:

メソッドのサマリー

修飾子と型

メソッド

説明

boolean

equals(Object obj)

このオブジェクトと指定されたオブジェクトを比較します。

byte[]

getAddress()

このInetAddressオブジェクトの生のIPアドレスを返します。

static Inet6Address

getByAddress(String host, byte[] addr, int scope_id)

InetAddress.getByAddress(String,byte[])とまったく同様にしてInet6Addressを作成します。ただし、IPv6スコープIDが指定された数値に設定される点は異なります。

static Inet6Address

getByAddress(String host, byte[] addr, NetworkInterface nif)

InetAddress.getByAddress(String,byte[])とまったく同様にしてInet6Addressを作成します。ただし、指定されたインタフェースのaddrに指定されたアドレス・タイプに対応する値に、IPv6スコープIDが設定される点は異なります。

String

getHostAddress()

テキスト表現のIPアドレス文字列を返します。

NetworkInterface

getScopedInterface()

スコープ指定インタフェースを使用してこのインスタンスが作成された場合は、スコープ指定インタフェースを返します。

int

getScopeId()

このインスタンスがインタフェースに関連付けられている場合は、数値スコープIDを返します。

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マルチキャスト・アドレスかどうかを調べるユーティリティ・ルーチンです。アドレスの先頭が11111111になっていれば、そのアドレスはマルチキャスト・アドレスです。

boolean

isSiteLocalAddress()

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

static InetAddress

ofLiteral(String ipv6AddressLiteral)

IPv6アドレスの指定された「テキスト表現」に基づいてInetAddressを作成します。

クラスjava.net.InetAddressで宣言されたメソッド
getAllByName, getByAddress, getByAddress, getByName, getCanonicalHostName, getHostName, getLocalHost, getLoopbackAddress, 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を作成します。ただし、指定されたインタフェースのaddrに指定されたアドレス・タイプに対応する値に、IPv6スコープIDが設定される点は異なります。指定されたインタフェースに、指定されたアドレス・タイプ(例:リンク・ローカルまたはサイト・ローカル)に割り当てられた数値scope_idがない場合、この呼び出しはUnknownHostExceptionで失敗します。 IPv6スコープ・アドレスについては、ここを参照してください。
  
  パラメータ:
  
  host - 指定されたホスト
  
  addr - ネットワーク・バイト・オーダーのIPアドレス
  
  nif−このアドレスを関連付ける必要のあるインタフェース。
  
  戻り値:
  
  生のIPアドレスから生成されたInet6Addressオブジェクト。
  
  例外:
  
  UnknownHostException−IPアドレスの長さが正しくない場合、または指定されたアドレス・タイプに割り当てられた数値スコープIDがインタフェースに存在しない場合。
  
  導入されたバージョン:
  
  1.5
- getByAddress
  
  public static Inet6Address getByAddress(String host, byte[] addr, int scope_id) throws UnknownHostException
  
  InetAddress.getByAddress(String,byte[])とまったく同様にしてInet6Addressを作成します。ただし、IPv6スコープIDが指定された数値に設定される点は異なります。このスコープIDに対応するインタフェースがシステム上に存在するかどうかのチェックは行われません。 IPv6スコープ・アドレスについては、ここを参照してください。
  
  パラメータ:
  
  host - 指定されたホスト
  
  addr - ネットワーク・バイト・オーダーのIPアドレス
  
  scope_id−このアドレスに対応する数値スコープID。
  
  戻り値:
  
  生のIPアドレスから生成されたInet6Addressオブジェクト。
  
  例外:
  
  UnknownHostException - IPアドレスの長さが不正の場合。
  
  導入されたバージョン:
  
  1.5
- ofLiteral
  
  public static InetAddress ofLiteral(String ipv6AddressLiteral)
  
  IPv6アドレスの指定された「テキスト表現」に基づいてInetAddressを作成します。
  指定されたアドレス・リテラルが「有効なIPv6アドレス」を表すことができない場合は、IllegalArgumentExceptionがスローされます。 IPv6スコープのアドレス・リテラルに、システム上のどのネットワーク・インタフェースにもマップされないスコープIDが含まれている場合、またはIPv4マップのIPv6アドレス・リテラルにスコープIDが存在する場合は、IllegalArgumentExceptionもスローされます。
  このメソッドはブロックされません。つまり、逆ルックアップは実行されません。
  IPv6アドレス・リテラル・フォームは、大カッコで囲まれている場合にもサポートされます。また、指定されたリテラルが「IPv4マップされたIPv6アドレス」を表す場合、Inet4Addressのインスタンスが返されます。
  
  パラメータ:
  
  ipv6AddressLiteral - IPv6アドレスのテキスト表現。
  
  戻り値:
  
  ホスト名が設定されていないInetAddressオブジェクトで、指定されたIPv6アドレス・リテラルから構築されます。
  
  例外:
  
  IllegalArgumentException - ipv6AddressLiteralをIPv6アドレス・リテラルとして解析できない場合。
  
  NullPointerException - ipv6AddressLiteralがnullの場合。
  
  導入されたバージョン:
  
  22
- isMulticastAddress
  
  public boolean isMulticastAddress()
  
  InetAddressがIPマルチキャスト・アドレスかどうかを調べるユーティリティ・ルーチンです。アドレスの先頭が11111111になっていれば、そのアドレスはマルチキャスト・アドレスです。
  
  オーバーライド:
  
  isMulticastAddress、クラスInetAddress
  
  戻り値:
  
  InetAddressがIPマルチキャスト・アドレスかどうかを示すboolean
- isAnyLocalAddress
  
  public boolean isAnyLocalAddress()
  
  InetAddressがワイルドカード・アドレスかどうかをチェックするユーティリティ・ルーチン。
  
  オーバーライド:
  
  isAnyLocalAddress、クラスInetAddress
  
  戻り値:
  
  InetAddressがワイルドカードのアドレスかどうかを示すboolean。
- isLoopbackAddress
  
  public boolean isLoopbackAddress()
  
  InetAddressがループバック・アドレスかどうかを調べるユーティリティ・ルーチンです。
  
  オーバーライド:
  
  isLoopbackAddress、クラスInetAddress
  
  戻り値:
  
  InetAddressがループバック・アドレスかどうかを示すboolean。ループバック・アドレスでない場合はfalse。
- isLinkLocalAddress
  
  public boolean isLinkLocalAddress()
  
  InetAddressがリンク・ローカル・アドレスかどうかをチェックするユーティリティ・ルーチン。
  
  オーバーライド:
  
  isLinkLocalAddress、クラスInetAddress
  
  戻り値:
  
  InetAddressがリンク・ローカル・アドレスかどうかを示すboolean。アドレスがリンク・ローカル・ユニキャスト・アドレスでない場合はfalse。
- isSiteLocalAddress
  
  public boolean isSiteLocalAddress()
  
  InetAddressがサイト・ローカル・アドレスかどうかを調べるユーティリティ・ルーチンです。
  
  オーバーライド:
  
  isSiteLocalAddress、クラスInetAddress
  
  戻り値:
  
  InetAddressがサイト・ローカル・アドレスかどうかを示すboolean。アドレスがサイト・ローカル・ユニキャスト・アドレスでない場合はfalse。
- isMCGlobal
  
  public boolean isMCGlobal()
  
  マルチキャスト・アドレスにグローバル・スコープがあるかどうかを調べるユーティリティ・ルーチンです。
  
  オーバーライド:
  
  isMCGlobal、クラスInetAddress
  
  戻り値:
  
  アドレスがグローバル・スコープのマルチキャスト・アドレスかどうかを示すboolean。それがグローバル・スコープのアドレスでないかマルチキャスト・アドレスでない場合はfalse
- isMCNodeLocal
  
  public boolean isMCNodeLocal()
  
  マルチキャスト・アドレスにノード・スコープがあるかどうかを調べるユーティリティ・ルーチンです。
  
  オーバーライド:
  
  isMCNodeLocal、クラスInetAddress
  
  戻り値:
  
  アドレスがノード・ローカル・スコープのマルチキャスト・アドレスかどうかを示すboolean。それがノード・ローカル・スコープのアドレスでないかマルチキャスト・アドレスでない場合はfalse
- isMCLinkLocal
  
  public boolean isMCLinkLocal()
  
  マルチキャスト・アドレスにリンク・スコープがあるかどうかを調べるユーティリティ・ルーチンです。
  
  オーバーライド:
  
  isMCLinkLocal、クラスInetAddress
  
  戻り値:
  
  アドレスがリンク・ローカル・スコープのマルチキャスト・アドレスかどうかを示すboolean。それがリンク・ローカル・スコープのアドレスでないかマルチキャスト・アドレスでない場合はfalse
- isMCSiteLocal
  
  public boolean isMCSiteLocal()
  
  マルチキャスト・アドレスにサイト・スコープがあるかどうかを調べるユーティリティ・ルーチンです。
  
  オーバーライド:
  
  isMCSiteLocal、クラスInetAddress
  
  戻り値:
  
  アドレスがサイト・ローカル・スコープのマルチキャスト・アドレスかどうかを示すboolean。それがサイト・ローカル・スコープのアドレスでないかマルチキャスト・アドレスでない場合はfalse
- isMCOrgLocal
  
  public boolean isMCOrgLocal()
  
  マルチキャスト・アドレスに組織スコープがあるかどうかを調べるユーティリティ・ルーチンです。
  
  オーバーライド:
  
  isMCOrgLocal、クラスInetAddress
  
  戻り値:
  
  アドレスが組織ローカル・スコープのマルチキャスト・アドレスかどうかを示すboolean。それが組織ローカル・スコープのアドレスでないかマルチキャスト・アドレスでない場合はfalse
- getAddress
  
  public byte[] getAddress()
  
  このInetAddressオブジェクトの生のIPアドレスを返します。その結果はネットワーク・バイト順序になります。アドレスの最上位順序バイトはgetAddress()[0].内に存在します。
  
  オーバーライド:
  
  getAddress、クラスInetAddress
  
  戻り値:
  
  このオブジェクトのIPアドレス。
- getScopeId
  
  public int getScopeId()
  
  このインスタンスがインタフェースに関連付けられている場合は、数値スコープIDを返します。スコープIDが設定されていない場合、戻り値はゼロになります。
  
  戻り値:
  
  スコープID。設定されていない場合はゼロ。
  
  導入されたバージョン:
  
  1.5
- getScopedInterface
  
  public NetworkInterface getScopedInterface()
  
  スコープ指定インタフェースを使用してこのインスタンスが作成された場合は、スコープ指定インタフェースを返します。
  
  戻り値:
  
  スコープ・インタフェース。設定されていない場合はnull。
  
  導入されたバージョン:
  
  1.5
- getHostAddress
  
  public String getHostAddress()
  
  テキスト表現のIPアドレス文字列を返します。スコープ識別子を指定してインスタンスが作成された場合、そのスコープIDがIPアドレスの末尾に追加されます。その際、スコープIDの先頭に「%」(パーセント)文字が付けられます。これは数値と文字列のいずれかになりますが、どちらになるかは、インスタンスの作成時にどちらが使用されたかによって決まります。
  
  オーバーライド:
  
  getHostAddress、クラスInetAddress
  
  戻り値:
  
  IPアドレスの文字列形式。
- hashCode
  public int hashCode()
  
  このIPアドレスのハッシュ・コードを返します。
  
  オーバーライド:
  
  hashCode、クラスInetAddress
  
  戻り値:
  
  このIPアドレスのハッシュ・コード値。
  
  関連項目:
  
  Object.equals(java.lang.Object)
  
  System.identityHashCode(java.lang.Object)
- equals
  public boolean equals(Object obj)
  
  このオブジェクトと指定されたオブジェクトを比較します。引数がnullではなく、その引数がこのオブジェクトと同じIPアドレスを表す場合にだけ、結果が trueになります。
  getAddressによって返されるバイト配列の長さが同じであり、バイト配列の各コンポーネントが同じである場合、2つのInetAddressのインスタンスは同じIPアドレスを表しています。
  
  オーバーライド:
  
  equals、クラスInetAddress
  
  パラメータ:
  
  obj - 比較対象のオブジェクト。
  
  戻り値:
  
  オブジェクトが同じである場合はtrue、そうでない場合はfalse。
  
  関連項目:
  
  InetAddress.getAddress()
- isIPv4CompatibleAddress
  
  public boolean isIPv4CompatibleAddress()
  
  InetAddressがIPv4互換のIPv6アドレスかどうかを調べるユーティリティ・ルーチンです。
  
  戻り値:
  
  InetAddressがIPv4互換IPv6アドレスかどうかを示すboolean。アドレスがIPv4アドレスである場合はfalse。

クラスInet6Address

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

特殊なIPv6アドレス

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

メソッド入力としてのIPv6アドレスのテキスト表現

メソッドのサマリー

クラスjava.net.InetAddressで宣言されたメソッド

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

メソッドの詳細

getByAddress

getByAddress

ofLiteral

isMulticastAddress

isAnyLocalAddress

isLoopbackAddress

isLinkLocalAddress

isSiteLocalAddress

isMCGlobal

isMCNodeLocal

isMCLinkLocal

isMCSiteLocal

isMCOrgLocal

getAddress

getScopeId

getScopedInterface

getHostAddress

hashCode

equals

isIPv4CompatibleAddress