java.net
클래스 Inet6Address

java.lang.Object 
  java.net.InetAddress 
      java.net.Inet6Address

모든 구현된 인터페이스:

Serializable

public final class Inet6Address
extends InetAddress 

이 클래스는 Internet Protocol 버전 6 (IPv6) 주소를 나타냅니다. 정의에 대해서는 「RFC 2373: IP Version 6 Addressing Architecture」을 참조하십시오.

IP 주소의 텍스트 표현

메서드의 입력으로서 사용되는 Ipv6 주소의 텍스트 표현은 다음의 몇개의 형식이 됩니다.

1. 추천 되는 형식은 x:x:x:x:x:x:x:x 입니다. 여기서, x는 8개의 16 비트 주소의 16 진수치입니다. 이것이 완전한 형식입니다. 다음에 예를 나타냅니다.

   1080:0:0:0:8:800:200C:417A

   개개의 필드의 제로 매입은 필요 없습니다. 다만, 다음에 설명하는 경우를 제외해, 각 필드에는 적어도 1개의 수값이 필요합니다.

2. 특정의 스타일의 IPv6 주소를 할당하는 일부의 메서드를 위해서 0 비트의 긴 캐릭터 라인을 포함한 주소가 일반적입니다. 0 비트를 포함한 주소의 write를 간단하게 하기 위해서 특별한 구문을 사용해 0을 압축할 수 있습니다. 「::」의 사용은 복수의 그룹의 16 비트의 0을 나타냅니다. 「::」은 주소내에 1번 만 사용할 수 있습니다. 또, 「::」을 사용해, 주소내의 선두 또는 말미의 0을 압축할 수도 있습니다. 다음에 예를 나타냅니다.

   1080::8:800:200C:417A

3. IPv4 및 IPv6 노드가 혼재하는 환경에 대응하는 경우에 또한 편리한 대체 형식이 x:x:x:x:x:x:d.d.d.d 입니다. 여기서, x는 상위 6개의 16 비트 주소의 16 진수치로 d는 하위 4개의 8 비트 표준 IPv4 표현 주소의 십진수치입니다. 다음에 예를 나타냅니다.

   ::FFFF:129. 144.52. 38
   ::129. 144.52. 38

   「::FFFF:d.d.d.d」와「::d.d.d.d」는 각각 IPv4 맵의 IPv6 주소와 IPv4 호환 IPv6 주소의 일반적인 형식입니다. IPv4 부분은 「d.d.d.d」형식이 아니면 안됩니다. 다음의 형식은 무효입니다.

   ::FFFF:d.d.d
   ::FFFF:d.d
   ::d.d.d
   ::d.d

   다음의 형식은 유효합니다.

   ::FFFF:d

   다만, 이것은 IPv4 호환의 IPv6 주소 (아래와 같이)의 규칙에 따르지 않은 표현입니다.

   ::255. 255.0.d

   여기서, 「::d」는 일반적인 IPv6 주소 「0:0:0:0:0:0:0:d」에 대응합니다.

텍스트 표현을 출력값으로 돌려주는 메서드의 경우는 완전한 형식이 사용됩니다. Inet6Addres는 다른 텍스트 데이터와 조합해 사용하면 명확해서, 완전한 형식을 리턴합니다.

특수한 IPv6 주소

IPv4 맵의 주소	::ffff:w.x.y.z 라고 하는 형식의 IPv6 주소는 IPv4 주소를 나타내는데 사용됩니다. 이 주소에의해 IPv4와 IPv6 양쪽 모두의 노드와 통신할 경우에 네이티브 프로그램은 같은 주소 데이터 구조를 사용할 수가 있어 같은 소켓을 사용할 수도 있습니다. InetAddress와 Inet6Address 에서는 이 주소는 내부 표현에 사용되어 기능상의 역할은 없습니다. Java는 IPv4 맵의 주소를 돌려주지 않습니다. 이러한 클래스는 IPv4 맵의 주소를 바이트 배열과 텍스트 표현의 양쪽 모두로 입력으로서 사용할 수 있습니다. 다만, IPv4 맵의 주소는 IPv4 주소에 변환됩니다.

