java.net
클래스 InetAddress

java.lang.Object 
  |
  +--java.net.InetAddress

모든 구현 인터페이스:

Serializable

직계의 기존의 서브 클래스:

Inet4Address , Inet6Address

public class InetAddress

extends Object

implements Serializable

IP (Internet Protocol) 주소를 나타내는 클래스입니다.

IP 주소는 IP 로 사용되는 32 비트 또는 128 비트의 부호 없음의 숫자로, UDP 나 TCP 등의 프로토콜이 구축되는 하위 레벨의 프로토콜입니다. IP 주소의 아키텍쳐는 「RFC 790: Assigned Numbers」,「RFC 1918: Address Allocation for Private Internets」,「RFC 2365: Administratively Scoped IP Multicast」, 및「RFC 2373: IP Version 6 Addressing Architecture」에 정의되고 있습니다. InetAddress 의 인스턴스는 IP 주소와 어쩌면 거기에 대응하는 호스트명으로 구성됩니다 (호스트명을 사용해 구축되었는지 호스트명의 역해결을 벌써 실행했는지 어떠했는지에 따라서 다르다).

주소의 타입

uni-cast

단일 인터페이스의 식별자. uni-cast 주소에 송신된 패킷은 그 주소로 식별되는 인터페이스에 전달됩니다. 미지정의 주소 - 임의 로컬 주소 또는 와일드 카드 주소라고도 불립니다. 이 주소는 어느 노드에도 할당해 되지 않습니다. 이것은 주소가 없는 것을 나타냅니다. 이 주소를 사용한 예로서 바인드의 대상이 있습니다. 이것에 의해, 서버 호스트에 복수의 인터페이스가 있는 경우에, 서버는 임의의 인터페이스로 클라이언트 접속을 받아들일 수가 있습니다. 「미지정」의 주소는 IP 패킷의 전송처 주소로서 사용해 되지 않습니다. 「루프백」주소 -- 루프백 인터페이스에 할당할 수 있는 주소입니다. 이 IP 주소에 송신된 것은 모두 루프 해, 로컬 호스트로 IP 입력이 됩니다. 이 주소는 자주(잘) 클라이언트의 테스트에 사용됩니다.

멀티 캐스트

일련의 인터페이스 (통상은 다른 노드에 속한다)의 식별자. 멀티 캐스트 주소에 송신된 패킷은 그 주소로 식별되는 모든 인터페이스에 전달됩니다.

IP 주소의 스코프

「링크 로컬」주소는 자동 주소 구성, 인접 주소의 발견등을 목적으로 해, 혹은 라우터가 존재하지 않는 경우에, 단일 링크의 주소 지정에 사용하기 위해서(때문에) 설계되고 있습니다.

「사이트 로컬」주소는 글로벌 접두사를 필요로 하지 않는 사이트내의 주소 지정에 사용하기 위해서(때문에) 설계되고 있습니다.

「글로벌」주소는 인터넷 전체로 일의입니다.

IP 주소의 텍스트 표현

IP 주소의 텍스트 표현은 주소 패밀리에게 고유합니다.

IPv4 의 주소 형식에 대해서는 「Inet4Address」를 참조해 주세요. IPv6 의 주소 형식에 대해서는 「Inet6Address」를 참조해 주세요.

호스트명 해결

호스트명과 IP 주소의 「해결」은 로컬 머신의 구성 정보와 도메인 네임 시스템 (DNS)이나 네트워크 정보 서비스 (NIS)등의 네트워크 네임 서비스를 조합해 사용하는 것으로 실현됩니다. 사용되는 개개의 네임 서비스는 디폴트에서는 로컬 머신에 구성되어 있는 네임 서비스입니다. 임의의 호스트명에 대해, 대응하는 IP 주소가 돌려주어집니다.

「역이름 해석」에서는 임의의 IP 주소에 대해, 그 IP 주소에 관련하는 호스트명이 돌려주어집니다.

InetAddress 클래스는 호스트명으로부터 그 IP 주소에의 해결, 및 그 역의 해결의 메소드를 제공합니다.

InetAddress 의 캐쉬

