compact1, compact2, compact3

java.nio.channels

Каналы класса

java.lang. Объект

java.nio.channels. Каналы

public final class Channels
extends Object

Служебные методы для каналов и потоков.

Этот class определяет статические методы, которые поддерживают взаимодействие потоковых классов java.io пакет с классами канала этого пакета.

С тех пор:

1.4

Сводка метода

Модификатор и Тип	Метод и Описание
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) Создает писателя, который кодирует символы согласно именованному набору символов и пишет получающиеся байты в данный канал.

Методы, наследованные от class java.lang. Объект

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 - Канал, из которого будут считаны байты

Возвраты:

Новый входной поток

С тех пор:

1.7

newOutputStream

public static OutputStream newOutputStream(AsynchronousByteChannel ch)

Создает поток, который пишет байты в данный канал.

Поток не будет буферизован. Поток будет безопасен для доступа многократными параллельными потоками. Закрытие потока поочередно заставит канал быть закрытым.

Параметры:

ch - Канал, которому будут записаны байты

Возвраты:

Новый поток вывода

С тех пор:

1.7

newChannel

public static ReadableByteChannel newChannel(InputStream in)

Создает канал, который читает байты из данного потока.

Получающийся канал не будет буферизован; это просто перенаправит свои операции ввода-вывода к данному потоку. Закрытие канала поочередно заставит поток быть закрытым.

Параметры:

in - Поток, из которого должны быть считаны байты

Возвраты:

Новый читаемый канал байта

newChannel

public static WritableByteChannel newChannel(OutputStream out)

Создает канал, который пишет байты в данный поток.

Получающийся канал не будет буферизован; это просто перенаправит свои операции ввода-вывода к данному потоку. Закрытие канала поочередно заставит поток быть закрытым.

Параметры:

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