[camel] branch camel-3.18.x updated: CAMEL-18336: camel-jbang - Add docs about using Java beans

[davsclaus]

This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch camel-3.18.x
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/camel-3.18.x by this push:
     new d757a35d90f CAMEL-18336: camel-jbang - Add docs about using Java beans
d757a35d90f is described below

commit d757a35d90f6cd9afe2832a41306506ed9a3a9de
Author: Claus Ibsen <claus.ib...@gmail.com>
AuthorDate: Wed Aug 3 07:33:23 2022 +0200

    CAMEL-18336: camel-jbang - Add docs about using Java beans
---
 .../modules/ROOT/pages/camel-jbang.adoc            | 36 ++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc 
b/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
index cc8cf56bd28..9c575e9bce7 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
@@ -531,7 +531,39 @@ There is basic support for including regular Java source 
files together with Cam
 and let Camel JBang runtime compile the Java source. This means you can 
include smaller utility
 classes, POJOs, Camel Processors and whatnot that the application needs.
 
-NOTE: The Java source files cannot use package names. This may change in the 
future.
+If any of these beans must be used/shared in the Camel application then they 
must be shared via bean ids,
+and not via classloading.
+
+Given a bean as below:
+
+[source,java]
+----
+@org.apache.camel.BindToRegistry("helloBean")
+public class HelloBean {
+
+    public String greeting() {
+        return "Hello World";
+    }
+}
+----
+
+Notice how the class is annotated with `@BindToRegistry`, to assign the bean 
an id, which
+we can use to call the bean from Camel routes such as:
+
+TIP: Instead of using `@BindToRegistry` you can also use Spring or Quarkus 
annotations (see further below).
+
+[source,yaml]
+----
+- from:
+    uri: "timer:yaml"
+    parameters:
+      period: "1000"
+    steps:
+      - bean: "helloBean"
+      - log: "${body}"
+----
+
+IMPORTANT: The Java source files cannot use package names. This may change in 
the future.
 
 === Dependency Injection in Java classes
 
@@ -563,7 +595,7 @@ You can use the following Spring Boot annotations:
 You can use the following Quarkus annotations:
 
 - `@ApplicationScoped` or `@Singleton` on class level to create an instance of 
the class and register in the xref:registry.adoc[Registry]. `@Named` can be 
used to specify the bean id.
-- `@Inject` to dependency inject an bean on a class field. `@Named` can be 
used to specify the bean id.
+- `@Inject` to dependency inject a bean on a class field. `@Named` can be used 
to specify the bean id.
 - `@ConfigProperty` to inject a xref:using-propertyplaceholder.adoc[property 
placeholder]. Such as a property defined in `application.properties`.
 - `@Produces` on a method to create a bean by invoking the method. `@Named` 
can be used to specify the bean id.