com.qcloud.cos.internal

Class AbstractCosResponseHandler<T>

java.lang.Object

com.qcloud.cos.internal.AbstractCosResponseHandler<T>

All Implemented Interfaces:

HttpResponseHandler<CosServiceResponse<T>>

Direct Known Subclasses:

CIGetSnapshotResponseHandler, CosMetadataResponseHandler, COSObjectResponseHandler, COSStringResponseHandler, COSXmlResponseHandler, GetAsyncFetchTaskResultHandler, GetSymlinkResultHandler, HeadBucketResultHandler, PutAsyncFetchTaskResultHandler, PutSymlinkResultHandler, VoidCosResponseHandler

public abstract class AbstractCosResponseHandler<T>
extends Object
implements HttpResponseHandler<CosServiceResponse<T>>

Constructor Summary

Constructors

Constructor and Description
AbstractCosResponseHandler()

Method Summary

Modifier and Type	Method and Description
boolean	needsConnectionLeftOpen() The majority of COS response handlers read the complete response while handling it, and don't need to manually manage the underlying HTTP connection.
protected CosServiceResponse<T>	parseResponseMetadata(CosHttpResponse response) Parses the COS response metadata (ex: COS request ID) from the specified response, and returns a CosServiceResponse object ready for the result to be plugged in.
protected void	populateObjectMetadata(CosHttpResponse response, ObjectMetadata metadata) Populates the specified COSObjectMetadata object with all object metadata pulled from the headers in the specified response.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.qcloud.cos.http.HttpResponseHandler

handle

Constructor Detail

AbstractCosResponseHandler

public AbstractCosResponseHandler()

Method Detail

needsConnectionLeftOpen

public boolean needsConnectionLeftOpen()

The majority of COS response handlers read the complete response while handling it, and don't need to manually manage the underlying HTTP connection.

Specified by:

needsConnectionLeftOpen in interface HttpResponseHandler<CosServiceResponse<T>>

Returns:

True if this response handler requires that the underlying HTTP connection be left open, and not automatically closed, otherwise false.

parseResponseMetadata

protected CosServiceResponse<T> parseResponseMetadata(CosHttpResponse response)

Parses the COS response metadata (ex: COS request ID) from the specified response, and returns a CosServiceResponse object ready for the result to be plugged in.

Parameters:

response - The response containing the response metadata to pull out.

Returns:

A new, populated CosServiceResponse object, ready for the result to be plugged in.

populateObjectMetadata

protected void populateObjectMetadata(CosHttpResponse response,
                                      ObjectMetadata metadata)

Populates the specified COSObjectMetadata object with all object metadata pulled from the headers in the specified response.

Parameters:

response - The HTTP response containing the object metadata within the headers.

metadata - The metadata object to populate from the response's headers.