Socket (Java 2 Platform SE 5.0)

생성자 개요
	`Socket ()` 시스템으로 디폴트가 되어 있는 타입의 SocketImpl를 사용해, 접속되어 있지 않은 소켓을 작성합니다.
	`Socket (InetAddress address, int port)` 스트림 소켓을 작성해, 지정된 IP 주소의 지정된 포트 번호에 접속합니다.
	`Socket (InetAddress host, int port, boolean stream)` 추천하지 않습니다. UDP 전송은 아니고 DatagramSocket를 사용해 주세요.
	`Socket (InetAddress address, int port, InetAddress localAddr, int localPort)` 소켓을 작성해, 지정된 리모트 포트상의 지정된 리모트 주소에 접속합니다.
	`Socket (Proxy proxy)` (존재하는 경우는) 다른 설정에 관계없이 사용하는 프록시의 타입을 지정해, 접속되어 있지 않은 소켓을 작성합니다.
`protected`	`Socket (SocketImpl impl)` 사용자가 지정한 SocketImpl를 사용해, 접속되어 있지 않은 소켓을 작성합니다.
	`Socket (String host, int port)` 스트림 소켓을 작성해, 지정된 호스트상의 지정된 포트 번호에 접속합니다.
	`Socket (String host, int port, boolean stream)` 추천하지 않습니다. UDP 전송은 아니고 DatagramSocket를 사용해 주세요.
	`Socket (String host, int port, InetAddress localAddr, int localPort)` 소켓을 작성해, 지정된 리모트 포트상의 지정된 리모트 호스트에게 접속합니다.

메서드 개요
`void`	`bind (SocketAddress bindpoint)` 소켓을 로컬 주소에 바인드 합니다.
`void`	`close ()` 이 소켓을 닫습니다.
`void`	`connect (SocketAddress endpoint)` 이 소켓을 서버에 접속합니다.
`void`	`connect (SocketAddress endpoint, int timeout)` 지정된 타임 아웃치를 사용해 이 소켓을 서버에 접속합니다.
`SocketChannel`	`getChannel ()` 이 소켓에 관련된 고유 `SocketChannel` 객체를 리턴합니다 (존재하는 경우).
`InetAddress`	`getInetAddress ()` 소켓의 접속처의 주소를 리턴합니다.
`InputStream`	`getInputStream ()` 이 소켓의 입력 스트림을 리턴합니다.
`boolean`	`getKeepAlive ()` SO_KEEPALIVE가 유효한가 어떤가를 조사합니다.
`InetAddress`	`getLocalAddress ()` 소켓의 바인드처의 로컬 주소를 취득합니다.
`int`	`getLocalPort ()` 이 소켓의 바인드처의 로컬 포트를 리턴합니다.
`SocketAddress`	`getLocalSocketAddress ()` 이 소켓이 바인드 되고 있는 단 점의 주소를 리턴합니다.
`boolean`	`getOOBInline ()` OOBINLINE가 유효한가 어떤가를 조사합니다.
`OutputStream`	`getOutputStream ()` 이 소켓의 출력 스트림을 리턴합니다.
`int`	`getPort ()` 이 소켓의 접속처의 리모트 포트를 리턴합니다.
`int`	`getReceiveBufferSize ()` 이 `Socket`로 사용되는 SO_RCVBUF 옵션의 값을 취득합니다.
`SocketAddress`	`getRemoteSocketAddress ()` 이 소켓이 접속되고 있는 단 점의 주소를 리턴합니다.
`boolean`	`getReuseAddress ()` SO_REUSEADDR가 유효한가 어떤가를 조사합니다.
`int`	`getSendBufferSize ()` 이 `Socket`로 사용되는 SO_SNDBUF 옵션의 값을 취득합니다.
`int`	`getSoLinger ()` SO_LINGER 설정을 리턴합니다.
`int`	`getSoTimeout ()` SO_TIMEOUT 설정을 리턴합니다.
`boolean`	`getTcpNoDelay ()` TCP_NODELAY가 유효한가 어떤가를 조사합니다.
`int`	`getTrafficClass ()` 이 소켓으로부터 송신되는 패킷의 IP 헤더의 트래픽 클래스 또는 서비스형을 취득합니다.
`boolean`	`isBound ()` 소켓의 바인딩 상태를 리턴합니다.
`boolean`	`isClosed ()` 소켓이 닫은 상태를 리턴합니다.
`boolean`	`isConnected ()` 소켓의 접속 상태를 리턴합니다.
`boolean`	`isInputShutdown ()` 소켓 접속의 독해측의 반이 닫고 있는지를 리턴합니다.
`boolean`	`isOutputShutdown ()` 소켓 접속의 출력측의 반이 닫고 있는지를 리턴합니다.
`void`	`sendUrgentData (int data)` 소켓상의 1 바이트의 긴급 데이터를 송신합니다.
`void`	`setKeepAlive (boolean on)` SO_KEEPALIVE를 유효 또는 무효로 합니다.
`void`	`setOOBInline (boolean on)` OOBINLINE (TCP 긴급 데이터의 수신)를 유효 또는 무효로 합니다.
`void`	`setPerformancePreferences (int connectionTime, int latency, int bandwidth)` 이 소켓의 퍼포먼스 설정을 실시합니다.
`void`	`setReceiveBufferSize (int size)` SO_RCVBUF 옵션을 이 `Socket`로 지정된 값으로 설정합니다.
`void`	`setReuseAddress (boolean on)` SO_REUSEADDR 소켓 옵션을 유효 또는 무효로 합니다.
`void`	`setSendBufferSize (int size)` SO_SNDBUF 옵션을 이 `Socket`로 지정된 값으로 설정합니다.
`static void`	`setSocketImplFactory (SocketImplFactory fac)` 어플리케이션의 클라이언트 소켓 구현 팩토리를 설정합니다.
`void`	`setSoLinger (boolean on, int linger)` 지정된 지연 시간 (초단위)으로 SO_LINGER를 유효 또는 무효로 합니다.
`void`	`setSoTimeout (int timeout)` 지정된 타임 아웃 (밀리 세컨드 단위)을 사용해, SO_TIMEOUT를 유효 또는 무효로 합니다.
`void`	`setTcpNoDelay (boolean on)` TCP_NODELAY를 유효 또는 무효로 합니다 (Nagle 알고리즘의 유효, 무효의 변환).
`void`	`setTrafficClass (int tc)` 이 Socket 로부터 송신되는 패킷의 IP 헤더의 트래픽 클래스 또는 서비스형 8중창을 설정합니다.
`void`	`shutdownInput ()` 이 소켓의 입력 스트림을 「스트림의 최후」에 배치합니다.
`void`	`shutdownOutput ()` 이 소켓의 출력 스트림을 무효로 합니다.
`String`	`toString ()` 이 소켓을 `String`로 변환합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

