java.nio.channels
클래스 SocketChannel

java.lang.Object 
  java.nio.channels.spi.AbstractInterruptibleChannel 
      java.nio.channels.SelectableChannel 
          java.nio.channels.spi.AbstractSelectableChannel 
              java.nio.channels.SocketChannel

모든 구현된 인터페이스:

Closeable, ByteChannel, Channel, GatheringByteChannel, InterruptibleChannel, ReadableByteChannel, ScatteringByteChannel, WritableByteChannel

public abstract class SocketChannel
extends AbstractSelectableChannel 
implements ByteChannel,
 ScatteringByteChannel,
 GatheringByteChannel 

스트림형 접속 소켓용의 선택 가능 채널입니다.

소켓 채널은 네트워크 소켓 접속의 완전한 추상화가 아닙니다. 소켓 옵션의 바인드, 정지, 조작은, socket 메서드의 호출에 의해 취득한 관련 Socket 객체를 개입시켜 실시할 필요가 있습니다. 임의의 기존 소켓의 채널을 작성하거나 소켓 채널에 관련한 소켓으로 SocketImpl 객체를 사용하도록 지정하거나 할 수 없습니다.

소켓 채널은 이 클래스의 open 메서드를 호출하면 작성됩니다. 새롭게 작성된 소켓 채널은 오픈입니다만, 미접속입니다. 미접속의 소켓 채널에 대해서 입출력 조작을 호출하려고 하면, NotYetConnectedException을 발생시킵니다. 소켓 채널을 접속하려면, 소켓 채널의 connect 메서드를 호출합니다. 접속된 소켓 채널은 클로우즈 할 때까지 접속된 채로 있습니다. 소켓 채널이 접속되고 있을지 어떨지는 isConnected 메서드의 호출에 의해 판단할 수 있습니다.

소켓 채널은 「비블록 접속」을 지원 합니다. 소켓 채널의 작성과 리모트 소켓에의 링크의 확립 프로세스는 connect 메서드에 의해 시작되어 나중에 finishConnect 메서드에 의해 완료합니다. 접속 조작이 실행중일지 어떨지는 isConnectionPending 메서드의 호출에 의해 판단할 수 있습니다.

소켓 채널의 입력측과 출력측은 실제로 채널을 클로우즈 하는 일 없이, 따로 따로 「정지」할 수 있습니다. 관련 소켓 객체의 shutdownInput 메서드를 호출해 채널의 입력측을 정지한뒤 또한 채널을 읽어내려고 하면, 스트림의 마지막을 나타내는 -1 이 리턴됩니다 . 관련 소켓 객체의 shutdownOutput 메서드를 호출해 채널의 출력측을 정지한뒤 또한 채널에 출력하려고 하면, ClosedChannelException을 발생시킵니다.

소켓 채널은, Channel 클래스로 가리키는 비동기 클로우즈 조작과 자주 닮은 「비동기 정지」를 지원 합니다. 소켓의 채널에 대한 read 조작의 도중에 블록 된 thread가 있을 때, 다른 thread가 소켓의 입력측을 정지했을 경우, 블록 된 thread의 read 조작은 바이트를 일절 읽어내는 일 없이 종료해, -1를 리턴합니다. 소켓의 채널에 대한 출력 조작의 도중에 블록 된 thread가 있을 때, 다른 thread가 소켓의 출력측을 정지했을 경우, 블록 된 thread는 AsynchronousCloseException를 받습니다.

소켓 채널은 복수의 병행 thread로 안전하게 사용할 수 있습니다. 소켓 채널은 병행 read 및 병행 write를 지원 합니다. 다만, read를 실시하는 thread와 write를 실시하는 thread는 항상 1개 이하입니다. connect 메서드와 finishConnect 메서드는 서로 동기 하고 있어, 어느 쪽인지 한편의 메서드의 처리가 진행중에 읽기 또는 출력조작을 개시하려고 하면, 그 처리는 메서드의 호출 처리가 완료할 때까지 블록 됩니다.

도입된 버전 :

1.4

생성자 개요

protected

