SeekableByteChannel (Java Platform SE 8 )

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

Interface SeekableByteChannel

方法摘要

Methods inherited from interface java.nio.channels.Channel

方法详细信息

read

write

position

position

size

truncate