This is an automated email from the ASF dual-hosted git repository. davsclaus pushed a commit to branch CAMEL-25737-sqs-visibility-extender in repository https://gitbox.apache.org/repos/asf/camel.git
commit 877987b2dc643bf6f661fb39edbeee8ea4dd14c8 Author: Claus Ibsen <[email protected]> AuthorDate: Sun Nov 22 19:54:07 2026 +0100 CAMEL-25737: camel-aws2-sqs - extendMessageVisibility requires a visibilityTimeout of at least 2 seconds The visibility timeout extender runs every max(1, visibilityTimeout / 2) whole seconds and extends a message once 80% of its visibility timeout has passed. With visibilityTimeout=1 each extension came when the message was already visible again, so another consumer received it while it was processed; with 0 or a negative value the extender was silently not created. The endpoint now fails to be created when extendMessageVisibility is enabled with a visibilityTimeout below 2 seconds, and the consumer logs a warning when it is below 10 seconds, as the extension then has only 1 to 2 seconds left. Co-Authored-By: Claude Opus 5.5 <[email protected]> Signed-off-by: Claus Ibsen <[email protected]> --- .../apache/camel/catalog/components/aws2-sqs.json | 8 +++---- .../camel/catalog/docs/aws2-sqs-component.adoc | 6 +++++ .../apache/camel/component/aws2/sqs/aws2-sqs.json | 8 +++---- .../src/main/docs/aws2-sqs-component.adoc | 6 +++++ .../camel/component/aws2/sqs/Sqs2Component.java | 6 +++++ .../component/aws2/sqs/Sqs2Configuration.java | 8 ++++--- .../camel/component/aws2/sqs/Sqs2Consumer.java | 7 ++++++ .../aws2/sqs/SqsComponentConfigurationTest.java | 26 ++++++++++++++++++++++ .../aws2/sqs/dst/SqsVisibilityDstTest.java | 2 +- .../camel/component/aws2/sqs/dst/SqsWorld.java | 3 +-- .../ROOT/pages/camel-4x-upgrade-guide-4_24.adoc | 12 ++++++++++ .../dsl/Aws2SqsComponentBuilderFactory.java | 10 ++++++--- .../endpoint/dsl/Sqs2EndpointBuilderFactory.java | 20 ++++++++++++----- 13 files changed, 99 insertions(+), 23 deletions(-) diff --git a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json index d104a1f161fc..ca9e9d118b8b 100644 --- a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json +++ b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json @@ -39,13 +39,13 @@ "defaultVisibilityTimeout": { "index": 12, "kind": "property", "displayName": "Default Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The visibility timeout (in seconds) of the queue. When the endpoint starts, [...] "deleteAfterRead": { "index": 13, "kind": "property", "displayName": "Delete After Read", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Delete the message from SQS when the exchange completes successfully" }, "deleteIfFiltered": { "index": 14, "kind": "property", "displayName": "Delete If Filtered", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Whether to send the DeleteMessage to the SQS queue if the exchange has property [...] - "extendMessageVisibility": { "index": 15, "kind": "property", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extending [...] + "extendMessageVisibility": { "index": 15, "kind": "property", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extending [...] "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "property", "displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The length of time, in seconds, for which Amazon SQS can reuse a [...] "kmsMasterKeyId": { "index": 17, "kind": "property", "displayName": "Kms Master Key Id", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK." }, "messageAttributeNames": { "index": 18, "kind": "property", "displayName": "Message Attribute Names", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "A list of message attribute names to receive when consuming. Multiple names can be [...] "serverSideEncryptionEnabled": { "index": 19, "kind": "property", "displayName": "Server Side Encryption Enabled", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Define if Server Side Encryption is enabled or not on t [...] "sortAttributeName": { "index": 20, "kind": "property", "displayName": "Sort Attribute Name", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The name of the message attribute used for sorting the messages. When specified, the messag [...] - "visibilityTimeout": { "index": 21, "kind": "property", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve r [...] + "visibilityTimeout": { "index": 21, "kind": "property", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve r [...] "waitTimeSeconds": { "index": 22, "kind": "property", "displayName": "Wait Time Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Duration in seconds (0 to 20) that the ReceiveMessage action call will wait until a message i [...] "batchSeparator": { "index": 23, "kind": "property", "displayName": "Batch Separator", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "defaultValue": ",", "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Set the separator when passing a String to send batch message operation" }, "delaySeconds": { "index": 24, "kind": "property", "displayName": "Delay Seconds", "group": "producer", "label": "producer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Delay sending messages for a number of seconds." }, @@ -115,7 +115,7 @@ "defaultVisibilityTimeout": { "index": 12, "kind": "parameter", "displayName": "Default Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The visibility timeout (in seconds) of the queue. When the endpoint starts [...] "deleteAfterRead": { "index": 13, "kind": "parameter", "displayName": "Delete After Read", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Delete the message from SQS when the exchange completes successfully" }, "deleteIfFiltered": { "index": 14, "kind": "parameter", "displayName": "Delete If Filtered", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Whether to send the DeleteMessage to the SQS queue if the exchange has propert [...] - "extendMessageVisibility": { "index": 15, "kind": "parameter", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extendin [...] + "extendMessageVisibility": { "index": 15, "kind": "parameter", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extendin [...] "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "parameter", "displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The length of time, in seconds, for which Amazon SQS can reuse [...] "kmsMasterKeyId": { "index": 17, "kind": "parameter", "displayName": "Kms Master Key Id", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK." }, "maxMessagesPerPoll": { "index": 18, "kind": "parameter", "displayName": "Max Messages Per Poll", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "defaultValue": 10, "description": "The maximum number of messages to receive in each poll. A receive request returns at most 10 messages, so a value above 10 is split into several receive requests of at most 10 messages each, and 0 [...] @@ -123,7 +123,7 @@ "sendEmptyMessageWhenIdle": { "index": 20, "kind": "parameter", "displayName": "Send Empty Message When Idle", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "description": "If the polling consumer did not poll any files, you can enable this option to send an empty message (no body) instead." }, "serverSideEncryptionEnabled": { "index": 21, "kind": "parameter", "displayName": "Server Side Encryption Enabled", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Define if Server Side Encryption is enabled or not on [...] "sortAttributeName": { "index": 22, "kind": "parameter", "displayName": "Sort Attribute Name", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The name of the message attribute used for sorting the messages. When specified, the messa [...] - "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve [...] + "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve [...] "waitTimeSeconds": { "index": 24, "kind": "parameter", "displayName": "Wait Time Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Duration in seconds (0 to 20) that the ReceiveMessage action call will wait until a message [...] "bridgeErrorHandler": { "index": 25, "kind": "parameter", "displayName": "Bridge Error Handler", "group": "consumer (advanced)", "label": "consumer,advanced", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "description": "Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while the Camel consumer is trying to pickup incoming [...] "exceptionHandler": { "index": 26, "kind": "parameter", "displayName": "Exception Handler", "group": "consumer (advanced)", "label": "consumer,advanced", "required": false, "type": "object", "javaType": "org.apache.camel.spi.ExceptionHandler", "optionalPrefix": "consumer.", "deprecated": false, "autowired": false, "secret": false, "description": "To let the consumer use a custom ExceptionHandler. Notice if the option bridgeErrorHandler is enabled then this option is not in use. By de [...] diff --git a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc index cd3fc132b2e0..bebae6dcb613 100644 --- a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc +++ b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc @@ -72,6 +72,12 @@ the route is slow, the last messages of a poll can become visible again before t them a second time. Enable `extendMessageVisibility` together with `visibilityTimeout`, which keeps every message of the poll invisible until it is processed, or use a visibility timeout that covers the processing of a whole poll. +With `extendMessageVisibility`, the visibility of a message is extended when 80% of its visibility timeout has passed, +by a task that runs every half of the visibility timeout, in whole seconds. A `visibilityTimeout` below 2 seconds is +rejected when the endpoint is created, as the extension would always come too late, and a value below 10 seconds is +logged as a warning when the consumer starts, as it leaves only 1 to 2 seconds for the extension. Use a +`visibilityTimeout` of 10 seconds or more. + With a FIFO queue, a poll can receive several messages of the same message group. A message that fails is not deleted, but the next messages of its group in the same poll are still routed and deleted, so the failed message is delivered again after them. Set `maxMessagesPerPoll=1` if the messages of a group must keep their order when one of them fails. diff --git a/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json b/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json index d104a1f161fc..ca9e9d118b8b 100644 --- a/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json +++ b/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json @@ -39,13 +39,13 @@ "defaultVisibilityTimeout": { "index": 12, "kind": "property", "displayName": "Default Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The visibility timeout (in seconds) of the queue. When the endpoint starts, [...] "deleteAfterRead": { "index": 13, "kind": "property", "displayName": "Delete After Read", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Delete the message from SQS when the exchange completes successfully" }, "deleteIfFiltered": { "index": 14, "kind": "property", "displayName": "Delete If Filtered", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Whether to send the DeleteMessage to the SQS queue if the exchange has property [...] - "extendMessageVisibility": { "index": 15, "kind": "property", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extending [...] + "extendMessageVisibility": { "index": 15, "kind": "property", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extending [...] "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "property", "displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The length of time, in seconds, for which Amazon SQS can reuse a [...] "kmsMasterKeyId": { "index": 17, "kind": "property", "displayName": "Kms Master Key Id", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK." }, "messageAttributeNames": { "index": 18, "kind": "property", "displayName": "Message Attribute Names", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "A list of message attribute names to receive when consuming. Multiple names can be [...] "serverSideEncryptionEnabled": { "index": 19, "kind": "property", "displayName": "Server Side Encryption Enabled", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Define if Server Side Encryption is enabled or not on t [...] "sortAttributeName": { "index": 20, "kind": "property", "displayName": "Sort Attribute Name", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The name of the message attribute used for sorting the messages. When specified, the messag [...] - "visibilityTimeout": { "index": 21, "kind": "property", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve r [...] + "visibilityTimeout": { "index": 21, "kind": "property", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve r [...] "waitTimeSeconds": { "index": 22, "kind": "property", "displayName": "Wait Time Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Duration in seconds (0 to 20) that the ReceiveMessage action call will wait until a message i [...] "batchSeparator": { "index": 23, "kind": "property", "displayName": "Batch Separator", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "defaultValue": ",", "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Set the separator when passing a String to send batch message operation" }, "delaySeconds": { "index": 24, "kind": "property", "displayName": "Delay Seconds", "group": "producer", "label": "producer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Delay sending messages for a number of seconds." }, @@ -115,7 +115,7 @@ "defaultVisibilityTimeout": { "index": 12, "kind": "parameter", "displayName": "Default Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The visibility timeout (in seconds) of the queue. When the endpoint starts [...] "deleteAfterRead": { "index": 13, "kind": "parameter", "displayName": "Delete After Read", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Delete the message from SQS when the exchange completes successfully" }, "deleteIfFiltered": { "index": 14, "kind": "parameter", "displayName": "Delete If Filtered", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": true, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Whether to send the DeleteMessage to the SQS queue if the exchange has propert [...] - "extendMessageVisibility": { "index": 15, "kind": "parameter", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extendin [...] + "extendMessageVisibility": { "index": 15, "kind": "parameter", "displayName": "Extend Message Visibility", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "If enabled, then a scheduled background task will keep extendin [...] "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "parameter", "displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The length of time, in seconds, for which Amazon SQS can reuse [...] "kmsMasterKeyId": { "index": 17, "kind": "parameter", "displayName": "Kms Master Key Id", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK." }, "maxMessagesPerPoll": { "index": 18, "kind": "parameter", "displayName": "Max Messages Per Poll", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "defaultValue": 10, "description": "The maximum number of messages to receive in each poll. A receive request returns at most 10 messages, so a value above 10 is split into several receive requests of at most 10 messages each, and 0 [...] @@ -123,7 +123,7 @@ "sendEmptyMessageWhenIdle": { "index": 20, "kind": "parameter", "displayName": "Send Empty Message When Idle", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "description": "If the polling consumer did not poll any files, you can enable this option to send an empty message (no body) instead." }, "serverSideEncryptionEnabled": { "index": 21, "kind": "parameter", "displayName": "Server Side Encryption Enabled", "group": "consumer", "label": "consumer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Define if Server Side Encryption is enabled or not on [...] "sortAttributeName": { "index": 22, "kind": "parameter", "displayName": "Sort Attribute Name", "group": "consumer", "label": "consumer", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The name of the message attribute used for sorting the messages. When specified, the messa [...] - "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve [...] + "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": "Visibility Timeout", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "The duration (in seconds) that the received messages are hidden from subsequent retrieve [...] "waitTimeSeconds": { "index": 24, "kind": "parameter", "displayName": "Wait Time Seconds", "group": "consumer", "label": "consumer", "required": false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": "configuration", "description": "Duration in seconds (0 to 20) that the ReceiveMessage action call will wait until a message [...] "bridgeErrorHandler": { "index": 25, "kind": "parameter", "displayName": "Bridge Error Handler", "group": "consumer (advanced)", "label": "consumer,advanced", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "description": "Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while the Camel consumer is trying to pickup incoming [...] "exceptionHandler": { "index": 26, "kind": "parameter", "displayName": "Exception Handler", "group": "consumer (advanced)", "label": "consumer,advanced", "required": false, "type": "object", "javaType": "org.apache.camel.spi.ExceptionHandler", "optionalPrefix": "consumer.", "deprecated": false, "autowired": false, "secret": false, "description": "To let the consumer use a custom ExceptionHandler. Notice if the option bridgeErrorHandler is enabled then this option is not in use. By de [...] diff --git a/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc b/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc index cd3fc132b2e0..bebae6dcb613 100644 --- a/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc +++ b/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc @@ -72,6 +72,12 @@ the route is slow, the last messages of a poll can become visible again before t them a second time. Enable `extendMessageVisibility` together with `visibilityTimeout`, which keeps every message of the poll invisible until it is processed, or use a visibility timeout that covers the processing of a whole poll. +With `extendMessageVisibility`, the visibility of a message is extended when 80% of its visibility timeout has passed, +by a task that runs every half of the visibility timeout, in whole seconds. A `visibilityTimeout` below 2 seconds is +rejected when the endpoint is created, as the extension would always come too late, and a value below 10 seconds is +logged as a warning when the consumer starts, as it leaves only 1 to 2 seconds for the extension. Use a +`visibilityTimeout` of 10 seconds or more. + With a FIFO queue, a poll can receive several messages of the same message group. A message that fails is not deleted, but the next messages of its group in the same poll are still routed and deleted, so the failed message is delivered again after them. Set `maxMessagesPerPoll=1` if the messages of a group must keep their order when one of them fails. diff --git a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java index d4bb634052a4..123b8444386e 100644 --- a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java +++ b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java @@ -79,6 +79,12 @@ public class Sqs2Component extends HealthCheckComponent { throw new IllegalArgumentException( "Extending message visibility (extendMessageVisibility) requires visibilityTimeout to be set on the Endpoint."); } + // the extender runs every visibilityTimeout / 2 whole seconds, so with less than 2 seconds it is always late + if (configuration.isExtendMessageVisibility() && configuration.getVisibilityTimeout() < 2) { + throw new IllegalArgumentException( + "Extending message visibility (extendMessageVisibility) requires visibilityTimeout to be at least 2 seconds, was: " + + configuration.getVisibilityTimeout()); + } return sqsEndpoint; } diff --git a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java index 5eb209771067..83f8442a3587 100644 --- a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java +++ b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java @@ -230,7 +230,8 @@ public class Sqs2Configuration implements Cloneable, AwsCommonConfiguration { * The duration (in seconds) that the received messages are hidden from subsequent retrieve requests after being * retrieved by a ReceiveMessage request. It is sent with each ReceiveMessage request and does not change the queue: * use defaultVisibilityTimeout to set the visibility timeout attribute of the queue. extendMessageVisibility - * extends the visibility of a message by this duration. + * extends the visibility of a message by this duration, and requires at least 2 seconds; 10 seconds or more is + * recommended. */ public void setVisibilityTimeout(Integer visibilityTimeout) { this.visibilityTimeout = visibilityTimeout; @@ -343,8 +344,9 @@ public class Sqs2Configuration implements Cloneable, AwsCommonConfiguration { /** * If enabled, then a scheduled background task will keep extending the message visibility on SQS. This is needed if - * it takes a long time to process the message. If set to true visibilityTimeout must be set. See details at Amazon - * docs. + * it takes a long time to process the message. If set to true visibilityTimeout must be set to at least 2 seconds; + * 10 seconds or more is recommended, as the visibility is extended when 80% of the visibility timeout has passed, + * which leaves only 1 to 2 seconds with a shorter timeout. See details at Amazon docs. */ public void setExtendMessageVisibility(boolean extendMessageVisibility) { this.extendMessageVisibility = extendMessageVisibility; diff --git a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java index fdde6c3a05a8..4a5fbfdb3381 100644 --- a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java +++ b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java @@ -405,6 +405,13 @@ public class Sqs2Consumer extends ScheduledBatchPollingConsumer { Integer visibilityTimeout = getConfiguration().getVisibilityTimeout(); if (ObjectHelper.isNotEmpty(visibilityTimeout) && visibilityTimeout > 0) { + if (visibilityTimeout < 10) { + LOG.warn( + "The visibilityTimeout of {} seconds leaves the extendMessageVisibility task only 1 to 2 seconds" + + " to extend the visibility of a message before it becomes visible again." + + " A visibilityTimeout of 10 seconds or more is recommended.", + visibilityTimeout); + } int delay = Math.max(1, visibilityTimeout / 2); this.timeoutExtender = new TimeoutExtender(visibilityTimeout, delay); diff --git a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java index a68426ee7d48..f083e742ba30 100644 --- a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java +++ b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java @@ -19,6 +19,8 @@ package org.apache.camel.component.aws2.sqs; import org.apache.camel.Endpoint; import org.apache.camel.test.junit6.CamelTestSupport; import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ValueSource; import software.amazon.awssdk.core.Protocol; import software.amazon.awssdk.regions.Region; @@ -249,6 +251,30 @@ public class SqsComponentConfigurationTest extends CamelTestSupport { }); } + // The visibility timeout extender runs every visibilityTimeout / 2 whole seconds, so with less than 2 seconds it + // always comes too late (CAMEL-25737) + @ParameterizedTest + @ValueSource(ints = { -1, 0, 1 }) + public void createEndpointWithExtendMessageVisibilityAndShortVisibilityTimeoutThrowsException(int visibilityTimeout) { + Sqs2Component component = context.getComponent("aws2-sqs", Sqs2Component.class); + IllegalArgumentException e = assertThrows(IllegalArgumentException.class, () -> { + component.createEndpoint("aws2-sqs://MyQueue?accessKey=xxx&secretKey=yyy&extendMessageVisibility=true" + + "&visibilityTimeout=" + visibilityTimeout); + }); + assertTrue(e.getMessage().contains("at least 2 seconds"), e.getMessage()); + } + + @Test + public void createEndpointWithExtendMessageVisibilityAndTwoSecondsVisibilityTimeout() throws Exception { + AmazonSQSClientMock mock = new AmazonSQSClientMock(); + + context.getRegistry().bind("amazonSQSClient", mock); + Sqs2Component component = context.getComponent("aws2-sqs", Sqs2Component.class); + assertNotNull(component + .createEndpoint( + "aws2-sqs://MyQueue?amazonSQSClient=#amazonSQSClient&accessKey=xxx&secretKey=yyy&visibilityTimeout=2&extendMessageVisibility=true")); + } + @Test public void createEndpointWithExtendMessageVisibilityTrueAndVisibilityTimeoutSet() throws Exception { AmazonSQSClientMock mock = new AmazonSQSClientMock(); diff --git a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java index 3919ab3b0b1f..cd899458ca3d 100644 --- a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java +++ b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java @@ -25,7 +25,7 @@ import org.apache.camel.test.dst.DstTest; * short polling and faults of the SQS calls: a message the consumer holds must not be delivered again. Regression test * for CAMEL-25700 (apache/camel#27985): before that fix 1397 of 5000 seeds fail. The world was written by Claus Ibsen * for CAMEL-25738. A failing seed is replayed with {@code -Ddst.seed=<seed>}; {@code -Ddst.seeds=5000} runs more seeds; - * {@code -Ddst.sqs.visibilityTimeouts=1} shows CAMEL-25737. + * {@code -Ddst.sqs.visibilityTimeouts=2,3} runs only the short visibility timeouts. */ @DstInstrument("org.apache.camel.component.aws2.sqs") class SqsVisibilityDstTest { diff --git a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java index c5f9f17e7015..dbf66053b91c 100644 --- a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java +++ b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java @@ -102,8 +102,7 @@ final class SqsWorld { this.redelivery = redelivery; this.ledger = new DstLedger(dst); this.sqs = new FakeSqs(dst, ledger, this::received, extensionFaulted::addAll); - // 1 s is left out by default: the extender is always late with 1 s (CAMEL-25737, open); - // -Ddst.sqs.visibilityTimeouts=1,2,3,5,10 puts it back + // 1 s is rejected when the endpoint is created: the extender would always be late (CAMEL-25737) this.visibilityTimeout = dst.pick(Arrays.stream(System.getProperty("dst.sqs.visibilityTimeouts", "2,3,5,10") .split(",")).map(String::trim).map(Integer::valueOf).toList()); this.maxMessagesPerPoll = dst.pick(List.of(1, 2, 5, 10)); diff --git a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc index 5ead09afc66d..f9d72e86a9c9 100644 --- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc +++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc @@ -11069,3 +11069,15 @@ unset, and the producer uses its `indexName` option. A route that relied on the `embeddings` index must set the `CamelPineconeIndexName` header to `embeddings`, or configure `indexName=embeddings` on the endpoint. + +=== camel-aws2-sqs - extendMessageVisibility requires a visibilityTimeout of at least 2 seconds + +An `aws2-sqs` endpoint with `extendMessageVisibility=true` now fails to be created when `visibilityTimeout` is below 2 +seconds. The task that extends the visibility runs every half of the visibility timeout, in whole seconds, and extends a +message once 80% of its visibility timeout has passed. With a `visibilityTimeout` of 1 second, each extension came when +the message was already visible again, so another consumer received it while the first one still processed it. With 0 +or a negative value, `extendMessageVisibility` was silently ignored. + +The consumer also logs a warning at startup when `visibilityTimeout` is below 10 seconds, as the extension then has only 1 +to 2 seconds before the message becomes visible again. Use a `visibilityTimeout` of 10 seconds or more with +`extendMessageVisibility`. diff --git a/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java b/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java index 6e532cffb7ba..2b27d723ab99 100644 --- a/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java +++ b/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java @@ -323,8 +323,11 @@ public interface Aws2SqsComponentBuilderFactory { /** * If enabled, then a scheduled background task will keep extending the * message visibility on SQS. This is needed if it takes a long time to - * process the message. If set to true visibilityTimeout must be set. - * See details at Amazon docs. + * process the message. If set to true visibilityTimeout must be set to + * at least 2 seconds; 10 seconds or more is recommended, as the + * visibility is extended when 80% of the visibility timeout has passed, + * which leaves only 1 to 2 seconds with a shorter timeout. See details + * at Amazon docs. * * The option is a: <code>boolean</code> type. * @@ -433,7 +436,8 @@ public interface Aws2SqsComponentBuilderFactory { * and does not change the queue: use defaultVisibilityTimeout to set * the visibility timeout attribute of the queue. * extendMessageVisibility extends the visibility of a message by this - * duration. + * duration, and requires at least 2 seconds; 10 seconds or more is + * recommended. * * The option is a: <code>java.lang.Integer</code> type. * diff --git a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java index 8ab6d23f2dc0..89f94652719c 100644 --- a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java +++ b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java @@ -393,8 +393,11 @@ public interface Sqs2EndpointBuilderFactory { /** * If enabled, then a scheduled background task will keep extending the * message visibility on SQS. This is needed if it takes a long time to - * process the message. If set to true visibilityTimeout must be set. - * See details at Amazon docs. + * process the message. If set to true visibilityTimeout must be set to + * at least 2 seconds; 10 seconds or more is recommended, as the + * visibility is extended when 80% of the visibility timeout has passed, + * which leaves only 1 to 2 seconds with a shorter timeout. See details + * at Amazon docs. * * The option is a: <code>boolean</code> type. * @@ -411,8 +414,11 @@ public interface Sqs2EndpointBuilderFactory { /** * If enabled, then a scheduled background task will keep extending the * message visibility on SQS. This is needed if it takes a long time to - * process the message. If set to true visibilityTimeout must be set. - * See details at Amazon docs. + * process the message. If set to true visibilityTimeout must be set to + * at least 2 seconds; 10 seconds or more is recommended, as the + * visibility is extended when 80% of the visibility timeout has passed, + * which leaves only 1 to 2 seconds with a shorter timeout. See details + * at Amazon docs. * * The option will be converted to a <code>boolean</code> type. * @@ -623,7 +629,8 @@ public interface Sqs2EndpointBuilderFactory { * and does not change the queue: use defaultVisibilityTimeout to set * the visibility timeout attribute of the queue. * extendMessageVisibility extends the visibility of a message by this - * duration. + * duration, and requires at least 2 seconds; 10 seconds or more is + * recommended. * * The option is a: <code>java.lang.Integer</code> type. * @@ -643,7 +650,8 @@ public interface Sqs2EndpointBuilderFactory { * and does not change the queue: use defaultVisibilityTimeout to set * the visibility timeout attribute of the queue. * extendMessageVisibility extends the visibility of a message by this - * duration. + * duration, and requires at least 2 seconds; 10 seconds or more is + * recommended. * * The option will be converted to a <code>java.lang.Integer</code> * type.
