Quarkus Embedded Docs (#10746)

ISPN-14584 Add Infinispan Quarkus Embedded documentation

build/bom/pom.xml

@@ -353,6 +353,11 @@
                 <artifactId>infinispan-anchored-keys</artifactId>
                 <version>${version.infinispan}</version>
             </dependency>
+            <dependency>
+                <groupId>org.infinispan</groupId>
+                <artifactId>infinispan-quarkus-embedded</artifactId>
+                <version>${version.infinispan}</version>
+            </dependency>
             <dependency>
                 <groupId>org.infinispan.protostream</groupId>
                 <artifactId>protostream</artifactId>

documentation/src/main/asciidoc/stories/assembly_quarkus_embedded.adoc

@@ -0,0 +1,13 @@
+[id='quarkus_embedded']
+:context: quarkus
+= Using the Quarkus extension
+{brandname} provides an extension that integrates with the Quarkus framework.
+The extension lets you create natively compiled {brandname} applications.
+
+include::{topics}/ref_quarkus_dependencies.adoc[leveloffset=+1]
+include::{topics}/proc_quarkus_injecting_embedded.adoc[leveloffset=+1]
+include::{topics}/proc_quarkus_native_compilation.adoc[leveloffset=+1]
+
+// Restore the parent context.
+ifdef::parent-context[:context: {parent-context}]
+ifndef::parent-context[:!context:]

documentation/src/main/asciidoc/titles/embedding/stories.adoc

@@ -9,6 +9,9 @@ include::{stories}/assembly_setting_up_clusters.adoc[leveloffset=+1]
 include::{stories}/assembly_clustered_locks.adoc[leveloffset=+1]
 include::{stories}/assembly_cluster_executor.adoc[leveloffset=+1]
 include::{stories}/assembly_streams.adoc[leveloffset=+1]
+ifdef::community[]
+include::{stories}/assembly_quarkus_embedded.adoc[leveloffset=+1]
+endif::community[]
 include::{stories}/assembly_cdi.adoc[leveloffset=+1]
 include::{stories}/assembly_multimap_cache.adoc[leveloffset=+1]
 //Community content

documentation/src/main/asciidoc/topics/dependencies_maven/cdi_embedded_quarkus.xml

@@ -0,0 +1,4 @@
+<dependency>
+  <groupId>org.infinispan</groupId>
+  <artifactId>infinispan-quarkus-embedded</artifactId>
+</dependency>

documentation/src/main/asciidoc/topics/proc_quarkus_injecting_embedded.adoc

@@ -0,0 +1,26 @@
+[id='quarkus_inject_embedded']
+= Injecting Embedded Caches
+Inject a `EmbeddedCacheManager` instance into your Quarkus application to interact with {brandname} caches..
+
+.Procedure
+
+. Optional: Use the `quarkus.infinispan-embedded.xml-config` property to set the path to an XML file that includes the configuration of the injected instance.
++
+[source,java]
+----
+quarkus.infinispan-embedded.xml-config=/example/path/to/config.xml
+----
+. Add the `@Inject` annotation to an uninitialized `EmbeddedCacheManager` class variable.
++
+[source,java]
+----
+import javax.inject.Inject;
+import org.infinispan.manager.EmbeddedCacheManager;
+...
+@Path("/example")
+public class ExampleResource {
+
+    @Inject
+    EmbeddedCacheManager emc;
+}
+----

documentation/src/main/asciidoc/topics/proc_quarkus_native_compilation.adoc

@@ -0,0 +1,15 @@
+[id='quarkus_native_compilation']
+= Compiling Quarkus {brandname} application
+Generate a native executable for Quarkus {brandname} application.
+
+.Prerequisites
+
+* Have a Quarkus based project. For a complete list of prerequisites, see link:https://quarkus.io/guides/building-native-image#prerequisites[Quarkus native prerequisites].
+
+.Procedure
+* Natively compile your Quarkus {brandname} application:
++
+[source]
+----
+mvn clean package -Pnative
+----

documentation/src/main/asciidoc/topics/ref_quarkus_dependencies.adoc

@@ -0,0 +1,8 @@
+[id='quarkus_embedded_dependencies']
+= Quarkus dependencies
+Include the {brandname} Quarkus extension in your `pom.xml`:
+
+.Embedded mode
+----
+include::dependencies_maven/cdi_embedded_quarkus.xml[]
+----