java.nio.channels
클래스 Selector

java.lang.Object 
  |
  +--java.nio.channels.Selector

직계의 기존의 서브 클래스:

AbstractSelector

public abstract class Selector

extends Object

SelectableChannel 오브젝트의 멀티플렉서입니다.

실렉터를 작성하려면 , 이 클래스의 open 메소드를 호출합니다. 이 메소드는 시스템의 디폴트의실렉터 프로바이더 를 사용해 새로운 실렉터를 작성합니다. 커스텀 실렉터 프로바이더의 openSelector 메소드를 호출해도, 실렉터를 작성할 수 있습니다. 실렉터는 close 메소드로 클로우즈 될 때까지 오픈 상태를 유지합니다.

SelectionKey 오브젝트는 선택 가능 채널이 실렉터에 등록되어 있는 것을 나타냅니다. 실렉터는 선택 키의 3 개세트를 관리합니다.

• 「키 세트」. 현재 이 실렉터에 등록되어 있는 채널을 나타내는 키로 구성된다. keys 메소드를 호출하는 것에 의해 취득 가능

• 「선택된 키 세트」. 선택전에, 개개의 키의 채널이 키의 대상 세트에 나타나고 있는 조작의 쳐 어느쪽이든을 실행할 수 있는 상태가 되어 있는 것을 나타내는 키로 구성된다. selectedKeys 메소드를 호출하는 것에 의해 취득 가능. 항상 키 세트의 부분집합이 된다

• 「삭제된 키 세트」. 채널의 등록은 아직 해제되어 있지 않지만, 취소는 완료하고 있는 키세트. 이 세트에 직접 액세스 할 수 없다. 항상 키 세트의 부분집합이 된다

새롭게 작성된 실렉터에서는 이 3 개세트는 하늘입니다.

채널의 register 메소드를 사용해 채널을 등록하면(자), 그 부작용으로서 실렉터의 키 세트에 키가 추가됩니다. 삭제된 키는 선택시에 키 세트로부터 삭제됩니다. 키 세트 자체를 직접 변경할 수 없습니다.

채널의 클로우즈나 cancel 메소드의 호출에 의해 키를 취소하면(자), 이 키가 실렉터의 삭제된 키 세트에 추가됩니다. 키를 취소하면(자), 다음의 선택시에 채널의 등록이 해제됩니다. 삭제된 키는 이 시점에서, 모든 실렉터의 키 세트로부터 삭제됩니다.

키는 선택 조작에 의해 선택된 키 세트에 추가됩니다. 선택된 키 세트로부터 직접 키를 삭제하고 싶은 경우는 이 키 세트의 remove 메소드를 호출하는지 이 세트로부터 취득 가능한반복자 의 remove 메소드를 호출합니다. 그 이외의 방법으로, 선택된 키 세트로부터 키를 삭제할 수 없습니다. 선택의 부작용으로서 키가 삭제될 것은 없습니다. 또, 선택된 키 세트에 직접 키를 추가할 수도 있습니다.

선택

선택마다, 실렉터의 선택된 키 세트에 키가 추가되거나 키 세트나 삭제된 키 세트로부터 키가 삭제 되거나 합니다. 선택은 select() ,select(long) ,selectNow() 의 몇개의 메소드에 의해, 다음의 3 단계의 순서를 거쳐 행해집니다.

1. 삭제된 키 세트에 포함되는 모든 키가 각 키 세트로부터 삭제되어 채널의 등록이 해제됩니다. 이 순서에 의해, 삭제된 키 세트는 비웁니다.

2. 선택 조작이 개시된 시점에서, 키의 대상 세트에 나타나고 싶은 차이인가의 조작을 실행할 수 있는 상태의 채널이 갱신되었는지 어떠했는지에 임해서, 기본이 되는 operating system가 조회됩니다. 해당하는 채널에 대해서는 다음의 몇개의 액션이 실행됩니다.

   1. 선택된 키 세트로부터 삭제된 채널의 키가 세트에 추가되어 현재 이 채널로 실행 가능한 조작을 알 수 있게 실행 가능 조작 세트가 변경된다. 그 이전에 실행 가능 세트에 기록된 정보는 파기된다

   2. 그 이외의 경우 채널의 키는 벌써 선택된 키 세트내에 있다. 따라서, 실행 가능 조작 세트는 채널을 실행할 수 있는 새로운 조작을 알 수 있게 변경된다. 그 이전에 실행 가능 세트에 기록된 정보는 보존된다. 즉, 기본이 되는 시스템으로부터 돌려주어지는 실행 가능 세트는 비트 단위로 현재의 실행 가능 세트 로 분리된다

이 순서의 개시시에, 키 세트내의 모든 키의 대상 세트가 비우고 있는 경우, 선택된 키 세트도 키의 실행 가능 조작 세트도 갱신되지 않습니다.