생성자 상세

Socket

public Socket()

시스템으로 디폴트가 되어 있는 타입의 SocketImpl를 사용해, 접속되어 있지 않은 소켓을 작성합니다.

도입된 버전 :: JDK1. 1

Socket

public Socket(Proxy  proxy)

(존재하는 경우는) 다른 설정에 관계없이 사용하는 프록시의 타입을 지정해, 접속되어 있지 않은 소켓을 작성합니다.

시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkConnect이 인수로서 프록시 호스트 주소와 포트 번호를 지정해 호출합니다. 이 결과, SecurityException가 되는 일이 있습니다.

례:

Socket s = new Socket(Proxy.NO_PROXY);에 서는 다른 프록시 구성을 무시해, 프레인인 소켓이 작성된다
Socket s = new Socket(new Proxy(Proxy.Type.SOCKS, new InetSocketAddress("socks.mydom.com", 1080)));에 서는 지정된 SOCKS 프록시 서버를 개입시켜 접속하는 소켓이 작성된다

파라미터:: proxy - 사용하는 프록시의 종류를 지정하는 Proxy 객체
예외:: IllegalArgumentException - 프록시의 형태가 무효 또는 null인 경우; SecurityException - 시큐러티 매니저가 존재해, 프록시에의 접속의 접근 권한이 거부되었을 경우
도입된 버전 :: 1.5
관련 항목:: ProxySelector, Proxy

Socket

protected Socket(SocketImpl  impl)
          throws SocketException

사용자가 지정한 SocketImpl를 사용해, 접속되어 있지 않은 소켓을 작성합니다.

파라미터:: impl - 서브 클래스가 Socket 상에서 사용하는 SocketImpl 인스턴스
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: JDK1. 1

Socket

public Socket(String  host,
              int port)
       throws UnknownHostException,

              IOException

스트림 소켓을 작성해, 지정된 호스트상의 지정된 포트 번호에 접속합니다.

지정된 호스트가 null인 경우, 이것은 InetAddress.getByName (null)로 서 주소를 지정하는 것과 같습니다. 즉, 루프백 인터페이스의 주소를 지정하는 것으로 같습니다.

어플리케이션으로 서버 소켓 팩토리를 지정하고 있는 경우는 그 팩토리의 createSocketImpl 메서드가 불려가 실제의 소켓이 작성됩니다. 그렇지 않은 경우는 「프레인인」소켓이 작성됩니다.

시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkConnect이 인수로서 호스트 주소와 port 번호를 지정해 호출합니다. 이 결과, SecurityException가 되는 일이 있습니다.

파라미터:: host - 호스트명. 루프백 주소의 경우는 null; port - 포트 번호
예외:: UnknownHostException - 호스트의 IP 주소를 판정할 수 없었던 경우; IOException - 소켓의 작성중에 입출력 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메서드가 이 조작을 허가하지 않는 경우
관련 항목:: setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

Socket

public Socket(InetAddress  address,
              int port)
       throws IOException

스트림 소켓을 작성해, 지정된 IP 주소의 지정된 포트 번호에 접속합니다.

파라미터:: address - IP 주소; port - 포트 번호
예외:: IOException - 소켓의 작성중에 입출력 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메서드가 이 조작을 허가하지 않는 경우
관련 항목:: setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

Socket

public Socket(String  host,
              int port,
              InetAddress  localAddr,
              int localPort)
       throws IOException

소켓을 작성해, 지정된 리모트 포트상의 지정된 리모트 호스트에게 접속합니다. 소켓은 지정된 로컬 주소와 포트에 바인드 됩니다.

지정된 호스트가 null 인 경우, 이것은 InetAddress.getByName (null)로 서 주소를 지정하는 것과 같습니다. 즉, 루프백 인터페이스의 주소를 지정하는 것으로 같습니다.

