io.netty.channel

接口 FileRegion

所有超级接口:

ReferenceCounted

所有已知实现类:

DefaultFileRegion

public interface FileRegion
extends ReferenceCounted

A region of a file that is sent via a Channel which supports zero-copy file transfer.

Upgrade your JDK / JRE

FileChannel.transferTo(long, long, WritableByteChannel) has at least four known bugs in the old versions of Sun JDK and perhaps its derived ones. Please upgrade your JDK to 1.6.0_18 or later version if you are going to use zero-copy file transfer.

• 5103988 - FileChannel.transferTo() should return -1 for EAGAIN instead throws IOException
• 6253145 - FileChannel.transferTo() on Linux fails when going beyond 2GB boundary
• 6427312 - FileChannel.transferTo() throws IOException "system call interrupted"
• 6470086 - FileChannel.transferTo(2147483647, 1, channel) causes "Value too large" exception

Check your operating system and JDK / JRE

If your operating system (or JDK / JRE) does not support zero-copy file transfer, sending a file with FileRegion might fail or yield worse performance. For example, sending a large file doesn't work well in Windows.

Not all transports support it

方法概要

限定符和类型	方法和说明
long	count() Returns the number of bytes to transfer.
long	position() Returns the offset in the file where the transfer began.
FileRegion	retain() Increases the reference count by 1.
FileRegion	retain(int increment) Increases the reference count by the specified increment.
FileRegion	touch() Records the current access location of this object for debugging purposes.
FileRegion	touch(java.lang.Object hint) Records the current access location of this object with an additional arbitrary information for debugging purposes.
long	transfered() 已过时。 Use transferred() instead.
long	transferred() Returns the bytes which was transferred already.
long	transferTo(java.nio.channels.WritableByteChannel target, long position) Transfers the content of this file region to the specified channel.

从接口继承的方法 io.netty.util.ReferenceCounted

refCnt, release, release

方法详细资料

position

long position()

Returns the offset in the file where the transfer began.

transfered

@Deprecated
long transfered()

已过时。 Use transferred() instead.

Returns the bytes which was transferred already.

transferred

long transferred()

Returns the bytes which was transferred already.

count

long count()

Returns the number of bytes to transfer.

transferTo

long transferTo(java.nio.channels.WritableByteChannel target,
                long position)
         throws java.io.IOException

Transfers the content of this file region to the specified channel.

参数:

target - the destination of the transfer

position - the relative offset of the file where the transfer begins from. For example, 0 will make the transfer start from position()th byte and count() - 1 will make the last byte of the region transferred.

抛出:

java.io.IOException

retain

FileRegion retain()

从接口复制的说明: ReferenceCounted

Increases the reference count by 1.

指定者:

retain 在接口中 ReferenceCounted

retain

FileRegion retain(int increment)

从接口复制的说明: ReferenceCounted

Increases the reference count by the specified increment.

指定者:

retain 在接口中 ReferenceCounted

touch

FileRegion touch()

从接口复制的说明: ReferenceCounted

Records the current access location of this object for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector. This method is a shortcut to touch(null).

指定者:

touch 在接口中 ReferenceCounted

touch

FileRegion touch(java.lang.Object hint)

从接口复制的说明: ReferenceCounted

Records the current access location of this object with an additional arbitrary information for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector.

指定者:

touch 在接口中 ReferenceCounted