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 () 이 네트워크 인터페이스의 표시명을 가져옵니다.
byte[]	getHardwareAddress () 인터페이스가 하드웨어 주소 (일반적으로은 MAC)를 가지고 있어 그 주소에 현재의 특권을 사용해 액세스 가능한 경우에, 그 주소를 돌려줍니다.
Enumeration <InetAddress >	getInetAddresses () 이 네트워크 인터페이스에 바인드 된 InetAddresses 의 모두 또는 부분집합의 열거를 돌려주는 편리한 메소드입니다.
List <InterfaceAddress >	getInterfaceAddresses () 이 네트워크 인터페이스의 InterfaceAddress 의 모두 또는 부분집합의 리스트를 가져옵니다.
int	getMTU () 이 인터페이스의 최대 전송 단위 (MTU)를 돌려줍니다.
String	getName () 이 네트워크 인터페이스의 이름을 가져옵니다.
static Enumeration <NetworkInterface >	getNetworkInterfaces () 이 머신상의 모든 인터페이스를 돌려줍니다.
NetworkInterface	getParent () 이 인터페이스가 서브 인터페이스의 경우는 그 부모가 되는 NetworkInterface 를 돌려주어, 이 인터페이스가 물리 (비가상) 인터페이스일까 부모를 가지지 않는 경우는 null 를 돌려줍니다.
Enumeration <NetworkInterface >	getSubInterfaces () 이 네트워크 인터페이스에 접속된 모든 서브 인터페이스 (가상 인터페이스라고도 불린다)를 포함한 열거를 가져옵니다.
int	hashCode () 객체의 해시 코드값를 돌려줍니다.
boolean	isLoopback () 네트워크 인터페이스가 루프백 인터페이스인가 어떤가를 돌려줍니다.
boolean	isPointToPoint () 네트워크 인터페이스가 point-to-point 인터페이스인가 어떤가를 돌려줍니다.
boolean	isUp () 네트워크 인터페이스가 기동해, 동작하고 있을지 어떨지를 돌려줍니다.
boolean	isVirtual () 이 인터페이스가 가상 인터페이스 (서브 인터페이스라고도 불린다) 화도인지를 돌려줍니다.
boolean	supportsMulticast () 네트워크 인터페이스가 멀티 캐스트를 지원하고 있을지 어떨지를 돌려줍니다.
String	toString () 객체의 캐릭터 라인 표현을 돌려줍니다.

클래스 java.lang. Object 로부터 상속된 메소드

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

메소드의 상세

getName

public String  getName()

이 네트워크 인터페이스의 이름을 가져옵니다.

반환값:

이 네트워크 인터페이스의 이름

getInetAddresses

public Enumeration <InetAddress > getInetAddresses()

이 네트워크 인터페이스에 바인드 된 InetAddresses 의 모두 또는 부분집합의 열거를 돌려주는 편리한 메소드입니다.

시큐리티 매니저가 존재하는 경우, InetAddress 마다 그 checkConnect 메소드가 불려 갑니다. checkConnect 가 SecurityException 를 throw 하지 않는 InetAddress 만이, 열거내에 돌려주어집니다.

반환값:

이 네트워크 인터페이스에 바인드 된 InetAddresses 의 모두 또는 부분집합의 열거 객체

getInterfaceAddresses

public List <InterfaceAddress > getInterfaceAddresses()

이 네트워크 인터페이스의 InterfaceAddress 의 모두 또는 부분집합의 리스트를 가져옵니다.

시큐리티 매니저가 존재하는 경우, InetAddress 마다 그 checkConnect 메소드가 InetAddress 를 지정해 불려 갑니다. checkConnect 가 SecurityException 를 throw 하지 않는 InterfaceAddress 만이, 리스트내에 돌려주어집니다.

반환값:

이 네트워크 인터페이스의 InterfaceAddress 의 모두 또는 부분집합의리스트객체

도입된 버젼:

1.6

getSubInterfaces

public Enumeration <NetworkInterface > getSubInterfaces()

이 네트워크 인터페이스에 접속된 모든 서브 인터페이스 (가상 인터페이스라고도 불린다)를 포함한 열거를 가져옵니다.

예를 들어, eth0:1 는 eth0 의 서브 인터페이스입니다.

반환값:

이 네트워크 인터페이스의 모든 서브 인터페이스를 포함한 열거형 객체

도입된 버젼:

1.6

getParent

public NetworkInterface  getParent()

이 인터페이스가 서브 인터페이스의 경우는 그 부모가 되는 NetworkInterface 를 돌려주어, 이 인터페이스가 물리 (비가상) 인터페이스일까 부모를 가지지 않는 경우는 null 를 돌려줍니다.

반환값:

이 인터페이스가 접속되고 있는 NetworkInterface

도입된 버젼:

1.6

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 

