Add Maven project template example

Author: dnault

couchbase-analytics-java-client/examples/maven-project-template/README.md

@@ -0,0 +1,3 @@
+# Maven project template for Couchbase Analytics
+
+This directory contains an example Maven project for getting started with the Couchbase Analytics Java SDK.

couchbase-analytics-java-client/examples/maven-project-template/pom.xml

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
+
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.example</groupId>
+    <artifactId>couchbase-analytics-java-example</artifactId>
+    <version>1.0.0-SNAPSHOT</version>
+
+    <name>Couchbase Analytics Java SDK Project Template</name>
+    <description>Examples project for Couchbase Analytics Java SDK</description>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <maven.compiler.release>21</maven.compiler.release>
+    </properties>
+
+    <!-- Required when using a *-SNAPSHOT version of the SDK. -->
+    <repositories>
+        <repository>
+            <id>sonatype-snapshots</id>
+            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
+            <releases>
+                <enabled>false</enabled>
+            </releases>
+            <snapshots>
+                <enabled>true</enabled>
+            </snapshots>
+        </repository>
+    </repositories>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.couchbase.client</groupId>
+            <artifactId>couchbase-analytics-java-client</artifactId>
+            <version>1.0.0-SNAPSHOT</version>
+        </dependency>
+
+        <!-- Specify your favorite SLF4J 2 binding -->
+        <dependency>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-slf4j2-impl</artifactId>
+            <version>2.24.3</version>
+        </dependency>
+    </dependencies>
+</project>

couchbase-analytics-java-client/examples/maven-project-template/src/main/java/com/example/couchbase/analytics/Example.java

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2025 Couchbase, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.couchbase.analytics;
+
+import com.couchbase.analytics.client.java.Cluster;
+import com.couchbase.analytics.client.java.Credential;
+import com.couchbase.analytics.client.java.QueryResult;
+
+import java.time.Duration;
+import java.util.List;
+
+public class Example {
+  public static void main(String[] args) {
+    var connectionString = "https://...";
+    var username = "...";
+    var password = "...";
+
+    try (Cluster cluster = Cluster.newInstance(
+      connectionString,
+      Credential.of(username, password),
+      // The third parameter is optional.
+      // This example sets the default query timeout to 2 minutes.
+      clusterOptions -> clusterOptions
+        .timeout(it -> it.queryTimeout(Duration.ofMinutes(2)))
+    )) {
+
+      // Buffered query. All rows must fit in memory.
+      QueryResult result = cluster.executeQuery(
+        "select ?=1",
+        options -> options
+          .readOnly(true)
+          .parameters(List.of(1))
+      );
+      result.rows().forEach(row -> System.out.println("Got row: " + row));
+
+      // Alternatively --
+
+      // Streaming query. Rows are processed one-by-one
+      // as they arrive from server.
+      cluster.executeStreamingQuery(
+        "select ?=1",
+        row -> System.out.println("Got row: " + row),
+        options -> options
+          .readOnly(true)
+          .parameters(List.of(1))
+      );
+    }
+  }
+}
+

couchbase-analytics-java-client/examples/maven-project-template/src/main/resources/log4j2.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Configuration status="WARN">
+    <Appenders>
+        <Console name="Console" target="SYSTEM_OUT">
+            <PatternLayout pattern="%d{ISO8601_OFFSET_DATE_TIME_HHCMM} %-5p [%c] %m%n"/>
+        </Console>
+    </Appenders>
+    <Loggers>
+        <Logger name="com.couchbase.client.core.deps.io.netty" level="warn"/>
+
+        <Root level="info">
+            <AppenderRef ref="Console"/>
+        </Root>
+    </Loggers>
+</Configuration>