com.amazon.sqs.javamessaging

Class ExtendedClientConfiguration

java.lang.Object

software.amazon.payloadoffloading.PayloadStorageConfiguration

com.amazon.sqs.javamessaging.ExtendedClientConfiguration

@NotThreadSafe
public class ExtendedClientConfiguration
extends software.amazon.payloadoffloading.PayloadStorageConfiguration

Amazon SQS extended client configuration options such as Amazon S3 client, bucket name, and message size threshold for large-payload messages.

Constructor Summary

Constructors

Constructor and Description
ExtendedClientConfiguration()
ExtendedClientConfiguration(ExtendedClientConfiguration other)

Method Summary

Modifier and Type	Method and Description
boolean	doesCleanupS3Payload() Checks whether or not clean up large objects in S3 is enabled.
int	getMessageSizeThreshold() Deprecated. Instead use PayloadStorageConfiguration.getPayloadSizeThreshold()
boolean	isLargePayloadSupportEnabled() Deprecated. Instead use PayloadStorageConfiguration.isPayloadSupportEnabled()
void	setLargePayloadSupportDisabled() Deprecated. Instead use PayloadStorageConfiguration.setPayloadSupportDisabled()
void	setLargePayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3, String s3BucketName) Deprecated. Instead use setPayloadSupportEnabled(AmazonS3, String, boolean)
void	setLegacyReservedAttributeNameDisabled() Disables the utilization legacy payload attribute name when sending messages.
void	setMessageSizeThreshold(int messageSizeThreshold) Deprecated. Instead use PayloadStorageConfiguration.setPayloadSizeThreshold(int)
void	setPayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3, String s3BucketName, boolean cleanupS3Payload) Enables support for payload messages.
boolean	usesLegacyReservedAttributeName() Checks whether or not the configuration uses the legacy reserved attribute name.
ExtendedClientConfiguration	withAlwaysThroughS3(boolean alwaysThroughS3)
ExtendedClientConfiguration	withCannedAccessControlList(com.amazonaws.services.s3.model.CannedAccessControlList cannedAccessControlList)
ExtendedClientConfiguration	withLargePayloadSupportDisabled() Deprecated. Instead use withPayloadSupportDisabled()
ExtendedClientConfiguration	withLargePayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3, String s3BucketName) Deprecated. Instead use withPayloadSupportEnabled(AmazonS3, String)
ExtendedClientConfiguration	withLegacyReservedAttributeNameDisabled() Disables the utilization legacy payload attribute name when sending messages.
ExtendedClientConfiguration	withMessageSizeThreshold(int messageSizeThreshold) Deprecated. Instead use withPayloadSizeThreshold(int)
ExtendedClientConfiguration	withPayloadSizeThreshold(int payloadSizeThreshold)
ExtendedClientConfiguration	withPayloadSupportDisabled()
ExtendedClientConfiguration	withPayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3, String s3BucketName)
ExtendedClientConfiguration	withPayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3, String s3BucketName, boolean cleanupS3Payload) Enables support for payload messages.
ExtendedClientConfiguration	withSSEAwsKeyManagementParams(com.amazonaws.services.s3.model.SSEAwsKeyManagementParams sseAwsKeyManagementParams)

Methods inherited from class software.amazon.payloadoffloading.PayloadStorageConfiguration

getAmazonS3Client, getCannedAccessControlList, getPayloadSizeThreshold, getS3BucketName, getSSEAwsKeyManagementParams, isAlwaysThroughS3, isCannedAccessControlListDefined, isPayloadSupportEnabled, setAlwaysThroughS3, setCannedAccessControlList, setPayloadSizeThreshold, setPayloadSupportDisabled, setPayloadSupportEnabled, setSSEAwsKeyManagementParams

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtendedClientConfiguration

public ExtendedClientConfiguration()

ExtendedClientConfiguration

public ExtendedClientConfiguration(ExtendedClientConfiguration other)

Method Detail

setPayloadSupportEnabled

public void setPayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3,
                                     String s3BucketName,
                                     boolean cleanupS3Payload)

Enables support for payload messages.

Parameters:

s3 - Amazon S3 client which is going to be used for storing payload messages.

s3BucketName - Name of the bucket which is going to be used for storing payload messages. The bucket must be already created and configured in s3.

cleanupS3Payload - If set to true, would handle deleting the S3 object as part of deleting the message from SQS queue. Otherwise, would not attempt to delete the object from S3. If opted to not delete S3 objects its the responsibility to the message producer to handle the clean up appropriately.

withPayloadSupportEnabled

public ExtendedClientConfiguration withPayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3,
                                                             String s3BucketName,
                                                             boolean cleanupS3Payload)

Enables support for payload messages.

Parameters:

s3 - Amazon S3 client which is going to be used for storing payload messages.

s3BucketName - Name of the bucket which is going to be used for storing payload messages. The bucket must be already created and configured in s3.

cleanupS3Payload - If set to true, would handle deleting the S3 object as part of deleting the message from SQS queue. Otherwise, would not attempt to delete the object from S3. If opted to not delete S3 objects its the responsibility to the message producer to handle the clean up appropriately.

setLegacyReservedAttributeNameDisabled

public void setLegacyReservedAttributeNameDisabled()

