public class SkipMd5CheckStrategy
extends Object 

• Field Summary

  Fields

  Modifier and Type	Field and Description
  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

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  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	skipClientSideValidation (PresignedUrlDownloadRequest request, ObjectMetadata returnedMetadata) Conveience method to determine whether to do client side validation of a PresignedUrlDownloadRequest 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 S3 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 S3 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 (PresignedUrlDownloadRequest request) Based on the given PresignedUrlDownloadRequest, returns whether the specified request should skip MD5 check on the requested object content.
  boolean	skipClientSideValidationPerRequest (PresignedUrlUploadRequest request) Determines whether the client should use the Headers.ETAG header returned by S3 to validate the integrity of the message client side.
  boolean	skipClientSideValidationPerRequest (PutObjectRequest request) Determines whether the client should use the Headers.ETAG header returned by S3 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 S3 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 S3 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 S3 per the request.
  boolean	skipServerSideValidation (UploadPartRequest request) Determines whether the client should calculate and send the Headers.CONTENT_MD5 header to be validated by S3 per the request.

  • Methods inherited from class java.lang.Object

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

• Field Detail

  • 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.

    See Also:

    Constant Field Values

  • 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.

    See Also:

    Constant Field Values

  • INSTANCE

    public static final SkipMd5CheckStrategy INSTANCE

• Method Detail

  • skipClientSideValidationPerGetResponse

    public boolean skipClientSideValidationPerGetResponse(ObjectMetadata metadata)

    Determines whether the client should use the Headers.ETAG header returned by S3 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.amazonaws.services.s3.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

    Returns:

    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 S3 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.amazonaws.services.s3.disablePutObjectMD5Validation" is set
    2. The request involves SSE-C or SSE-KMS
    3. The Etag header is missing

    Returns:

    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 S3 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.amazonaws.services.s3.disablePutObjectMD5Validation" is set
    2. The request involves SSE-C or SSE-KMS
    3. The Etag header is missing

    Returns:

    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.

    Parameters:

    request - Original GetObjectRequest

    returnedMetadata - Metadata returned in S3Object

    Returns:

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

  • skipClientSideValidation

    public boolean skipClientSideValidation(PresignedUrlDownloadRequest request,
     ObjectMetadata returnedMetadata)

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

    Parameters:

    request - Original PresignedUrlDownloadRequest

    returnedMetadata - Metadata returned in S3Object

    Returns:

    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 S3 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.amazonaws.services.s3.disablePutObjectMD5Validation" is set
    2. The request involves SSE-C or SSE-KMS

    Returns:

    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 S3 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.amazonaws.services.s3.disablePutObjectMD5Validation" is set
    2. The request involves SSE-C or SSE-KMS

    Returns:

    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 S3 per the request.

    Currently we always try and do server side validation unless it's been explicitly disabled by the "com.amazonaws.services.s3.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)

  • skipServerSideValidation

    public boolean skipServerSideValidation(UploadPartRequest request)

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

    Currently we always try and do server side validation unless it's been explicitly disabled by the "com.amazonaws.services.s3.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.amazonaws.services.s3.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.

  • skipClientSideValidationPerRequest

    public boolean skipClientSideValidationPerRequest(PresignedUrlDownloadRequest request)

    Based on the given PresignedUrlDownloadRequest, 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.amazonaws.services.s3.disableGetObjectMD5Validation" is set.
    2. The request is a range-get operation

    Otherwise, MD5 check should not be skipped.

  • skipClientSideValidationPerRequest

    public boolean skipClientSideValidationPerRequest(PresignedUrlUploadRequest request)

    Determines whether the client should use the Headers.ETAG header returned by S3 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.amazonaws.services.s3.disablePutObjectMD5Validation" is set
    2. The request involves SSE-C or SSE-KMS

    Returns:

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