InetAddress 클래스는 캐쉬를 가져, 성공 및 실패의 호스트명 해결을 저장합니다. 포지티브 캐쉬는 DNS 의 부정 액세스에 의한 공격으로부터 방어하기 위해서, 네가티브 캐쉬는 퍼포먼스의 향상을 위해서(때문에) 사용됩니다.

디폴트에서는 캐쉬의 엔트리를 삭제하는 안전한 시기를 결정하는 일반적인 규칙이 없기 때문에, 성공한 호스트명 해결의 결과는 영원히 캐쉬됩니다. 실패의 호스트명 해결의 결과는 퍼포먼스의 향상을 위해서(때문에) 단시간 (10 초)만 캐쉬됩니다.

DNS 의 부정 액세스에 의한 공격이 불가능과 판정할 수 있는 특정의 환경에서는 Java 시큐러티 프로퍼티를 포지티브 캐쉬의 다른 유효기간 (TTL) 치로 설정할 수가 있습니다. 같이 시스템 관리 책임자는 필요에 따라서 다른 네가티브캐슈 TTL 치를 설정할 수가 있습니다.

2 개의 Java 시큐러티 프로퍼티에 의해, 포지티브 및 네가티브의 호스트명 해결의 캐쉬에 사용하는 TTL 치를 제어합니다.

networkaddress.cache.ttl (디폴트: -1)

네임 서비스로 성공한 네임 참조의 캐쉬 폴리시를 나타냅니다. 성공한 참조를 캐쉬하는 초수를 나타내는 정수치를 지정합니다.

값 -1 은 「영원히 캐쉬」를 나타냅니다.

networkaddress.cache.negative.ttl (디폴트: 10)

네임 서비스로 성공하지 않았던 네임 참조의 캐쉬 폴리시를 나타냅니다. 성공하지 않았던 참조를 캐쉬하는 초수를 나타내는 정수치를 지정합니다.

값 0 은 「캐쉬하지 않는다」를, 값 -1 은 「영원히 캐쉬」를 나타냅니다.

도입된 버젼:

JDK1. 0

관련 항목:

getByAddress(byte[]) , getByAddress(java.lang.String, byte[]) , getAllByName(java.lang.String) , getByName(java.lang.String) , getLocalHost() , 직렬화 된 형식

메소드의 개요

boolean	equals (Object obj) 이 오브젝트와 지정된 오브젝트를 비교합니다.
byte[]	getAddress () 이 InetAddress 오브젝트의 IP 주소를 그대로 돌려줍니다.
static InetAddress []	getAllByName (String host) 호스트명을 지정하면(자), 시스템으로 설정되어 있는 네임 서비스에 근거해 그 IP 주소의 배열을 돌려줍니다.
static InetAddress	getByAddress (byte[] addr) 그대로의 IP 주소를 가지는 InetAddress 오브젝트를 돌려줍니다.
static InetAddress	getByAddress (String host, byte[] addr) 지정된 호스트명 및 IP 주소에 근거해 InetAddress 을 작성합니다.
static InetAddress	getByName (String host) 지정된 호스트명을 가지는 호스트의 IP 주소를 취득합니다.
String	getCanonicalHostName () 이 IP 주소의 완전 지정의 도메인명을 취득합니다.
String	getHostAddress () 텍스트 표현의 IP 주소 캐릭터 라인을 돌려줍니다.
String	getHostName () 이 IP 주소에 대응하는 호스트명을 취득합니다.
static InetAddress	getLocalHost () 로컬 호스트를 돌려줍니다.
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 가 사이트 로컬 주소인가 어떤가를 조사하는 유틸리티루틴입니다.
String	toString () 이 IP 주소를 String 로 변환합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

메소드의 상세

isMulticastAddress

public boolean isMulticastAddress()

InetAddress 가 IP 멀티 캐스트 주소인가 어떤가를 조사하는 유틸리티루틴입니다.

반환값:

InetAddress 가 IP 멀티 캐스트 주소인가 어떤가를 나타내는 boolean

도입된 버젼:

JDK1. 1

isAnyLocalAddress

public boolean isAnyLocalAddress()

