java.nio.channels
클래스 Channels

java.lang.Object 
  java.nio.channels.Channels

public final class Channels
extends Object 

채널과 스트림을 위한 유틸리티 메서드입니다.

이 클래스는 java.io 패키지의 스트림 클래스와 이 패키지의 채널 클래스의 제휴를 지원하는 static 메서드를 정의합니다.

도입된 버전 :

1.4

메서드 개요

static ReadableByteChannel	newChannel (InputStream in) 지정된 스트림로부터 바이트를 읽어내는 채널을 구축합니다.
static WritableByteChannel	newChannel (OutputStream out) 지정된 스트림에 바이트를 출력하는 채널을 구축합니다.
static InputStream	newInputStream (ReadableByteChannel ch) 지정된 채널로부터 바이트를 읽어내는 스트림을 구축합니다.
static OutputStream	newOutputStream (WritableByteChannel ch) 지정된 채널에 바이트를 출력하는 스트림을 구축합니다.
static Reader	newReader (ReadableByteChannel ch, CharsetDecoder dec, int minBufferCap) 지정된 디코더를 사용해 지정된 채널 바이트를 디코드하는 리더를 구축합니다.
static Reader	newReader (ReadableByteChannel ch, String csName) 지정 캐릭터셋에 따라 지정된 채널로부터 바이트를 디코드하는 리더를 구축합니다.
static Writer	newWriter (WritableByteChannel ch, CharsetEncoder enc, int minBufferCap) 지정된 엔코더를 사용해 문자를 encode 해, 결과적으로 얻을 수 있던 바이트가 지정된 채널에 출력하는 라이터를 구축합니다.
static Writer	newWriter (WritableByteChannel ch, String csName) 지정 캐릭터셋에 따라 문자를 encode 해, 결과적으로 얻을 수 있던 바이트가 지정된 채널에 출력하는 라이터를 구축합니다.

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

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

메서드의 상세

newInputStream

public static InputStream  newInputStream(ReadableByteChannel  ch)

지정된 채널로부터 바이트를 읽어내는 스트림을 구축합니다.

결과적으로 얻을 수 있는 스트림의 read 메서드는 기본이 되는 채널이 비블록 모드인 경우에 불려가 면, IllegalBlockingModeException를 Throw 합니다. 스트림은 버퍼 되지 않고, mark 메서드나 reset 메서드를 지원 하지 않습니다. 스트림은 복수의 병행 thread로부터의 액세스에 대해서 안전합니다. 스트림을 클로우즈 하면, 채널도 닫습니다.

파라미터:

ch - 바이트가 읽히는 채널

반환값:

새로운 입력 스트림

newOutputStream

public static OutputStream  newOutputStream(WritableByteChannel  ch)

지정된 채널에 바이트를 출력하는 스트림을 구축합니다.

결과적으로 얻을 수 있는 스트림의 write 메서드는 기본이 되는 채널이 비블록 모드인 경우에 불려가 면, IllegalBlockingModeException를 Throw 합니다. 스트림은 버퍼 되지 않고, 복수의 병행 thread로부터의 액세스에 대해서 안전합니다. 스트림을 클로우즈 하면, 채널도 닫습니다.

파라미터:

ch - 바이트가 출력해지는 채널

반환값:

새로운 출력 스트림

newChannel

public static ReadableByteChannel  newChannel(InputStream  in)

지정된 스트림로부터 바이트를 읽어내는 채널을 구축합니다.

결과적으로 얻을 수 있는 채널은 버퍼 되지 않고, 지정된 스트림에 입출력 조작을 리다이렉트 합니다. 채널을 클로우즈 하면 스트림도 닫습니다.

파라미터:

in - 바이트의 read처 스트림

반환값:

새로운 read 가능한 바이트 채널

newChannel

public static WritableByteChannel  newChannel(OutputStream  out)

지정된 스트림에 바이트를 출력하는 채널을 구축합니다.

결과적으로 얻을 수 있는 채널은 버퍼 되지 않고, 지정된 스트림에 입출력 조작을 리다이렉트 합니다. 채널을 클로우즈 하면 스트림도 닫습니다.