파라미터:: host - 리모트 호스트명. 루프백 주소의 경우는 null; port - 리모트 포트; localAddr - 소켓의 바인드처의 로컬 주소; localPort - 소켓의 바인드처의 로컬 포트
예외:: IOException - 소켓의 작성중에 입출력 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메서드가 이 조작을 허가하지 않는 경우
도입된 버전 :: JDK1. 1
관련 항목:: SecurityManager.checkConnect(java.lang.String, int)

Socket

public Socket(InetAddress  address,
              int port,
              InetAddress  localAddr,
              int localPort)
       throws IOException

소켓을 작성해, 지정된 리모트 포트상의 지정된 리모트 주소에 접속합니다. 소켓은 지정된 로컬 주소와 포트에 바인드 됩니다.

파라미터:: address - 리모트 주소; port - 리모트 포트; localAddr - 소켓의 바인드처의 로컬 주소; localPort - 소켓의 바인드처의 로컬 포트
예외:: IOException - 소켓의 작성중에 입출력 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메서드가 이 조작을 허가하지 않는 경우
도입된 버전 :: JDK1. 1
관련 항목:: SecurityManager.checkConnect(java.lang.String, int)

Socket

@Deprecated 
public Socket(String  host,
                         int port,
                         boolean stream)
       throws IOException

추천하지 않습니다. UDP 전송은 아니고 DatagramSocket를 사용해 주세요.

스트림 소켓을 작성해, 지정된 호스트상의 지정된 포트 번호에 접속합니다.

지정된 호스트가 null 인 경우, 이것은 InetAddress.getByName (null)로 서 주소를 지정하는 것과 같습니다. 즉, 루프백 인터페이스의 주소를 지정하는 것으로 같습니다.

stream 인수에 true를 지정하면, 스트림 소켓이 작성됩니다. stream 인수에 false를 지정하면, 데이터 그램 소켓이 작성됩니다.

UDP 소켓을 사용하는 경우, TCP/IP에 관련된 소켓 옵션은 적용되지 않습니다.

파라미터:: host - 호스트명. 루프백 주소의 경우는 null; port - 포트 번호; stream - 스트림 소켓이나 데이터 그램 소켓인지를 나타내는 boolean 치
예외:: IOException - 소켓의 작성중에 입출력 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메서드가 이 조작을 허가하지 않는 경우
관련 항목:: setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

Socket

@Deprecated 
public Socket(InetAddress  host,
                         int port,
                         boolean stream)
       throws IOException

추천하지 않습니다. UDP 전송은 아니고 DatagramSocket를 사용해 주세요.

소켓을 작성해, 지정된 IP 주소에 있는 지정된 포트 번호에 접속합니다.

stream 인수에 true를 지정하면, 스트림 소켓이 작성됩니다. stream 인수에 false를 지정하면, 데이터 그램 소켓이 작성됩니다.

시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkConnect 메서드가 인수로서 host.getHostAddress()와 port 번호를 지정해 호출합니다. 이 결과, SecurityException가 되는 일이 있습니다.

UDP 소켓을 사용하는 경우, TCP/IP에 관련된 소켓 옵션은 적용되지 않습니다.

파라미터:: host - IP 주소; port - 포트 번호; stream - true를 지정했을 경우는 스트림 소켓이 작성되어 그렇지 않은 경우는 데이터 그램 소켓이 작성된다
예외:: IOException - 소켓의 작성중에 입출력 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkConnect 메서드가 이 조작을 허가하지 않는 경우
관련 항목:: setSocketImplFactory(java.net.SocketImplFactory), SocketImpl, SocketImplFactory.createSocketImpl(), SecurityManager.checkConnect(java.lang.String, int)

메서드의 상세

connect

public void connect(SocketAddress  endpoint)
             throws IOException

이 소켓을 서버에 접속합니다.

파라미터:: endpoint - SocketAddress
예외:: IOException - 접속시에 에러가 발생했을 경우; IllegalBlockingModeException - 이 소켓에 관련된 채널이 존재해, 그 채널이 비블로킹 모드의 경우; IllegalArgumentException - 단 점이 null 인 경우, 또는 단 점이 이 소켓으로 지원 되어 있지 않은 SocketAddress 서브 클래스인 경우
도입된 버전 :: 1.4

connect

public void connect(SocketAddress  endpoint,
                    int timeout)
             throws IOException

지정된 타임 아웃치를 사용해 이 소켓을 서버에 접속합니다. 타임 아웃에 0을 지정하면, 타임 아웃은 무한이라고 해석됩니다. 그 경우, 접속이 확립될까 에러가 발생할 때까지, 접속은 블록 됩니다.

파라미터:: endpoint - SocketAddress; timeout - 사용하는 타임 아웃치 (밀리 세컨드)
예외:: IOException - 접속시에 에러가 발생했을 경우; SocketTimeoutException - 접속하기 전에 타임 아웃이 지났을 경우; IllegalBlockingModeException - 이 소켓에 관련된 채널이 존재해, 그 채널이 비블로킹 모드의 경우; IllegalArgumentException - 단 점이 null 인 경우, 또는 단 점이 이 소켓으로 지원 되어 있지 않은 SocketAddress 서브 클래스인 경우
도입된 버전 :: 1.4

bind

public void bind(SocketAddress  bindpoint)
          throws IOException

소켓을 로컬 주소에 바인드 합니다.

주소가 null인 경우는 시스템에 의해 일시적인 포트와 유효한 로컬 주소가 선택되어 소켓이 바인드 됩니다.