SocketChannel (SelectorProvider provider) 이 클래스의 새로운 인스턴스를 초기화합니다.

메서드 개요

abstract boolean	connect (SocketAddress remote) 이 채널의 소켓을 접속합니다.
abstract boolean	finishConnect () 소켓 채널의 접속 처리를 완료합니다.
abstract boolean	isConnected () 이 채널의 네트워크 소켓이 접속되고 있는지를 판단합니다.
abstract boolean	isConnectionPending () 이 채널상에서 접속 조작이 진행중인가 어떤가를 판단합니다.
static SocketChannel	open () 소켓 채널을 오픈합니다.
static SocketChannel	open (SocketAddress remote) 소켓 채널을 오픈해, 리모트 주소에 접속합니다.
abstract int	read (ByteBuffer dst) 이 채널의 바이트 순서를 지정의 버퍼에 읽어들입니다.
long	read (ByteBuffer [] dsts) 이 채널의 바이트 순서가 지정된 버퍼에 읽어들입니다.
abstract long	read (ByteBuffer [] dsts, int offset, int length) 이 채널의 바이트 순서가 지정된 버퍼의 서브 순서에 읽어들입니다.
abstract Socket	socket () 이 채널에 관련한 소켓을 취득합니다.
int	validOps () 이 채널의 지원 되고 있는 조작을 식별하는 조작 세트를 리턴합니다.
abstract int	write (ByteBuffer src) 이 채널의 바이트 순서를 지정의 버퍼로부터 써냅니다.
long	write (ByteBuffer [] srcs) 이 채널의 바이트 순서가 지정된 버퍼로부터 써냅니다.
abstract long	write (ByteBuffer [] srcs, int offset, int length) 이 채널의 바이트 순서가 지정된 버퍼의 서브 순서로부터 써냅니다.

클래스 java.nio.channels.spi. AbstractSelectableChannel 로부터 상속된 메서드

blockingLock, configureBlocking, implCloseChannel, implCloseSelectableChannel, implConfigureBlocking, isBlocking, isRegistered, keyFor, provider, register

클래스 java.nio.channels. SelectableChannel 로부터 상속된 메서드

register

클래스 java.nio.channels.spi. AbstractInterruptibleChannel 로부터 상속된 메서드

begin, close, end, isOpen

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

인터페이스 java.nio.channels. Channel 로부터 상속된 메서드

close, isOpen

인터페이스 java.nio.channels. Channel 로부터 상속된 메서드

close, isOpen

인터페이스 java.nio.channels. Channel 로부터 상속된 메서드

close, isOpen

인터페이스 java.nio.channels. Channel 로부터 상속된 메서드

close, isOpen

생성자 상세

SocketChannel

protected SocketChannel(SelectorProvider  provider)

이 클래스의 새로운 인스턴스를 초기화합니다.

메서드의 상세

open

public static SocketChannel  open()
                          throws IOException 

소켓 채널을 오픈합니다.

새로운 채널은 시스템 전체의 디폴트인 SelectorProvider 객체의 openSocketChannel 메서드를 호출하면 작성됩니다.

반환값:

새로운 소켓 채널

예외:

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

open

public static SocketChannel  open(SocketAddress  remote)
                          throws IOException 

소켓 채널을 오픈해, 리모트 주소에 접속합니다.

이 간이 메서드는 open() 메서드를 호출해, 작성된 소켓 채널에 대해서 remote를 지정한 connect 메서드를 호출했을 경우와 같이 기능합니다. 반환값은 작성된 채널입니다.

파라미터:

remote - 새로운 채널의 접속처 리모트 주소

예외:

AsynchronousCloseException - 접속 조작의 진행중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - 접속 조작의 진행중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

UnresolvedAddressException - 지정된 리모트 주소가 완전하게 해결되지 않는 경우

UnsupportedAddressTypeException - 지정된 리모트 주소의 타입이 지원 대상외의 경우

SecurityException - 시큐러티 매니저가 인스톨 되고 있어, 지정된 리모트 엔드 포인트에의 액세스가 허가되어 있지 않은 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

