com.amazonaws.services.s3

Class S3ClientOptions

java.lang.Object

com.amazonaws.services.s3.S3ClientOptions

public class S3ClientOptions
extends java.lang.Object

S3 client configuration options such as the request access style.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	S3ClientOptions.Builder Builder class for S3ClientOptions.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_ACCELERATE_MODE_ENABLED S3 accelerate is by default not enabled
static boolean	DEFAULT_CHUNKED_ENCODING_DISABLED The default setting for use of chunked encoding
static boolean	DEFAULT_DUALSTACK_ENABLED S3 dualstack endpoint is by default not enabled
static boolean	DEFAULT_PATH_STYLE_ACCESS The default setting for use of path-style access
static boolean	DEFAULT_PAYLOAD_SIGNING_ENABLED The default setting for use of payload signing
static boolean	DEFAULT_SKIP_CONTENT_MD5_CHECK The default setting for skipping content MD5 check

Constructor Summary

Constructors

Constructor and Description
S3ClientOptions() Deprecated. Use builder() to build new S3ClientOptions instead.
S3ClientOptions(S3ClientOptions other) Deprecated. Will be removed once S3ClientOptions is made an immutable class.

Method Summary

Modifier and Type	Method and Description
static S3ClientOptions.Builder	builder()
boolean	isAccelerateModeEnabled() Returns whether the client has enabled accelerate mode for getting and putting objects.
boolean	isChunkedEncodingDisabled() Returns whether the client has chunked encoding disabled for all requests.
boolean	isContentMd5CheckSkipped() Returns whether the client skips content MD5 check for all requests and responses.
boolean	isDualstackEnabled() Returns whether the client is configured to use dualstack mode for accessing S3.
boolean	isPathStyleAccess() Returns whether the client uses path-style access for all requests.
boolean	isPayloadSigningEnabled() Returns whether the client is configured to sign payloads in all situations.
void	setPathStyleAccess(boolean pathStyleAccess) Deprecated.
void	skipContentMd5Check(boolean skipContentMd5Check) Returns whether the client skips content MD5 check for all requests and responses.
S3ClientOptions	withPathStyleAccess(boolean pathStyleAccess) Deprecated.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SKIP_CONTENT_MD5_CHECK

public static final boolean DEFAULT_SKIP_CONTENT_MD5_CHECK

The default setting for skipping content MD5 check

See Also:

Constant Field Values

DEFAULT_PATH_STYLE_ACCESS

public static final boolean DEFAULT_PATH_STYLE_ACCESS

The default setting for use of path-style access

See Also:

Constant Field Values

DEFAULT_CHUNKED_ENCODING_DISABLED

public static final boolean DEFAULT_CHUNKED_ENCODING_DISABLED

The default setting for use of chunked encoding

See Also:

Constant Field Values

DEFAULT_PAYLOAD_SIGNING_ENABLED

public static final boolean DEFAULT_PAYLOAD_SIGNING_ENABLED

The default setting for use of payload signing

See Also:

Constant Field Values

DEFAULT_ACCELERATE_MODE_ENABLED

public static final boolean DEFAULT_ACCELERATE_MODE_ENABLED

S3 accelerate is by default not enabled

See Also:

Constant Field Values

DEFAULT_DUALSTACK_ENABLED

public static final boolean DEFAULT_DUALSTACK_ENABLED

S3 dualstack endpoint is by default not enabled

See Also:

Constant Field Values

Constructor Detail

S3ClientOptions

@Deprecated
public S3ClientOptions()

Deprecated. Use builder() to build new S3ClientOptions instead.

S3ClientOptions

@Deprecated
public S3ClientOptions(S3ClientOptions other)

Deprecated. Will be removed once S3ClientOptions is made an immutable class.

Parameters:

other - S3ClientOptions instance.

Method Detail

builder

public static S3ClientOptions.Builder builder()

Returns:

a new S3ClientOptions builder.

isContentMd5CheckSkipped

public boolean isContentMd5CheckSkipped()

Returns whether the client skips content MD5 check for all requests and responses.