파라미터:: bindpoint - 바인드처의 SocketAddress
예외:: IOException - 바인드 조작에 실패했을 경우, 혹은 소켓이 이미 바인드 되고 있는 경우; IllegalArgumentException - bindpoint가 이 소켓으로 지원 되어 있지 않은 SocketAddress 서브 클래스인 경우
도입된 버전 :: 1.4
관련 항목:: isBound()

getInetAddress

public InetAddress  getInetAddress()

소켓의 접속처의 주소를 리턴합니다.

반환값:: 이 소켓의 접속처의 리모트 IP 주소. 소켓이 접속되어 있지 않은 경우는 null

getLocalAddress

public InetAddress  getLocalAddress()

소켓의 바인드처의 로컬 주소를 취득합니다.

반환값:: 소켓의 바인드처의 로컬 주소. 소켓이 아직 바인드되어 있지 않은 경우는 InetAddress.anyLocalAddress()
도입된 버전 :: JDK1. 1

getPort

public int getPort()

이 소켓의 접속처의 리모트 포트를 리턴합니다.

반환값:: 이 소켓의 접속처의 리모트 포트 번호. 소켓이 아직 접속되어 있지 않은 경우는 0

getLocalPort

public int getLocalPort()

이 소켓의 바인드처의 로컬 포트를 리턴합니다.

반환값:: 이 소켓의 바인드처의 로컬 포트 번호. 소켓이 아직 바인드되어 있지 않은 경우는 -1

getRemoteSocketAddress

public SocketAddress  getRemoteSocketAddress()

이 소켓이 접속되고 있는 단 점의 주소를 리턴합니다. 소켓이 접속되어 있지 않은 경우는 null을 리턴합니다.

반환값:: 이 소켓의 리모트단점을 나타내는 SocketAddress. 소켓이 아직 접속되어 있지 않은 경우는 null
도입된 버전 :: 1.4
관련 항목:: getInetAddress(), getPort(), connect(SocketAddress, int), connect(SocketAddress)

getLocalSocketAddress

public SocketAddress  getLocalSocketAddress()

이 소켓이 바인드 되고 있는 단 점의 주소를 리턴합니다. 소켓이 바인드되어 있지 않은 경우는 null을 리턴합니다.

반환값:: 이 소켓의 로컬단점을 나타내는 SocketAddress. 소켓이 아직 바인드되어 있지 않은 경우는 null
도입된 버전 :: 1.4
관련 항목:: getLocalAddress(), getLocalPort(), bind(SocketAddress)

getChannel

public SocketChannel  getChannel()

이 소켓에 관련된 고유 SocketChannel 객체를 리턴합니다 (존재하는 경우).

채널 자체가 SocketChannel.open 메서드 또는 ServerSocketChannel.accept 메서드를 사용해 작성되었을 경우에만, 소켓에 채널이 존재합니다.

반환값:: 이 소켓에 관련된 소켓 채널. 이 소켓이 채널용으로 작성되지 않았던 경우는 null
도입된 버전 :: 1.4

getInputStream

public InputStream  getInputStream()
                           throws IOException

이 소켓의 입력 스트림을 리턴합니다.

이 소켓에 관련된 채널이 존재하는 경우는 결과의 입력 스트림은 그 조작을 모두 채널에 위양 합니다. 그 채널이 비블록 모드의 경우, 입력 스트림의 read 조작으로 IllegalBlockingModeException을 발생시킵니다.

이상한 상황에서는 기본이 되는 접속이 리모트 호스트 또는 네트워크 소프트웨어에 의해 절단 되는 일이 있습니다 (예: TCP 접속의 경우, 접속의 리셋). 네트워크 소프트웨어에 의해 절단 된 접속이 검출되었을 경우, 리턴된 입력 스트림에 이하가 적용됩니다.

네트워크 소프트웨어는 소켓에 의해 버퍼 된 바이트를 파기할 수가 있다. 네트워크 소프트웨어에 의해 파기되지 않는 바이트는 read를 사용해 읽어낼 수가 있다
소켓에 버퍼 된 바이트가 없는 경우, 또는 모든 버퍼 된 바이트가 read 에 의해 소비되었을 경우, read 에의 그 후의 호출은 모두, IOException를 Throw 한다
소켓에 버퍼 된 바이트가 없고, close를 사용해 소켓이 닫혀지지 않은 경우, available 는 0을 돌려준다

반환값:: 이 소켓으로부터 바이트를 읽어내기 위한 입력 스트림
예외:: IOException - 입력 스트림의 작성시에 입출력 에러가 발생했을 경우, 소켓이 닫혀지고 있는 경우, 소켓이 접속되어 있지 않은 경우, 또는 소켓 입력이 shutdownInput()를 사용해 정지되었을 경우

getOutputStream

public OutputStream  getOutputStream()
                             throws IOException

이 소켓의 출력 스트림을 리턴합니다.

이 소켓에 관련된 채널이 존재하는 경우는 결과의 출력 스트림은 그 조작을 모두 채널에 위양 합니다. 채널이 비블록 모드의 경우, 출력 스트림의 write 조작으로 IllegalBlockingModeException을 발생시킵니다.

반환값:: 이 소켓에 바이트를 출력하기 위한 출력 스트림
예외:: IOException - 출력 스트림의 작성중에 입출력 에러가 발생했을 경우, 혹은 소켓이 접속되지 않는 경우