validOps

public final int validOps()

이 채널의 지원 되고 있는 조작을 식별하는 조작 세트를 리턴합니다.

소켓 채널은 접속, 읽기, write를 지원 하므로 이 메서드는 (SelectionKey.OP_CONNECT | SelectionKey.OP_READ | SelectionKey.OP_WRITE )을 리턴합니다.

정의:

클래스 SelectableChannel 내의 validOps

반환값:

유효한 조작 세트

socket

public abstract Socket  socket()

이 채널에 관련한 소켓을 취득합니다.

리턴된 객체는 Socket 클래스에서 선언되어 있지 않은 public 메서드는 선언하지 않습니다.

반환값:

이 채널에 관련한 소켓

isConnected

public abstract boolean isConnected()

이 채널의 네트워크 소켓이 접속되고 있는지를 판단합니다.

반환값:

이 채널의 네트워크 소켓이 접속되고 있는 경우에 한정해 true

isConnectionPending

public abstract boolean isConnectionPending()

이 채널상에서 접속 조작이 진행중인가 어떤가를 판단합니다.

반환값:

이 채널상에서 접속 조작이 개시되었지만, 아직 완료하고 있지 않는 (finishConnect 메서드가 불려가 지 않았다) 경우에 한정해 true

connect

public abstract boolean connect(SocketAddress  remote)
                         throws IOException 

이 채널의 소켓을 접속합니다.

이 채널이 비블록 모드의 경우, 이 메서드의 호출에의해 비블록 접속 조작이 개시됩니다. 로컬 접속의 경우와 같이 즉석에서 접속이 확립되는 경우, 이 메서드는 true를 리턴합니다. 그 외의 경우는 false를 리턴합니다. 이 경우는 나중에 finishConnect 메서드를 호출하는 것으로 접속 조작을 완료할 필요가 있습니다.

이 채널이 블록 모드의 경우, 이 메서드의 호출은 접속이 확립될까 입출력 에러가 발생할 때까지 블록 됩니다.

이 메서드는 Socket 클래스와 완전히 같은 시큐러티 체크를 실시합니다. 시큐러티 매니저가 인스톨 되고 있는 경우, 이 메서드는 지정된 리모트 엔드 포인트의 주소 및 포트 번호에의 접속을 시큐러티 매니저의 checkConnect 메서드가 허가하는 것을 확인합니다.

이 메서드는 언제라도 호출할 수 있습니다 . 이 메서드의 호출 처리의 진행중에 이 채널에 대한 read 또는 출력조작을 호출했을 경우, 호출 처리가 완료할 때까지 그 조작은 블록 됩니다. 접속하려고 했지만 실패했을 경우, 즉 이 메서드의 호출이 체크되는 예외를 Throw 했을 경우, 채널은 클로우즈 됩니다.

파라미터:

remote - 이 채널의 접속처 리모트 주소

반환값:

접속이 확립되었을 경우는 true, 이 채널이 비블록 모드로 접속 조작의 실행중인 경우는 false

예외:

AlreadyConnectedException - 이 채널이 이미 접속되고 있는 경우

ConnectionPendingException - 이 채널로 이미 비블록 접속 조작이 실행중인 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - 접속 조작의 진행중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - 접속 조작의 진행중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

UnresolvedAddressException - 지정된 리모트 주소가 완전하게 해결되지 않는 경우

UnsupportedAddressTypeException - 지정된 리모트 주소의 타입이 지원 대상외의 경우

SecurityException - 시큐러티 매니저가 인스톨 되고 있어, 지정된 리모트 엔드 포인트에의 액세스가 허가되어 있지 않은 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

finishConnect

public abstract boolean finishConnect()
                               throws IOException 

소켓 채널의 접속 처리를 완료합니다.

소켓 채널을 비블록 모드로 하고 나서 connect 메서드를 호출하면, 비블록 접속 조작이 개시됩니다. 접속이 확립되는지, 접속에 실패한뒤 소켓 채널은 접속 가능한 상태가 되어, 이 메서드를 호출해 접속 순서를 완료할 수 있습니다 . 접속 조작에 실패했을 경우에 이 메서드를 호출하면, 해당하는 IOException을 발생시킵니다.

