패키지 java.nio.channels

입출력 조작을 실행할 수 있는 엔티티 (파일, 소켓등)에의 접속을 나타내는 채널이나, 다중화 된 비블록 입출력 조작용의 셀렉터를 정의합니다.

참조처:
설명

인터페이스 개요

ByteChannel	바이트의 read와 write를 할 수 있는 채널입니다.
Channel	입출력 조작에 관계된 채널입니다.
GatheringByteChannel	버퍼 순서로부터 바이트를 출력할 수 있는 채널입니다.
InterruptibleChannel	비동기의 클로우즈나 인터럽트가 가능한 채널입니다.
ReadableByteChannel	바이트를 읽어낼 수 있는 채널입니다.
ScatteringByteChannel	버퍼 순서에 바이트를 읽어들일 수 있는 채널입니다.
WritableByteChannel	바이트를 출력할 수 있는 채널입니다.

클래스 개요

Channels	채널과 스트림을 위한 유틸리티 메서드입니다.
DatagramChannel	데이터 그램형 소켓의 선택 가능한 채널입니다.
FileChannel	파일의 읽기, 출력해, 매핑, 조작용 채널입니다.
FileChannel.MapMode	파일 매핑방식의 형태 보증된 열거입니다.
FileLock	파일 영역상의 락을 나타내는 토큰입니다.
Pipe	단방향 파이프를 구현하는 1조의 채널입니다.
Pipe.SinkChannel	Pipe 출력측을 나타내는 채널입니다.
Pipe.SourceChannel	Pipe read측을 나타내는 채널입니다.
SelectableChannel	Selector 경유로 다중화할 수 있는 채널입니다.
SelectionKey	SelectableChannel 가 Selector에 등록되어 있는 것을 나타내는 토큰입니다.
Selector	SelectableChannel 객체의 멀티플렉서입니다.
ServerSocketChannel	스트림형 리스닝소켓트용의 선택 가능한 채널입니다.
SocketChannel	스트림형 접속 소켓용의 선택 가능 채널입니다.

예외 개요

AlreadyConnectedException	이미 접속되고 있는 SocketChannel 에의 접속을 시도했을 때에 발생되는 체크되지 않는 예외입니다.
AsynchronousCloseException	다른 thread가 채널 또는 입출력 조작시에 블록 되는 채널의 일부를 클로우즈 했을 때에 thread가 받는 체크 예외입니다.
CancelledKeyException	이미 무효가 된 선택 키를 사용하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
ClosedByInterruptException	thread가 채널에서의 입출력 조작으로 블록 되고 있는 것에도 불구하고, 다른 thread로부터 인터럽트를 받았을 경우에 수신하는 체크 예외입니다.
ClosedChannelException	클로우즈 한 채널에 대한 입출력 조작을 실시하려고 했을 때, 또는 실행하려고 한 입출력 조작에 대해서 그 채널이 클로우즈 되고 있는 경우에 발생되는 체크 예외입니다.
ClosedSelectorException	클로우즈 한 셀렉터에 대한 입출력 조작을 호출하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
ConnectionPendingException	비블록 접속 조작의 진행중에 SocketChannel에 접속하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
FileLockInterruptionException	파일 락의 획득을 대기하고 있는 thread에 대해서 다른 thread로부터 인터럽트가 있었을 때에 수취되는 체크 예외입니다.
IllegalBlockingModeException	블록 모드가 부정해요에 채널상에서 블록 모드 고유의 조작을 호출했을 때에 발생되는 체크되지 않는 예외입니다.
IllegalSelectorException	채널의 소스프로바이더 이외가 작성한 셀렉터에 채널을 등록하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
NoConnectionPendingException	SocketChannel connect 메서드의 호출이 아직 완료하고 있지 않는데, finishConnect 메서드를 호출했을 경우에 발생되는 미확인의 예외입니다.
NonReadableChannelException	처음은 읽을 위해 오픈되어 있지 않았던 채널로부터 read를 실시하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
NonWritableChannelException	처음은 write를 위해서 오픈되어 있지 않았던 채널에 대해서 write를 실시하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
NotYetBoundException	미바인드의 서버 소켓 채널상에서 입출력 조작을 호출하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
NotYetConnectedException	미접속의 소켓 채널상에서 입출력 조작을 호출하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
OverlappingFileLockException	락을 획득하려고 한 파일 영역이, 이미 같은 Java 가상 머신에 의해 락 되고 있는 영역에 오버랩 하고 있는 경우, 또는 그 외의 thread가 같은 파일의 오버랩 하고 있는 영역을 잠그려고 대기하고 있는 경우에 발생되는 체크되지 않는 예외입니다.
UnresolvedAddressException	미해결의 소켓 주소에 대해서 네트워크 조작을 호출하려고 했을 때에 발생되는 체크되지 않는 예외입니다.
UnsupportedAddressTypeException	지원 되어 있지 않은 형태의 소켓 주소에 바인드 또는 접속하려고 했을 때에 발생되는 체크되지 않는 예외입니다.

