compact1, compact2, compact3

java.nio.channels

Interface SeekableByteChannel

All Superinterfaces:

AutoCloseable， ByteChannel， Channel， Closeable， ReadableByteChannel， WritableByteChannel

所有已知实现类：

FileChannel

public interface SeekableByteChannel
extends ByteChannel

一个字节通道保持当前位置，允许位置被改变。

一个可寻址的字节通道连接到一个实体，通常是一个文件，包含一个可变长度的字节，可以读写序列。目前的位置可以queried和modified。该频道还提供了访问当前大小的实体，通道连接。的大小增加时，字节被写入超出其当前尺寸；尺寸减小，当它truncated。

的position和truncate方法，否则不具备返回的值是指定的返回通道后，他们被调用。这允许方法调用被。实现这个接口应该专门的返回类型，在实现类中的方法调用可以链接。

从以下版本开始：

一点七

另请参见：

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

方法摘要

Modifier and Type	Method and Description
long	position() 返回此通道的位置。
SeekableByteChannel	position(long newPosition) 设置此通道的位置。
int	read(ByteBuffer dst) 从这个通道读取一个字节序列到给定的缓冲区中。
long	size() 返回此通道连接的实体的当前大小。
SeekableByteChannel	truncate(long size) 截断的实体，此通道是连接到给定的尺寸。
int	write(ByteBuffer src) 从给定的缓冲区中写入该通道的一个字节序列。

Methods inherited from interface java.nio.channels.Channel

close, isOpen

方法详细信息

read

int read(ByteBuffer dst)
  throws IOException

从这个通道读取一个字节序列到给定的缓冲区中。

在该通道的当前位置开始读取字节，然后用实际读取的字节数进行更新。否则，此方法的行为完全按照ReadableByteChannel指定界面。

Specified by:

read 接口 ReadableByteChannel

参数

dst -缓冲区中的字节都被转移

结果

已读取的字节数，可能是零，或 -1如果信已经达到结束流

异常

ClosedChannelException -如果这通道关闭

AsynchronousCloseException如果另一个线程关闭通道而读操作正在进行中

ClosedByInterruptException如果另一个线程中断当前线程在读操作中，从而关闭通道和设置当前线程的中断状态

IOException -如果其他I/O错误发生

write

int write(ByteBuffer src)
   throws IOException

从给定的缓冲区中写入该通道的一个字节序列。

字节写入开始在这个频道的当前位置，除非通道连接到如打开的文件，与APPEND选择实体，在这种情况下，位置是第一个提出结束。该通道连接的实体生长，如果必要的话，以容纳写入的字节，然后将该位置与实际写入的字节数进行更新。否则，此方法的行为完全由WritableByteChannel指定界面。

Specified by:

write 接口 WritableByteChannel

参数

src -缓冲器字节进行检索

结果

写入的字节数，可能为零

异常

ClosedChannelException -如果这通道关闭

AsynchronousCloseException如果另一个线程关闭通道，而写操作正在进行中

ClosedByInterruptException如果另一个线程中断当前线程，而写操作正在进行，从而关闭通道和设置当前线程的中断状态

IOException -如果其他I/O错误发生

position

long position()
       throws IOException

返回此通道的位置。

结果

此通道的位置，一个非负整数，从实体的开始到当前位置的字节数

异常

ClosedChannelException -如果这通道关闭

IOException -如果其他I/O错误发生

position

SeekableByteChannel position(long newPosition)
                      throws IOException

设置此通道的位置。

将该位置设置为大于当前大小的值是合法的，但不改变实体的大小。稍后在这样一个位置读取字节的尝试将立即返回一个文件指示的结束。稍后尝试在这样一个位置上写字节将导致实体增长，以适应新的字节；任何字节的值之间的前一个文件和新写的字节是未指定的。

设置通道的位置是不推荐，当连接到一个实体，通常是一个文件，这是打开的APPEND选项。当打开附加时，位置是第一个先进的结束前写。

参数

newPosition -新的位置，一个非负整数计数字节数从实体开始

结果

这个频道

异常

ClosedChannelException -如果这通道关闭

IllegalArgumentException -如果新的位置是负的

IOException -如果其他I/O错误发生

size

long size()
   throws IOException

返回此通道连接的实体的当前大小。

结果

当前的大小，以字节计量的

异常

ClosedChannelException -如果这通道关闭

IOException -如果其他I/O错误发生

truncate

SeekableByteChannel truncate(long size)
                      throws IOException

截断的实体，此通道是连接到给定的尺寸。

如果给定的大小小于当前的大小，则实体被截断，丢弃新的结束后的任何字节。如果给定的大小大于或等于当前的大小，则实体不被修改。在这两种情况下，如果当前位置大于给定的大小，那么它被设置为该大小。

此接口的实现，可以禁止截断，当连接到一个实体，通常是一个文件，打开的APPEND选项。

参数

size -新的大小，一个非负的字节数

结果

这个频道

异常

NonWritableChannelException -如果这个渠道没有打开写作

ClosedChannelException -如果这通道关闭

IllegalArgumentException -如果新的大小负

IOException -如果其他I/O错误发生