이 채널이 이미 접속되고 있는 경우, 이 메서드는 블록 되어 즉시 true를 리턴합니다. 이 채널이 비블록 모드의 경우, 접속 처리가 아직 완료하고 있지 않으면, 이 메서드는 false를 리턴합니다. 이 채널이 블록 모드의 경우, 접속이 완료하는지 실패할 때까지 이 메서드는 블록 됩니다. 덧붙여 접속이 완료했을 경우는 true가 돌려주고져 접속에 실패했을 경우는 체크되는 예외가 발생 됩니다.

이 메서드는 언제라도 호출할 수 있습니다 . 이 메서드의 호출 처리의 진행중에 이 채널에 대한 read 또는 출력조작을 호출했을 경우, 호출 처리가 완료할 때까지 그 조작은 블록 됩니다. 접속이 실패했을 경우, 즉 이 메서드의 호출이 체크되는 예외를 Throw 했을 경우, 채널은 클로우즈 됩니다.

반환값:

이 채널의 소켓이 접속되고 있는 경우에 한정해 true

예외:

NoConnectionPendingException - 이 채널이 접속되지 않고, 접속 조작도 시작되어 있지 않은 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - 접속 조작의 진행중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - 접속 조작의 진행중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

read

public abstract int read(ByteBuffer  dst)
                  throws IOException 

인터페이스 ReadableByteChannel 기술:

이 채널의 바이트 순서를 지정의 버퍼에 읽어들입니다.

채널로부터 최대 r 바이트를 읽어내려고 합니다. r는 이 메서드를 호출할 때 버퍼내에 존재하는 바이트수, dst.remaining()가 됩니다.

길이 n (0 <= n <= r)의 바이트 순서가 읽어내진다고 합니다. 이 바이트 순서가 버퍼에 전송 되기 때문에 순서내의 최초의 바이트의 인덱스는 p, 마지막 바이트의 인덱스는 p + n - 1 이 됩니다. 덧붙여p는 이 메서드를 호출할 때의 버퍼의 위치입니다. 버퍼의 위치는 돌려주고질 때 p + n에 동일해집니다. 리밋트에 변화는 없습니다.

read 조작에 의해 버퍼가 가득 된다고는인가 선. 바이트가 일절 읽어내지지 않은 경우도 있습니다. 버퍼가 가득 될지 어떨지는 채널의 본래의 성질과 상태에 의해 결정합니다. 예를 들어 비블록 모드의 소켓은 소켓의 입력 버퍼로부터 즉시 취득할 수 있는 바이트 이외를 읽어낼 수가 없습니다. 같이 파일 채널은 파일내의 바이트 이외를 읽어낼 수가 없습니다. 다만, 채널이 블록 모드이며, 버퍼내의 바이트수가 1 바이트 이상의 경우, 1 바이트 이상이 읽어내질 때까지 이 메서드는 블록 되게 되어 있습니다.

이 메서드는 언제라도 호출할 수 있습니다. 다만, 다른 thread가 이 채널에 대해서 읽기 조작을 개시하고 있는 경우, 이 메서드의 호출은 최초의 조작이 끝날 때까지 블록 됩니다.

정의:

인터페이스 ReadableByteChannel 내의 read

파라미터:

dst - 바이트의 전송처 버퍼

반환값:

읽힌 문자수. 제로인가 채널이 스트림의 마지막에 이르고 있는 경우는 -1

예외:

NotYetConnectedException - 이 채널이 아직 접속되어 있지 않은 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - read 조작의 진행중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - read 조작의 진행중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

read

public abstract long read(ByteBuffer [] dsts,
                          int offset,
                          int length)
                   throws IOException 

인터페이스 ScatteringByteChannel 기술:

이 채널의 바이트 순서가 지정된 버퍼의 서브 순서에 읽어들입니다.