InetAddress 가 와일드 카드 주소인가 어떤가를 조사하는 유틸리티루틴입니다.

반환값:

InetAddress 가 와일드 카드 주소인가 어떤가를 나타내는 boolean

도입된 버젼:

1.4

isLoopbackAddress

public boolean isLoopbackAddress()

InetAddress 가 루프백 주소인가 어떤가를 조사하는 유틸리티루틴입니다.

반환값:

InetAddress 가 루프백 주소인가 어떤가를 나타내는 boolean. 루프백 주소가 아닌 경우는 false

도입된 버젼:

1.4

isLinkLocalAddress

public boolean isLinkLocalAddress()

InetAddress 가 링크 로컬 주소인가 어떤가를 조사하는 유틸리티루틴입니다.

반환값:

InetAddress 가 링크 로컬 주소인가 어떤가를 나타내는 boolean. 주소가 링크 로컬 uni-cast 주소가 아닌 경우는 false

도입된 버젼:

1.4

isSiteLocalAddress

public boolean isSiteLocalAddress()

InetAddress 가 사이트 로컬 주소인가 어떤가를 조사하는 유틸리티루틴입니다.

반환값:

InetAddress 가 사이트 로컬 주소인가 어떤가를 나타내는 boolean. 주소가 사이트 로컬 uni-cast 주소가 아닌 경우는 false

도입된 버젼:

1.4

isMCGlobal

public boolean isMCGlobal()

멀티 캐스트 주소에 글로벌 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다

반환값:

주소가 글로벌 스코프의 멀티 캐스트 주소일지 어떨지를 나타내는 boolean. 주소가 글로벌 스코프가 아닌 경우, 혹은 멀티 캐스트 주소가 아닌 경우는 false

도입된 버젼:

1.4

isMCNodeLocal

public boolean isMCNodeLocal()

멀티 캐스트 주소에 노드 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다

반환값:

주소가 노드 로컬 스코프의 멀티 캐스트 주소일지 어떨지를 나타내는 boolean. 주소가 노드 로컬 스코프가 아닌 경우, 혹은 멀티 캐스트 주소가 아닌 경우는 false

도입된 버젼:

1.4

isMCLinkLocal

public boolean isMCLinkLocal()

멀티 캐스트 주소에 린크스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다

반환값:

주소가 링크 로컬 스코프의 멀티 캐스트 주소일지 어떨지를 나타내는 boolean. 주소가 링크 로컬 스코프가 아닌 경우, 혹은 멀티 캐스트 주소가 아닌 경우는 false

도입된 버젼:

1.4

isMCSiteLocal

public boolean isMCSiteLocal()

멀티 캐스트 주소에 사이트 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다

반환값:

주소가 사이트 로컬 스코프의 멀티 캐스트 주소일지 어떨지를 나타내는 boolean. 주소가 사이트 로컬 스코프가 아닌 경우, 혹은 멀티 캐스트 주소가 아닌 경우는 false

도입된 버젼:

1.4

isMCOrgLocal

public boolean isMCOrgLocal()

멀티 캐스트 주소에 조직 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다

반환값:

주소가 조직 로컬 스코프의 멀티 캐스트 주소일지 어떨지를 나타내는 boolean. 주소가 조직 로컬 스코프가 아닌 경우, 혹은 멀티 캐스트 주소가 아닌 경우는 false

도입된 버젼:

1.4

getHostName

public String  getHostName()

이 IP 주소에 대응하는 호스트명을 취득합니다.

이 InetAddress 가 호스트명을 사용해 작성되었을 경우는 이 호스트명이 보존되어 돌려주어집니다. 그렇지 않은 경우는 역네임 참조가 실행되어, 시스템으로 설정된 네임 참조 서비스에 근거해 결과가 돌려주어집니다. 네임 서비스의 참조가 필요한 경우는 getCanonicalHostName 를 호출합니다.

시큐러티 매니저가 존재하는 경우, 우선 시큐러티 매니저의 checkConnect 메소드가, 인수로서 호스트명 및 -1 을 지정해 불려 가 이 조작이 허가되고 있는지 어떤지를 확인합니다. 조작이 허가되어 있지 않은 경우는 IP 주소의 텍스트 표현을 돌려줍니다.