3. 순서 2 의 실행중에 삭제된 키 세트에 추가된 키는 순서 1 에 따라 처리됩니다.

3 개의 선택 메소드는 1 개 이상의 채널이 실행 가능한 상태가 될 때까지 선택 조작이 블록 될지 어떨지 블록 되는 경우는 어느 정도의 기간 블록 되는가 하는 점 이외는 본질적으로 같습니다.

병행성

실렉터 자체는 복수의 병행 thread로 안전하게 사용할 수 있습니다. 그러나, 이것은 키 세트에는 들어맞지 않습니다.

선택 조작은 실렉터 자체, 키 세트, 선택된 키 세트를 이 차례로 동기화합니다. 상기의 순서 1 및 3 의 실행시는 삭제된 키 세트를 동기화합니다.

선택 조작의 실행중에 실렉터의 키의 대상 세트로 변경을 더해도, 변경이 적용되는 것은 다음의 선택 조작으로부터여, 현재 실행중의 조작에 영향은 없습니다.

키의 취소나 채널의 클로우즈는 언제라도 실행할 수 있습니다. 어느 키가 1 개 이상의 실렉터의 키 세트내에 존재하고 있어도, 그 키가 유효해, 채널이 오픈하고 있다고는인가 선. 다른 thread에 의해 키가 삭제되거나 채널이 클로우즈 될 가능성이 있는 경우는 어플리케이션 코드의 동기화를 신중하게 실시해, 필요에 따라서 그 상태를 체크할 필요가 있습니다.

select() 메소드 또는 select(long) 메소드에 의해 블록 된 thread는 다음의 3 개의 쳐 몇개의 방법으로, 그 외의 thread에 의해 끼어들어집니다.

• 실렉터의 wakeup 메소드의 호출

• 실렉터의 close 메소드의 호출

• 블록 된 thread의 interrupt 메소드의 호출. 이 경우, 세치기 상태가 설정되어 실렉터의 wakeup 메소드가 불려 간다

close 메소드는 실렉터와 3 개의 키 세트 모든 것을 선택 조작시와 같은 차례로 동기화합니다.

통상, 실렉터의 키 세트 및 선택된 키 세트는 복수의 병행 thread로 안전하게 사용할 수 없습니다. 몇개의 세트를 직접 변경하는 thread가 있는 경우, 그 세트를 동기화하는 것에 의해 액세스 제어를 실시할 필요가 있습니다. 이러한 세트의 iterator 메소드에 의해 돌려주어지는 반복자는 fail-fast 입니다. 반복자의 작성 후, 반복자 고유의 remove 메소드 호출해 이외 방법으로 세트가 변경되었을 경우,ConcurrentModificationException 가 슬로우 됩니다.

도입된 버젼:

1.4

관련 항목:

SelectableChannel , SelectionKey

생성자의 개요

protected

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

메소드의 개요

abstract void	close () 이 실렉터를 클로우즈 합니다.
abstract boolean	isOpen () 이 실렉터 상태가 오픈일지 어떨지를 판단합니다.
abstract Set	keys () 이 실렉터의 키 세트를 돌려줍니다.
static Selector	open () 실렉터를 오픈합니다.
abstract SelectorProvider	provider () 이 채널의 작성원프로바이더를 돌려줍니다.
abstract int	select () 입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.
abstract int	select (long timeout) 입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.
abstract Set	selectedKeys () 이 실렉터의 선택된 키 세트를 돌려줍니다.
abstract int	selectNow () 입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.
abstract Selector	wakeup () 아직 종료하고 있지 않는 최초의 선택 조작을 즉시 종료시킵니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

Selector

protected Selector()

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

메소드의 상세

open

public static Selector  open()
                     throws IOException 

실렉터를 오픈합니다.

새로운 실렉터를 작성하려면 , 시스템 전체의 디폴트의 SelectorProvider 오브젝트의 openSelector 메소드를 호출합니다.

반환값:

새로운 실렉터

예외:

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

isOpen

public abstract boolean isOpen()

이 실렉터 상태가 오픈일지 어떨지를 판단합니다.

반환값:

이 실렉터가 오픈인 경우에 한해 true

provider

public abstract SelectorProvider  provider()

이 채널의 작성원프로바이더를 돌려줍니다.

반환값:

이 채널의 작성원프로바이더

keys

public abstract Set  keys()

이 실렉터의 키 세트를 돌려줍니다.

키 세트를 직접 변경할 수 없습니다. 키를 취소한 뒤, 채널의 등록이 해제된 시점에서, 그 키가 삭제됩니다. 키 세트를 변경하려고 하면(자),UnsupportedOperationException 가 슬로우 됩니다.

키 세트는thread 세이프가 아닙니다 .

반환값:

이 실렉터의 키 세트

예외:

ClosedSelectorException - 이 실렉터가 클로우즈 하고 있는 경우