이 머신상의 모든 인터페이스를 돌려줍니다. 이 머신상에서 네트워크 인터페이스가 1 개도 발견되지 않았던 경우는, null 를 돌려줍니다. 주: getNetworkInterfaces()와 getInetAddresses()를 사용해, 이 노드의 모든 IP 주소를 취득할 수 있습니다.

반환값:

이 머신으로 발견된 NetworkInterfaces 의 열거

예외:

SocketException - 입출력 에러가 발생했을 경우

isUp

public boolean isUp()
             throws SocketException 

네트워크 인터페이스가 기동해, 동작하고 있을지 어떨지를 돌려줍니다.

반환값:

인터페이스가 기동해, 동작하고 있는 경우는 true

예외:

SocketException - 입출력 에러가 발생했을 경우

도입된 버젼:

1.6

isLoopback

public boolean isLoopback()
                   throws SocketException 

네트워크 인터페이스가 루프백 인터페이스인가 어떤가를 돌려줍니다.

반환값:

인터페이스가 루프백 인터페이스인 경우는 true

예외:

SocketException - 입출력 에러가 발생했을 경우

도입된 버젼:

1.6

isPointToPoint

public boolean isPointToPoint()
                       throws SocketException 

네트워크 인터페이스가 point-to-point 인터페이스인가 어떤가를 돌려줍니다. 일반적으로의 point-to-point 인터페이스로서 모뎀 경유의 PPP 접속을 들 수 있습니다.

반환값:

인터페이스가 point-to-point 인터페이스인 경우는 true

예외:

SocketException - 입출력 에러가 발생했을 경우

도입된 버젼:

1.6

supportsMulticast

public boolean supportsMulticast()
                          throws SocketException 

네트워크 인터페이스가 멀티 캐스트를 지원하고 있을지 어떨지를 돌려줍니다.

반환값:

인터페이스가 멀티 캐스트를 지원하고 있는 경우는 true

예외:

SocketException - 입출력 에러가 발생했을 경우

도입된 버젼:

1.6

getHardwareAddress

public byte[] getHardwareAddress()
                          throws SocketException 

인터페이스가 하드웨어 주소 (일반적으로은 MAC)를 가지고 있어 그 주소에 현재의 특권을 사용해 액세스 가능한 경우에, 그 주소를 돌려줍니다.

반환값:

주소를 포함한 바이트 배열. 주소가 존재하지 않는가 주소에 액세스 할 수 없는 경우는 null

예외:

SocketException - 입출력 에러가 발생했을 경우

도입된 버젼:

1.6

getMTU

public int getMTU()
           throws SocketException 

이 인터페이스의 최대 전송 단위 (MTU)를 돌려줍니다.

반환값:

그 인터페이스의 MTU 의 값

예외:

SocketException - 입출력 에러가 발생했을 경우

도입된 버젼:

1.6

isVirtual

public boolean isVirtual()

이 인터페이스가 가상 인터페이스 (서브 인터페이스라고도 불린다) 화도인지를 돌려줍니다. 가상 인터페이스는 시스템에 따라서는, 어느 물리 인터페이스의 아이로서 작성되어 다른 설정 (주소나 MTU 등)이 주어진 인터페이스가 됩니다. 일반적으로, 이 인터페이스의 이름은, 부모의 이름의 후에, 구두점 (:)과 아이를 식별하기 위한 숫자를 부가한 것이 됩니다. 이것은, 단일의 물리 인터페이스에 복수의 가상 인터페이스가 접속될 가능성이 있기 (위해)때문에입니다.

반환값:

이 인터페이스가 가상 인터페이스인 경우는 true

도입된 버젼:

1.6

equals

public boolean equals(Object  obj)

객체와 지정된 객체를 비교합니다. 인수가 null 는 아니고, 이 객체와 같은 NetworkInterface 를 나타내고 있는 경우에만, 결과가 true 가 됩니다.

이름과 주소가 양쪽 모두 같은 경우,NetworkInterface 의 2 개의 인스턴스는 같은 NetworkInterface 를 나타냅니다.

오버라이드(override):

클래스 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 프로그램 언어에서는 불필요합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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

toString

public String  toString()

클래스 Object 의 기술:

객체의 캐릭터 라인 표현을 돌려줍니다. 일반적으로,toString 메소드는 이 객체를 「텍스트로 표현한다」캐릭터 라인을 돌려줍니다. 이 결과는, 인간이 읽을 수 있는 간결하고 유익한 정보여야 합니다. 모든 서브 클래스에서, 이 메소드를 오버라이드(override) 하는 것을 추천합니다.

Object 클래스의 toString 메소드는, 객체의 파생원의 클래스명, @ 부호 (@), 및 객체의 해시 코드의 부호 없음 16 진표현으로부터 구성되는 캐릭터 라인을 돌려줍니다. 즉, 이 메소드는 다음의 값과 동일한 캐릭터 라인을 돌려줍니다.

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

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현