setTcpNoDelay

public void setTcpNoDelay(boolean on)
                   throws SocketException

TCP_NODELAY를 유효 또는 무효로 합니다 (Nagle 알고리즘의 유효, 무효의 변환).

파라미터:: on - TCP_NODELAY를 유효하게 하는 경우는 true, 무효로 하는 경우는 false
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: JDK1. 1
관련 항목:: getTcpNoDelay()

getTcpNoDelay

public boolean getTcpNoDelay()
                      throws SocketException

TCP_NODELAY가 유효한가 어떤가를 조사합니다.

반환값:: TCP_NODELAY가 유효한가 어떤가를 나타내는 boolean 치
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: JDK1. 1
관련 항목:: setTcpNoDelay(boolean)

setSoLinger

public void setSoLinger(boolean on,
                        int linger)
                 throws SocketException

지정된 지연 시간 (초단위)으로 SO_LINGER를 유효 또는 무효로 합니다. 최대 타임 아웃의 값은 플랫폼에 고유합니다. 설정은 소켓을 닫는 경우에만 영향을 줍니다.

파라미터:: on - 지연 시간을 유효하게 할지 어떨지를 지정; linger - on가 true인 경우는 지연 시간
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우; IllegalArgumentException - 지연 시간의 값이 부의 수치인 경우
도입된 버전 :: JDK1. 1
관련 항목:: getSoLinger()

getSoLinger

public int getSoLinger()
                throws SocketException

SO_LINGER 설정을 리턴합니다. 반환값이 -1인 경우는 이 옵션이 무효라는 점을 나타냅니다. 설정은 소켓을 닫는 경우에만 영향을 줍니다.

반환값:: SO_LINGER 설정
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: JDK1. 1
관련 항목:: setSoLinger(boolean, int)

sendUrgentData

public void sendUrgentData(int data)
                    throws IOException

소켓상의 1 바이트의 긴급 데이터를 송신합니다. 송신되는 바이트는 데이터 파라미터의 최하정도 8 비트입니다. 긴급 데이터는 소켓의 OutputStream 에의 모든 선행하는 출력뒤 및 OutputStream 에의 향후의 출력전에 송신됩니다.

파라미터:: data - 송신하는 데이터의 바이트
예외:: IOException - 데이터를 송신할 경우에 에러가 발생했을 경우
도입된 버전 :: 1.4

setOOBInline

public void setOOBInline(boolean on)
                  throws SocketException

OOBINLINE (TCP 긴급 데이터의 수신)를 유효 또는 무효로 합니다. 디폴트에서는 이 옵션은 무효로 소켓으로 수신한 TCP 긴급 데이터는 그대로 파기됩니다. 긴급 데이터를 수신하는 경우는 이 옵션을 유효하게 할 필요가 있습니다. 유효하게 했을 경우, 긴급 데이터는 보통 데이터와 함께 인 라인으로 수신됩니다.

수신하는 긴급 데이터의 처리에는 한정한 지원 밖에 제공되지 않는 것에 주의해 주세요. 특히, 고위 레벨의 프로토콜이 제공되어 있지 않은 경우, 수신하는 긴급 데이터의 통지는 제공되지 않고, 보통 데이터와 긴급 데이터를 구별하는 기능은 없습니다.

파라미터:: on - OOBINLINE를 유효하게 하는 경우는 true, 무효로 하는 경우는 false
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.4
관련 항목:: getOOBInline()

getOOBInline

public boolean getOOBInline()
                     throws SocketException

OOBINLINE가 유효한가 어떤가를 조사합니다.

반환값:: OOBINLINE가 유효한가 어떤가를 나타내는 boolean 치
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.4
관련 항목:: setOOBInline(boolean)

setSoTimeout

public void setSoTimeout(int timeout)
                  throws SocketException

지정된 타임 아웃 (밀리 세컨드 단위)을 사용해, SO_TIMEOUT를 유효 또는 무효로 합니다. 이 옵션에 0 이외의 타임 아웃을 설정해, 이 Socket에 관련한 InputStream에 대해서 read()를 호출하면, 설정한 시간만 블록 됩니다. 타임 아웃이 지나면, Socket는 유효한 그대로 java.net.SocketTimeoutException가 발생합니다. 이 옵션은 블록 조작에 들어가기 전에 유효하게의해 둘필요가 있습니다. 타임 아웃에는 0 보다 큰 값을 지정합니다. 타임 아웃에 0을 지정하면, 타임 아웃은 무한이라고 해석됩니다.

파라미터:: timeout - 밀리 세컨드로 나타내지는 지정된 타임 아웃
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: JDK 1.1
관련 항목:: getSoTimeout()

getSoTimeout

public int getSoTimeout()
                 throws SocketException

SO_TIMEOUT 설정을 리턴합니다. 이 옵션이 무효 (타임 아웃이 무한)의 경우는 0을 리턴합니다.

반환값:: SO_TIMEOUT 설정
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: JDK1. 1
관련 항목:: setSoTimeout(int)

setSendBufferSize

public void setSendBufferSize(int size)
                       throws SocketException

SO_SNDBUF 옵션을 이 Socket로 지정된 값으로 설정합니다. SO_SNDBUF 옵션은 사용하는 네트워크 입출력 버퍼로 설정하는 사이즈의 힌트로서 플랫폼의 네트워크 코드가 사용합니다.