IPv6 스코프 주소의 텍스트 표현

IPv6 주소의 텍스트 표현을 상기와 같이 확장해, IPv6 스코프 주소를 지정할 수 있습니다. 이러한 기본 주소 지정 아키텍쳐의 확장에 대해서는 「draft-ietf-ipngwg-scoping-arch-04. txt」를 참조하십시오.

링크 로컬의 주소나 사이트 로컬의 주소는 비글로벌입니다. 이 때문에 복수의 호스트가 같은 행선지 주소를 공유해, 그 결과, 이러한 호스트에게 같은 송신원시스템상의 복수의 인터페이스를 개입시켜 도달할 수 있을 가능성이 있습니다. 이 경우 송신원시스템은 같은 스코프의 복수의 존에 접속되고 있게 됩니다. 어떤 것이 목적의 존일까 명확하게 하기 위한, IPv6 주소에 존 식별자 (scope_id)를 추가할 수 있습니다.

scope_id는 보통, 다음과 같이 지정합니다.

IPv6-address%scope_id

IPv6 주소는 상기의 설명과 같이, 리터럴 IPv6 주소입니다. scope_id는 로컬 시스템상의 인터페이스를 참조합니다. 다음의 2 방법의 방법으로 지정할 수 있습니다.

1. 수치 식별자로서 지정. 시스템에 의해 인식되는 특정의 인터페이스 및 스코프를 식별하는 정의 정수. 보통, 이 수치는 시스템상의 관리툴에 의해 판정 가능. 단일의 인터페이스가 복수의 값 (스코프 마다 1개 씩)을 가질 수가 있다. 스코프가 지정되어 있지 않은 경우는 기본값 0 이 사용된다
2. 캐릭터 라인으로서 지정. 해당하는 인터페이스의 NetworkInterface.getName() 에 의해 리턴된 캐릭터 라인. 이 방법으로 Inet6Address를 작성하는 경우, 수치의 scope-id는 객체의 작성시에 관련된 NetworkInterface를 조회하는 것에 의해 판정되는

수치의 scope_id는 NetworkInterface 클래스로부터 리턴된 Inet6Address 인스턴스로부터 취득할 수도 있습니다. 이것을 사용해, 시스템상에서 설정되어 있는 현재의 스코프 ID를 확인할 수 있습니다.

관련 항목:

직렬화 된 형식

메서드 개요

boolean	equals (Object obj) 이 객체와 지정된 객체를 비교합니다.
byte[]	getAddress () 이 InetAddress 객체의 IP 주소를 그대로 리턴합니다.
static Inet6Address	getByAddress (String host, byte[] addr, int scope_id) InetAddress.getByAddress(String, byte[]) 와 같게의해 Inet6Address를 작성합니다.
static Inet6Address	getByAddress (String host, byte[] addr, NetworkInterface nif) InetAddress.getByAddress(String, byte[]) 와 같게의해 Inet6Address를 작성합니다.
String	getHostAddress () IP 주소의 텍스트 표현을 리턴합니다.
NetworkInterface	getScopedInterface () 이 인스턴스가 스코프 인터페이스로 작성되었을 경우, 이 스코프 인터페이스를 리턴합니다.
int	getScopeId () 이 인스턴스에 인터페이스를 관련된 인 경우, 수치의 scopeId를 리턴합니다.
int	hashCode () 이 IP 주소의 해시 코드를 리턴합니다.
boolean	isAnyLocalAddress () InetAddress가와 일드 카드 주소인가 어떤가를 조사하는 유틸리티루틴입니다.
boolean	isIPv4CompatibleAddress () InetAddress가 IPv4 호환의 IPv6 주소인가 어떤가를 조사하는 유틸리티루틴입니다.
boolean	isLinkLocalAddress () InetAddress가 링크 로컬 주소인가 어떤가를 조사하는 유틸리티루틴입니다.
boolean	isLoopbackAddress () InetAddress가 루프백 주소인가 어떤가를 조사하는 유틸리티루틴입니다.
boolean	isMCGlobal () 멀티 캐스트 주소에 글로벌 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다.
boolean	isMCLinkLocal () 멀티 캐스트 주소에 린크스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다.
boolean	isMCNodeLocal () 멀티 캐스트 주소에 노드 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다.
boolean	isMCOrgLocal () 멀티 캐스트 주소에 조직 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다.
boolean	isMCSiteLocal () 멀티 캐스트 주소에 사이트 스코프가 있을지 어떨지를 조사하는 유틸리티루틴입니다.
boolean	isMulticastAddress () InetAddress가 IP 멀티 캐스트 주소인가 어떤가를 조사하는 유틸리티루틴입니다.
boolean	isSiteLocalAddress () InetAddress가 사이트 로컬 주소인가 어떤가를 조사하는 유틸리티루틴입니다.

