com.qcloud.cos.internal

类 SkipMd5CheckStrategy

java.lang.Object

com.qcloud.cos.internal.SkipMd5CheckStrategy

public class SkipMd5CheckStrategy
extends Object

Logic for determining whether MD5 checksum validation should be performed or not.

字段概要

字段

限定符和类型	字段和说明
static String	DISABLE_GET_OBJECT_MD5_VALIDATION_PROPERTY System property to disable MD5 validation for GetObject.
static String	DISABLE_PUT_OBJECT_MD5_VALIDATION_PROPERTY System property to disable MD5 validation for both PutObject and UploadPart.
static SkipMd5CheckStrategy	INSTANCE

方法概要

方法

限定符和类型	方法和说明
boolean	skipClientSideValidation(GetObjectRequest request, ObjectMetadata returnedMetadata) Conveience method to determine whether to do client side validation of a GetObject call based on both the request and the response.
boolean	skipClientSideValidationPerGetResponse(ObjectMetadata metadata) Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side based on the server response.
boolean	skipClientSideValidationPerPutResponse(ObjectMetadata metadata) Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side based on the server response.
boolean	skipClientSideValidationPerRequest(GetObjectRequest request) Based on the given GetObjectRequest, returns whether the specified request should skip MD5 check on the requested object content.
boolean	skipClientSideValidationPerRequest(PutObjectRequest request) Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side.
boolean	skipClientSideValidationPerRequest(UploadPartRequest request) Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side.
boolean	skipClientSideValidationPerUploadPartResponse(ObjectMetadata metadata) Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side based on the server response.
boolean	skipServerSideValidation(PutObjectRequest request) Determines whether the client should calculate and send the Headers#CONTENT_MD5 header to be validated by COS per the request.

从类继承的方法 java.lang.Object

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

字段详细资料

DISABLE_GET_OBJECT_MD5_VALIDATION_PROPERTY

public static final String DISABLE_GET_OBJECT_MD5_VALIDATION_PROPERTY

System property to disable MD5 validation for GetObject. Any value set for this property will disable validation.

另请参阅:

常量字段值

DISABLE_PUT_OBJECT_MD5_VALIDATION_PROPERTY

public static final String DISABLE_PUT_OBJECT_MD5_VALIDATION_PROPERTY

System property to disable MD5 validation for both PutObject and UploadPart. Any value set for this property will disable validation.

另请参阅:

常量字段值

INSTANCE

public static final SkipMd5CheckStrategy INSTANCE

方法详细资料

skipClientSideValidationPerGetResponse

public boolean skipClientSideValidationPerGetResponse(ObjectMetadata metadata)

Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side based on the server response. We skip the client side check if any of the following conditions are true:

1. The system property "com.Qcloud.services.cos.disableGetObjectMD5Validation" is set
2. The request involves SSE-C or SSE-KMS
3. The Etag header is missing
4. The Etag indicates that the object was created by a MultiPart Upload

返回:

True if client side validation should be skipped, false otherwise.

skipClientSideValidationPerPutResponse

public boolean skipClientSideValidationPerPutResponse(ObjectMetadata metadata)

Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side based on the server response. We skip the client side check if any of the following conditions are true:

1. The system property "com.Qcloud.services.cos.disablePutObjectMD5Validation" is set
2. The request involves SSE-C or SSE-KMS
3. The Etag header is missing

返回:

True if client side validation should be skipped, false otherwise.

skipClientSideValidationPerUploadPartResponse

public boolean skipClientSideValidationPerUploadPartResponse(ObjectMetadata metadata)

Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side based on the server response. We skip the client side check if any of the following conditions are true:

1. The system property "com.Qcloud.services.cos.disablePutObjectMD5Validation" is set
2. The request involves SSE-C or SSE-KMS
3. The Etag header is missing

返回:

True if client side validation should be skipped, false otherwise.

skipClientSideValidation

public boolean skipClientSideValidation(GetObjectRequest request,
                               ObjectMetadata returnedMetadata)

Conveience method to determine whether to do client side validation of a GetObject call based on both the request and the response. See skipClientSideValidationPerRequest(GetObjectRequest) and skipClientSideValidationPerGetResponse(ObjectMetadata) for more details on the criterion.

参数:

request - Original GetObjectRequest

returnedMetadata - Metadata returned in COSObject

返回:

True if client side validation should be skipped, false otherwise.

skipClientSideValidationPerRequest

public boolean skipClientSideValidationPerRequest(PutObjectRequest request)

Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side. We skip the client side check if any of the following conditions are true:

1. The system property "com.Qcloud.services.cos.disablePutObjectMD5Validation" is set
2. The request involves SSE-C or SSE-KMS

返回:

True if client side validation should be skipped, false otherwise.

skipClientSideValidationPerRequest

public boolean skipClientSideValidationPerRequest(UploadPartRequest request)

Determines whether the client should use the Headers#ETAG header returned by COS to validate the integrity of the message client side. We skip the client side check if any of the following conditions are true:

1. The system property "com.Qcloud.services.cos.disablePutObjectMD5Validation" is set
2. The request involves SSE-C or SSE-KMS

返回:

True if client side validation should be skipped, false otherwise.

skipServerSideValidation

public boolean skipServerSideValidation(PutObjectRequest request)

Determines whether the client should calculate and send the Headers#CONTENT_MD5 header to be validated by COS per the request.

Currently we always try and do server side validation unless it's been explicitly disabled by the "com.Qcloud.services.cos.disablePutObjectMD5Validation" property. Whether or not we actually calculate the MD5 header is determined in the client based on the source of the data (i.e. if it's a file we calculate, if not then we don't)

skipClientSideValidationPerRequest

public boolean skipClientSideValidationPerRequest(GetObjectRequest request)

Based on the given GetObjectRequest, returns whether the specified request should skip MD5 check on the requested object content. Specifically, MD5 check should be skipped if one of the following conditions are true:

1. The system property "com.Qcloud.services.cos.disableGetObjectMD5Validation" is set.
2. The request is a range-get operation
3. The request is a GET object operation that involves SSE-C

Otherwise, MD5 check should not be skipped.