Disables the utilization legacy payload attribute name when sending messages.

withLegacyReservedAttributeNameDisabled

public ExtendedClientConfiguration withLegacyReservedAttributeNameDisabled()

Disables the utilization legacy payload attribute name when sending messages.

doesCleanupS3Payload

public boolean doesCleanupS3Payload()

Checks whether or not clean up large objects in S3 is enabled.

Returns:

True if clean up is enabled when deleting the concerning SQS message. Default: true

usesLegacyReservedAttributeName

public boolean usesLegacyReservedAttributeName()

Checks whether or not the configuration uses the legacy reserved attribute name.

Returns:

True if legacy reserved attribute name is used. Default: true

withAlwaysThroughS3

public ExtendedClientConfiguration withAlwaysThroughS3(boolean alwaysThroughS3)

Overrides:

withAlwaysThroughS3 in class software.amazon.payloadoffloading.PayloadStorageConfiguration

withPayloadSupportEnabled

public ExtendedClientConfiguration withPayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3,
                                                             String s3BucketName)

Overrides:

withPayloadSupportEnabled in class software.amazon.payloadoffloading.PayloadStorageConfiguration

withSSEAwsKeyManagementParams

public ExtendedClientConfiguration withSSEAwsKeyManagementParams(com.amazonaws.services.s3.model.SSEAwsKeyManagementParams sseAwsKeyManagementParams)

Overrides:

withSSEAwsKeyManagementParams in class software.amazon.payloadoffloading.PayloadStorageConfiguration

withPayloadSizeThreshold

public ExtendedClientConfiguration withPayloadSizeThreshold(int payloadSizeThreshold)

Overrides:

withPayloadSizeThreshold in class software.amazon.payloadoffloading.PayloadStorageConfiguration

withPayloadSupportDisabled

public ExtendedClientConfiguration withPayloadSupportDisabled()

Overrides:

withPayloadSupportDisabled in class software.amazon.payloadoffloading.PayloadStorageConfiguration

withCannedAccessControlList

public ExtendedClientConfiguration withCannedAccessControlList(com.amazonaws.services.s3.model.CannedAccessControlList cannedAccessControlList)

Overrides:

withCannedAccessControlList in class software.amazon.payloadoffloading.PayloadStorageConfiguration

setLargePayloadSupportEnabled

@Deprecated
public void setLargePayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3,
                                                      String s3BucketName)

Deprecated. Instead use setPayloadSupportEnabled(AmazonS3, String, boolean)

Enables support for large-payload messages.

Parameters:

s3 - Amazon S3 client which is going to be used for storing large-payload messages.

s3BucketName - Name of the bucket which is going to be used for storing large-payload messages. The bucket must be already created and configured in s3.

withLargePayloadSupportEnabled

@Deprecated
public ExtendedClientConfiguration withLargePayloadSupportEnabled(com.amazonaws.services.s3.AmazonS3 s3,
                                                                              String s3BucketName)

Deprecated. Instead use withPayloadSupportEnabled(AmazonS3, String)

Enables support for large-payload messages.

Parameters:

s3 - Amazon S3 client which is going to be used for storing large-payload messages.

s3BucketName - Name of the bucket which is going to be used for storing large-payload messages. The bucket must be already created and configured in s3.

Returns:

the updated ExtendedClientConfiguration object.

setLargePayloadSupportDisabled

@Deprecated
public void setLargePayloadSupportDisabled()

Deprecated. Instead use PayloadStorageConfiguration.setPayloadSupportDisabled()

Disables support for large-payload messages.

withLargePayloadSupportDisabled

@Deprecated
public ExtendedClientConfiguration withLargePayloadSupportDisabled()

Deprecated. Instead use withPayloadSupportDisabled()

Disables support for large-payload messages.

Returns:

the updated ExtendedClientConfiguration object.

isLargePayloadSupportEnabled

@Deprecated
public boolean isLargePayloadSupportEnabled()

Deprecated. Instead use PayloadStorageConfiguration.isPayloadSupportEnabled()

Check if the support for large-payload message if enabled.

Returns:

true if support for large-payload messages is enabled.

setMessageSizeThreshold

@Deprecated
public void setMessageSizeThreshold(int messageSizeThreshold)

Deprecated. Instead use PayloadStorageConfiguration.setPayloadSizeThreshold(int)

Sets the message size threshold for storing message payloads in Amazon S3.

Parameters:

messageSizeThreshold - Message size threshold to be used for storing in Amazon S3. Default: 256KB.

withMessageSizeThreshold

@Deprecated
public ExtendedClientConfiguration withMessageSizeThreshold(int messageSizeThreshold)

Deprecated. Instead use withPayloadSizeThreshold(int)

Sets the message size threshold for storing message payloads in Amazon S3.

Parameters:

messageSizeThreshold - Message size threshold to be used for storing in Amazon S3. Default: 256KB.

Returns:

the updated ExtendedClientConfiguration object.

getMessageSizeThreshold

@Deprecated
public int getMessageSizeThreshold()

Deprecated. Instead use PayloadStorageConfiguration.getPayloadSizeThreshold()

Gets the message size threshold for storing message payloads in Amazon S3.

Returns:

Message size threshold which is being used for storing in Amazon S3. Default: 256KB.