Package software.amazon.awssdk.services.s3.internal.handlers

Class S3ExpressChecksumInterceptor

java.lang.Object

software.amazon.awssdk.services.s3.internal.handlers.S3ExpressChecksumInterceptor

All Implemented Interfaces:

ExecutionInterceptor

public final class S3ExpressChecksumInterceptor
extends Object
implements ExecutionInterceptor

S3Express has different checksum requirements compared to standard S3 calls. This interceptor modifies checksums only for S3Express calls.

Checksums can be configured through model traits on operations as follows

1. httpChecksumRequired - older setting used in S3Control -> not allowed
2. httpChecksum is set and required -> always add CRC32 checksum even if algorithm is not specified.
3. httpChecksum is set but not required -> if algorithm is not specified, behavior differs

Note that, if httpChecksum is not present, no checksum may be calculated. PutBucketPolicy, DeleteObjects are examples of operations that require checksums. PutObject, UploadPart are examples of operations that do not require checksums.

Special cases

• PutObject -> always calculate CRC32
• UploadPart -> do not calculate CRC32 if algorithm is missing, unless TM is used

Constructor Summary

Constructors

Constructor	Description
S3ExpressChecksumInterceptor()

Method Summary

Modifier and Type	Method	Description
SdkHttpRequest	modifyHttpRequest(Context.ModifyHttpRequest context, ExecutionAttributes executionAttributes)
SdkRequest	modifyRequest(Context.ModifyRequest context, ExecutionAttributes executionAttributes)

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awssdk.core.interceptor.ExecutionInterceptor

afterExecution, afterMarshalling, afterTransmission, afterUnmarshalling, beforeExecution, beforeMarshalling, beforeTransmission, beforeUnmarshalling, modifyAsyncHttpContent, modifyAsyncHttpResponseContent, modifyException, modifyHttpContent, modifyHttpResponse, modifyHttpResponseContent, modifyResponse, onExecutionFailure

Constructor Detail

S3ExpressChecksumInterceptor

public S3ExpressChecksumInterceptor()

Method Detail

modifyRequest

public SdkRequest modifyRequest(Context.ModifyRequest context,
                                ExecutionAttributes executionAttributes)

Specified by:

modifyRequest in interface ExecutionInterceptor

modifyHttpRequest

public SdkHttpRequest modifyHttpRequest(Context.ModifyHttpRequest context,
                                        ExecutionAttributes executionAttributes)

Specified by:

modifyHttpRequest in interface ExecutionInterceptor