SO_SNDBUF는 힌트이므로 어플리케이션으로 버퍼의 사이즈 설정을 조사할 필요가 있는 경우는 getSendBufferSize()를 호출해 주세요.

파라미터:: size - 송신 버퍼용으로서 설정하는 사이즈. 0 보다 큰 값을 지정할 필요가 있다
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우; IllegalArgumentException - 값이 0 또는 잘못된 값 인 경우
도입된 버전 :: 1.2
관련 항목:: getSendBufferSize()

getSendBufferSize

public int getSendBufferSize()
                      throws SocketException

이 Socket로 사용되는 SO_SNDBUF 옵션의 값을 취득합니다. 이것은 이 Socket로 출력용으로서 플랫폼이 사용하는 버퍼의 사이즈입니다.

반환값:: 이 Socket SO_SNDBUF 옵션의 값
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.2
관련 항목:: setSendBufferSize(int)

setReceiveBufferSize

public void setReceiveBufferSize(int size)
                          throws SocketException

SO_RCVBUF 옵션을 이 Socket로 지정된 값으로 설정합니다. SO_RCVBUF 옵션은 사용하는 네트워크 입출력 버퍼로 설정하는 사이즈의 힌트로서 플랫폼의 네트워크 코드가 사용합니다.

수신 버퍼의 사이즈를 늘리면, 대규모 접속에서의 네트워크 입출력의 퍼포먼스를 올릴 수가 있습니다. 한편, 사이즈를 줄이면, 수신 데이터의 백 로그를 줄일 수가 있습니다.

SO_RCVBUF는 힌트이므로 어플리케이션으로 버퍼의 사이즈 설정을 조사할 필요가 있는 경우는 getReceiveBufferSize()를 호출해 주세요.

SO_RCVBUF 값은 리모트 피어에 통지되는 TCP 수신 윈도우의 설정에도 사용됩니다. 일반적으로 윈도우 사이즈는 소켓의 접속시에 언제라도 변경할 수 있습니다. 다만, 64K 보다 큰 수신 윈도우가 필요한 경우는 소켓을 리모트 피어에 접속하기전으로 변경을 요구할 필요가 있습니다. 다음의 2개의 점에 유의해 주세요.

ServerSocket 로부터 받아들인 소켓의 경우, ServerSocket를 로컬 주소에 바인드 하기 전에 ServerSocket.setReceiveBufferSize(int)를 호출해 이것을 실행할 필요가 있다
클라이언트 소켓의 경우, 소켓을 그 리모트 피어에 접속하기 전에 setReceiveBufferSize()를 호출할 필요가 있다

파라미터:: size - 수신 버퍼용으로서 설정하는 사이즈. 0 보다 큰 값을 지정할 필요가 있다
예외:: IllegalArgumentException - 값이 0 또는 잘못된 값 인 경우; SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.2
관련 항목:: getReceiveBufferSize(), ServerSocket.setReceiveBufferSize(int)

getReceiveBufferSize

public int getReceiveBufferSize()
                         throws SocketException

이 Socket로 사용되는 SO_RCVBUF 옵션의 값을 취득합니다. 이것은 이 Socket로 입력용으로서 플랫폼이 사용하는 버퍼의 사이즈입니다.

반환값:: 이 Socket SO_RCVBUF 옵션의 값
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.2
관련 항목:: setReceiveBufferSize(int)

setKeepAlive

public void setKeepAlive(boolean on)
                  throws SocketException

SO_KEEPALIVE를 유효 또는 무효로 합니다.

파라미터:: on - 소켓을 온대로의해 둘지 어떨지를 지정
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.3
관련 항목:: getKeepAlive()

getKeepAlive

public boolean getKeepAlive()
                     throws SocketException

SO_KEEPALIVE가 유효한가 어떤가를 조사합니다.

반환값:: SO_KEEPALIVE가 유효한가 어떤가를 나타내는 boolean 치
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.3
관련 항목:: setKeepAlive(boolean)

setTrafficClass

public void setTrafficClass(int tc)
                     throws SocketException

이 Socket 로부터 송신되는 패킷의 IP 헤더의 트래픽 클래스 또는 서비스형 8중창을 설정합니다. 사용하는 네트워크 구현이 이 값을 무시하는 일이 있으므로 어플리케이션에서는 이 값을 힌트라고 생각해 주세요.

tc 범위는 0 <= tc <= 255가 아니면 안됩니다. 그렇지 않은 경우는 IllegalArgumentException 이 발생 됩니다.

주:

IP (Internet Protocol) 버전 4인 경우, RFC 1349 로 설명되고 있도록, 이 값은 우선 순위의 높은 8중창과 TOS 필드로 구성됩니다. TOS 필드는 다음과 같이 비트 단위의 논리합에 의해 작성되는 비트 세트입니다.

IPTOS_LOWCOST (0x02)
IPTOS_RELIABILITY (0x04)
IPTOS_THROUGHPUT (0x08)
IPTOS_LOWDELAY (0x10)

최하정도 비트는 MBZ (0 이 아니면 안된다) 비트에 대응하므로 항상 무시됩니다.

우선 필드에 비트를 설정하면, 조작이 허가되지 않는 것을 나타내는 SocketException가 되는 일이 있습니다.

IP (Internet Protocol) 버전 6인 경우, tc는 IP 헤더의 sin6_flowinfo 필드에 포함되는 값입니다.