이 메서드 호출은 이 채널로부터 최대 r 바이트를 읽어내려고 합니다. r는 이 메서드의 호출시로 지정된 버퍼 배열의 지정된 서브 순서에 포함되는 합계 바이트수입니다.

 dsts[offset]. remaining() + dsts[offset+1]. remaining() + ... + dsts[offset+length-1]. remaining()

길이 n (0 <= n <= r)의 바이트 순서가 읽어내진다고 합니다. 이 순서의 최초의 dsts[offset]. remaining() 바이트까지가 버퍼 dsts[offset]에 전송 되어 다음의 dsts[offset+1]. remaining() 바이트까지가 버퍼 dsts[offset+1]에 전송 됩니다. 이 처리는 모든 바이트 순서가 지정된 버퍼에 전송 될 때까지 반복해집니다. 각 버퍼에는 최대한의 바이트가 전송 되기 때문에 최종 갱신 버퍼를 제외한 개개의 갱신 버퍼의 최종적인 위치는 이 버퍼의 리밋트와 동일해집니다.

이 메서드는 언제라도 호출할 수 있습니다. 다만, 다른 thread가 이 채널에 대해서 읽기 조작을 개시하고 있는 경우, 이 메서드의 호출은 최초의 조작이 끝날 때까지 블록 됩니다.

정의:

인터페이스 ScatteringByteChannel 내의 read

파라미터:

dsts - 바이트의 전송처 버퍼

offset - 최초의 바이트의 전송처가 되는 버퍼 배열내의 오프셋(offset). dsts.length 아래의 제로 또는 정의 수

length - 액세스 가능한 최대 버퍼수. dsts.length - offset 아래의 제로 또는 정의 수

반환값:

읽힌 문자수. 제로인가 채널이 스트림의 마지막에 이르고 있는 경우는 -1

예외:

NotYetConnectedException - 이 채널이 아직 접속되어 있지 않은 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - read 조작의 진행중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - read 조작의 진행중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

read

public final long read(ByteBuffer [] dsts)
                throws IOException 

인터페이스 ScatteringByteChannel 기술:

이 채널의 바이트 순서가 지정된 버퍼에 읽어들입니다.

이 메서드를 c.read(dsts) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

 c.read(dsts, 0, srcs.length);

정의:

인터페이스 ScatteringByteChannel 내의 read

파라미터:

dsts - 바이트의 전송처 버퍼

반환값:

읽힌 문자수. 제로인가 채널이 스트림의 마지막에 이르고 있는 경우는 -1

예외:

NotYetConnectedException - 이 채널이 아직 접속되어 있지 않은 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - read 조작의 진행중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - read 조작의 진행중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

write

public abstract int write(ByteBuffer  src)
                   throws IOException 

인터페이스 WritableByteChannel 기술:

이 채널의 바이트 순서를 지정의 버퍼로부터 써냅니다.

채널에 최대 r 바이트를 출력하려고 합니다. r는 이 메서드를 호출할 때 버퍼내에 존재하는 바이트수, dst.remaining()가 됩니다.

길이 n (0 <= n <= r)의 바이트 순서가 출력해진다고 합니다. 이 바이트 순서는 버퍼의 인덱스 p 로부터 전송 됩니다. p는 이 메서드를 호출한 시점의 버퍼의 위치입니다. 출력해지는 마지막 바이트는 p + n - 1 이 됩니다. 버퍼의 위치는 종료시에 p + n에 동일해집니다. 리밋트에 변화는 없습니다.

특히 지정이 없는 한, 요구된 r 바이트가 모두 출력해지면 출력 조작은 종료합니다. 채널의 종류에 따라서는 그 상태에 응해, 일부의 바이트 밖에 출력해지지 않은 경우나, 전혀 write를 하지 않는 경우도 있습니다. 예를 들어 비블록 모드의 소켓 채널에서는 소켓의 출력 버퍼내의 바이트수가 최대 출력 바이트수가 됩니다.

이 메서드는 언제라도 호출할 수 있습니다. 다만, 다른 thread가 이 채널에 대해서 출력조작을 개시하고 있는 경우, 이 메서드의 호출은 최초의 조작이 끝날 때까지 블록 됩니다.