클래스 java.net. InetAddress 로부터 상속된 메서드

getAllByName, getByAddress, getByAddress, getByName, getCanonicalHostName, getHostName, getLocalHost, isReachable, isReachable, toString

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

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

메서드의 상세

getByAddress

public static Inet6Address  getByAddress(String  host,
                                        byte[] addr,
                                        NetworkInterface  nif)
                                 throws UnknownHostException 

InetAddress.getByAddress(String, byte[]) 와 같게의해 Inet6Address를 작성합니다. 다만, IPv6 scope_id 에는 addr로 지정된 주소형의 인터페이스에 대응하는 값을 설정합니다. 이 인터페이스에 지정의 주소형 (링크 로컬 또는 사이트 로컬)의 수치의 scope_id를 할당할 수 있지 않은 경우, 호출은 실패해, UnkinownHostException가 발생합니다. IPv6 스코프 주소의 설명은, 여기에 있습니다.

파라미터:

host - 지정된 호스트

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

nif - 이 주소에 관련지을 필요가 있는 인터페이스

반환값:

IP 주소로부터 작성된 Inet6Address 객체

예외:

UnknownHostException - IP 주소의 길이가 부정한 경우, 또는 인터페이스로 지정의 주소형의 수치의 scope_id를 할당할 수 있지 않은 경우

도입된 버전 :

1.5

getByAddress

public static Inet6Address  getByAddress(String  host,
                                        byte[] addr,
                                        int scope_id)
                                 throws UnknownHostException 

InetAddress.getByAddress(String, byte[]) 와 같게의해 Inet6Address를 작성합니다. 다만, IPv6 scope_id에는 지정의 수치를 설정합니다. scope_id가 시스템상의 인터페이스에 대응하고 있을지 어떨지는 체크되지 않습니다. IPv6 스코프 주소의 설명은, 여기에 있습니다.

파라미터:

host - 지정된 호스트

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

scope_id - 주소의 수치의 scope_id

반환값:

IP 주소로부터 작성된 Inet6Address 객체

예외:

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

도입된 버전 :

1.5

isMulticastAddress

public boolean isMulticastAddress()

InetAddress가 IP 멀티 캐스트 주소인가 어떤가를 조사하는 유틸리티루틴입니다. 주소 개시점의 11111111 에의해 주소가 멀티 캐스트 주소인 것이 식별됩니다.

오버라이드(override):

클래스 InetAddress 내의 isMulticastAddress

반환값:

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

도입된 버전 :

JDK1. 1

isAnyLocalAddress

public boolean isAnyLocalAddress()

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

오버라이드(override):

클래스 InetAddress 내의 isAnyLocalAddress

반환값:

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

도입된 버전 :

1.4

isLoopbackAddress

public boolean isLoopbackAddress()

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

오버라이드(override):

