compact1, compact2, compact3

java.nio.channels

Интерфейс SeekableByteChannel

Все Суперинтерфейсы:

AutoCloseable, ByteChannel, Канал, Closeable, ReadableByteChannel, WritableByteChannel

Все Известные Классы с реализацией:

FileChannel

public interface SeekableByteChannel
extends ByteChannel

Канал байта, который поддерживает текущую позицию и позволяет позиции быть измененной.

seekable канал байта соединяется с объектом, обычно файлом, который содержит последовательность переменной длины байтов, которые могут быть считаны и записаны. Текущая позиция может быть queried и modified. Канал также обеспечивает доступ к текущему размеру объекта, с которым соединяется канал. Размер увеличивается, когда байты пишутся вне его текущего размера; размер уменьшается, когда это truncated.

position и truncate методы, у которых иначе нет значения, чтобы возвратиться, определяются, чтобы возвратить канал, на который они вызываются. Это позволяет вызовам метода быть объединенными в цепочку. Реализации этого интерфейса должны специализировать тип возврата так, чтобы вызовы метода на реализации class могли быть объединены в цепочку.

С тех пор:

1.7

См. Также:

Files.newByteChannel(java.nio.file.Path, java.util.Set<? extends java.nio.file.OpenOption>, java.nio.file.attribute.FileAttribute<?>...)

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

Модификатор и Тип	Метод и Описание
long	position() Возвраты позиция этого канала.
SeekableByteChannel	position(long newPosition) Наборы позиция этого канала.
int	read(ByteBuffer dst) Читает последовательность байтов от этого канала в данный буфер.
long	size() Возвращает текущий размер объекта, с которым соединяется этот канал.
SeekableByteChannel	truncate(long size) Усекает объект, с которым этот канал соединяется к данному размеру.
int	write(ByteBuffer src) Пишет последовательность байтов к этому каналу от данного буфера.

Методы, наследованные от интерфейса java.nio.channels. Канал

close, isOpen

Деталь метода

читать

int read(ByteBuffer dst)
  throws IOException

Читает последовательность байтов от этого канала в данный буфер.

Байты читаются, запускаясь в текущей позиции этого канала, и затем позиция обновляется с числом байтов фактически чтение. Иначе этот метод ведет себя точно как определено в ReadableByteChannel интерфейс.

Определенный:

read в интерфейсе ReadableByteChannel

Параметры:

dst - Буфер, в который должны быть переданы байты

Возвраты:

Число байтов считало, возможно обнуляет, или -1, если канал достиг конца потока

Броски:

ClosedChannelException - Если этот канал закрывается

AsynchronousCloseException - Если другой поток закрывает этот канал, в то время как операция чтения происходит

ClosedByInterruptException - Если другой поток прерывает текущий поток, в то время как операция чтения происходит, таким образом закрывая канал и устанавливая состояние прерывания текущего потока

IOException - Если некоторая другая ошибка ввода-вывода происходит

записать

int write(ByteBuffer src)
   throws IOException

Пишет последовательность байтов к этому каналу от данного буфера.

Байты пишутся, запускаясь в текущей позиции этого канала, если канал не соединяется с объектом, таким как файл, который открывается с APPEND опция, когда позиция сначала совершенствуется до конца. Объект, с которым соединяется канал, выращивается, в случае необходимости, чтобы разместить записанные байты, и затем позиция обновляется с числом байтов, фактически записанных. Иначе этот метод ведет себя точно как определено WritableByteChannel интерфейс.

Определенный:

write в интерфейсе WritableByteChannel

Параметры:

src - Буфер, от которого должны быть получены байты

Возвраты:

Число записанных байтов, возможно обнулите

Броски:

ClosedChannelException - Если этот канал закрывается

AsynchronousCloseException - Если другой поток закрывает этот канал, в то время как операция записи происходит

ClosedByInterruptException - Если другой поток прерывает текущий поток, в то время как операция записи происходит, таким образом закрывая канал и устанавливая состояние прерывания текущего потока

IOException - Если некоторая другая ошибка ввода-вывода происходит

позиция

long position()
       throws IOException

Возвраты позиция этого канала.

Возвраты:

Позиция этого канала, неотрицательное целое число, считая число байтов с начала объекта к текущей позиции

Броски:

ClosedChannelException - Если этот канал закрывается

IOException - Если некоторая другая ошибка ввода-вывода происходит

позиция

SeekableByteChannel position(long newPosition)
                      throws IOException

Наборы позиция этого канала.

Установка позиции к значению, которое больше чем текущий размер, является законной, но не изменяет размер объекта. Более поздняя попытка считать байты в такой позиции сразу возвратит индикацию конца файла. Более поздняя попытка записать байты в такой позиции заставит объект расти, чтобы разместить новые байты; значения любых байтов между предыдущим концом файла и недавно записанных байтов являются неуказанными.

Установка позиции канала не рекомендуется когда соединено с объектом, обычно файлом, который открывается с APPEND опция. Когда открыто для добавляют, позиция сначала совершенствуется до конца перед записью.

Параметры:

newPosition - Новая позиция, неотрицательное целое число, считая число байтов с начала объекта

Возвраты:

Этот канал

Броски:

ClosedChannelException - Если этот канал закрывается

IllegalArgumentException - Если новая позиция отрицательна

IOException - Если некоторая другая ошибка ввода-вывода происходит

размер

long size()
   throws IOException

Возвращает текущий размер объекта, с которым соединяется этот канал.

Возвраты:

Текущий размер, измеренный в байтах

Броски:

ClosedChannelException - Если этот канал закрывается

IOException - Если некоторая другая ошибка ввода-вывода происходит

усеченный

SeekableByteChannel truncate(long size)
                      throws IOException

Усекает объект, с которым этот канал соединяется к данному размеру.

Если данный размер является меньше чем текущий размер тогда, объект является усеченным, отбрасывая любые байты вне нового конца. Если данный размер больше чем или равен текущему размеру тогда, объект не изменяется. В любом случае, если текущая позиция больше чем данный размер тогда, что это устанавливается в тот размер.

Реализация этого интерфейса может запретить усечение когда соединено с объектом, обычно файлом, открытым с APPEND опция.

Параметры:

size - Новый размер, неотрицательное количество байта

Возвраты:

Этот канал

Броски:

NonWritableChannelException - Если этот канал не был открыт для того, чтобы записать

ClosedChannelException - Если этот канал закрывается

IllegalArgumentException - Если новый размер отрицателен

IOException - Если некоторая другая ошибка ввода-вывода происходит