java.nio.channels
클래스 SelectableChannel

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

모든 구현된 인터페이스:

Closeable, Channel, InterruptibleChannel

알려진 직계 서브 클래스:

AbstractSelectableChannel

public abstract class SelectableChannel
extends AbstractInterruptibleChannel 
implements Channel 

Selector 경유로 다중화할 수 있는 채널입니다.

셀렉터로 사용하기 위해서는 우선, register 메서드를 사용해 이 클래스의 인스턴스를 「등록」할 필요가 있습니다. 이 메서드는 채널이 셀렉터에 등록된 것을 나타내는 새로운 SelectionKey 객체를 리턴합니다.

셀렉터에 등록된 채널은 등록을 해제할 때까지 등록된 채로 있습니다. 등록을 해제하는데는 셀렉터에 의해 채널에 할당할 수 있었던 자원을 해방할 필요가 있습니다.

채널의 등록을 직접 해제할 수 없습니다. 그 대신에 등록을 나타내는 키를 취소합니다. 키를 취소하려면, 셀렉터가 다음의 선택을 행하고 있는 동안에 채널의 등록을 해제합니다. 키의 cancel 메서드를 호출하면, 키를 명시적으로 취소할 수 있습니다 . 채널의 close 메서드의 호출해, 또는 채널상의 입출력 조작중에 블록 된 thread에 대한 인터럽트에 의해 채널이 클로우즈 하면, 암묵적으로 그 채널의 모든 키가 삭제됩니다.

셀렉터 자체를 클로우즈 하면, 채널의 등록이 해제되어 그 등록을 나타내고 있던 키도 즉석에서 무효가 됩니다.

셀렉터 1개에 대해서 최대 1개의 채널을 등록할 수 있습니다.

채널이 1개 이상의 셀렉터에 등록되지 않은지 어떤지를 판단하려면, isRegistered 메서드를 호출합니다.

선택 가능 채널은 복수의 병행 thread로 안전하게 사용할 수 있습니다.

블록 모드

선택 가능 채널은 블록 모드나 비블록 모드가 됩니다. 블록 모드의 경우, 채널상에서 불려 간 입출력 조작은 전의 조작이 완료할 때까지 블록 됩니다. 비블록 모드의 경우, 입출력 조작은 블록 되지 않고, 요구된 바이트수보다 적은 바이트수가 전송 됩니다. 바이트가 일절 전송 되지 않는 경우도 있습니다. 선택 가능 채널이 블록 모드일지 어떨지는 isBlocking 메서드를 호출하는 것으로 판단할 수 있습니다.

새롭게 작성된 선택 가능 채널은 항상 블록 모드가 됩니다. 비블록 모드는 셀렉터 베이스의 다중화와 함께 가장 유용합니다. 셀렉터에 등록하기 전에 채널을 비블록 모드로 해, 등록 해제까지 그대로의해 둘 필요가 있습니다.

도입된 버전 :

1.4

관련 항목:

SelectionKey, Selector

생성자 개요

protected

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

메서드 개요

abstract Object	blockingLock () configureBlocking 메서드와 register 메서드가 동기의 대상으로 하는 객체를 리턴합니다.
abstract SelectableChannel	configureBlocking (boolean block) 이 채널의 블록 모드를 조정합니다.
abstract boolean	isBlocking () 이 채널상의 개개의 입출력 조작이 전의 입출력 조작이 완료할 때까지 블록 될지 어떨지를 판단합니다.
abstract boolean	isRegistered () 현재 이 채널이 셀렉터에 등록되어 있는지를 판단합니다.
abstract SelectionKey	keyFor (Selector sel) 채널이 지정된 셀렉터에 등록되어 있는 것을 나타내는 키를 취득합니다.
abstract SelectorProvider	provider () 이 채널의 소스프로바이더를 리턴합니다.
SelectionKey	register (Selector sel, int ops) 이 채널이 지정된 셀렉터에 등록해, 선택 키를 리턴합니다.
abstract SelectionKey	register (Selector sel, int ops, Object att) 이 채널이 지정된 셀렉터에 등록해, 선택 키를 리턴합니다.
abstract int	validOps () 이 채널로 지원 되고 있는 조작을 식별하는조작 세트를 리턴합니다.

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

begin, close, end, implCloseChannel, isOpen

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

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

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

close, isOpen

생성자 상세

SelectableChannel

protected SelectableChannel()

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

메서드의 상세

provider

public abstract SelectorProvider  provider()

이 채널의 소스프로바이더를 리턴합니다.

반환값:

이 채널의 소스프로바이더

validOps

public abstract int validOps()

이 채널로 지원 되고 있는 조작을 식별하는조작 세트를 리턴합니다. 이 정수값 로 세트 되고 있는 비트는 이 채널에 대해서 유효한 조작을 나타냅니다. 이 메서드는 특정의 구상 채널 클래스에 대해서 항상 같은 값을 리턴합니다.

반환값:

유효한 조작 세트

isRegistered

public abstract boolean isRegistered()

현재 이 채널이 셀렉터에 등록되어 있는지를 판단합니다. 새롭게 작성된 채널은 등록되어 있지 않습니다.

키의 취소로부터 채널의 등록 해제까지의 사이에 발생하는 필연적인 지연이기 때문에 키를 모두 취소해도, 당분간의 사이 채널의 등록은 해제되지 않습니다. 채널을 클로우즈 했을 때도 같습니다.

반환값:

이 채널이 등록되어 있는 경우에 한정해 true

keyFor

public abstract SelectionKey  keyFor(Selector  sel)

채널이 지정된 셀렉터에 등록되어 있는 것을 나타내는 키를 취득합니다.

반환값:

