Package org.apache.http.impl.nio.codecs
Class IdentityDecoder
java.lang.Object
org.apache.http.impl.nio.codecs.AbstractContentDecoder
org.apache.http.impl.nio.codecs.IdentityDecoder
- All Implemented Interfaces:
ContentDecoder
,FileContentDecoder
Content decoder that reads data without any transformation. The end of the
content entity is delineated by closing the underlying connection
(EOF condition). Entities transferred using this input stream can be of
unlimited length.
This decoder is optimized to transfer data directly from the underlying
I/O session's channel to a FileChannel
, whenever
possible avoiding intermediate buffering in the session buffer.
- Since:
- 4.0
-
Field Summary
Fields inherited from class org.apache.http.impl.nio.codecs.AbstractContentDecoder
buffer, channel, completed, metrics
-
Constructor Summary
ConstructorsConstructorDescriptionIdentityDecoder
(ReadableByteChannel channel, SessionInputBuffer buffer, HttpTransportMetricsImpl metrics) -
Method Summary
Modifier and TypeMethodDescriptionint
read
(ByteBuffer dst) Reads a portion of content from the underlying channeltoString()
long
transfer
(FileChannel dst, long position, long count) Transfers a portion of entity content from the underlying network channel into the given file channel.Methods inherited from class org.apache.http.impl.nio.codecs.AbstractContentDecoder
fillBufferFromChannel, isCompleted, readFromChannel, readFromChannel, setCompleted, setCompleted
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.apache.http.nio.ContentDecoder
isCompleted
-
Constructor Details
-
IdentityDecoder
public IdentityDecoder(ReadableByteChannel channel, SessionInputBuffer buffer, HttpTransportMetricsImpl metrics)
-
-
Method Details
-
read
Description copied from interface:ContentDecoder
Reads a portion of content from the underlying channel- Specified by:
read
in interfaceContentDecoder
- Parameters:
dst
- The buffer into which entity content is to be transferred- Returns:
- The number of bytes read, possibly zero, or -1 if the channel has reached end-of-stream
- Throws:
IOException
- if I/O error occurs while reading content
-
transfer
Description copied from interface:FileContentDecoder
Transfers a portion of entity content from the underlying network channel into the given file channel.Warning: Many implementations cannot write beyond the length of the file. If the position exceeds the channel's size, some implementations may throw an IOException.
- Specified by:
transfer
in interfaceFileContentDecoder
- Parameters:
dst
- the target FileChannel to transfer data into.position
- The position within the file at which the transfer is to begin; must be non-negative. Must be less than or equal to the size of the filecount
- The maximum number of bytes to be transferred; must be non-negative- Returns:
- The number of bytes, possibly zero, that were actually transferred
- Throws:
IOException
- if some I/O error occurs.
-
toString
-