파라미터:

out - 바이트의 출력처 스트림

반환값:

새로운 출력 가능한 바이트 채널

newReader

public static Reader  newReader(ReadableByteChannel  ch,
                               CharsetDecoder  dec,
                               int minBufferCap)

지정된 디코더를 사용해 지정된 채널 바이트를 디코드하는 리더를 구축합니다.

결과적으로 얻을 수 있는 스트림에는 minBufferCap 바이트 이상의 내부 입력 버퍼가 포함되어 있습니다. 스트림의 read 메서드는 필요에 따라서 기본이 되는 채널로부터 바이트를 읽기, 버퍼에 넣습니다. 바이트의 read시에 채널이 비블록 모드가 되어 있으면, IllegalBlockingModeException을 발생시킵니다. 결과적으로 얻을 수 있는 스트림은 그 이외의 점에서는 버퍼 되지 않고, mark 메서드나 reset 메서드를 지원 하지 않습니다. 스트림을 클로우즈 하면 채널도 닫습니다.

파라미터:

ch - 바이트가 읽히는 채널

dec - 사용하는 캐릭터셋 디코더

minBufferCap - 내부 byte 버퍼의 최소 용량인가 구현에 의존된 디폴트의 용량을 사용하는 경우는 -1

반환값:

새로운 리더

newReader

public static Reader  newReader(ReadableByteChannel  ch,
                               String  csName)

지정 캐릭터셋에 따라 지정된 채널로부터 바이트를 디코드하는 리더를 구축합니다.

다음의 폼의 메서드 호출은,

 Channels.newReader(ch, csname)

다음의 표현과 같게 동작합니다.

 Channels.newReader(ch, Charset.forName(csName) . newDecoder(), -1);

파라미터:

ch - 바이트가 읽히는 채널

csName - 사용하는 캐릭터셋의 이름

반환값:

새로운 리더

예외:

UnsupportedCharsetException - 지정 캐릭터셋가 현재의 Java 가상 머신에서는 이용할 수 없는 경우

newWriter

public static Writer  newWriter(WritableByteChannel  ch,
                               CharsetEncoder  enc,
                               int minBufferCap)

지정된 엔코더를 사용해 문자를 encode 해, 결과적으로 얻을 수 있던 바이트가 지정된 채널에 출력하는 라이터를 구축합니다.

결과적으로 얻을 수 있는 스트림에는 minBufferCap 바이트 이상의 내부 출력 버퍼가 포함되어 있습니다. 스트림의 write 메서드는 필요에 따라서 기본이 되는 채널에 바이트를 출력해, 버퍼를 플래시 합니다. 바이트의 출력시에 채널이 비블록 모드가 되어 있으면, IllegalBlockingModeException을 발생시킵니다. 결과적으로 얻을 수 있는 스트림은 그 이외의 점에서는 버퍼 되지 않습니다. 스트림을 클로우즈 하면 채널도 닫습니다.

파라미터:

ch - 바이트가 출력해지는 채널

enc - 사용하는 캐릭터셋 엔코더

minBufferCap - 내부 byte 버퍼의 최소 용량인가 구현에 의존된 디폴트의 용량을 사용하는 경우는 -1

반환값:

새로운 라이터

newWriter

public static Writer  newWriter(WritableByteChannel  ch,
                               String  csName)

지정 캐릭터셋에 따라 문자를 encode 해, 결과적으로 얻을 수 있던 바이트가 지정된 채널에 출력하는 라이터를 구축합니다.

다음의 폼의 메서드 호출은,

 Channels.newWriter(ch, csname)

다음의 표현과 같게 동작합니다.

 Channels.newWriter(ch, Charset.forName(csName) . newEncoder(), -1);

파라미터:

ch - 바이트가 출력해지는 채널

csName - 사용하는 캐릭터셋의 이름

반환값:

새로운 라이터

예외:

UnsupportedCharsetException - 지정 캐릭터셋가 현재의 Java 가상 머신에서는 이용할 수 없는 경우