JavaTM Platform
Standard Ed. 6

java.net
クラス Inet4Address

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

public final class Inet4Address
extends InetAddress

このクラスは、インターネットプロトコルバージョン 4 (IPv4) アドレスを表します。RFC 790: Assigned NumbersRFC 1918: Address Allocation for Private Internets、および RFC 2365: Administratively Scoped IP Multicast で規定されています。

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

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

4 つの部分が指定されると、各部分がデータのバイトとして解釈され、左から右へ、IPv4 アドレスの 4 つのバイトに割り当てられます。

3 つの部分から成るアドレスが指定された場合、その最後の部分が 16 ビットデータとして解釈され、ネットワークアドレスの右側の 2 バイトに配置されます。このため、3 つの部分から成るアドレスの形式は、Class B のネットワークアドレスを 128.net.host として指定する際に役立ちます。

2 つの部分から成るアドレスが指定された場合、その最後の部分が 24 ビットデータとして解釈され、ネットワークアドレスの右側の 3 バイトに配置されます。このため、2 つの部分から成るアドレスの形式は、Class A のネットワークアドレスを net.host として指定する際に役立ちます。

1 つの部分だけが指定されると、その値は直接ネットワークアドレスに格納され、バイトの再配置は行われません。

テキスト表現を出力値として返すメソッドでは、最初の形式、つまりドットで区切られた 4 部から成る文字列が使用されます。

マルチキャストアドレスのスコープ

歴史的に、IP ヘッダーの IPv4 TTL フィールドはマルチキャストスコープフィールドとして 2 倍になりました。0 の TTL はノードローカル、1 はリンクローカル、32 まではサイトローカル、64 までは地域ローカル、128 までは大陸ローカル、255 まではグローバルを意味します。ただし、管理スコープが優先されます。RFC 2365: Administratively Scoped IP Multicast を参照してください。

導入されたバージョン:
1.4
関連項目:
直列化された形式

メソッドの概要
 boolean equals(Object obj)
          オブジェクトと指定されたオブジェクトを比較します。
 byte[] getAddress()
          この InetAddress オブジェクトの生の IP アドレスを返します。
 String getHostAddress()
          テキスト表現形式の IP アドレス文字列を返します。
 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 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
 

メソッドの詳細

isMulticastAddress

public boolean isMulticastAddress()
InetAddress が IP マルチキャストアドレスかどうかを調べるユーティリティールーチンです。IP マルチキャストアドレスは Class D アドレスです。つまり、そのアドレスの先頭の 4 ビットが 1110 です。

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

isAnyLocalAddress

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

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

isLoopbackAddress

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

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

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 アドレス

getHostAddress

public String getHostAddress()
テキスト表現形式の IP アドレス文字列を返します。

オーバーライド:
クラス InetAddress 内の getHostAddress
戻り値:
IP アドレスの文字列形式
導入されたバージョン:
JDK1.0.2

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()

JavaTM Platform
Standard Ed. 6

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

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