selectedKeys

public abstract Set  selectedKeys()

이 실렉터의 선택된 키 세트를 돌려줍니다.

선택된 키 세트로부터 키를 삭제할 수 있습니다만, 이 세트에 직접 키를 추가할 수 없습니다. 키 세트에 오브젝트를 추가하려고 하면(자),UnsupportedOperationException 가 슬로우 됩니다.

선택된 키 세트는thread 세이프가 아닙니다 .

반환값:

이 실렉터의 선택된 키 세트

예외:

ClosedSelectorException - 이 실렉터가 클로우즈 하고 있는 경우

selectNow

public abstract int selectNow()
                       throws IOException 

입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.

이 메소드는 비블록형의선택 조작을 실행합니다. 전회의 선택 조작 이후, 선택 가능하게 될 수 있는 채널이 존재하지 않는 경우, 이 메소드는 즉시 제로를 돌려줍니다.

이 메소드를 호출하면(자), 이전에 호출한 wakeup 메소드의 결과가 클리어 됩니다.

반환값:

선택 조작에 의해 갱신된 실행 가능 조작 세트를 가지는 키의 수. 제로의 경우도 있다

예외:

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

ClosedSelectorException - 이 실렉터가 클로우즈 하고 있는 경우

select

public abstract int select(long timeout)
                    throws IOException 

입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.

이 메소드는 블록형의선택 조작을 실행합니다. 이 메소드는 1 개 이상의 채널이 선택되었을 경우, 이 실렉터의 wakeup 메소드가 불려 갔을 경우, 현재의 thread에 대해서 세치기가 발생했을 경우, 지정의 타임 아웃 기간이 종료했을 경우에 한해 종료합니다.

이 메소드는 리얼타임 프로텍션을 실시하지 않습니다. Object.wait(long) 메소드 호출과 같게 타임 아웃의 스케줄을 작성합니다.

파라미터:

timeout - 정의 수의 경우, 채널이 실행 가능 상태가 되는 것을 대기하는 동안, 블록 되는 것은 최대로 대략 timeout 밀리 세컨드, 제로의 경우 무기한의 블록. 부의 수는 지정할 수 없다

반환값:

갱신된 실행 가능 조작 세트를 가지는 키의 수. 제로의 경우도 있다

예외:

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

ClosedSelectorException - 이 실렉터가 클로우즈 하고 있는 경우

IllegalArgumentException - timeout 인수의 값이 부의 경우

select

public abstract int select()
                    throws IOException 

입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.

이 메소드는 블록형의선택 조작을 실행합니다. 이 메소드는 1 개 이상의 채널이 선택되었을 경우, 이 실렉터의 wakeup 메소드가 불려 갔을 경우, 현재의 thread에 대해서 세치기가 발생했을 경우에 한해 종료합니다.

반환값:

갱신된 실행 가능 조작 세트를 가지는 키의 수. 제로의 경우도 있다

예외:

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

ClosedSelectorException - 이 실렉터가 클로우즈 하고 있는 경우

wakeup

public abstract Selector  wakeup()

아직 종료하고 있지 않는 최초의 선택 조작을 즉시 종료시킵니다.

select() 메소드나 select(long) 메소드의 호출시에 그 외의 thread가 블록 되고 있으면(자), 호출은 곧바로 종료합니다. 현재 실행중의 선택 조작이 없는 경우는 사전에 selectNow() 메소드를 호출하지 않는 한, 다음번 호출시도 이러한 메소드는 곧바로 종료합니다. 이 호출의 반환값은 어느 경우도 제로 이외의 값입니다. 그 이후, 다음번 호출시까지 이 메소드를 재차 호출하지 않는 한,select() 메소드 또는 select(long) 메소드의 호출은 통상 대로 블록 됩니다.

어느 선택 조작으로부터 다음의 선택 조작까지의 사이에 이 메소드를 1 회 이상 호출해도, 1 회만 호출했을 때와 같은 결과가 됩니다.

반환값:

이 실렉터

close

public abstract void close()
                    throws IOException 

이 실렉터를 클로우즈 합니다.

이 실렉터의 선택 메소드내에서 블록 되고 있는 thread가 있는 경우, 실렉터의 wakeup 메소드를 호출했을 경우와 같게, 이 thread에 대한 세치기가 발생합니다.

삭제되지 않고 실렉터에 관련지을 수 있던 채로의 키는 무효가 됩니다. 채널의 등록은 해제되어 이 실렉터에 관련한 그 외의 모든 리소스가 해방됩니다.

실렉터가 클로우즈 하고 있는 상태로 이 메소드를 호출해도, 무슨 효과도 없습니다.

일단 클로우즈 한 실렉터를 재차 이용하려고 하면(자), 이 메소드 또는 wakeup 메소드를 호출하지 않는 한,ClosedSelectorException 가 슬로우 됩니다.

예외:

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