패키지 java.nio.channels 설명

입출력 조작을 실행할 수 있는 엔티티 (파일, 소켓등)에의 접속을 나타내는 채널이나, 다중화 된 비블록 입출력 조작용의 셀렉터를 정의합니다.

채널	설명
Channel	입출력 조작을 하는 장소
ReadableByteChannel	버퍼에의 read를 실시하는
ScatteringByteChannel	버퍼 순서에의 read를 실시하는
WritableByteChannel	버퍼로부터의 서두를 실시하는
GatheringByteChannel	버퍼 순서로부터의 서두를 실시하는
ByteChannel	버퍼에의 읽기, 버퍼로부터의 서두를 실시하는
Channels	채널과 스트림의 제휴를 위한 유틸리티 메서드

「채널」은 1개 이상의 입출력 조작 (읽기, 출력등)을 실행할 수 있는 하드웨어 디바이스, 파일, 네트워크 소켓, 프로그램 컴퍼넌트등의 엔티티에의 오픈 접속을 나타냅니다. Channel 인터페이스로 가리키는 대로 채널은 오픈화 클로우즈의 머지않아인가입니다. 어느 쪽 상태의 채널도, 「비동기 클로우즈 가능」한편 「인터럽트 가능」입니다.

Channel l 인터페이스는 새로운 입출력 조작을 지정하는 복수외의 인터페이스에 의해 확장되고 있습니다.

ReadableByteChannel 인터페이스는 채널로부터 버퍼에 바이트를 읽어들이는 read 메서드를 지정합니다. 같이WritableByteChannel 인터페이스는 버퍼로부터 채널에 바이트를 써내는 write 메서드를 지정합니다. ByteChannel 인터페이스는 이것들 2개의 인터페이스를 통일한 인터페이스이며, 바이트의 read와 서두의 양쪽 모두를 실행할 수 있는 일반적인 채널로 사용됩니다.

ScatteringByteChannel 인터페이스와 GatheringByteChannel 인터페이스는 각각 ReadableByteChannel 인터페이스 및 WritableByteChannel 인터페이스를 확장한 것으로 각각, 단일의 버퍼가 아니고 복수의 버퍼의 순서를 사용하는 read 메서드 및 write 메서드를 추가하고 있습니다.

Channels 유틸리티 클래스는 java.io 패키지의 스트림 클래스와 이 패키지의 채널 클래스의 제휴를 지원하는 static 메서드를 정의합니다. 적절한 채널을 InputStream 또는 OutputStream 로부터 구축할 수 있습니다 . 반대로InputStream 또는 OutputStream를 채널로부터 구축할 수도 있습니다. Reader 는 지정된 캐릭터셋를 사용해 지정된 read 가능 바이트 채널의 바이트를 디코드하도록 구축할 수 있습니다. 한편, Writer 캐쉬는 지정된 캐릭터셋를 사용해 문자를 바이트에 encode 해, 지정된 출력 가능 바이트 채널에 출력하도록 구축할 수 있습니다.

파일 채널	설명
FileChannel	파일의 읽기, 출력해, 매핑, 조작
FileLock	파일의 (영역의) 락
MappedByteBuffer	파일 영역에 매핑 되는 다이렉트 byte 버퍼

FileChannel 클래스는 파일에 접속된 채널로부터의 바이트의 읽기, 파일에 접속된 채널에의 바이트의 출력이라고 한 일반적인 조작외, 현재의 파일 위치의 조회라고 변경, 파일 말미의 잘라서 버림에 한 특정 사이즈에의 변경을 지원 합니다. 이 클래스는 파일 전체 또는 파일내의 특정의 영역의 락을 획득하는 메서드를 정의합니다. 이러한 메서드는 FileLock 클래스의 인스턴스를 리턴합니다. 게다가FileChannel 클래스는 파일의 갱신 내용을 그 파일이 포함되고 있는 기억장치에 강제적으로 출력하는 메서드나, 파일과 그 외의 채널간에 효율적으로 바이트를 전송 하는 메서드나, 파일의 영역을 메모리에 직접 매핑 하는 메서드를 정의합니다. 이 마지막 조작을 위해서 인스턴스를 작성하는 MappedByteBuffer 클래스는 몇개의 파일 관련 조작을 갖춘 ByteBuffer 클래스를 확장한 것입니다.

