JavaTM 2 Platform
Standard Ed. 5.0

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 メソッドの一般的な規則を次に示します。

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

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

toString

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

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


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

オーバーライド:
クラス Object 内の toString
戻り値:
このオブジェクトの文字列表現

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 も参照してください。