클래스 InetAddress 내의 isLoopbackAddress

반환값:

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

도입된 버전 :

1.4

isLinkLocalAddress

public boolean isLinkLocalAddress()

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

오버라이드(override):

클래스 InetAddress 내의 isLinkLocalAddress

반환값:

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

도입된 버전 :

1.4

isSiteLocalAddress

public boolean isSiteLocalAddress()

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

오버라이드(override):

클래스 InetAddress 내의 isSiteLocalAddress

반환값:

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

도입된 버전 :

1.4

isMCGlobal

public boolean isMCGlobal()

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

오버라이드(override):

클래스 InetAddress 내의 isMCGlobal

반환값:

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

도입된 버전 :

1.4

isMCNodeLocal

public boolean isMCNodeLocal()

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

오버라이드(override):

클래스 InetAddress 내의 isMCNodeLocal

반환값:

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

도입된 버전 :

1.4

isMCLinkLocal

public boolean isMCLinkLocal()

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

오버라이드(override):

클래스 InetAddress 내의 isMCLinkLocal

반환값:

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

도입된 버전 :

1.4

isMCSiteLocal

public boolean isMCSiteLocal()

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

오버라이드(override):

클래스 InetAddress 내의 isMCSiteLocal

반환값:

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

도입된 버전 :

1.4

isMCOrgLocal

public boolean isMCOrgLocal()

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

오버라이드(override):

클래스 InetAddress 내의 isMCOrgLocal

반환값:

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

도입된 버전 :

1.4

getAddress

public byte[] getAddress()

이 InetAddress 객체의 IP 주소를 그대로 리턴합니다. 결과는 네트워크 바이트 순서에 따라 리턴됩니다 . 주소의 최상정도 바이트가 getAddress()[0] 이 됩니다.

오버라이드(override):

클래스 InetAddress 내의 getAddress

반환값:

이 객체의 IP 주소

getScopeId

public int getScopeId()

이 인스턴스에 인터페이스를 관련된 인 경우, 수치의 scopeId를 리턴합니다. scoped_id가 설정되어 있지 않은 경우, 반환값은 제로입니다.

반환값:

scopeId. 설정되어 있지 않은 경우는 제로

도입된 버전 :

1.5

getScopedInterface

public NetworkInterface  getScopedInterface()

이 인스턴스가 스코프 인터페이스로 작성되었을 경우, 이 스코프 인터페이스를 리턴합니다.

반환값:

스코프 인터페이스. 설정되어 있지 않은 경우는 null

도입된 버전 :

1.5

getHostAddress

public String  getHostAddress()

IP 주소의 텍스트 표현을 리턴합니다. 인스턴스가 스코프 식별자를 지정하는 것에 의해 작성되었을 경우, IP 주소의 말미에 「%」에 이어 스코프 ID가 추가됩니다. 이 스코프 ID는 인스턴스의 작성시에 사용된 수치 또는 캐릭터 라인이 됩니다.

오버라이드(override):

클래스 InetAddress 내의 getHostAddress

반환값:

IP 주소의 캐릭터 라인 형식

hashCode

public int hashCode()

이 IP 주소의 해시 코드를 리턴합니다.

오버라이드(override):

클래스 InetAddress 내의 hashCode

반환값:

이 IP 주소의 해시 코드값

관련 항목:

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

equals

public boolean equals(Object  obj)

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

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

오버라이드(override):

클래스 InetAddress 내의 equals

파라미터:

obj - 비교 대상의 객체

반환값:

객체가 같은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

InetAddress.getAddress()

isIPv4CompatibleAddress

public boolean isIPv4CompatibleAddress()

InetAddress가 IPv4 호환의 IPv6 주소인가 어떤가를 조사하는 유틸리티루틴입니다.

반환값:

InetAddress가 IPv4 호환의 IPv6 주소일지 어떨지를 나타내는 boolean. 주소가 IPv4 주소의 경우는 false

도입된 버전 :

1.4