Add MongoDB with Panache extension

azure-pipelines.yml

@@ -261,6 +261,7 @@ stages:
             - infinispan-cache-jpa
             - infinispan-client
             - mongodb-client
+            - mongodb-panache
             - neo4j
           name: data
 

bom/deployment/pom.xml

@@ -216,6 +216,11 @@
                 <artifactId>quarkus-resteasy-server-common-spi</artifactId>
                 <version>${project.version}</version>
             </dependency>
+            <dependency>
+                <groupId>io.quarkus</groupId>
+                <artifactId>quarkus-resteasy-common-spi</artifactId>
+                <version>${project.version}</version>
+            </dependency>
             <dependency>
                 <groupId>io.quarkus</groupId>
                 <artifactId>quarkus-resteasy-server-common-deployment</artifactId>

bom/runtime/pom.xml

@@ -163,6 +163,8 @@
         <spring-data.version>2.1.9.RELEASE</spring-data.version>
         <mvel2.version>2.4.4.Final</mvel2.version>
         <mockito.version>3.0.0</mockito.version>
+        <jna.version>5.3.1</jna.version>
+        <antlr.version>4.7.2</antlr.version>
     </properties>
 
     <dependencyManagement>
@@ -317,11 +319,21 @@
                 <artifactId>quarkus-panache-common</artifactId>
                 <version>${project.version}</version>
             </dependency>
+            <dependency>
+                <groupId>io.quarkus</groupId>
+                <artifactId>quarkus-panacheql</artifactId>
+                <version>${project.version}</version>
+            </dependency>
             <dependency>
                 <groupId>io.quarkus</groupId>
                 <artifactId>quarkus-hibernate-orm-panache</artifactId>
                 <version>${project.version}</version>
             </dependency>
+            <dependency>
+                <groupId>io.quarkus</groupId>
+                <artifactId>quarkus-mongodb-panache</artifactId>
+                <version>${project.version}</version>
+            </dependency>
             <dependency>
                 <groupId>io.quarkus</groupId>
                 <artifactId>quarkus-hibernate-search-elasticsearch</artifactId>
@@ -693,7 +705,6 @@
             </dependency>
 
             <!-- Additional dependencies, keep in alphabetical order -->
-
             <dependency>
                 <groupId>commons-logging</groupId>
                 <artifactId>commons-logging</artifactId>
@@ -876,6 +887,11 @@
                 <version>${debezium.version}</version>
                 <type>test-jar</type>
             </dependency>
+            <dependency>
+                <groupId>org.antlr</groupId>
+                <artifactId>antlr4-runtime</artifactId>
+                <version>${antlr.version}</version>
+            </dependency>
             <dependency>
                 <groupId>org.scala-lang</groupId>
                 <artifactId>scala-reflect</artifactId>
@@ -1243,11 +1259,22 @@
                 <artifactId>json-smart</artifactId>
                 <version>${json-smart.version}</version>
             </dependency>
+            <!-- JNA dependency is fixed due to transitive dependency issue on testcontainers-->
+            <dependency>
+                <groupId>net.java.dev.jna</groupId>
+                <artifactId>jna</artifactId>
+                <version>${jna.version}</version>
+            </dependency>
             <dependency>
                 <groupId>org.testcontainers</groupId>
                 <artifactId>testcontainers</artifactId>
                 <version>${test-containers.version}</version>
             </dependency>
+            <dependency>
+                <groupId>org.testcontainers</groupId>
+                <artifactId>junit-jupiter</artifactId>
+                <version>${test-containers.version}</version>
+            </dependency>
 
             <dependency>
                 <groupId>org.codehaus.plexus</groupId>

build-parent/pom.xml

@@ -58,6 +58,9 @@
         <microprofile-reactive-messaging-api.version>1.0</microprofile-reactive-messaging-api.version>
         <microprofile-rest-client-api.version>1.2.1</microprofile-rest-client-api.version>
         <microprofile-open-api.version>1.1.2</microprofile-open-api.version>
+
+        <!-- Antlr is used by the PanacheQL parser-->
+        <antlr.version>4.7.2</antlr.version>
     </properties>
 
     <dependencyManagement>
@@ -245,6 +248,11 @@
                         <version>${elasticsearch-server.version}</version>
                     </configuration>
                 </plugin>
+                <plugin>
+                    <groupId>org.antlr</groupId>
+                    <artifactId>antlr4-maven-plugin</artifactId>
+                    <version>${antlr.version}</version><!-- keep it aligned with the runtime bom-->
+                </plugin>
             </plugins>
         </pluginManagement>
     </build>

core/deployment/src/main/java/io/quarkus/deployment/builditem/FeatureBuildItem.java

@@ -34,6 +34,7 @@ public final class FeatureBuildItem extends MultiBuildItem {
     public static final String KUBERNETES_CLIENT = "kubernetes-client";
     public static final String MAILER = "mailer";
     public static final String MONGODB_CLIENT = "mongodb-client";
+    public static final String MONGODB_PANACHE = "mongodb-panache";
     public static final String NARAYANA_JTA = "narayana-jta";
     public static final String REACTIVE_PG_CLIENT = "reactive-pg-client";
     public static final String REACTIVE_MYSQL_CLIENT = "reactive-mysql-client";

devtools/common/src/main/filtered/extensions.json

@@ -305,6 +305,18 @@
     "groupId": "io.quarkus",
     "artifactId": "quarkus-mongodb-client"
   },
+  {
+    "name": "MongoDB with Panache",
+    "labels": [
+      "mongo",
+      "mongodb",
+      "nosql",
+      "datastore",
+      "panache"
+    ],
+    "groupId": "io.quarkus",
+    "artifactId": "quarkus-mongodb-panache"
+  },
   {
     "name": "Narayana JTA - Transaction manager",
     "labels": [

docs/src/main/asciidoc/index.adoc

@@ -47,6 +47,8 @@ include::quarkus-intro.adoc[tag=intro]
 * link:kogito-guide.html[Using Kogito (business automation with processes and rules)]
 * link:oauth2-guide.html[Using OAuth2 RBAC]
 * link:tika-guide.html[Using Apache Tika]
+* link:mongo-guide.html[Using MongoDB]
+* link:mongodb-panache-guide.html[Simplified MongoDB with Panache]
 
 * link:faq.html[FAQs]
 

docs/src/main/asciidoc/mongo-guide.adoc

@@ -462,6 +462,9 @@ public class CodecFruitService {
 }
 ----
 
+== Simplifying MongoDB with Panache
+
+The link:mongodb-panache-guide.html[MongoDB with Panache] extension facilitates the usage of MongoDB by providing active record style entities (and repositories) like you have in link:hibernate-orm-panache-guide.html[Hibernate ORM with Panache] and focuses on making your entities trivial and fun to write in Quarkus.
 
 == Building a native executable