java.io 패키지의 FileInputStream 클래스, FileOutputStream 클래스 및 RandomAccessFile 클래스에 각각 getChannel 메서드가 추가되었습니다. 이러한 쳐 몇개의 클래스의 인스턴스에 대해서 이 메서드를 호출하면, 기초에 있는 파일에 접속된 파일 채널이 리턴됩니다 .

다중화 된 비블록 입출력	설명
SelectableChannel	다중화가 가능한 채널
DatagramChannel	java.net.DatagramSocket 용의 채널
Pipe.SinkChannel	파이프의 출력측
Pipe.SourceChannel	파이프의 read측
ServerSocketChannel	java.net.ServerSocket 용의 채널
SocketChannel	java.net.Socket 용의 채널
Selector	선택 가능한 채널의 멀티플렉서
SelectionKey	셀렉터에의 채널의 등록을 나타내는 토큰
Pipe	단방향 파이프를 형성하는 2개의 채널

「셀렉터」, 「선택 가능 채널」 및 「선택 키」에 의해 제공되는 다중화 된 비블록 입출력은 thread 지향의 블록 입출력보다 스케이라불입니다.

셀렉터는선택 가능 채널의 멀티플렉서입니다. 선택 가능 채널은, 비블록 모드로 분류되는 특수한 채널이기도 합니다. 다중화 된 입출력 조작을 실행하고 싶은 경우는 우선 선택 가능 채널을 1개 이상 작성합니다. 다음에 이것을 비블록 모드로 해, 셀렉터에등록 합니다. 채널을 등록할 때는 사용 가능한가 어떤가를 셀렉터가 테스트하는 일련의 입출력 조작을 지정합니다. 셀렉터는 등록을 나타내는선택 키를 리턴합니다.

셀렉터에 채널을 등록하면, 범위가 미리 선언되고 있는 1개 이상의 조작의 실행이 가능하게 된 채널을 검출하기 위해, 선택 조작을 실행합니다. 채널의 준비가 되어 있으면, 등록시에 리턴된 키가 셀렉터의 「선택 키 세트」에 추가됩니다. 이 키 세트와 이 세트에 포함되는 키를 조사하는 것으로 각 채널을 실행할 수 있는 조작을 판단할 수 있습니다. 요구된 입출력 조작을 실행하기 위해, 각 키로부터 대응하는 채널을 취득할 수 있습니다.

선택 키는 그 채널이 있는 조작을 실행할 수 있는 상태가 되어 있는 것을 나타냅니다. 다만, 이것은 단순한 힌트이며, thread가 블록 되는 일 없이 그 조작을 실행할 수 있는 것을 보증하는 것이 아닙니다. 다중화 입출력 처리를 실행하는 코드는 힌트의 내용이 잘못되어 있으면 판명되었을 경우에 그 힌트를 무시하도록 기술해 주세요.

이 패키지는 java.net 패키지로 정의되고 있는 DatagramSocket 클래스, ServerSocket 클래스 및 Socket 클래스에 대응하는 선택 가능 채널 클래스를 정의합니다. 이러한 클래스에는 채널에 관련된 소켓을 지원 할 수 있도록, 소규모의 변경이 더해졌습니다. 이 패키지는 단방향 파이프를 구현하는 단순한 클래스도 정의합니다. 어느 경우에도, 새로운 선택 가능 채널을 작성하려면, 대응하는 클래스의 open 라고 하는 static 메서드를 호출합니다. 채널이 관련 소켓을 필요로 하고 있는 경우는 이 조작의 부작용으로서 소켓이 작성됩니다.

셀렉터, 선택 가능 채널, 선택 키의 구현을 옮겨놓고 싶은 경우는 java.nio.channels.spi 패키지로 정의되고 있는 SelectorProvider 클래스의 대체 정의 또는 인스턴스를 「플러그 인」합니다. 다만, 이 기능은 모든 개발자를 대상으로 한 기능이 아닙니다. 이것은 매우 높은 성능이 요구되는 경우에 OS 고유의 입출력 다중화 메카니즘을 활용할 수 있도록 하는 상급 사용자 전용 기능입니다.

다중화 입출력의 추상을 구현하기 위해서 필요하게 되는 등록 및 동기 처리의 대부분은, java.nio.channels.spi 패키지 AbstractInterruptibleChannel 클래스, AbstractSelectableChannel 클래스, AbstractSelectionKey 클래스 및 AbstractSelector 클래스에 의해 실행됩니다. 커스텀 셀렉터 프로바이더를 정의할 때는 AbstractSelector 클래스와 AbstractSelectionKey 클래스만을 직접 상속합니다. 커스텀 채널 클래스는 이 패키지로 정의되고 있는 적절한 SelectableChannel 서브 클래스를 확장할 필요가 있습니다.

도입된 버전 :

1.4