정의:

인터페이스 WritableByteChannel 내의 write

파라미터:

src - 바이트의 취득처 버퍼

반환값:

출력해지는 바이트수. 제로의 경우도 있다

예외:

NotYetConnectedException - 이 채널이 아직 접속되어 있지 않은 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - 출력중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - 출력중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

write

public abstract long write(ByteBuffer [] srcs,
                           int offset,
                           int length)
                    throws IOException 

인터페이스 GatheringByteChannel 기술:

이 채널의 바이트 순서가 지정된 버퍼의 서브 순서로부터 써냅니다.

이 채널에 최대 r 바이트를 출력하려고 합니다. r는 이 메서드의 호출시로 지정된 버퍼 배열의 지정된 서브 순서에 포함되는 합계 바이트수입니다.

 srcs[offset]. remaining() + srcs[offset+1]. remaining() + ... + srcs[offset+length-1]. remaining()

길이 n (0 <= n <= r)의 바이트 순서가 출력해진다고 합니다. 이 순서의 최초의 srcs[offset]. remaining()바이트까지가 버퍼 srcs[offset]에 출력해져 다음의 srcs[offset+1]. remaining() 바이트가 버퍼 srcs[offset]로 부터 버퍼 srcs[offset+1]에 출력해집니다. 이 처리는 바이트 순서 전부가 출력해질 때까지 반복해집니다. 각 버퍼로부터 최대한의 바이트가 출력해지기 때문에 갱신된 개개의 버퍼의 최종적인 위치는 최종 갱신 버퍼를 제외해, 이 버퍼의 리밋트와 동일해집니다.

특히 지정이 없는 한, 요구된 r 바이트가 모두 출력해지면 출력 조작은 종료합니다. 채널의 종류에 따라서는 그 상태에 응해, 일부의 바이트 밖에 출력해지지 않은 경우나, 전혀 write를 하지 않는 경우도 있습니다. 예를 들어 비블록 모드의 소켓 채널에서는 소켓의 출력 버퍼내의 바이트수가 최대 출력 바이트수가 됩니다.

이 메서드는 언제라도 호출할 수 있습니다. 다만, 다른 thread가 이 채널에 대해서 출력조작을 개시하고 있는 경우, 이 메서드의 호출은 최초의 조작이 끝날 때까지 블록 됩니다.

정의:

인터페이스 GatheringByteChannel 내의 write

파라미터:

srcs - 바이트의 취득처 버퍼

offset - 최초의 바이트의 취득처가 되는 버퍼 배열내의 오프셋(offset). srcs.length 아래의 제로 또는 정의 수

length - 액세스 가능한 최대 버퍼수. srcs.length - offset 아래의 제로 또는 정의 수

반환값:

출력해지는 바이트수. 제로의 경우도 있다

예외:

NotYetConnectedException - 이 채널이 아직 접속되어 있지 않은 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - 출력중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - 출력중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

IOException - 그 외의 입출력 에러가 발생했을 경우

write

public final long write(ByteBuffer [] srcs)
                 throws IOException 

인터페이스 GatheringByteChannel 기술:

이 채널의 바이트 순서가 지정된 버퍼로부터 써냅니다.

이 메서드를 c.write(srcs) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

 c.write(srcs, 0, srcs.length);

정의:

인터페이스 GatheringByteChannel 내의 write

파라미터:

srcs - 바이트의 취득처 버퍼

반환값:

출력해지는 바이트수. 제로의 경우도 있다

예외:

NotYetConnectedException - 이 채널이 아직 접속되어 있지 않은 경우

ClosedChannelException - 이 채널이 클로우즈 하고 있는 경우

AsynchronousCloseException - 출력중에 다른 thread에 의해 이 채널이 클로우즈 되었을 경우

ClosedByInterruptException - 출력중에 다른 thread로부터의 인터럽트가 있었기 때문에 채널이 클로우즈 해, 현재의 thread의 인터럽트 상태가 설정되었을 경우

IOException - 그 외의 입출력 에러가 발생했을 경우