파라미터:: tc - 비트 세트의 int값
예외:: SocketException - 트래픽 클래스 또는 서비스형을 설정할 경우에 에러가 발생했을 경우
도입된 버전 :: 1.4
관련 항목:: getTrafficClass()

getTrafficClass

public int getTrafficClass()
                    throws SocketException

이 소켓으로부터 송신되는 패킷의 IP 헤더의 트래픽 클래스 또는 서비스형을 취득합니다.

배후의 네트워크 구현이, setTrafficClass(int)를 사용해 설정된 트래픽 클래스 또는 서비스형을 무시하는 일이 있으므로 이 Socket 로 setTrafficClass(int) 메서드를 사용해 이전으로 설정된 값과는 다른 값이 이 메서드로부터 리턴된 일이 있습니다.

반환값:: 이미 설정되어 있는 트래픽 클래스 또는 서비스형
예외:: SocketException - 트래픽 클래스 또는 서비스형의 값을 취득할 경우에 에러가 발생했을 경우
도입된 버전 :: 1.4
관련 항목:: setTrafficClass(int)

setReuseAddress

public void setReuseAddress(boolean on)
                     throws SocketException

SO_REUSEADDR 소켓 옵션을 유효 또는 무효로 합니다.

TCP 접속을 닫으면, 접속이 닫은뒤 접속이 일정한 시간 타임 아웃 상태대로 되는 일이 있습니다 (보통, TIME_WAIT 상태 또는 2MSL 대기 상태로 불린다). 주지의 소켓 주소 또는 포트를 사용하는 어플리케이션의 경우, 소켓 주소 또는 포트에 관련된 접속이 타임 아웃 상태에 있으면, 소켓을 필요한 SocketAddress에 바인드 할 수 없는 것이 있습니다.

bind(SocketAddress)를 사용해 소켓을 바인드 하기 전에 SO_REUSEADDR를 유효하게 하면, 이전의 접속이 타임 아웃 상태에서도 소켓을 바인드 할 수 있습니다 .

Socket가 작성되면, SO_REUSEADDR 초기설정은 무효가 됩니다.

소켓이 바인드 되었다 (isBound()를 참조) 나중에 SO_REUSEADDR를 유효 또는 무효로 하는 경우의 동작은 정의되지 않습니다.

파라미터:: on - 소켓 옵션을 유효하게 할까 무효로 하는지를 지정
예외:: SocketException - SO_RESUEADDR 소켓 옵션을 유효 또는 무효로 할 경우에 에러가 발생하는 경우, 혹은 소켓이 닫고 있는 경우
도입된 버전 :: 1.4
관련 항목:: getReuseAddress(), bind(SocketAddress), isClosed(), isBound()

getReuseAddress

public boolean getReuseAddress()
                        throws SocketException

SO_REUSEADDR가 유효한가 어떤가를 조사합니다.

반환값:: SO_REUSEADDR가 유효한가 어떤가를 나타내는 boolean 치
예외:: SocketException - 기본이 되는 프로토콜로 TCP 에러등의 에러가 발생했을 경우
도입된 버전 :: 1.4
관련 항목:: setReuseAddress(boolean)

close

public void close()
           throws IOException

이 소켓을 닫습니다.

현재 이 소켓의 입출력 조작으로 블록 떠날 수 있어 모든 thread가 SocketException를 Throw 합니다.

소켓이 닫혀지면, 그 후의 네트워크에 그 소켓을 사용할 수 없습니다 (즉, 재접속 또는 재바인드는 할 수 없다). 새로운 소켓을 작성할 필요가 있습니다.

이 소켓에 관련된 채널이 존재하는 경우는 그 채널도 닫혀집니다.

예외:: IOException - 이 소켓을 닫을 때 입출력 에러가 발생했을 경우
관련 항목:: isClosed()

shutdownInput

public void shutdownInput()
                   throws IOException

이 소켓의 입력 스트림을 「스트림의 최후」에 배치합니다. 소켓의 입력 스트림 측에 송신된 데이터는 확인되어 그대로 파기됩니다.

소켓으로 shutdownInput()를 호출한 뒤에 소켓의 입력 스트림로부터 읽어내면, 스트림은 EOF를 리턴합니다.

예외:: IOException - 이 소켓을 정지할 경우에 입출력 에러가 발생했을 경우
도입된 버전 :: 1.3
관련 항목:: shutdownOutput(), close(), setSoLinger(boolean, int), isInputShutdown()

shutdownOutput

public void shutdownOutput()
                    throws IOException

이 소켓의 출력 스트림을 무효로 합니다. TCP 소켓의 경우, 이미 출력해지고 있는 데이터가 송신되어 그 후에 TCP 보통 의 접속 종료 처리가 계속됩니다. 소켓으로 shutdownOutput()를 호출한 뒤에 소켓의 출력 스트림에 출력하면, 스트림은 IOException을 Throw 합니다.

예외:: IOException - 이 소켓을 정지할 경우에 입출력 에러가 발생했을 경우
도입된 버전 :: 1.3
관련 항목:: shutdownInput(), close(), setSoLinger(boolean, int), isOutputShutdown()

toString

public String  toString()

이 소켓을 String로 변환합니다.

오버라이드(override):: 클래스 Object 내의 toString

반환값:: 이 소켓의 캐릭터 라인 표현

isConnected

public boolean isConnected()

소켓의 접속 상태를 리턴합니다.

