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方法来返回调用它们的通道。 这允许方法调用被链接。 该接口的实现应该专门化返回类型，以便可以链接实现类上的方法调用。

从以下版本开始：

1.7

另请参见：

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错误