java.net
クラス NetworkInterface

java.lang.Object
  java.net.NetworkInterface

public final class NetworkInterface
extends Object

このクラスは、名前と、このインタフェースに割り当てられた一連の IP アドレスから成るネットワークインタフェースを表します。これは、マルチキャストグループへの参加に使用するローカルインタフェースを特定するのに使用されます。 インタフェースは通常、「le0」などの名前で識別されます。

導入されたバージョン:

1.4

メソッドの概要

boolean	equals(Object obj) オブジェクトと指定されたオブジェクトを比較します。
static NetworkInterface	getByInetAddress(InetAddress addr) 指定された インターネットプロトコル (IP) アドレスがバインドされているネットワークインタフェースを検索する簡易メソッド。
static NetworkInterface	getByName(String name) 指定された名前のネットワークインタフェースを検索します。
String	getDisplayName() このネットワークインタフェースの表示名を取得します。
Enumeration	getInetAddresses() このネットワークインタフェースにバインドされた InetAddresses のすべてまたはサブセットの列挙を返す便利なメソッドです。
String	getName() このネットワークインタフェースの名前を取得します。
static Enumeration	getNetworkInterfaces() このマシン上のすべてのインタフェースを返します。
int	hashCode() オブジェクトのハッシュコード値を返します。
String	toString() オブジェクトの文字列表現を返します。

クラス java.lang.Object から継承されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

メソッドの詳細

getName

public String getName()

このネットワークインタフェースの名前を取得します。

戻り値:

このネットワークインタフェースの名前

getInetAddresses

public Enumeration getInetAddresses()

このネットワークインタフェースにバインドされた InetAddresses のすべてまたはサブセットの列挙を返す便利なメソッドです。

セキュリティーマネージャーが存在する場合、InetAddress ごとにその checkConnect メソッドが呼び出されます。checkConnect が SecurityException をスローしない InetAddresses だけが Enumeration の形で返されます。

戻り値:

このネットワークインタフェースにバインドされた InetAddresses のすべてまたはサブセットの列挙オブジェクト

getDisplayName

public String getDisplayName()

このネットワークインタフェースの表示名を取得します。表示名とは、ネットワークデバイスを記述した、人間が読むことのできる String のことです。

戻り値:

このネットワークインタフェースの表示名。表示名が使用できない場合は null

getByName

public static NetworkInterface getByName(String name)
                                  throws SocketException

指定された名前のネットワークインタフェースを検索します。

パラメータ:

name - ネットワークインタフェースの名前

戻り値:

指定された名前の NetworkInterface。指定された名前のネットワークインタフェースが存在しない場合は null

例外:

SocketException - 入出力エラーが発生した場合

NullPointerException - 指定された名前が null の場合

getByInetAddress

public static NetworkInterface getByInetAddress(InetAddress addr)
                                         throws SocketException

指定された インターネットプロトコル (IP) アドレスがバインドされているネットワークインタフェースを検索する簡易メソッド。

指定された IP アドレスが複数のネットワークインタフェースにバインドされている場合、どのネットワークインタフェースが返されるかは未定義となります。

パラメータ:

addr - 検索に使用する InetAddress

戻り値:

NetworkInterface。指定された IP アドレスを持つネットワークインタフェースが存在しない場合は null

例外:

SocketException - 入出力エラーが発生した場合

NullPointerException - 指定されたアドレスが null の場合

getNetworkInterfaces

public static Enumeration getNetworkInterfaces()
                                        throws SocketException

このマシン上のすべてのインタフェースを返します。このマシン上でネットワークインタフェースが 1 つも見つからなかった場合は、null を返します。 注:getNetworkInterfaces() と getInetAddresses() を使用して、このノードのすべての IP アドレスを取得できます。

戻り値:

このマシンで見つかった NetworkInterfaces の 列挙

例外:

SocketException - 入出力エラーが発生した場合

equals

public boolean equals(Object obj)

オブジェクトと指定されたオブジェクトを比較します。引数が null ではなく、このオブジェクトと同じ NetworkInterface を表している場合にだけ、結果が true になります。

名前とアドレスが両方とも同じ場合、NetworkInterface の 2 つのインスタンスは同じ NetworkInterface を表します。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 比較対象のオブジェクト

戻り値:

オブジェクトが同じである場合は true、そうでない場合は false

関連項目:

InetAddress.getAddress()

hashCode

public int hashCode()

クラス Object の記述:

オブジェクトのハッシュコード値を返します。このメソッドは、java.util.Hashtable によって提供されるようなハッシュテーブルで使用するために用意されています。

hashCode メソッドの一般的な規則を次に示します。

• Java アプリケーションの実行中に同じオブジェクト上で複数回呼び出される場合は必ず、このオブジェクトに対する equals による比較で使われた情報が変更されていなければ、hashCode メソッドは同じ整数を一貫して返さなければならない。ただし、この整数は同じアプリケーションの実行ごとに同じである必要はない
• equals(Object) メソッドで 2 つのオブジェクトが等価とされた場合、どちらのオブジェクトで hashCode メソッドを呼び出しても結果は同じ整数値にならなければならない
• Object.equals(java.lang.Object) メソッドで 2 つのオブジェクトが等価でないとされた場合は、これらのオブジェクトに対して hashCode メソッドを呼び出したときに、結果が異なる整数値にならなくてもかまわない。しかし、等しくないオブジェクトについては異なる整数値が生成されるようにすれば、ハッシュテーブルのパフォーマンスを上げることができる

できるかぎり、Object クラスで定義される hashCode メソッドは、異なるオブジェクトについては異なる整数値を返します。通常、これはオブジェクトの内部アドレスを整数値に変換する形で実装されますが、そのような実装テクニックは Java^TM プログラミング言語では不要です。

オーバーライド:

クラス Object 内の hashCode

戻り値:

このオブジェクトのハッシュコード値

関連項目:

Object.equals(java.lang.Object), Hashtable

toString

public String toString()

クラス Object の記述:

オブジェクトの文字列表現を返します。通常、toString メソッドはこのオブジェクトを「テキストで表現する」文字列を返します。この結果は、人間が読める簡潔で有益な情報であるべきです。すべてのサブクラスで、このメソッドをオーバーライドすることをお勧めします。

Object クラスの toString メソッドは、オブジェクトの派生元のクラス名、アットマーク (@)、およびオブジェクトのハッシュコードの符号なし 16 進表現から構成される文字列を返します。つまり、このメソッドは次の値と等しい文字列を返します。

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

オーバーライド:

クラス Object 内の toString

戻り値:

このオブジェクトの文字列表現