Implementations of this class may buffer data internally to reduce remote calls. This interface implementsRestorable to allow saving the reader's state to continue reading afterwards.

Implements

Captures the read channel state so that it can be saved and restored afterwards.

Overridden to remove IOException.See Also:java.nio.channels.Channel#close()

The currently defined limit for this channel. Initial value isLong#MAX_VALUE

Limit the maximum number of bytes to be read from the objects content, counting from the beginning of the object, which will be available to read from this channel. If the limit is larger than the actual size of the content this will have no material impact.

If used in conjunction with#seek(long) the total number of returned bytes from this channel will be reduced by the number of bytes specified to seek.

The value provided aslimit will define aleft-closed, right-open interval along with either0 or any value provided to#seek(long), i.e.[#seek(long),#limit(long)).

An example to help illustrate the relationship

Imagine some data[A, B, C, D, E, F, G, H, I, J], 10 bytes total.

1. limit(5) would produce[A, B, C, D, E]
2. seek(8) would produce[I, J]
3. seek(2)limit(5) would produce[C, D, E]
4. seek(3)limit(3) would produce[]

NOTE:Implementers are not required to return a new instance from this method, however they are allowed to. Users of this method should always use the instance returned from this method.

Default Implementation:By default, this method will simply returnthis.

Set the offset to read from.

Sets the minimum size that will be read by a single RPC. Read data will be locally buffered until consumed.