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<InetAddress>	getInetAddresses() このネットワークインタフェースにバインドされた InetAddresses のすべてまたはサブセットの Enumeration を返す便利なメソッドです。
String	getName() このネットワークインタフェースの名前を取得します。
static Enumeration<NetworkInterface>	getNetworkInterfaces() このマシン上のすべてのインタフェースを返します。
int	hashCode() オブジェクトのハッシュコード値を返します。
String	toString() オブジェクトの文字列表現を返します。

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

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

メソッドの詳細

getName

public String getName()

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

戻り値:

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

getInetAddresses

public Enumeration<InetAddress> getInetAddresses()

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

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

戻り値:

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

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<NetworkInterface> getNetworkInterfaces()
                                                          throws SocketException

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

戻り値:

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

例外:

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

equals

public boolean equals(Object obj)

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

名前と addrs が両方とも同じ場合、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

戻り値:

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