Setting this flag will allow the client to disregard data transfer integrity check by bypassing content MD5 check for all requests and responses.

Returns:

True if the client should always skip content MD5 check

isPathStyleAccess

public boolean isPathStyleAccess()

Returns whether the client uses path-style access for all requests.

Amazon S3 supports virtual-hosted-style and path-style access in all Regions. The path-style syntax, however, requires that you use the region-specific endpoint when attempting to access a bucket.

The default behaviour is to detect which access style to use based on the configured endpoint (an IP will result in path-style access) and the bucket being accessed (some buckets are not valid DNS names). Setting this flag will result in path-style access being used for all requests.

Returns:

True if the client should always use path-style access

isChunkedEncodingDisabled

public boolean isChunkedEncodingDisabled()

Returns whether the client has chunked encoding disabled for all requests.

The default behavior is to enable chunked encoding automatically for PutObjectRequest and UploadPartRequest. Setting this flag will result in disabling chunked encoding for all requests.

Note: Enabling this option has performance implications since the checksum for the payload will have to be pre-calculated before sending the data. If your payload is large this will affect the overall time required to upload an object. Using this option is recommended only if your endpoint does not implement chunked uploading.

Returns:

True if chunked encoding is explicitly disabled for all requests

isAccelerateModeEnabled

public boolean isAccelerateModeEnabled()

Returns whether the client has enabled accelerate mode for getting and putting objects.

The default behavior is to disable accelerate mode for any operations (GET, PUT, DELETE). You need to call AmazonS3Client.setBucketAccelerateConfiguration(com.amazonaws.services.s3.model.SetBucketAccelerateConfigurationRequest) first to use this feature.

Returns:

True if accelerate mode is enabled.

isPayloadSigningEnabled

public boolean isPayloadSigningEnabled()

Returns whether the client is configured to sign payloads in all situations.

Payload signing is optional when chunked encoding is not used and requests are made against an HTTPS endpoint. Under these conditions the client will by default opt to not sign payloads to optimize performance. If this flag is set to true the client will instead always sign payloads.

Note: Payload signing can be expensive, particularly if transferring large payloads in a single chunk. Enabling this option will result in a performance penalty.

Returns:

True if body signing is explicitly enabled for all requests

skipContentMd5Check

public void skipContentMd5Check(boolean skipContentMd5Check)

Returns whether the client skips content MD5 check for all requests and responses.

Setting this flag will allow the client to disregard data transfer integrity check by bypassing content MD5 check for all requests and responses.

Parameters:

skipContentMd5Check - True to always skip content MD5 check

setPathStyleAccess

@Deprecated
public void setPathStyleAccess(boolean pathStyleAccess)

Deprecated.

Configures the client to use path-style access for all requests.

Amazon S3 supports virtual-hosted-style and path-style access in all Regions. The path-style syntax, however, requires that you use the region-specific endpoint when attempting to access a bucket.

The default behaviour is to detect which access style to use based on the configured endpoint (an IP will result in path-style access) and the bucket being accessed (some buckets are not valid DNS names). Setting this flag will result in path-style access being used for all requests.

Parameters:

pathStyleAccess - True to always use path-style access.

isDualstackEnabled

public boolean isDualstackEnabled()

Returns whether the client is configured to use dualstack mode for accessing S3.

Returns:

True if the client will use the dualstack mode

withPathStyleAccess

@Deprecated
public S3ClientOptions withPathStyleAccess(boolean pathStyleAccess)

Deprecated.

Configures the client to use path-style access for all requests.

Amazon S3 supports virtual-hosted-style and path-style access in all Regions. The path-style syntax, however, requires that you use the region-specific endpoint when attempting to access a bucket.

The default behaviour is to detect which access style to use based on the configured endpoint (an IP will result in path-style access) and the bucket being accessed (some buckets are not valid DNS names). Setting this flag will result in path-style access being used for all requests.

Parameters:

pathStyleAccess - True to always use path-style access.

Returns:

The updated S3ClientOptions object with the new path-style access setting.