docs(genai): Add Initial Sample for Gen AI SDK

Author: holtskinner

genai/pom.xml

@@ -0,0 +1,65 @@
+<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>com.example.genai</groupId>
+  <artifactId>genai-snippets</artifactId>
+  <packaging>jar</packaging>
+  <name>Google Gen AI SDK Snippets</name>
+  <url>https://github.com/GoogleCloudPlatform/java-docs-samples/tree/main/genai</url>
+
+  <!--
+    The parent pom defines common style checks and testing strategies for our samples.
+    Removing or replacing it should not affect the execution of the samples in anyway.
+  -->
+  <parent>
+    <groupId>com.google.cloud.samples</groupId>
+    <artifactId>shared-configuration</artifactId>
+    <version>1.2.0</version>
+  </parent>
+
+  <properties>
+    <maven.compiler.target>1.8</maven.compiler.target>
+    <maven.compiler.source>1.8</maven.compiler.source>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <artifactId>libraries-bom</artifactId>
+        <groupId>com.google.cloud</groupId>
+        <scope>import</scope>
+        <type>pom</type>
+        <version>26.32.0</version>
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+  <!-- [START googlegenaisdk_install_with_bom] -->
+  <dependencies>
+    <dependency>
+      <groupId>com.google.genai</groupId>
+      <artifactId>google-genai</artifactId>
+    </dependency>
+    <!-- [END googlegenaisdk_install_with_bom] -->
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.13.2</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.google.truth</groupId>
+      <artifactId>truth</artifactId>
+      <version>1.4.0</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
+      <version>RELEASE</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>

genai/src/main/java/genai/text_generation/TextgenWithTxt.java

@@ -0,0 +1,42 @@
+/*
+ * 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 genai.text_generation;
+
+// [START googlegenaisdk_textgen_with_txt]
+import com.google.genai.Client;
+import com.google.genai.types.GenerateContentResponse;
+import java.io.IOException;
+import org.apache.http.HttpException;
+
+public class TxtgenWithTxt {
+  public static void main(String[] args) throws IOException, HttpException {
+    Client client = new Client();
+
+    GenerateContentResponse response = client.models.generateContent(
+      "gemini-2.0-flash-001",
+      "How does AI work?",
+      null
+    );
+    System.out.println(response.text());
+    // Example response:
+    // Okay, let's break down how AI works. It's a broad field, so I'll focus on the ...
+    //
+    // Here's a simplified overview:
+    // ...
+  }
+}
+// [END googlegenaisdk_textgen_with_txt]

genai/src/test/java/genai/text_generation/TextGenerationIT.java

@@ -0,0 +1,64 @@
+/*
+ * 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.
+ */
+
+// Tests for Gen AI SDK code samples.
+
+package genai.text_generation;
+
+import static com.google.common.truth.Truth.assertThat;
+import static com.google.common.truth.Truth.assertWithMessage;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.PrintStream;
+import org.apache.http.HttpException;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+
+@RunWith(JUnit4.class)
+public class TextGenerationIT {
+
+  private ByteArrayOutputStream bout;
+  private PrintStream originalOut;
+
+
+  // Check if the required environment variables are set.
+  public static void requireEnvVar(String envVarName) {
+    assertWithMessage(String.format("Missing environment variable '%s' ", envVarName))
+        .that(System.getenv(envVarName))
+        .isNotEmpty();
+  }
+
+  @Before
+  public void setUp() {
+      originalOut = System.out;
+      bout = new ByteArrayOutputStream();
+      System.setOut(new PrintStream(bout));
+  }
+
+    public void tearDown() {
+        System.setOut(originalOut);
+    }
+
+  @Test
+  public void testTextgenWithTxt() throws IOException, HttpException {
+    TxtgenWithTxt.main(new String[]{});
+    tearDown();
+    assertThat(bout.toString()).isNotEmpty();
+  }
+}