public class ChunkedNioFile extends java.lang.Object implements ChunkedInput
ChunkedInput
that fetches data from a file chunk by chunk using
NIO FileChannel
.
If your operating system supports
zero-copy file transfer
such as sendfile()
, you might want to use FileRegion
instead.
构造器和说明 |
---|
ChunkedNioFile(java.io.File in)
Creates a new instance that fetches data from the specified file.
|
ChunkedNioFile(java.nio.channels.FileChannel in)
Creates a new instance that fetches data from the specified file.
|
ChunkedNioFile(java.nio.channels.FileChannel in,
int chunkSize)
Creates a new instance that fetches data from the specified file.
|
ChunkedNioFile(java.nio.channels.FileChannel in,
long offset,
long length,
int chunkSize)
Creates a new instance that fetches data from the specified file.
|
ChunkedNioFile(java.io.File in,
int chunkSize)
Creates a new instance that fetches data from the specified file.
|
限定符和类型 | 方法和说明 |
---|---|
void |
close()
Releases the resources associated with the stream.
|
long |
getCurrentOffset()
Returns the offset in the file where the transfer is happening currently.
|
long |
getEndOffset()
Returns the offset in the file where the transfer will end.
|
long |
getStartOffset()
Returns the offset in the file where the transfer began.
|
boolean |
hasNextChunk()
Returns
true if and only if there is any data left in the
stream. |
boolean |
isEndOfInput()
Return
true if and only if there is no data left in the stream
and the stream has reached at its end. |
java.lang.Object |
nextChunk()
Fetches a chunked data from the stream.
|
public ChunkedNioFile(java.io.File in) throws java.io.IOException
java.io.IOException
public ChunkedNioFile(java.io.File in, int chunkSize) throws java.io.IOException
chunkSize
- the number of bytes to fetch on each
nextChunk()
calljava.io.IOException
public ChunkedNioFile(java.nio.channels.FileChannel in) throws java.io.IOException
java.io.IOException
public ChunkedNioFile(java.nio.channels.FileChannel in, int chunkSize) throws java.io.IOException
chunkSize
- the number of bytes to fetch on each
nextChunk()
calljava.io.IOException
public ChunkedNioFile(java.nio.channels.FileChannel in, long offset, long length, int chunkSize) throws java.io.IOException
offset
- the offset of the file where the transfer beginslength
- the number of bytes to transferchunkSize
- the number of bytes to fetch on each
nextChunk()
calljava.io.IOException
public long getStartOffset()
public long getEndOffset()
public long getCurrentOffset()
public boolean hasNextChunk() throws java.lang.Exception
ChunkedInput
true
if and only if there is any data left in the
stream. Please note that false
does not necessarily mean that
the stream has reached at its end. In a slow stream, the next chunk
might be unavailable just momentarily.hasNextChunk
在接口中 ChunkedInput
java.lang.Exception
public boolean isEndOfInput() throws java.lang.Exception
ChunkedInput
true
if and only if there is no data left in the stream
and the stream has reached at its end.isEndOfInput
在接口中 ChunkedInput
java.lang.Exception
public void close() throws java.lang.Exception
ChunkedInput
close
在接口中 ChunkedInput
java.lang.Exception
public java.lang.Object nextChunk() throws java.lang.Exception
ChunkedInput
ChannelBuffer
, but you could extend an existing implementation
to convert the ChannelBuffer
into a different type that your
handler or encoder understands. Once this method returns the last chunk
and thus the stream has reached at its end, any subsequent ChunkedInput.isEndOfInput()
call must return false
.nextChunk
在接口中 ChunkedInput
ChannelBuffer
.
null
if there is no data left in the stream.
Please note that null
does not necessarily mean that the
stream has reached at its end. In a slow stream, the next chunk
might be unavailable just momentarily.java.lang.Exception