chore: Add samples for unnamed(or positional) parameters

Author: sakthivelmanii

.kokoro/presubmit/samples.cfg

@@ -0,0 +1,38 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+  key: "TRAMPOLINE_IMAGE"
+  value: "gcr.io/cloud-devrel-kokoro-resources/java8"
+}
+
+env_vars: {
+  key: "JOB_TYPE"
+  value: "samples"
+}
+
+# TODO: remove this after we've migrated all tests and scripts
+env_vars: {
+  key: "GCLOUD_PROJECT"
+  value: "gcloud-devel"
+}
+
+env_vars: {
+  key: "GOOGLE_CLOUD_PROJECT"
+  value: "gcloud-devel"
+}
+
+env_vars: {
+  key: "GOOGLE_APPLICATION_CREDENTIALS"
+  value: "secret_manager/java-it-service-account"
+}
+
+env_vars: {
+  key: "SECRET_MANAGER_KEYS"
+  value: "java-it-service-account"
+}
+
+env_vars: {
+  key: "ENABLE_BUILD_COP"
+  value: "true"
+}

samples/install-without-bom/pom.xml

@@ -33,7 +33,7 @@
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>google-cloud-spanner</artifactId>
-      <version>6.89.0</version>
+      <version>6.91.0</version>
     </dependency>
     <!-- [END spanner_install_without_bom] -->
 

samples/snippets/pom.xml

@@ -34,7 +34,7 @@
       <dependency>
         <groupId>com.google.cloud</groupId>
         <artifactId>libraries-bom</artifactId>
-        <version>26.57.0</version>
+        <version>26.58.0</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>

samples/snippets/src/main/java/com/example/spanner/UnnamedParametersExample.java

@@ -0,0 +1,68 @@
+package com.example.spanner;
+
+import com.google.cloud.Timestamp;
+import com.google.cloud.spanner.DatabaseClient;
+import com.google.cloud.spanner.DatabaseId;
+import com.google.cloud.spanner.ResultSet;
+import com.google.cloud.spanner.Spanner;
+import com.google.cloud.spanner.SpannerOptions;
+import com.google.cloud.spanner.Statement;
+import com.google.cloud.spanner.Statement.StatementFactory;
+import java.time.LocalDate;
+
+public class UnnamedParametersExample {
+
+  static void executeQueryWithUnnamedParameters() {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "my-project";
+    String instanceId = "my-instance";
+    String databaseId = "my-database";
+
+    executeQueryWithUnnamedParameters(projectId, instanceId, databaseId);
+  }
+
+  static void executeQueryWithUnnamedParameters(
+      String projectId, String instanceId, String databaseId) {
+    try (Spanner spanner =
+        SpannerOptions.newBuilder().setProjectId(projectId).build().getService()) {
+
+      DatabaseClient client =
+          spanner.getDatabaseClient(DatabaseId.of(projectId, instanceId, databaseId));
+      StatementFactory statementFactory = client.getStatementFactory();
+
+      // Insert a row with unnamed parameters
+      client
+          .readWriteTransaction()
+          .run(
+              transaction -> {
+                Statement statement =
+                    statementFactory.withUnnamedParameters(
+                        "INSERT INTO Students(StudentId, Name, IsNRI, AvgMarks, JoinedAt, PinCode, CreatedAt) VALUES(?, ?, ?, ?, ?, ?, ?)",
+                        1000001,
+                        "Google",
+                        false,
+                        (float) 34.5,
+                        LocalDate.of(2024, 3, 31),
+                        "123456",
+                        Timestamp.now());
+                transaction.executeUpdate(statement);
+
+                return null;
+              });
+      System.out.println("Row is inserted.");
+
+      // Query the table with unnamed parameters
+      try (ResultSet resultSet =
+          client
+              .singleUse()
+              .executeQuery(
+                  statementFactory.withUnnamedParameters(
+                      "SELECT * FROM Students WHERE StudentId = ?", 1000001))) {
+        while (resultSet.next()) {
+          System.out.println(resultSet.getString("Name"));
+        }
+      }
+      System.out.println("Row is fetched.");
+    }
+  }
+}

samples/snippets/src/test/java/com/example/spanner/UnnamedParametersIT.java

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * 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
+ *
+ *       http://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.spanner;
+
+import static org.junit.Assert.assertTrue;
+
+import com.google.cloud.spanner.DatabaseId;
+import com.google.common.collect.ImmutableList;
+import java.util.concurrent.ExecutionException;
+import org.junit.Before;
+import org.junit.Test;
+
+public class UnnamedParametersIT extends SampleTestBase {
+  private static String databaseId;
+
+  @Before
+  public void setup() throws ExecutionException, InterruptedException {
+    databaseId = idGenerator.generateDatabaseId();
+    databaseAdminClient
+        .createDatabase(
+            databaseAdminClient
+                .newDatabaseBuilder(DatabaseId.of(projectId, instanceId, databaseId))
+                .build(),
+            ImmutableList.of(
+                "CREATE TABLE Students ("
+                    + "  StudentId INT64 NOT NULL PRIMARY KEY,"
+                    + "  Name STRING(1024) NOT NULL,"
+                    + "  IsNRI BOOL NOT NULL,"
+                    + "  AvgMarks FLOAT32 NOT NULL,"
+                    + "  JoinedAt DATE NOT NULL,"
+                    + "  PinCode  INT64 NOT NULL,"
+                    + "  CreatedAt TIMESTAMP NOT NULL"
+                    + ")"))
+        .get();
+  }
+
+  @Test
+  public void testUnnamedParameters() throws Exception {
+    final String out =
+        SampleRunner.runSample(
+            () -> UnnamedParametersExample.executeQueryWithUnnamedParameters(projectId, instanceId, databaseId));
+    assertTrue(out.contains("Row is inserted."));
+    assertTrue(out.contains("Google"));
+    assertTrue(out.contains("Row is fetched."));
+  }
+}