public class S3ObjectInputStream extends SdkFilterInputStream
S3Object
. In addition to
the methods supplied by the InputStream
class,
S3ObjectInputStream
supplies the abort() method, which will terminate
an HTTP connection to the S3 object.in
Constructor and Description |
---|
S3ObjectInputStream(InputStream in,
org.apache.http.client.methods.HttpRequestBase httpRequest) |
S3ObjectInputStream(InputStream in,
org.apache.http.client.methods.HttpRequestBase httpRequest,
boolean collectMetrics) |
Modifier and Type | Method and Description |
---|---|
void |
abort()
Aborts the underlying http request without reading any more data and
closes the stream.
|
int |
available()
Returns the value of super.available() if the result is nonzero, or 1
otherwise.
|
void |
close()
Delegates to
abort() if there is any data
remaining in the stream. |
org.apache.http.client.methods.HttpRequestBase |
getHttpRequest()
Returns the http request from which this input stream is derived.
|
abortIfNeeded, isAborted, isMetricActivated, mark, markSupported, read, read, release, reset, skip
read
public S3ObjectInputStream(InputStream in, org.apache.http.client.methods.HttpRequestBase httpRequest)
public S3ObjectInputStream(InputStream in, org.apache.http.client.methods.HttpRequestBase httpRequest, boolean collectMetrics)
public void abort()
By default Apache HttpClient
tries to reuse http connections by
reading to the end of an attached input stream on
InputStream.close()
. This is efficient from a socket pool
management perspective, but for objects with large payloads can incur
significant overhead while bytes are read from s3 and discarded. It's up
to clients to decide when to take the performance hit implicit in not
reusing an http connection in order to not read unnecessary information
from S3.
abort
in class SdkFilterInputStream
EofSensorInputStream
public org.apache.http.client.methods.HttpRequestBase getHttpRequest()
public int available() throws IOException
This is necessary to work around a known bug in GZIPInputStream.available(), which returns zero in some edge cases, causing file truncation.
Ref: http://bugs.java.com/bugdatabase/view_bug.do?bug_id=7036144
available
in class SdkFilterInputStream
IOException
public void close() throws IOException
abort()
if there is any data
remaining in the stream. Otherwise, it safely closes the stream.close
in interface Closeable
close
in interface AutoCloseable
close
in class SdkFilterInputStream
IOException
abort()
,
S3AbortableInputStream
Copyright © 2018. All rights reserved.