반환값:

이 IP 주소의 호스트명. 시큐러티 체크에 의해 조작이 허가되지 않는 경우는 IP 주소의 텍스트 표현

관련 항목:

getCanonicalHostName() , SecurityManager.checkConnect(java.lang.String, int)

getCanonicalHostName

public String  getCanonicalHostName()

이 IP 주소의 완전 지정의 도메인명을 취득합니다. 이것은 best effort형의 메소드입니다. 즉, 배후의 시스템 구성에 따라서는 FQDN 를 돌려줄 수가 없는 경우가 있습니다.

시큐러티 매니저가 존재하는 경우, 이 메소드는 우선 시큐러티 매니저의 checkConnect 메소드를 인수로서 호스트명과 -1 를 지정해 호출해, 호출측의 코드가 이 IP 주소의 호스트명을 인식한다, 즉 호스트에 접속하는 것이 허가되고 있는지 어떤지를 확인합니다. 조작이 허가되어 있지 않은 경우는 IP 주소의 텍스트 표현을 돌려줍니다.

반환값:

이 IP 주소의 완전 지정의 도메인명. 시큐러티 체크에 의해 조작이 허가되지 않는 경우는 IP 주소의 텍스트 표현

도입된 버젼:

1.4

관련 항목:

SecurityManager.checkConnect(java.lang.String, int)

getAddress

public byte[] getAddress()

이 InetAddress 오브젝트의 IP 주소를 그대로 돌려줍니다. 결과는 네트워크 바이트 순서에 따라 돌려주어집니다. 주소의 최상정도 바이트가 getAddress()[0] 이 됩니다.

반환값:

이 오브젝트의 IP 주소

getHostAddress

public String  getHostAddress()

텍스트 표현의 IP 주소 캐릭터 라인을 돌려줍니다.

반환값:

IP 주소의 캐릭터 라인 형식

도입된 버젼:

JDK1. 0.2

hashCode

public int hashCode()

이 IP 주소의 해시 코드를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 IP 주소의 해시 코드치

관련 항목:

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

equals

public boolean equals(Object  obj)

이 오브젝트와 지정된 오브젝트를 비교합니다. 인수가 null 는 아니고, 이 오브젝트와 같은 IP 주소를 나타내는 오브젝트의 경우에만, 결과가 true 가 됩니다.

getAddress 에 의해 돌려주어지는 바이트 배열의 길이가 같고, 바이트 배열의 각 요소가 같은 경우, 2 개의 InetAddress 의 인스턴스는 같은 IP 주소를 나타내고 있습니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교 대상의 오브젝트

반환값:

오브젝트가 같은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

getAddress()

toString

public String  toString()

이 IP 주소를 String 로 변환합니다. 돌려주어지는 캐릭터 라인의 형식은 호스트명 / 리터럴 IP 주소입니다. 호스트명이 해결되지 않는 경우, 역네임 서비스 참조는 실행되지 않습니다. 호스트명의 부분은 하늘의 캐릭터 라인으로 나타내집니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 IP 주소의 캐릭터 라인 표현

getByAddress

public static InetAddress  getByAddress(String  host,
                                       byte[] addr)
                                throws UnknownHostException 

지정된 호스트명 및 IP 주소에 근거해 InetAddress 를 작성합니다. 주소의 유효성을 확인하기 위한 네임 서비스의 체크는 행해지지 않습니다.

호스트명은 「java.sun.com」등의 머신명인가, 또는 그 IP 주소의 텍스트 표현입니다.

리터럴 IPv6 주소로 지정되는 host 에 대해서는 RFC 2732 로 정의되고 있는 형식인가, RFC 2373 으로 정의되고 있는 리터럴 IPv6 주소 형식이 가능합니다.

addr 에 IPv4 주소를 지정하면(자), Inet4Address 의 인스턴스가 돌려주어집니다. 그렇지 않은 경우는 Inet6Address 의 인스턴스가 돌려주어집니다.

IPv4 주소의 바이트 배열은 4 바이트장, IPv6 의 바이트 배열은 16 바이트장이 아니면 안됩니다.