반환값:: 소켓이 서버에 정상적으로 접속되고 있는 경우는 true
도입된 버전 :: 1.4

isBound

public boolean isBound()

소켓의 바인딩 상태를 리턴합니다.

반환값:: 소켓이 정상적으로 주소에 바인드 되고 있는 경우는 true
도입된 버전 :: 1.4
관련 항목:: bind(java.net.SocketAddress)

isClosed

public boolean isClosed()

소켓이 닫은 상태를 리턴합니다.

반환값:: 소켓이 닫았을 경우는 true
도입된 버전 :: 1.4
관련 항목:: close()

isInputShutdown

public boolean isInputShutdown()

소켓 접속의 독해측의 반이 닫고 있는지를 리턴합니다.

반환값:: 소켓의 입력이 정지했을 경우는 true
도입된 버전 :: 1.4
관련 항목:: shutdownInput()

isOutputShutdown

public boolean isOutputShutdown()

소켓 접속의 출력측의 반이 닫고 있는지를 리턴합니다.

반환값:: 소켓의 출력이 정지했을 경우는 true
도입된 버전 :: 1.4
관련 항목:: shutdownOutput()

setSocketImplFactory

public static void setSocketImplFactory(SocketImplFactory  fac)
                                 throws IOException

어플리케이션의 클라이언트 소켓 구현 팩토리를 설정합니다. 팩토리를 설정할 수 있는 것은 1회 뿐입니다.

어플리케이션으로 새로운 클라이언트 소켓을 작성하면, 소켓 구현 팩토리의 createSocketImpl 메서드가 불려가 실제의 소켓이 작성됩니다.

팩토리가 이미 설정되어 있지 않은 한, 메서드에 null을 건네주어도 아무것도 행해지지 않습니다.

시큐러티 매니저가 존재하는 경우, 이 메서드는 최초로 시큐러티 매니저의 checkSetFactory 메서드를 호출하는 것으로 이 조작이 허가되고 있는 것을 확인합니다. 이 결과, SecurityException가 되는 일이 있습니다.

파라미터:: fac - 목적의 팩토리
예외:: IOException - 소켓 팩토리의 설정중에 입출력 에러가 발생했을 경우; SocketException - 팩토리가 이미 정의되고 있는 경우; SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkSetFactory 메서드가 이 조작을 허가하지 않는 경우
관련 항목:: SocketImplFactory.createSocketImpl(), SecurityManager.checkSetFactory()

setPerformancePreferences

public void setPerformancePreferences(int connectionTime,
                                      int latency,
                                      int bandwidth)

이 소켓의 퍼포먼스 설정을 실시합니다.

소켓은 디폴트로 TCP/IP 프로토콜을 사용합니다. 구현에 따라서는 TCP/IP와는 다른 퍼포먼스 특성을 가지는 대체 프로토콜이 제공되는 일도 있습니다. 어플리케이션은 이 메서드를 사용하는 것으로 구현으로 이용 가능한 프로토콜의 선택시에 이러한 균형의 취하는 방법을 나타내는 독자적인 설정을 표현할 수 있습니다.

퍼포먼스 설정은 접속 시간의 짧음, 응답 시간의 속도, 대역폭의 넓이의 상대적인 중요도를 나타내는 3개의 정수값에 의해 기술됩니다. 정수의 절대치에 관계성은 없고, 프로토콜을 선택하기 위해서 값을 단지 비교합니다. 값이 크면보다 강한 설정을 나타냅니다. 잘못된 값은 정의 값보다 우선 순위가 낮은 일을 나타냅니다. 어플리케이션이 응답 시간의 속도와 대역폭의 넓이보다 접속 시간의 짧음을 우선하는 경우, 이 메서드를 (1, 0, 0) 이라고 하는 값으로 호출할 수 있습니다 . 어플리케이션이 응답 시간의 속도보다 대역폭의 넓이를, 또 접속 시간의 짧음보다 응답 시간의 속도를 우선하는 경우, 이 메서드를 (0, 1, 2) 이라고 하는 값으로 호출할 수 있습니다 .

이 소켓이 접속된 뒤에 이 메서드를 호출해도, 아무것도 행해지지 않습니다.

파라미터:: connectionTime - 접속 시간의 짧음의 상대적인 중요도를 나타내는 int; latency - 응답 시간의 속도의 상대적인 중요도를 나타내는 int; bandwidth - 대역폭의 넓이의 상대적인 중요도를 나타내는 int
도입된 버전 :: 1.5

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.net 클래스 Socket

Socket

Socket

Socket

Socket

Socket

Socket

Socket

Socket

Socket

connect

connect

bind

getInetAddress

getLocalAddress

getPort

getLocalPort

getRemoteSocketAddress

getLocalSocketAddress

getChannel

getInputStream

getOutputStream

setTcpNoDelay

getTcpNoDelay

setSoLinger

getSoLinger

sendUrgentData

setOOBInline

getOOBInline

setSoTimeout

getSoTimeout

setSendBufferSize

getSendBufferSize

setReceiveBufferSize

getReceiveBufferSize

setKeepAlive

getKeepAlive

setTrafficClass

getTrafficClass

setReuseAddress

getReuseAddress

close

shutdownInput

shutdownOutput

toString

isConnected

isBound

isClosed

isInputShutdown

isOutputShutdown

setSocketImplFactory

setPerformancePreferences

java.net
클래스 Socket