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 메서드를 호출하는 것에 의해 취득 가능

• 「선택된 키 세트」. 이 키 세트내에 포함되는 키는 각각, 그 대응하는 채널이, 전회 선택시의 대상 세트에 포함되어 있던 조작의 적어도 1개을 실행할 수 있는 상태가 되어 있는 것을 나타낸다. selectedKeys 메서드를 호출하는 것에 의해 취득 가능. 항상 키 세트의 부분집합이 된다

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

새롭게 작성된 셀렉터에서는 이 3 개세트는 비어있습니다.

셀렉터의 키 세트에는 채널의 register 메서드를 사용해 채널을 등록한 영향에의해 키가 추가됩니다. 삭제된 키는 선택시에 키 세트로부터 삭제됩니다. 키 세트 자체를 직접 변경할 수 없습니다.

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

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

선택

선택 조작마다, 셀렉터의 선택된 키 세트에 대해서 키의 추가 및 삭제가 실행되는 것과 동시에 키 세트 및 삭제된 키 세트로부터 키가 삭제됩니다. 선택은 select(), select(long), selectNow() 몇개의 메서드에의해 다음의 3 단계의 순서를 거쳐 행해집니다.

1. 삭제된 키 세트에 포함되는 모든 키가 소속하는 각 키 세트로부터 삭제되는 것과 동시에 그것들에 대응하는 채널의 등록도 모두 해제됩니다. 이 순서가 완료하면, 삭제된 키 세트는 비웁니다.

2. 키의 대상 세트에 포함되는 조작의 적어도 1개을 실행할 수 있는 상태가 된 채널이 선택 개시의 시점에서 존재할지 어떨지의 최신 정보를 얻기 위해서 기본이 되는 OS에 조회합니다. 해당하는 채널에 대해서는 다음의 몇개의 액션이 실행됩니다.

   1. 선택된 키 세트내에 그 채널의 키가 존재하지 않았던 경우, 선택된 키 세트내에 그 키가 추가되는 것과 동시에 실행 가능 조작 세트가 변경되어 그 채널로 준비가 갖추어졌다고 보고된 조작이 등록된다. 그 이전에 실행 가능 조작 세트에 기록되고 있던 정보는 파기된다

   2. 그렇지 않은 경우는 그 채널의 키는 이미 선택된 키 세트내에 존재하고 있기 때문에 실행 가능 조작 세트가 변경되어 그 채널로 준비가 갖추어졌다고 보고된 조작이 모두 등록된다. 그 이전에 실행 가능 조작 세트에 기록되고 있던 정보는 보존된다. 즉, 기본이 되는 시스템으로부터 리턴된 실행 가능 조작 세트는 현재의 실행 가능 조작 세트에 「bitwise-disjoin (비트 단위에서의 분리)」된다

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

3. 순서 2 실행중에 삭제된 키 세트에 추가된 키가 존재하는 경우, 그러한 키는 순서 1에 따라 처리됩니다.

3개의 선택 메서드의 본질적인 차이는 1개 이상의 채널의 준비가 갖추어질 때까지 선택 조작이 블록 될지 어떨지라고 블록 되는 경우에 어느 정도의 기간 블록 되는지, 2 점 뿐입니다.

병행성

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

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

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

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

select(), select(long) 몇개의 메서드에 의해 블록 된 thread에 대해서 다른 thread로부터 인터럽트를 걸치려면, 다음의 3개의 방법의 어느쪽이든을 사용합니다.

• 셀렉터의 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 <SelectionKey >	keys () 이 셀렉터의 키 세트를 리턴합니다.
static Selector	open () 셀렉터를 오픈합니다.
abstract SelectorProvider	provider () 이 채널의 소스프로바이더를 리턴합니다.
abstract int	select () 입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.
abstract int	select (long timeout) 입출력 조작의 실행이 가능한 대응하는 채널을 가지는 키 세트를 선택합니다.
abstract Set <SelectionKey >	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 <SelectionKey > keys()

이 셀렉터의 키 세트를 리턴합니다.

키 세트를 직접 변경할 수 없습니다. 키를 취소한뒤 채널의 등록이 해제된 시점에서 그 키가 삭제됩니다. 키 세트를 변경을 시도하면, UnsupportedOperationException을 발생시킵니다.

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

반환값:

이 셀렉터의 키 세트

예외:

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

selectedKeys

public abstract Set <SelectionKey > 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 - 입출력 에러가 발생했을 경우