JavaTM Platform
Standard Ed. 6

java.net
클래스 InetSocketAddress

java.lang.Object 
  상위를 확장 java.net.SocketAddress 
      상위를 확장 java.net.InetSocketAddress
모든 구현된 인터페이스:
Serializable


public class InetSocketAddress
extends SocketAddress

이 클래스는, IP 소켓 주소 (IP 주소 + 포트 번호)를 구현합니다. 이것은 페어 (호스트명 + 포트 번호)로 할 수도 있습니다. 그 경우, 호스트명의 해결이 시도됩니다. 해결에 실패하면(자), 그 주소는 「미해결」이라고 불리게 됩니다만, 프록시 경유의 접속과 같은 일부의 환경에서는 아직 사용할 수가 있습니다.  

이 클래스는, 바인드 또는 접속을 위해서(때문에) 소켓이 사용한다, 또는 반환값으로서 사용하는 변경 불가능한 객체를 제공합니다.  

「와일드 카드」는 특수한 로컬 IP 주소입니다. 그것은 일반적으로 「임의」를 의미하고 있어,bind 조작인 만큼 사용할 수 있습니다.

도입된 버젼:
1.4
관련 항목:
Socket , ServerSocket , 직렬화 된 형식

생성자 의 개요
InetSocketAddress (InetAddress  addr, int port)
          IP 주소와 포트 번호로부터 소켓 주소를 작성합니다.
InetSocketAddress (int port)
          소켓 주소를 작성합니다.
InetSocketAddress (String  hostname, int port)
          호스트명과 포트 번호로부터 소켓 주소를 작성합니다.
 
메소드의 개요
static InetSocketAddress createUnresolved (String  host, int port)
          호스트명과 포트 번호로부터 미해결의 소켓 주소를 작성합니다.
 boolean equals (Object  obj)
          객체와 지정된 객체를 비교합니다.
 InetAddress getAddress ()
          InetAddress 를 가져옵니다.
 String getHostName ()
          hostname 를 가져옵니다.
 int getPort ()
          포트 번호를 가져옵니다.
 int hashCode ()
          이 소켓 주소의 해시 코드를 돌려줍니다.
 boolean isUnresolved ()
          주소가 해결되었는지의 여부를 조사합니다.
 String toString ()
          이 InetSocketAddress 의 캐릭터 라인 표현을 구축합니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

InetSocketAddress

public InetSocketAddress(int port)
소켓 주소를 작성합니다. 이 경우, IP 주소는 와일드 카드 주소로, 포트 번호는 지정된 값입니다.  

유효한 포트 번호는 0 에서 65535 의 범위입니다. 포트 번호가 0 의 경우는,bind 조작으로 일시적인 포트가 선택됩니다.  

파라미터:
port - 포트 번호
예외:
IllegalArgumentException - port 파라미터가 지정된 유효한 포트치의 범위외인 경우

InetSocketAddress

public InetSocketAddress(InetAddress  addr,
                         int port)
IP 주소와 포트 번호로부터 소켓 주소를 작성합니다.  

유효한 포트 번호는 0 에서 65535 의 범위입니다. 포트 번호가 0 의 경우는,bind 조작으로 일시적인 포트가 선택됩니다.  

주소가 null 의 경우는, 와일드 카드 주소를 할당할 수 있습니다.  

파라미터:
addr - IP 주소
port - 포트 번호
예외:
IllegalArgumentException - port 파라미터가 지정된 유효한 포트치의 범위외인 경우

InetSocketAddress

public InetSocketAddress(String  hostname,
                         int port)
호스트명과 포트 번호로부터 소켓 주소를 작성합니다.  

InetAddress 에의 호스트명의 해결이 시도됩니다. 그 시도가 실패하면(자), 그 주소에는 「미해결」의 플래그를 붙일 수 있습니다.  

시큐리티 매니저가 존재하는 경우, 그 checkConnect 메소드가 호스트명을 인수로 지정해 불려 가 호스트명을 해결하는 권한이 체크됩니다. 이 결과, SecurityException 가 throw 되는 일이 있습니다.  

유효한 포트 번호는 0 에서 65535 의 범위입니다. 포트 번호가 0 의 경우는,bind 조작으로 일시적인 포트가 선택됩니다.  

파라미터:
hostname - 호스트명
port - 포트 번호
예외:
IllegalArgumentException - port 파라미터가 유효한 포트치의 범위외인 경우, 또는 hostname 파라미터가 null 의 경우
SecurityException - 시큐리티 매니저가 존재해, 호스트명을 해결하는 권한이 거부되었을 경우
관련 항목:
isUnresolved()
메소드의 상세

createUnresolved

public static InetSocketAddress  createUnresolved(String  host,
                                                 int port)
호스트명과 포트 번호로부터 미해결의 소켓 주소를 작성합니다.  

InetAddress 에의 호스트명의 해결은 시도되지 않습니다. 이 주소에는 「미해결」의 플래그를 붙일 수 있습니다.  

유효한 포트 번호는 0 에서 65535 의 범위입니다. 포트 번호가 0 의 경우는,bind 조작으로 일시적인 포트가 선택됩니다.  

파라미터:
host - 호스트명
port - 포트 번호
반환값:
미해결의 소켓 주소를 나타내는 InetSocketAddress
예외:
IllegalArgumentException - port 파라미터가 유효한 포트치의 범위외인 경우, 또는 hostname 파라미터가 null 의 경우
도입된 버젼:
1.5
관련 항목:
isUnresolved()

getPort

public final int getPort()
포트 번호를 가져옵니다.

반환값:
포트 번호

getAddress

public final InetAddress  getAddress()
InetAddress 를 가져옵니다.

반환값:
InetAdress. 미해결의 경우는 null

getHostName

public final String  getHostName()
hostname 를 가져옵니다.

반환값:
주소의 호스트명 부분

isUnresolved

public final boolean isUnresolved()
주소가 해결되었는지의 여부를 조사합니다.

반환값:
호스트명으로부터 InetAddress 에의 해결을 할 수 없었던 경우는 true

toString

public String  toString()
이 InetSocketAddress 의 캐릭터 라인 표현을 구축합니다. 이 String 는, InetAddress 의 toString()를 호출해, 게다가 포트 번호를 (구두점 첨부로) 연결하는 것으로 구축됩니다. 주소가 미해결의 경우, 구두점의 전의 부분에는 호스트명만이 포함됩니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 객체의 캐릭터 라인 표현

equals

public final boolean equals(Object  obj)
객체와 지정된 객체를 비교합니다. 인수가 null 는 아니고, 이 객체와 같은 주소를 나타내고 있는 경우에만, 결과가 true 가 됩니다.  

2 개의 InetSocketAddress 인스턴스의 InetAddress (주소가 미해결의 경우는 호스트명)와 포트 번호의 양쪽 모두가 동일한 경우, 양자는 같은 주소를 나타내고 있습니다. 어느 쪽의 주소도 미해결인 경우에는, 호스트명과 포트 번호가 비교됩니다.

오버라이드(override):
클래스 Object 내의 equals
파라미터:
obj - 비교 대상의 객체
반환값:
객체가 동일한 경우는 true, 그렇지 않은 경우는 false
관련 항목:
InetAddress.equals(java.lang.Object)

hashCode

public final int hashCode()
이 소켓 주소의 해시 코드를 돌려줍니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
이 소켓 주소의 해시 코드값
관련 항목:
Object.equals(java.lang.Object) , Hashtable

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.