compact1, compact2, compact3

java.nio.channels

Class Channels

java.lang.Object

java.nio.channels.Channels

public final class Channels
extends Object

用于信道和流的实用方法。

这类定义的静态方法，支持的java.io包流类的互操作与本频道包装类。

从以下版本开始：

一点四

方法摘要

Modifier and Type	Method and Description
static ReadableByteChannel	newChannel(InputStream in) 构建一个从给定流读取字节的通道。
static WritableByteChannel	newChannel(OutputStream out) 构造一个将字节写入给定流的通道。
static InputStream	newInputStream(AsynchronousByteChannel ch) 构建一个从给定的信道读取字节的流。
static InputStream	newInputStream(ReadableByteChannel ch) 构建一个从给定的信道读取字节的流。
static OutputStream	newOutputStream(AsynchronousByteChannel 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) 构建一个作者，使用给定的编码器对字符进行编码，并将所得的字节写入给定的信道中。
static Writer	newWriter(WritableByteChannel ch, String csName) 结构，根据指定的字符集编码的字符的字节写入到给定的信道的作家。

Methods inherited from class java.lang.Object

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

方法详细信息

newInputStream

public static InputStream newInputStream(ReadableByteChannel ch)

构建一个从给定的信道读取字节的流。

结果流的read方法会调用底层的信道是非阻塞模式，把一个IllegalBlockingModeException。流不会缓存，它将不支持mark或reset方法。该流将是安全的多个并发线程访问。关闭流将反过来导致通道关闭。

参数

ch -从哪个渠道会读取字节

结果

一个新的输入流

newOutputStream

public static OutputStream newOutputStream(WritableByteChannel ch)

构造一个将字节写入给定信道的流。

结果流的write方法会调用底层的信道是非阻塞模式，把一个IllegalBlockingModeException。流将不会被缓冲。该流将是安全的多个并发线程访问。关闭流将反过来导致通道关闭。

参数

ch的通道，将被写入字节

结果

一个新的输出流

newInputStream

public static InputStream newInputStream(AsynchronousByteChannel ch)

构建一个从给定的信道读取字节的流。

流不会缓存，它将不支持mark或reset方法。该流将是安全的多个并发线程访问。关闭流将反过来导致通道关闭。

参数

ch -从哪个渠道会读取字节

结果

一个新的输入流

从以下版本开始：

一点七

newOutputStream

public static OutputStream newOutputStream(AsynchronousByteChannel ch)

构造一个将字节写入给定信道的流。

流将不会被缓冲。该流将是安全的多个并发线程访问。关闭流将反过来导致通道关闭。

参数

ch的通道，将被写入字节

结果

一个新的输出流

从以下版本开始：

一点七

newChannel

public static ReadableByteChannel newChannel(InputStream in)

构建一个从给定流读取字节的通道。

由此产生的信道将不会被缓冲，它只会将其I / O操作重定向到给定的流中。关闭通道将导致流关闭。

参数

in -流的字节被读取

结果

一种新的可读字节通道

newChannel

public static WritableByteChannel newChannel(OutputStream out)

构造一个将字节写入给定流的通道。

由此产生的信道将不会被缓冲，它只会将其I / O操作重定向到给定的流中。关闭通道将导致流关闭。

参数

out -流字节被写入

结果

一个新的可写字节通道

newReader

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

构建读者解码字节从给定的信道使用给定的解码器。

由此产生的气流将包含至少一个字节minBufferCap内部输入缓冲区。流的read方法会根据需要，从底层通道读取字节填充缓冲区；如果信道是非阻塞模式时，字节要读那么IllegalBlockingModeException将抛出。由此产生的流将不会被缓存，它将不支持mark或reset方法。关闭流将反过来导致通道关闭。

参数

ch -从哪个渠道会读取字节

dec -解码器用于字符集

minBufferCap -内部字节缓冲区的最小容量，或 -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)

构建一个作者，使用给定的编码器对字符进行编码，并将所得的字节写入给定的信道中。

由此产生的气流将包含至少minBufferCap字节内部输出缓冲器。流的write方法会根据需要，通过字节写入底层通道刷新缓冲区；如果信道是非阻塞模式时，字节被写入然后IllegalBlockingModeException将抛出。由此产生的流将不会被缓冲。关闭流将反过来导致通道关闭。

参数

ch的通道，将被写入字节

enc的字符集编码被使用

minBufferCap -内部字节缓冲区的最小容量，或 -1如果实施相关的默认容量是用

结果

一个新的作家

newWriter

public static Writer newWriter(WritableByteChannel ch,
                               String csName)

结构，根据指定的字符集编码的字符的字节写入到给定的信道的作家。

此方法的调用

 Channels.newWriter(ch, csname)

表现一样，表达

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

参数

ch的通道，将被写入字节

csName -字符集的名字使用

结果

一个新的作家

异常

UnsupportedCharsetException -如果不支持指定的字符中的java虚拟机实例是可用的