FileRegion (Netty API Reference (4.1.22.Final))

All Superinterfaces:

ReferenceCounted

所有已知实现类：

DefaultFileRegion
```
public interface FileRegion
extends ReferenceCounted
```
通过支持zero-copy file transfer的Channel发送的文件区域。
升级您的JDK / JRE
FileChannel.transferTo(long, long, WritableByteChannel)在旧版本的Sun JDK及其衍生版本中至少有四个已知的错误。如果您打算使用零拷贝文件传输，请将您的JDK升级到1.6.0_18或更高版本。
- 5103988 - FileChannel.transferTo（）应该为EAGAIN返回-1，而不是抛出IOException
- 6253145 - 超出2GB边界时，Linux上的FileChannel.transferTo（）失败
- 6427312 - FileChannel.transferTo（）抛出IOException“系统调用中断”
- 6470086 - FileChannel.transferTo（2147483647，1，channel）导致“值太大”异常
检查您的操作系统和JDK / JRE
如果您的操作系统（或JDK / JRE）不支持零拷贝文件传输，则发送包含FileRegion的文件可能会失败或性能降低。例如，发送大文件在Windows中运行不正常。
并非所有的传输都支持它

方法摘要

所有方法接口方法抽象方法弃用的方法
Modifier and Type	Method and Description
`long`	`count()` 返回要传输的字节数。
`long`	`position()` 返回传输开始的文件中的偏移量。
`FileRegion`	`retain()` 将引用计数增加 `1` 。
`FileRegion`	`retain(int increment)` 将参考计数增加指定的 `increment` 。
`FileRegion`	`touch()` 记录此对象的当前访问位置以进行调试。
`FileRegion`	`touch(java.lang.Object hint)` 记录此对象的当前访问位置，并附加一些用于调试的任意信息。
`long`	`transfered()` 已过时。改为使用`transferred()` 。
`long`	`transferred()` 返回已经传输的字节。
`long`	`transferTo(java.nio.channels.WritableByteChannel target, long position)` 将此文件区域的内容传输到指定的通道。

Methods inherited from interface io.netty.util.ReferenceCounted
refCnt, release, release

- 方法详细信息
  - position
```
long position()
```
    返回传输开始的文件中的偏移量。
  - transfered
```
@Deprecated
long transfered()
```
    已过时。改为使用transferred() 。
    
    返回已经传输的字节。
  - transferred
```
long transferred()
```
    返回已经传输的字节。
  - count
```
long count()
```
    返回要传输的字节数。
  - transferTo
```
long transferTo(java.nio.channels.WritableByteChannel target,
                long position)
         throws java.io.IOException
```
    将此文件区域的内容传输到指定的通道。
    
    参数
    
    target - 转移的目的地
    
    position - 从传输开始的文件的相对偏移量。例如， 0将使传输从第position()个字节开始， count() - 1将使该区域的最后一个字节传输。
    
    异常
    
    java.io.IOException
  - retain
```
FileRegion retain()
```
    从界面复制的描述： ReferenceCounted
    
    将引用计数增加 1 。
    
    Specified by:
    
    retain在界面 ReferenceCounted
  - retain
```
FileRegion retain(int increment)
```
    从接口ReferenceCounted复制的描述
    
    将参考计数增加 increment 。
    
    Specified by:
    
    retain在界面 ReferenceCounted
  - touch
```
FileRegion touch()
```
    从接口ReferenceCounted复制的描述
    
    记录此对象的当前访问位置以进行调试。如果确定此物体泄漏，则通过此操作记录的信息将通过ResourceLeakDetector提供给您。此方法是touch(null)的快捷方式。
    
    Specified by:
    
    touch在界面 ReferenceCounted
  - touch
```
FileRegion touch(java.lang.Object hint)
```
    从接口ReferenceCounted复制的描述
    
    记录此对象的当前访问位置，并附加一些用于调试的任意信息。如果确定此物体泄漏，则通过此操作记录的信息将通过ResourceLeakDetector提供给您。
    
    Specified by:
    
    touch在界面 ReferenceCounted

Interface FileRegion

升级您的JDK / JRE

检查您的操作系统和JDK / JRE

并非所有的传输都支持它

方法摘要

Methods inherited from interface io.netty.util.ReferenceCounted

方法详细信息

position

transfered

transferred

count

transferTo

retain

retain

touch

touch