This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new b64b3d079e0b chore: docs - the S3 examples of poll and pollEnrich use
aws2-s3, a plain & in Java, and a timeout for pollEnrich (#29176)
b64b3d079e0b is described below
commit b64b3d079e0b552fdc892093d2564c76d0665441
Author: Claus Ibsen <[email protected]>
AuthorDate: Wed Nov 4 15:53:17 2026 +0100
chore: docs - the S3 examples of poll and pollEnrich use aws2-s3, a plain &
in Java, and a timeout for pollEnrich (#29176)
- 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.
Claude-Session: https://claude.ai/code/session_016Y4dDi5iQNgtHrDdz2NpwF
Co-authored-by: Claude Opus 5.5 <[email protected]>
---
.../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 e9da59bd98c6..00dc12941efa 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
@@ -322,7 +322,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::
@@ -337,8 +337,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>
----
@@ -361,10 +361,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 e9da59bd98c6..00dc12941efa 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
@@ -322,7 +322,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::
@@ -337,8 +337,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>
----
@@ -361,10 +361,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 949386bd1179..a4449af9330c 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": [
