This is an automated email from the ASF dual-hosted git repository. davsclaus pushed a commit to branch eip-docs-poll-s3 in repository https://gitbox.apache.org/repos/asf/camel.git
commit fe6142f6448030b6d6213368fc85fd54bdd95cab Author: Claus Ibsen <[email protected]> AuthorDate: Wed Nov 4 15:27:47 2026 +0100 chore: docs - the S3 examples of poll and pollEnrich use aws2-s3, a plain & in Java, and a timeout for pollEnrich - aws-s3: is aws2-s3: in Camel 4 (Java, XML and YAML tabs of both pages). - The Java tabs had & inside a Java string, and the poll Java tab had .to*( and no semicolon. - The pollEnrich example has a timeout of 5000 ms, so a file that is not in the bucket does not make the request wait forever. The catalog copies of the pages and the eip-samples.json of camel-jbang-core are regenerated. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y4dDi5iQNgtHrDdz2NpwF --- .../resources/org/apache/camel/catalog/docs/poll-eip.adoc | 8 ++++---- .../org/apache/camel/catalog/docs/pollEnrich-eip.adoc | 11 +++++++---- .../src/main/docs/modules/eips/pages/poll-eip.adoc | 8 ++++---- .../src/main/docs/modules/eips/pages/pollEnrich-eip.adoc | 11 +++++++---- .../apache/camel/dsl/jbang/core/commands/ai/eip-samples.json | 4 ++-- 5 files changed, 24 insertions(+), 18 deletions(-) diff --git a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/poll-eip.adoc b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/poll-eip.adoc index 641f37cdece3..4130d1704efa 100644 --- a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/poll-eip.adoc +++ b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/poll-eip.adoc @@ -151,10 +151,10 @@ Java:: ---- rest("/report") .get("/{id}/payload") - .to*("direct:payload"); + .to("direct:payload"); from("direct:payload") - .poll("aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf") + .poll("aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"); ---- XML:: @@ -169,7 +169,7 @@ XML:: <route> <from uri="direct:payload"/> - <poll uri="aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"/> + <poll uri="aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"/> </route> ---- @@ -188,7 +188,7 @@ YAML:: uri: direct:payload steps: - poll: - uri: aws-s3:xavier-dev + uri: aws2-s3:xavier-dev parameters: amazonS3Client: "#s3client" deleteAfterRead: false diff --git a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/pollEnrich-eip.adoc b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/pollEnrich-eip.adoc index 18e81feaba9f..a0fbb81a5df7 100644 --- a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/pollEnrich-eip.adoc +++ b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/pollEnrich-eip.adoc @@ -319,7 +319,7 @@ rest("/report") .to("direct:report"); from("direct:report") - .pollEnrich("aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"); + .pollEnrich("aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf", 5000); ---- XML:: @@ -334,8 +334,8 @@ XML:: <route> <from uri="direct:report"/> - <pollEnrich> - <constant>aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf</constant> + <pollEnrich timeout="5000"> + <constant>aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf</constant> </pollEnrich> </route> ---- @@ -358,10 +358,13 @@ YAML:: - pollEnrich: expression: constant: - expression: "aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf" + expression: "aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf" + timeout: 5000 ---- ==== +The timeout (5000 milliseconds) ends the wait when the file is not in the bucket; without a timeout, `pollEnrich` waits until it is there. + Notice that the enriched endpoint is a constant, however, Camel also supports dynamic endpoints which is covered next. === Using Poll Enrich with file based components diff --git a/core/camel-core-engine/src/main/docs/modules/eips/pages/poll-eip.adoc b/core/camel-core-engine/src/main/docs/modules/eips/pages/poll-eip.adoc index 641f37cdece3..4130d1704efa 100644 --- a/core/camel-core-engine/src/main/docs/modules/eips/pages/poll-eip.adoc +++ b/core/camel-core-engine/src/main/docs/modules/eips/pages/poll-eip.adoc @@ -151,10 +151,10 @@ Java:: ---- rest("/report") .get("/{id}/payload") - .to*("direct:payload"); + .to("direct:payload"); from("direct:payload") - .poll("aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf") + .poll("aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"); ---- XML:: @@ -169,7 +169,7 @@ XML:: <route> <from uri="direct:payload"/> - <poll uri="aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"/> + <poll uri="aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"/> </route> ---- @@ -188,7 +188,7 @@ YAML:: uri: direct:payload steps: - poll: - uri: aws-s3:xavier-dev + uri: aws2-s3:xavier-dev parameters: amazonS3Client: "#s3client" deleteAfterRead: false diff --git a/core/camel-core-engine/src/main/docs/modules/eips/pages/pollEnrich-eip.adoc b/core/camel-core-engine/src/main/docs/modules/eips/pages/pollEnrich-eip.adoc index 18e81feaba9f..a0fbb81a5df7 100644 --- a/core/camel-core-engine/src/main/docs/modules/eips/pages/pollEnrich-eip.adoc +++ b/core/camel-core-engine/src/main/docs/modules/eips/pages/pollEnrich-eip.adoc @@ -319,7 +319,7 @@ rest("/report") .to("direct:report"); from("direct:report") - .pollEnrich("aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf"); + .pollEnrich("aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf", 5000); ---- XML:: @@ -334,8 +334,8 @@ XML:: <route> <from uri="direct:report"/> - <pollEnrich> - <constant>aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf</constant> + <pollEnrich timeout="5000"> + <constant>aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf</constant> </pollEnrich> </route> ---- @@ -358,10 +358,13 @@ YAML:: - pollEnrich: expression: constant: - expression: "aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf" + expression: "aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf" + timeout: 5000 ---- ==== +The timeout (5000 milliseconds) ends the wait when the file is not in the bucket; without a timeout, `pollEnrich` waits until it is there. + Notice that the enriched endpoint is a constant, however, Camel also supports dynamic endpoints which is covered next. === Using Poll Enrich with file based components diff --git a/dsl/camel-jbang/camel-jbang-core/src/generated/resources/org/apache/camel/dsl/jbang/core/commands/ai/eip-samples.json b/dsl/camel-jbang/camel-jbang-core/src/generated/resources/org/apache/camel/dsl/jbang/core/commands/ai/eip-samples.json index b9ea20c18570..e937a7970b04 100644 --- a/dsl/camel-jbang/camel-jbang-core/src/generated/resources/org/apache/camel/dsl/jbang/core/commands/ai/eip-samples.json +++ b/dsl/camel-jbang/camel-jbang-core/src/generated/resources/org/apache/camel/dsl/jbang/core/commands/ai/eip-samples.json @@ -860,7 +860,7 @@ }, { "source": "poll-eip.adoc", - "yaml": "- rest:\n path: \/report\n get:\n - path: \/{id}\/payload\n to:\n uri: direct:payload\n- route:\n from:\n uri: direct:payload\n steps:\n - poll:\n uri: aws-s3:xavier-dev\n parameters:\n amazonS3Client: \"#s3client\"\n deleteAfterRead: false\n fileName: report-file.pdf\n" + "yaml": "- rest:\n path: \/report\n get:\n - path: \/{id}\/payload\n to:\n uri: direct:payload\n- route:\n from:\n uri: direct:payload\n steps:\n - poll:\n uri: aws2-s3:xavier-dev\n parameters:\n amazonS3Client: \"#s3client\"\n deleteAfterRead: false\n fileName: report-file.pdf\n" }, { "source": "poll-eip.adoc", @@ -886,7 +886,7 @@ }, { "source": "pollEnrich-eip.adoc", - "yaml": "- rest:\n path: \/report\n get:\n - path: \/{id}\/report\n to:\n uri: direct:report\n\n- route:\n from:\n uri: direct:report\n steps:\n - pollEnrich:\n expression:\n constant:\n expression: \"aws-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf\"\n" + "yaml": "- rest:\n path: \/report\n get:\n - path: \/{id}\/report\n to:\n uri: direct:report\n\n- route:\n from:\n uri: direct:report\n steps:\n - pollEnrich:\n expression:\n constant:\n expression: \"aws2-s3:xavier-dev?amazonS3Client=#s3client&deleteAfterRead=false&fileName=report-file.pdf\"\n timeout: 5000\n" } ], "process": [