전회 이 채널이 지정된 셀렉터에 등록했을 때 리턴된 키. 현재 이 채널이 지정된 셀렉터에 등록되지 않은 경우는 null

register

public abstract SelectionKey  register(Selector  sel,
                                      int ops,
                                      Object  att)
                               throws ClosedChannelException 

이 채널이 지정된 셀렉터에 등록해, 선택 키를 리턴합니다.

현재 이 채널이 지정된 셀렉터에 등록되어 있는 경우, 이 등록을 나타내는 선택 키가 리턴됩니다 . 키의 대상 리스트는 interestOps(int) 메서드를 호출했을 경우와 같이 ops로 변경되고 있습니다. att 인수의 값이 null 이외의 경우, 키의 첨부 객체는 그 값으로 설정되어 있습니다. 키가 이미 삭제되고 있는 경우는 CancelledKeyException을 발생시킵니다.

그 외의 경우, 이 채널은 지정된 셀렉터에 아직 등록되어 있지 않습니다. 거기서, 이 채널이 등록된뒤 새롭게 생성된 키가 리턴됩니다 . 키의 대상 리스트의 초기값 는 ops, 첨부 객체는 att가 됩니다.

이 메서드는 언제라도 호출할 수 있습니다 . 이 메서드의 호출중, 또는 configureBlocking 메서드의 호출중에 중복의해 이 메서드를 호출했을 경우, 새롭게 호출한 메서드는 최초의 메서드의 처리가 완료할 때까지 블록 됩니다. 그 후, 이 메서드와 셀렉터의 키 세트의 동기가 취해집니다. 이 때문에 같은 셀렉터를 사용하는 다른 등록 또는 선택 처리와 동시에 불려 갔을 경우, 이 메서드는 블록 됩니다.

이 조작의 실행중에 이 채널이 클로우즈 했을 경우, 이 메서드로부터 리턴된 키는 삭제되어 무효가 됩니다.

파라미터:

sel - 이 채널의 등록처 셀렉터

ops - 생성된 키의 대상 세트

att - 생성된 키의 첨부 객체. null인 경우도 있다

반환값:

이 채널이 지정된 셀렉터에 등록되어 있는 것을 나타내는 키

예외:

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

IllegalBlockingModeException - 이 채널이 블록 모드의 경우

IllegalSelectorException - 이 채널의 소스프로바이더가 지정된 셀렉터의 소스프로바이더와 다른 경우

CancelledKeyException - 채널은 지정된 셀렉터에 등록되어 있지만, 대응하는 키가 이미 삭제되고 있는 경우

IllegalArgumentException - ops 세트내의 비트가 이 채널로 지원 되는 조작에 대응하고 있지 않는 경우 (set & ~validOps() ! = 0)

register

public final SelectionKey  register(Selector  sel,
                                   int ops)
                            throws ClosedChannelException 

이 채널이 지정된 셀렉터에 등록해, 선택 키를 리턴합니다.

이 메서드를 다음의 형식에서 호출하면, 상기의 동작을 합니다.

sc.register(sel, ops)

다음의 호출과 정확하게 같은 동작이 됩니다.

sc. register (sel, ops, null)

파라미터:

sel - 이 채널의 등록처 셀렉터

ops - 생성된 키의 대상 세트

반환값:

이 채널이 지정된 셀렉터에 등록되어 있는 것을 나타내는 키

예외:

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

IllegalBlockingModeException - 이 채널이 블록 모드의 경우

IllegalSelectorException - 이 채널의 소스프로바이더가 지정된 셀렉터의 소스프로바이더와 다른 경우

CancelledKeyException - 채널은 지정된 셀렉터에 등록되어 있지만, 대응하는 키가 이미 삭제되고 있는 경우

IllegalArgumentException - ops 세트내의 비트가 이 채널로 지원 되는 조작에 대응하고 있지 않는 경우 (set & ~validOps() ! = 0)

configureBlocking

public abstract SelectableChannel  configureBlocking(boolean block)
                                             throws IOException 

이 채널의 블록 모드를 조정합니다.

이 채널이 1개 이상의 셀렉터에 등록되어 있는 경우, 블록 모드로 설정하려고 하면 IllegalBlockingModeException을 발생시킵니다.

이 메서드는 언제라도 호출할 수 있습니다 . 새로운 블록 모드는 이 메서드의 종료후에 개시된 입출력 조작인 만큼 영향을 미칩니다. 구현에 따라서는 보류된 입출력 조작이 완료할 때까지 블록을 속행할 필요가 있습니다.

이 메서드 또는 register 메서드의 호출중에 이 메서드를 중복의해 호출했을 경우, 새롭게 호출한 메서드는 최초의 처리가 완료할 때까지 블록 됩니다.

파라미터:

block - 이 채널이 블록 모드가 되는 경우는 true, 비블록 모드가 되는 경우는 false

반환값:

이 선택 가능 채널

예외:

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

IllegalBlockingModeException - block가 true로 이 채널이 1개 이상의 셀렉터에 등록되어 있는 경우

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

isBlocking

public abstract boolean isBlocking()

이 채널상의 개개의 입출력 조작이 전의 입출력 조작이 완료할 때까지 블록 될지 어떨지를 판단합니다. 새롭게 작성된 채널은 항상 블록 모드입니다.

이 채널이 클로우즈 하고 있는 경우, 이 메서드의 반환값은 특정되지 않습니다.

반환값:

이 채널이 블록 모드인 경우에 한정해 true

blockingLock

public abstract Object  blockingLock()

configureBlocking 메서드와 register 메서드가 동기의 대상으로 하는 객체를 리턴합니다. 이 기능은 특정의 블록 모드를 단시간 보관 유지할 필요가 있는 어댑터를 구현하는 경우에 편리합니다.

반환값:

블록 모드의 락 객체