파라미터:

host - 지정된 호스트

addr - 네트워크 바이트 순서의 IP 주소

반환값:

IP 주소로부터 작성된 InetAddress 오브젝트

예외:

UnknownHostException - IP 주소의 길이가 부정의 경우

도입된 버젼:

1.4

getByName

public static InetAddress  getByName(String  host)
                             throws UnknownHostException 

지정된 호스트명을 가지는 호스트의 IP 주소를 취득합니다.

호스트명은 「java.sun.com」와 같은 머신명인가, IP 주소의 텍스트 표현입니다. 리터럴 IP 주소가 지정되었을 경우, 주소 형식의 유효성만을 체크합니다.

리터럴 IPv6 주소로 지정되는 host 에 대해서는 RFC 2732 로 정의되고 있는 형식인가, RFC 2373 으로 정의되고 있는 리터럴 IPv6 주소 형식이 가능합니다.

파라미터:

host - 지정하는 호스트, 또는 로컬 호스트의 경우는 null

반환값:

지정된 호스트명의 IP 주소

예외:

UnknownHostException - host 인수로 지정된 호스트의 IP 주소가 발견되지 않는 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메소드가 이 조작을 허가하지 않는 경우

getAllByName

public static InetAddress [] getAllByName(String  host)
                                  throws UnknownHostException 

호스트명을 지정하면(자), 시스템으로 설정되어 있는 네임 서비스에 근거해 그 IP 주소의 배열을 돌려줍니다.

호스트명은 「java.sun.com」와 같은 머신명인가, IP 주소의 텍스트 표현입니다. 리터럴 IP 주소가 지정되었을 경우, 주소 형식의 유효성만을 체크합니다.

리터럴 IPv6 주소로 지정되는 host 에 대해서는 RFC 2732 로 정의되고 있는 형식인가, RFC 2373 으로 정의되고 있는 리터럴 IPv6 주소 형식이 가능합니다.

시큐러티 매니저가 존재하는 경우,host 가 null 는 아니고,host.length() 의 값이 제로는 아닐 때는 시큐러티 매니저의 checkConnect 메소드가, 인수로서 호스트명과 -1 를 지정해 불려 가 이 조작이 허가되고 있는 것을 확인합니다.

파라미터:

host - 호스트명

반환값:

지정된 호스트명의 모든 IP 주소를 포함한 배열

예외:

UnknownHostException - host 인수로 지정된 호스트의 IP 주소가 발견되지 않는 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메소드가 이 조작을 허가하지 않는 경우

관련 항목:

SecurityManager.checkConnect(java.lang.String, int)

getByAddress

public static InetAddress  getByAddress(byte[] addr)
                                throws UnknownHostException 

그대로의 IP 주소를 가지는 InetAddress 오브젝트를 돌려줍니다. 인수는 네트워크 바이트 순서로, 주소의 최상정도 바이트가 getAddress()[0] 이 됩니다.

이 메소드는 블록 하지 않습니다. 즉, 역네임 서비스 참조는 실행되지 않습니다.

IPv4 주소의 바이트 배열은 4 바이트장, IPv6 의 바이트 배열은 16 바이트장이 아니면 안됩니다.

파라미터:

addr - 네트워크 바이트 순서의 IP 주소

반환값:

IP 주소로부터 작성된 InetAddress 오브젝트

예외:

UnknownHostException - IP 주소의 길이가 부정의 경우

도입된 버젼:

1.4

getLocalHost

public static InetAddress  getLocalHost()
                                throws UnknownHostException 

로컬 호스트를 돌려줍니다.

시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkConnect 메소드가, 인수로서 로컬 호스트명 및 -1 을 지정해 불려 가 이 조작이 허가되고 있는지 어떤지를 확인합니다. 조작이 허가되어 있지 않은 경우는 참조 주소를 나타내는 InetAddress 가 돌려주어집니다.

반환값:

로컬 호스트의 IP 주소

예외:

UnknownHostException - host 인수로 지정된 호스트의 IP 주소가 발견되지 않는 경우

관련 항목:

SecurityManager.checkConnect(java.lang.String, int)