feat(appengine): quickstart version

appengine-java21/helloworld/http-server/README.md

@@ -0,0 +1,20 @@
+# Standalone HTTP Server on Google App Engine Standard with Java 21
+
+This sample shows how to deploy an application to Google App Engine from source. The `entrypoint` field listed in the [`app.yaml`](src/main/appengine/app.yaml) is not required,
+as GAE will determine the entrypoint by searching the `target` directory for the .jar file with a Main-Class Manifest entry.
+
+## Setup
+
+See [Prerequisites](../README.md#Prerequisites).
+
+## Deploy to App Engine Standard
+
+```
+gcloud app deploy
+```
+
+To view your app, use command:
+```
+gcloud app browse
+```
+Or navigate to `https://<your-project-id>.appspot.com`.

appengine-java21/helloworld/http-server/pom.xml

@@ -0,0 +1,49 @@
+<?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.appengine</groupId>
+  <artifactId>http-server</artifactId>
+  <version>0.1</version>
+
+  <!--
+   The parent pom defines common style checks and testing strategies for our samples.
+   Removing or replacing it should not effect 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.source>11</maven.compiler.source>
+    <maven.compiler.target>11</maven.compiler.target>
+  </properties>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <version>3.3.0</version>
+        <configuration>
+          <archive>
+            <manifest>
+              <mainClass>com.example.appengine.Main</mainClass>
+            </manifest>
+          </archive>
+        </configuration>
+      </plugin>
+
+      <plugin>
+        <groupId>com.google.cloud.tools</groupId>
+        <artifactId>appengine-maven-plugin</artifactId>
+        <version>2.8.0</version>
+        <configuration>
+          <projectId>GCLOUD_CONFIG</projectId>
+          <version>http-server</version>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+</project>

appengine-java21/helloworld/http-server/src/main/appengine/app.yaml

@@ -0,0 +1,18 @@
+# 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.
+
+# [START gae_java21_runtime]
+runtime: java21
+# No need for an entrypoint with single fatjar with correct manifest class-path entry.
+# [END gae_java21_runtime]

appengine-java21/helloworld/http-server/src/main/java/com/example/appengine/Main.java

@@ -0,0 +1,52 @@
+/*
+ * 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.appengine;
+
+import com.sun.net.httpserver.HttpServer;
+import java.io.IOException;
+import java.io.OutputStream;
+import java.net.InetSocketAddress;
+
+public class Main {
+
+  public static void main(String[] args) throws IOException {
+    // Create an instance of HttpServer bound to port defined by the 
+    // PORT environment variable when present, otherwise on 8080.
+    int port = Integer.parseInt(System.getenv().getOrDefault("PORT", "8080"));
+    HttpServer server = HttpServer.create(new InetSocketAddress(port), 0);
+
+    // Set root URI path.
+    server.createContext("/", (var t) -> {
+      byte[] response = "Hello World!".getBytes();
+      t.sendResponseHeaders(200, response.length);
+      try (OutputStream os = t.getResponseBody()) {
+        os.write(response);
+      }
+    });
+
+    // Create a second URI path.
+    server.createContext("/foo", (var t) -> {
+      byte[] response = "Foo!".getBytes();
+      t.sendResponseHeaders(200, response.length);
+      try (OutputStream os = t.getResponseBody()) {
+        os.write(response);
+      }
+    });
+
+    server.start();
+  }
+}