diff --git a/flexible/java-11/springboot-helloworld/src/main/appengine/app.yaml b/flexible/java-11/springboot-helloworld/src/main/appengine/app.yaml
index 61519f389dc..317786f1870 100644
--- a/flexible/java-11/springboot-helloworld/src/main/appengine/app.yaml
+++ b/flexible/java-11/springboot-helloworld/src/main/appengine/app.yaml
@@ -11,7 +11,7 @@
# 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_flex_java11_yaml]
runtime: java
env: flex
runtime_config:
@@ -23,3 +23,4 @@ handlers:
manual_scaling:
instances: 1
+# [END gae_flex_java11_yaml]
diff --git a/flexible/java-17/micronaut-helloworld/src/main/appengine/app.yaml b/flexible/java-17/micronaut-helloworld/src/main/appengine/app.yaml
index a1d19ec959e..388757d0fa1 100644
--- a/flexible/java-17/micronaut-helloworld/src/main/appengine/app.yaml
+++ b/flexible/java-17/micronaut-helloworld/src/main/appengine/app.yaml
@@ -11,7 +11,7 @@
# 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_flex_java17_yaml]
runtime: java
env: flex
runtime_config:
@@ -23,3 +23,4 @@ handlers:
manual_scaling:
instances: 1
+# [END gae_flex_java17_yaml]
diff --git a/flexible/java-8/analytics/pom.xml b/flexible/java-8/analytics/pom.xml
new file mode 100644
index 00000000000..80109348cb3
--- /dev/null
+++ b/flexible/java-8/analytics/pom.xml
@@ -0,0 +1,82 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-analytics
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ 2.4.3
+ 9.4.44.v20210927
+ false
+
+
+
+
+ org.apache.httpcomponents
+ httpclient
+ 4.5.13
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/analytics/src/main/appengine/app.yaml b/flexible/java-8/analytics/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..46baccfc558
--- /dev/null
+++ b/flexible/java-8/analytics/src/main/appengine/app.yaml
@@ -0,0 +1,25 @@
+# Copyright 2023 Google 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
+#
+# 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.
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+# [START gae_flex_analytics_env_variables]
+env_variables:
+ GA_TRACKING_ID: YOUR-GA-TRACKING-ID
+# [END gae_flex_analytics_env_variables]
diff --git a/flexible/java-8/analytics/src/main/java/com/example/analytics/AnalyticsServlet.java b/flexible/java-8/analytics/src/main/java/com/example/analytics/AnalyticsServlet.java
new file mode 100644
index 00000000000..198aa35e02c
--- /dev/null
+++ b/flexible/java-8/analytics/src/main/java/com/example/analytics/AnalyticsServlet.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.analytics;
+
+import java.io.IOException;
+import java.net.URI;
+import java.net.URISyntaxException;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.apache.http.client.HttpClient;
+import org.apache.http.client.methods.HttpPost;
+import org.apache.http.client.utils.URIBuilder;
+import org.apache.http.impl.client.HttpClientBuilder;
+
+// [START gae_flex_analytics_track_event]
+@SuppressWarnings("serial")
+@WebServlet(name = "analytics", value = "")
+public class AnalyticsServlet extends HttpServlet {
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ String trackingId = System.getenv("GA_TRACKING_ID");
+ HttpClient client = HttpClientBuilder.create().build();
+ URIBuilder builder = new URIBuilder();
+ builder
+ .setScheme("http")
+ .setHost("www.google-analytics.com")
+ .setPath("/collect")
+ .addParameter("v", "1") // API Version.
+ .addParameter("tid", trackingId) // Tracking ID / Property ID.
+ // Anonymous Client Identifier. Ideally, this should be a UUID that
+ // is associated with particular user, device, or browser instance.
+ .addParameter("cid", "555")
+ .addParameter("t", "event") // Event hit type.
+ .addParameter("ec", "example") // Event category.
+ .addParameter("ea", "test action"); // Event action.
+ URI uri = null;
+ try {
+ uri = builder.build();
+ } catch (URISyntaxException e) {
+ throw new ServletException("Problem building URI", e);
+ }
+ HttpPost request = new HttpPost(uri);
+ client.execute(request);
+ resp.getWriter().println("Event tracked.");
+ }
+}
+// [END gae_flex_analytics_track_event]
diff --git a/flexible/java-8/async-rest/README.md b/flexible/java-8/async-rest/README.md
new file mode 100644
index 00000000000..314ba75f2c8
--- /dev/null
+++ b/flexible/java-8/async-rest/README.md
@@ -0,0 +1,52 @@
+
+# Example Web App Using Asynchronous Servlets #
+
+
+
+
+
+This web app demonstrates using asynchronous servlet techniques to reduce server resources.
+
+The code for this tutorial is [here](https://github.com/GoogleCloudPlatform/java-docs-samples/tree/main/flexible/async-rest).
+
+
+## Initial Setup ##
+
+First, complete the following steps:
+
+- [Create your project](https://developers.google.com/appengine/docs/managed-vms/) and have it enabled for Managed VMs.
+- Obtain an app key for the Google Places WebService API.
+- Download and install [the Beta build of the Google Cloud SDK](https://developers.google.com/cloud/sdk/#Quick_Start).
+- Install the Cloud SDK `app-engine-java` component.
+- Authenticate wth the gcloud SDK: gcloud auth application-default login.
+- Install [Maven](http://maven.apache.org/download.cgi) if you haven't already.
+
+
+## Providing your Google Places API key ##
+
+To run locally, you need to edit the pom.xml file and replace YOUR_PLACES_APP_KEY with the value of your key:
+
+ YOUR_PLACES_APP_KEY
+
+To deploy to gcloud, you need to edit the src/main/appengine/app.yaml file and replace YOUR_PLACES_APP_KEY with the value of your key:
+
+ PLACES_APPKEY: 'YOUR_PLACES_APP_KEY'
+
+
+## Running locally without the AppEngine environment ##
+
+The application does not use any AppEngine specific services, so you can run it simply on your local machine by doing:
+
+ mvn jetty:run
+
+Go to http://localhost:8080 to see the webapp.
+
+
+## Deploying to the cloud as an AppEngine ManagedVM ##
+
+To automatically stage and deploy the webapp to your project in the cloud do:
+
+ mvn clean package appengine:deploy
+
+See here for more information on the [GCloud Maven Plugin](https://github.com/GoogleCloudPlatform/gcloud-maven-plugin).
+
diff --git a/flexible/java-8/async-rest/pom.xml b/flexible/java-8/async-rest/pom.xml
new file mode 100644
index 00000000000..17b5410cdbf
--- /dev/null
+++ b/flexible/java-8/async-rest/pom.xml
@@ -0,0 +1,100 @@
+
+
+
+ 4.0.0
+ com.google.appengine.demos
+ async-rest
+ 1.0.0-SNAPSHOT
+ war
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ YOUR_PLACES_APP_KEY
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+ 1.8
+ 1.8
+
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+ com.google.appengine.demos.asyncrest.appKey
+ ${places.appkey}
+
+
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+
+
+ org.eclipse.jetty
+ jetty-client
+ ${jetty}
+
+
+ org.eclipse.jetty
+ jetty-util-ajax
+ ${jetty}
+
+
+ org.eclipse.jetty
+ jetty-webapp
+ ${jetty}
+ test
+
+
+ javax.servlet
+ javax.servlet-api
+ provided
+ 3.1.0
+
+
+
diff --git a/flexible/java-8/async-rest/src/main/appengine/app.yaml b/flexible/java-8/async-rest/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..fa7a48ec60b
--- /dev/null
+++ b/flexible/java-8/async-rest/src/main/appengine/app.yaml
@@ -0,0 +1,23 @@
+# Copyright 2016 Google 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
+#
+# 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.
+runtime: custom
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+
+env_variables:
+ PLACES_APPKEY: 'YOUR_PLACES_APP_KEY'
diff --git a/flexible/java-8/async-rest/src/main/docker/Dockerfile b/flexible/java-8/async-rest/src/main/docker/Dockerfile
new file mode 100644
index 00000000000..e6dd3dcad7e
--- /dev/null
+++ b/flexible/java-8/async-rest/src/main/docker/Dockerfile
@@ -0,0 +1,22 @@
+# Copyright 2023 Google 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
+#
+# 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.
+
+FROM gcr.io/google_appengine/jetty9
+
+ADD async-rest-1.0.0-SNAPSHOT.war $JETTY_BASE/webapps/root.war
+ADD jetty-logging.properties $JETTY_BASE/resources/jetty-logging.properties
+RUN chown jetty:jetty $JETTY_BASE/webapps/root.war $JETTY_BASE/resources/jetty-logging.properties
+WORKDIR $JETTY_BASE
+#RUN java -jar $JETTY_HOME/start.jar --approve-all-licenses --add-to-startd=jmx,stats,hawtio
+
diff --git a/flexible/java-8/async-rest/src/main/docker/jetty-logging.properties b/flexible/java-8/async-rest/src/main/docker/jetty-logging.properties
new file mode 100644
index 00000000000..afe37732286
--- /dev/null
+++ b/flexible/java-8/async-rest/src/main/docker/jetty-logging.properties
@@ -0,0 +1,33 @@
+# Copyright 2023 Google 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
+#
+# 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.
+
+## Copied to $JETTY_BASE/resources in Dockerfile
+
+## Direct Jetty logging to JavaUtilLog
+# org.eclipse.jetty.util.log.class=org.eclipse.jetty.util.log.JavaUtilLog
+
+### Configure jetty root logger level for the default StdErrLog class.
+## Levels are OFF, DEBUG, INFO, WARN, ALL
+org.eclipse.jetty.LEVEL=INFO
+#org.eclipse.jetty.server.LEVEL=DEBUG
+
+## If SOURCE is true, the filename and line number of the logging event origin are logged
+org.eclipse.jetty.SOURCE=false
+
+## If STACKS is true, full stack traces for exceptions are logged
+org.eclipse.jetty.STACKS=true
+
+## If LONG is true, fully qualified package names are used rather than abbreviations
+org.eclipse.jetty.LONG=false
+
diff --git a/flexible/java-8/async-rest/src/main/java/com/google/appengine/demos/DumpServlet.java b/flexible/java-8/async-rest/src/main/java/com/google/appengine/demos/DumpServlet.java
new file mode 100644
index 00000000000..aaba6a97ab8
--- /dev/null
+++ b/flexible/java-8/async-rest/src/main/java/com/google/appengine/demos/DumpServlet.java
@@ -0,0 +1,102 @@
+/*
+ * Copyright 2016 Google 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
+ *
+ * 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.google.appengine.demos;
+
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.util.Collections;
+import javax.servlet.ServletException;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+@SuppressWarnings("serial")
+public class DumpServlet extends HttpServlet {
+
+ @Override
+ protected void doGet(HttpServletRequest request, HttpServletResponse response)
+ throws ServletException, IOException {
+
+ if (Boolean.parseBoolean(request.getParameter("throw"))) {
+ throw new ServletException("Test Exception");
+ }
+
+ response.setContentType("text/html");
+ response.setStatus(HttpServletResponse.SC_OK);
+
+ PrintWriter out = response.getWriter();
+
+ out.println("
+This demo calls the Google Maps WebService API
+to find places matching each of the search criteria passed on the query
+string.
+
+
The rest API is called both synchronously and asynchronously for comparison. The time the request thread is held by the servlet is
+displayed in red for both.
+
+Using a combination of the asynchronous servlet API and an asynchronous http client, the server is able to release the
+request thread back to the thread pool (shown in green) while waiting for the response from the Google service. The thread can be reused to handle other
+requests during the wait, which greatly reduces the number of threads required and server resources.
+
+
+
+
+
+
Synchronous
+
+
+
+
+
+
+
+
+
+
+
+
Asynchronous
+
+
+
+
+
+
+
+
+
+
+
+
Effects of Synchronous Vs Asynchronous processing
+
+
+
+
+
+
+
diff --git a/flexible/java-8/cloudsql/README.md b/flexible/java-8/cloudsql/README.md
new file mode 100644
index 00000000000..544379cf59a
--- /dev/null
+++ b/flexible/java-8/cloudsql/README.md
@@ -0,0 +1,50 @@
+# Cloud SQL sample for Google App Engine Flexible
+
+
+
+
+This sample demonstrates how to use [Cloud SQL](https://cloud.google.com/cloudsql/) on Google App
+Engine Flexible
+
+## Setup
+
+* If you haven't already, Download and initialize the [Cloud SDK](https://cloud.google.com/sdk/)
+
+ `gcloud init`
+
+* If you haven't already, Create an App Engine app within the current Google Cloud Project
+
+ `gcloud app create`
+
+* If you haven't already, Setup
+[Application Default Credentials](https://developers.google.com/identity/protocols/application-default-credentials)
+
+ `gcloud auth application-default login`
+
+* [Create an instance](https://cloud.google.com/sql/docs/mysql/create-instance)
+
+* [Create a Database](https://cloud.google.com/sql/docs/mysql/create-manage-databases)
+
+* [Create a user](https://cloud.google.com/sql/docs/mysql/create-manage-users)
+
+* Note the **Instance connection name** under Overview > properties
+
+Looks like: `projectID:region:instance`
+
+## Running locally
+
+```bash
+$ mvn clean jetty:run -DINSTANCE_CONNECTION_NAME=instanceConnectionName -Duser=root -Dpassword=myPassword -Ddatabase=myDatabase
+```
+
+## Deploying
+
+```bash
+$ mvn clean package appengine:deploy -DINSTANCE_CONNECTION_NAME=instanceConnectionName -Duser=root -Dpassword=myPassword -Ddatabase=myDatabase
+```
+
+
+## Cleaning up
+
+* [Delete your Instance](https://cloud.google.com/sql/docs/mysql/delete-instance)
+
diff --git a/flexible/java-8/cloudsql/pom.xml b/flexible/java-8/cloudsql/pom.xml
new file mode 100644
index 00000000000..08ce5167830
--- /dev/null
+++ b/flexible/java-8/cloudsql/pom.xml
@@ -0,0 +1,124 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-cloudsql
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+
+
+ Project:Region:Instance
+ root
+ myPassword
+ sqldemo
+
+ 1.8
+ 1.8
+
+ false
+
+ 9.4.44.v20210927
+
+ jdbc:mysql://google/${database}?cloudSqlInstance=${INSTANCE_CONNECTION_NAME}&socketFactory=com.google.cloud.sql.mysql.SocketFactory&user=${user}&password=${password}&useSSL=false
+
+
+
+
+
+ com.google.api-client
+ google-api-client
+ 2.0.0
+
+
+ com.google.api-client
+ google-api-client-appengine
+ 2.1.1
+
+
+ com.google.api-client
+ google-api-client-servlet
+ 2.1.1
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+ mysql
+ mysql-connector-java
+ 8.0.31
+
+
+ com.google.cloud.sql
+ mysql-socket-factory-connector-j-6
+ 1.2.1
+
+
+
+
+
+
+
+ src/main/resources
+ true
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.4.4
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/cloudsql/src/main/appengine/app.yaml b/flexible/java-8/cloudsql/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..ca251053293
--- /dev/null
+++ b/flexible/java-8/cloudsql/src/main/appengine/app.yaml
@@ -0,0 +1,24 @@
+# Copyright 2016 Google 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
+#
+# 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.
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+automatic_scaling:
+ min_num_instances: 1
+ max_num_instances: 2
diff --git a/flexible/java-8/cloudsql/src/main/java/com/example/cloudsql/CloudSqlServlet.java b/flexible/java-8/cloudsql/src/main/java/com/example/cloudsql/CloudSqlServlet.java
new file mode 100644
index 00000000000..d979e4f5f36
--- /dev/null
+++ b/flexible/java-8/cloudsql/src/main/java/com/example/cloudsql/CloudSqlServlet.java
@@ -0,0 +1,128 @@
+/*
+ * Copyright 2016 Google 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
+ *
+ * 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.cloudsql;
+
+import com.google.common.base.Stopwatch;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.net.Inet4Address;
+import java.net.Inet6Address;
+import java.net.InetAddress;
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.sql.Timestamp;
+import java.util.Date;
+import java.util.Properties;
+import java.util.concurrent.TimeUnit;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+// [START gae_flex_mysql_app]
+@SuppressWarnings("serial")
+@WebServlet(name = "cloudsql", value = "")
+public class CloudSqlServlet extends HttpServlet {
+ Connection conn;
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ final String createTableSql =
+ "CREATE TABLE IF NOT EXISTS visits ( visit_id INT NOT NULL "
+ + "AUTO_INCREMENT, user_ip VARCHAR(46) NOT NULL, timestamp DATETIME NOT NULL, "
+ + "PRIMARY KEY (visit_id) )";
+ final String createVisitSql = "INSERT INTO visits (user_ip, timestamp) VALUES (?, ?)";
+ final String selectSql =
+ "SELECT user_ip, timestamp FROM visits ORDER BY timestamp DESC " + "LIMIT 10";
+
+ String path = req.getRequestURI();
+ if (path.startsWith("/favicon.ico")) {
+ return; // ignore the request for favicon.ico
+ }
+
+ PrintWriter out = resp.getWriter();
+ resp.setContentType("text/plain");
+
+ // store only the first two octets of a users ip address
+ String userIp = req.getRemoteAddr();
+ InetAddress address = InetAddress.getByName(userIp);
+ if (address instanceof Inet6Address) {
+ // nest indexOf calls to find the second occurrence of a character in a string
+ // an alternative is to use Apache Commons Lang: StringUtils.ordinalIndexOf()
+ userIp = userIp.substring(0, userIp.indexOf(":", userIp.indexOf(":") + 1)) + ":*:*:*:*:*:*";
+ } else if (address instanceof Inet4Address) {
+ userIp = userIp.substring(0, userIp.indexOf(".", userIp.indexOf(".") + 1)) + ".*.*";
+ }
+
+ Stopwatch stopwatch = Stopwatch.createStarted();
+ try (PreparedStatement statementCreateVisit = conn.prepareStatement(createVisitSql)) {
+ conn.createStatement().executeUpdate(createTableSql);
+ statementCreateVisit.setString(1, userIp);
+ statementCreateVisit.setTimestamp(2, new Timestamp(new Date().getTime()));
+ statementCreateVisit.executeUpdate();
+
+ try (ResultSet rs = conn.prepareStatement(selectSql).executeQuery()) {
+ stopwatch.stop();
+ out.print("Last 10 visits:\n");
+ while (rs.next()) {
+ String savedIp = rs.getString("user_ip");
+ String timeStamp = rs.getString("timestamp");
+ out.print("Time: " + timeStamp + " Addr: " + savedIp + "\n");
+ }
+ out.println("Elapsed: " + stopwatch.elapsed(TimeUnit.MILLISECONDS));
+ }
+ } catch (SQLException e) {
+ throw new ServletException("SQL error", e);
+ }
+ }
+
+ @Override
+ public void init() throws ServletException {
+ try {
+ String url;
+
+ Properties properties = new Properties();
+ try {
+ properties.load(
+ getServletContext().getResourceAsStream("/WEB-INF/classes/config.properties"));
+ url = properties.getProperty("sqlUrl");
+ } catch (IOException e) {
+ log("no property", e); // Servlet Init should never fail.
+ return;
+ }
+
+ log("connecting to: " + url);
+ try {
+ Class.forName("com.mysql.jdbc.Driver");
+ conn = DriverManager.getConnection(url);
+ } catch (ClassNotFoundException e) {
+ throw new ServletException("Error loading JDBC Driver", e);
+ } catch (SQLException e) {
+ throw new ServletException("Unable to connect to PostGre", e);
+ }
+
+ } finally {
+ // Nothing really to do here.
+ }
+ }
+}
+// [END gae_flex_mysql_app]
diff --git a/flexible/java-8/cloudsql/src/main/resources/config.properties b/flexible/java-8/cloudsql/src/main/resources/config.properties
new file mode 100644
index 00000000000..8ca6f55071f
--- /dev/null
+++ b/flexible/java-8/cloudsql/src/main/resources/config.properties
@@ -0,0 +1,17 @@
+# Copyright 2015 Google 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
+#
+# 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_flex_mysql_config_properties]
+sqlUrl=${sqlURL}
+# [END gae_flex_mysql_config_properties]
diff --git a/flexible/java-8/cloudstorage/README.md b/flexible/java-8/cloudstorage/README.md
new file mode 100644
index 00000000000..986d2d6621a
--- /dev/null
+++ b/flexible/java-8/cloudstorage/README.md
@@ -0,0 +1,29 @@
+# Cloud Storage sample for Google Managed VMs
+
+
+
+
+This sample demonstrates how to use [Cloud Storage](https://cloud.google.com/storage/) on Google Managed VMs.
+
+## Setup
+Before you can run or deploy the sample, you will need to do the following:
+
+1. Enable the Cloud Storage API in the [Google Developers Console](https://console.developers.google.com/project/_/apiui/apiview/storage/overview).
+2. Create a Cloud Storage Bucket. You can do this with the [Google Cloud SDK](https://cloud.google.com/sdk) using the following command:
+
+ ```
+ $ gsutil mb gs://[your-bucket-name]
+ ```
+3. Set the default ACL on your bucket to public read in order to serve files directly from Cloud Storage. You can do this with the [Google Cloud SDK](https://cloud.google.com/sdk) using the following command:
+
+ ```
+ $ gsutil defacl set public-read gs://[your-bucket-name]
+ ```
+4. Update the bucket name in `src/main/appengine/app.yaml`. This makes the bucket name an environment variable in deployment. You still need to set the environment variable when running locally, as shown below.
+
+## Running locally
+ $ export BUCKET_NAME=[your-bucket-name]
+ $ mvn clean jetty:run
+
+## Deploying
+ $ mvn clean package appengine:deploy
diff --git a/flexible/java-8/cloudstorage/pom.xml b/flexible/java-8/cloudstorage/pom.xml
new file mode 100644
index 00000000000..d8fd3192b71
--- /dev/null
+++ b/flexible/java-8/cloudstorage/pom.xml
@@ -0,0 +1,100 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-cloudstorage
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+
+
+
+ com.google.cloud
+ libraries-bom
+ 26.1.4
+ pom
+ import
+
+
+
+
+
+
+ com.google.cloud
+ google-cloud-storage
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/cloudstorage/src/main/appengine/app.yaml b/flexible/java-8/cloudstorage/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..7182c9dd636
--- /dev/null
+++ b/flexible/java-8/cloudstorage/src/main/appengine/app.yaml
@@ -0,0 +1,23 @@
+# Copyright 2023 Google 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
+#
+# 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.
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+env_variables:
+ BUCKET_NAME: YOUR-BUCKET-NAME
diff --git a/flexible/java-8/cloudstorage/src/main/java/com/example/cloudstorage/UploadServlet.java b/flexible/java-8/cloudstorage/src/main/java/com/example/cloudstorage/UploadServlet.java
new file mode 100644
index 00000000000..594893aff75
--- /dev/null
+++ b/flexible/java-8/cloudstorage/src/main/java/com/example/cloudstorage/UploadServlet.java
@@ -0,0 +1,68 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.cloudstorage;
+
+import com.google.cloud.storage.Acl;
+import com.google.cloud.storage.Blob;
+import com.google.cloud.storage.BlobInfo;
+import com.google.cloud.storage.Storage;
+import com.google.cloud.storage.StorageOptions;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.MultipartConfig;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import javax.servlet.http.Part;
+
+// [START gae_flex_storage_app]
+@SuppressWarnings("serial")
+@WebServlet(name = "upload", value = "/upload")
+@MultipartConfig()
+public class UploadServlet extends HttpServlet {
+
+ private static final String BUCKET_NAME = System.getenv("BUCKET_NAME");
+ private static Storage storage = null;
+
+ @Override
+ public void init() {
+ storage = StorageOptions.getDefaultInstance().getService();
+ }
+
+ @Override
+ public void doPost(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ final Part filePart = req.getPart("file");
+ final String fileName = filePart.getSubmittedFileName();
+
+ // Modify access list to allow all users with link to read file
+ List acls = new ArrayList<>();
+ acls.add(Acl.of(Acl.User.ofAllUsers(), Acl.Role.READER));
+ // the inputstream is closed by default, so we don't need to close it here
+ Blob blob =
+ storage.create(
+ BlobInfo.newBuilder(BUCKET_NAME, fileName).setAcl(acls).build(),
+ filePart.getInputStream());
+
+ // return the public download link
+ resp.getWriter().print(blob.getMediaLink());
+ }
+}
+// [END gae_flex_storage_app]
diff --git a/flexible/java-8/cloudstorage/src/main/webapp/index.html b/flexible/java-8/cloudstorage/src/main/webapp/index.html
new file mode 100644
index 00000000000..4d541565e96
--- /dev/null
+++ b/flexible/java-8/cloudstorage/src/main/webapp/index.html
@@ -0,0 +1,25 @@
+
+
+
+ Google Managed VMs Cloud Storage Sample
+
+
Select a file to upload to your Google Cloud Storage bucket.
+
+
+
diff --git a/flexible/java-8/cron/README.md b/flexible/java-8/cron/README.md
new file mode 100644
index 00000000000..ca818920fa0
--- /dev/null
+++ b/flexible/java-8/cron/README.md
@@ -0,0 +1,15 @@
+# App Engine Cron Service sample for Google App Engine
+
+
+
+
+This sample demonstrates how to deploy App Engine Cron Service to ping a servlet deployed in the app.
+
+## Running locally
+ $ mvn jetty:run
+
+## Deploying app
+ $ mvn package appengine:deploy
+
+## Deploying cron job
+ $ gcloud app deploy cron.yaml
diff --git a/flexible/java-8/cron/pom.xml b/flexible/java-8/cron/pom.xml
new file mode 100644
index 00000000000..ae4720f71ba
--- /dev/null
+++ b/flexible/java-8/cron/pom.xml
@@ -0,0 +1,79 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.managedvms
+ managed-vms-cron
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/cron/src/main/appengine/app.yaml b/flexible/java-8/cron/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..e3db20c1c78
--- /dev/null
+++ b/flexible/java-8/cron/src/main/appengine/app.yaml
@@ -0,0 +1,21 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
diff --git a/flexible/java-8/cron/src/main/appengine/cron.yaml b/flexible/java-8/cron/src/main/appengine/cron.yaml
new file mode 100644
index 00000000000..369e08e6939
--- /dev/null
+++ b/flexible/java-8/cron/src/main/appengine/cron.yaml
@@ -0,0 +1,19 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+cron:
+ - description: sample cron job
+ url: /cron
+ schedule: every 1 mins
\ No newline at end of file
diff --git a/flexible/java-8/cron/src/main/java/com/example/cron/CronServlet.java b/flexible/java-8/cron/src/main/java/com/example/cron/CronServlet.java
new file mode 100644
index 00000000000..556904e4569
--- /dev/null
+++ b/flexible/java-8/cron/src/main/java/com/example/cron/CronServlet.java
@@ -0,0 +1,35 @@
+/*
+ * Copyright 2016 Google 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
+ *
+ * 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.cron;
+
+import java.io.IOException;
+import java.io.PrintWriter;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+@WebServlet(name = "cron", value = "/cron")
+@SuppressWarnings("serial")
+public class CronServlet extends HttpServlet {
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
+ PrintWriter out = resp.getWriter();
+ out.println("Hello from cron!");
+ }
+}
diff --git a/flexible/java-8/datastore/pom.xml b/flexible/java-8/datastore/pom.xml
new file mode 100644
index 00000000000..ea2e499e23b
--- /dev/null
+++ b/flexible/java-8/datastore/pom.xml
@@ -0,0 +1,100 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-datastore
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+
+
+
+ com.google.cloud
+ libraries-bom
+ 26.1.4
+ pom
+ import
+
+
+
+
+
+
+ com.google.cloud
+ google-cloud-datastore
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/datastore/src/main/appengine/app.yaml b/flexible/java-8/datastore/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..da7604717b7
--- /dev/null
+++ b/flexible/java-8/datastore/src/main/appengine/app.yaml
@@ -0,0 +1,21 @@
+# Copyright 2016 Google 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
+#
+# 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.
+#
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
diff --git a/flexible/java-8/datastore/src/main/java/com/example/datastore/DatastoreServlet.java b/flexible/java-8/datastore/src/main/java/com/example/datastore/DatastoreServlet.java
new file mode 100644
index 00000000000..a6ab66b9eb1
--- /dev/null
+++ b/flexible/java-8/datastore/src/main/java/com/example/datastore/DatastoreServlet.java
@@ -0,0 +1,87 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.managedvms.datastore;
+
+import com.google.cloud.Timestamp;
+import com.google.cloud.datastore.Datastore;
+import com.google.cloud.datastore.DatastoreOptions;
+import com.google.cloud.datastore.Entity;
+import com.google.cloud.datastore.FullEntity;
+import com.google.cloud.datastore.IncompleteKey;
+import com.google.cloud.datastore.KeyFactory;
+import com.google.cloud.datastore.Query;
+import com.google.cloud.datastore.QueryResults;
+import com.google.cloud.datastore.StructuredQuery;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.net.Inet4Address;
+import java.net.Inet6Address;
+import java.net.InetAddress;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+// [START gae_flex_datastore_app]
+@SuppressWarnings("serial")
+@WebServlet(name = "datastore", value = "")
+public class DatastoreServlet extends HttpServlet {
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ // store only the first two octets of a users ip address
+ String userIp = req.getRemoteAddr();
+ InetAddress address = InetAddress.getByName(userIp);
+ if (address instanceof Inet6Address) {
+ // nest indexOf calls to find the second occurrence of a character in a string
+ // an alternative is to use Apache Commons Lang: StringUtils.ordinalIndexOf()
+ userIp = userIp.substring(0, userIp.indexOf(":", userIp.indexOf(":") + 1)) + ":*:*:*:*:*:*";
+ } else if (address instanceof Inet4Address) {
+ userIp = userIp.substring(0, userIp.indexOf(".", userIp.indexOf(".") + 1)) + ".*.*";
+ }
+
+ Datastore datastore = DatastoreOptions.getDefaultInstance().getService();
+ KeyFactory keyFactory = datastore.newKeyFactory().setKind("visit");
+ IncompleteKey key = keyFactory.setKind("visit").newKey();
+
+ // Record a visit to the datastore, storing the IP and timestamp.
+ FullEntity curVisit =
+ FullEntity.newBuilder(key).set("user_ip", userIp).set("timestamp", Timestamp.now()).build();
+ datastore.add(curVisit);
+
+ // Retrieve the last 10 visits from the datastore, ordered by timestamp.
+ Query query =
+ Query.newEntityQueryBuilder()
+ .setKind("visit")
+ .setOrderBy(StructuredQuery.OrderBy.desc("timestamp"))
+ .setLimit(10)
+ .build();
+ QueryResults results = datastore.run(query);
+
+ resp.setContentType("text/plain");
+ PrintWriter out = resp.getWriter();
+ out.print("Last 10 visits:\n");
+ while (results.hasNext()) {
+ Entity entity = results.next();
+ out.format(
+ "Time: %s Addr: %s\n", entity.getTimestamp("timestamp"), entity.getString("user_ip"));
+ }
+ }
+}
+// [END gae_flex_datastore_app]
diff --git a/flexible/java-8/disk/pom.xml b/flexible/java-8/disk/pom.xml
new file mode 100644
index 00000000000..c3f372af888
--- /dev/null
+++ b/flexible/java-8/disk/pom.xml
@@ -0,0 +1,78 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-disk
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/disk/src/main/appengine/app.yaml b/flexible/java-8/disk/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..e3db20c1c78
--- /dev/null
+++ b/flexible/java-8/disk/src/main/appengine/app.yaml
@@ -0,0 +1,21 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
diff --git a/flexible/java-8/disk/src/main/java/com/example/disk/DiskServlet.java b/flexible/java-8/disk/src/main/java/com/example/disk/DiskServlet.java
new file mode 100644
index 00000000000..82a03178d1f
--- /dev/null
+++ b/flexible/java-8/disk/src/main/java/com/example/disk/DiskServlet.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.disk;
+
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.net.Inet4Address;
+import java.net.Inet6Address;
+import java.net.InetAddress;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.nio.file.StandardOpenOption;
+import java.util.List;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+@SuppressWarnings("serial")
+@WebServlet(name = "disk", value = "")
+public class DiskServlet extends HttpServlet {
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
+ // store only the first two octets of a users ip address
+ String userIp = req.getRemoteAddr();
+ InetAddress address = InetAddress.getByName(userIp);
+ if (address instanceof Inet6Address) {
+ // nest indexOf calls to find the second occurrence of a character in a string
+ // an alternative is to use Apache Commons Lang: StringUtils.ordinalIndexOf()
+ userIp = userIp.substring(0, userIp.indexOf(":", userIp.indexOf(":") + 1)) + ":*:*:*:*:*:*";
+ } else if (address instanceof Inet4Address) {
+ userIp = userIp.substring(0, userIp.indexOf(".", userIp.indexOf(".") + 1)) + ".*.*";
+ }
+ Path tmpFile = Paths.get("/tmp/seen.txt");
+ Files.write(
+ tmpFile, (userIp + "\n").getBytes(), StandardOpenOption.CREATE, StandardOpenOption.APPEND);
+ StringBuffer sb = new StringBuffer();
+ List strings = Files.readAllLines(tmpFile, StandardCharsets.US_ASCII);
+ for (String s : strings) {
+ sb.append(s + "\n");
+ }
+
+ String instanceId =
+ System.getenv().containsKey("GAE_INSTANCE") ? System.getenv("GAE_INSTANCE") : "1";
+ PrintWriter out = resp.getWriter();
+ resp.setContentType("text/plain");
+ out.print("Instance: " + instanceId + "\nSeen:\n" + sb.toString());
+ }
+}
diff --git a/flexible/java-8/errorreporting/README.md b/flexible/java-8/errorreporting/README.md
new file mode 100644
index 00000000000..3d72c906720
--- /dev/null
+++ b/flexible/java-8/errorreporting/README.md
@@ -0,0 +1,54 @@
+# Error reporting sample for Google App Engine Flexible
+
+
+
+
+[Stackdriver Error Reporting][error-reporting] Stackdriver Error Reporting counts, analyzes and aggregates the crashes in your running cloud services.
+A [centralized error management interface](https://console.cloud.google.com/errors) displays the results with sorting and filtering capabilities.
+
+This sample Java application demonstrates how errors are automatically sent to Error reporting in applications running in [App Engine Flex environment][ae-flex].
+It also demonstrates how to send custom error events using the Error Reporting API.
+
+[error-reporting]: https://cloud.google.com/error-reporting/
+[ae-flex]: https://cloud.google.com/appengine/docs/flexible/java
+[google-cloud-java]: https://github.com/GoogleCloudPlatform/google-cloud-java
+
+## Setup
+
+1. Install [Maven](http://maven.apache.org/).
+1. Install and initialize [GCloud SDK](https://cloud.google.com/sdk/downloads).
+1. [Enable](https://console.cloud.google.com/apis/api/clouderrorreporting.googleapis.com/overview) Stack Driver Error Reporting API.
+(Note : only required for logging custom events using the Error Reporting API)
+
+## Build
+Build your project with:
+```
+ mvn clean package
+```
+
+## Local testing
+[Create a service account](https://cloud.google.com/docs/authentication/getting-started#creating_the_service_account)
+and set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable.
+
+For local testing, we will be using the [Jetty Maven plugin](http://www.eclipse.org/jetty/documentation/9.4.x/jetty-maven-plugin.html).
+Run:
+```
+ mvn jetty:run
+```
+Access [http://localhost:8080/error](http://localhost:8080/error) endpoint.
+
+After accessing the `/error` endpoint, check the [error reporting console](https://console.cloud.google.com/errors).
+Confirm that you see the custom error reported using the error reporting API.
+
+## Deploy
+Run:
+```
+ mvn clean package appengine:deploy
+```
+Access [https://YOUR_PROJECT_ID.appspot.com/error] endpoint.
+
+After accessing the `/error` endpoint, check the [error reporting console](https://console.cloud.google.com/errors).
+Confirm that you see:
+1. IllegalArgumentException logged via the standard logging framework.
+1. Custom error reported using the error reporting API.
+1. Runtime exception.
diff --git a/flexible/java-8/errorreporting/pom.xml b/flexible/java-8/errorreporting/pom.xml
new file mode 100644
index 00000000000..1a8d85004bd
--- /dev/null
+++ b/flexible/java-8/errorreporting/pom.xml
@@ -0,0 +1,81 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-error-reporting
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 2.4.3
+ 1.8
+ 1.8
+ false
+ 9.4.44.v20210927
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+ com.google.cloud
+ google-cloud-errorreporting
+ 0.117.0-beta
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty.maven.plugin}
+
+
+
+
diff --git a/flexible/java-8/errorreporting/src/main/appengine/app.yaml b/flexible/java-8/errorreporting/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..3aa2bc7c367
--- /dev/null
+++ b/flexible/java-8/errorreporting/src/main/appengine/app.yaml
@@ -0,0 +1,18 @@
+# Copyright 2017 Google 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
+#
+# 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.
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
diff --git a/flexible/java-8/errorreporting/src/main/java/com/example/flexible/errorreporting/ErrorReportingExample.java b/flexible/java-8/errorreporting/src/main/java/com/example/flexible/errorreporting/ErrorReportingExample.java
new file mode 100644
index 00000000000..a00c68463cc
--- /dev/null
+++ b/flexible/java-8/errorreporting/src/main/java/com/example/flexible/errorreporting/ErrorReportingExample.java
@@ -0,0 +1,82 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.errorreporting;
+
+import com.google.cloud.ServiceOptions;
+import com.google.cloud.errorreporting.v1beta1.ReportErrorsServiceClient;
+import com.google.devtools.clouderrorreporting.v1beta1.ErrorContext;
+import com.google.devtools.clouderrorreporting.v1beta1.ProjectName;
+import com.google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent;
+import com.google.devtools.clouderrorreporting.v1beta1.SourceLocation;
+import java.io.IOException;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+// [START error_reporting_setup_java_appengine_flex]
+@WebServlet(name = "Error reporting", value = "/error")
+public class ErrorReportingExample extends HttpServlet {
+
+ private Logger logger = Logger.getLogger(ErrorReportingExample.class.getName());
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+
+ // errors logged to stderr / Cloud logging with exceptions are automatically reported.
+ logger.log(Level.SEVERE, "exception using log framework", new IllegalArgumentException());
+
+ // use the error-reporting client library only if you require logging custom error events.
+ logCustomErrorEvent();
+
+ // runtime exceptions are also automatically reported.
+ throw new RuntimeException("this is a runtime exception");
+ }
+
+ private void logCustomErrorEvent() {
+ try (ReportErrorsServiceClient reportErrorsServiceClient = ReportErrorsServiceClient.create()) {
+ // Custom error events require an error reporting location as well.
+ ErrorContext errorContext =
+ ErrorContext.newBuilder()
+ .setReportLocation(
+ SourceLocation.newBuilder()
+ .setFilePath("Test.java")
+ .setLineNumber(10)
+ .setFunctionName("myMethod")
+ .build())
+ .build();
+ // Report a custom error event
+ ReportedErrorEvent customErrorEvent =
+ ReportedErrorEvent.getDefaultInstance()
+ .toBuilder()
+ .setMessage("custom error event")
+ .setContext(errorContext)
+ .build();
+
+ // default project id
+ ProjectName projectName = ProjectName.of(ServiceOptions.getDefaultProjectId());
+ reportErrorsServiceClient.reportErrorEvent(projectName, customErrorEvent);
+ } catch (Exception e) {
+ logger.log(Level.SEVERE, "Exception encountered logging custom event", e);
+ }
+ }
+}
+// [END error_reporting_setup_java_appengine_flex]
diff --git a/flexible/java-8/extending-runtime/README.md b/flexible/java-8/extending-runtime/README.md
new file mode 100644
index 00000000000..fdb535c4c63
--- /dev/null
+++ b/flexible/java-8/extending-runtime/README.md
@@ -0,0 +1,7 @@
+# Java extending runtime sample for Google App Engine Flexible
+
+
+
+
+This sample demonstrates how to use custom runtime on Google App Engine Flexible
+
diff --git a/flexible/java-8/extending-runtime/pom.xml b/flexible/java-8/extending-runtime/pom.xml
new file mode 100644
index 00000000000..a7d1d9a47c1
--- /dev/null
+++ b/flexible/java-8/extending-runtime/pom.xml
@@ -0,0 +1,78 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ extendingruntime
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/extending-runtime/src/main/appengine/Dockerfile b/flexible/java-8/extending-runtime/src/main/appengine/Dockerfile
new file mode 100644
index 00000000000..615a09b398a
--- /dev/null
+++ b/flexible/java-8/extending-runtime/src/main/appengine/Dockerfile
@@ -0,0 +1,19 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+FROM gcr.io/google_appengine/jetty9
+
+RUN apt-get update && apt-get install -y fortunes
+ADD extendingruntime-1.0-SNAPSHOT.war $JETTY_BASE/webapps/root.war
diff --git a/flexible/java-8/extending-runtime/src/main/appengine/app.yaml b/flexible/java-8/extending-runtime/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..418be6c29ef
--- /dev/null
+++ b/flexible/java-8/extending-runtime/src/main/appengine/app.yaml
@@ -0,0 +1,21 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+runtime: custom
+env: flexible
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
diff --git a/flexible/java-8/extending-runtime/src/main/java/com/example/extendingruntime/FortuneServlet.java b/flexible/java-8/extending-runtime/src/main/java/com/example/extendingruntime/FortuneServlet.java
new file mode 100644
index 00000000000..73851b70e0d
--- /dev/null
+++ b/flexible/java-8/extending-runtime/src/main/java/com/example/extendingruntime/FortuneServlet.java
@@ -0,0 +1,63 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.extendingruntime;
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileReader;
+import java.io.IOException;
+import java.io.PrintWriter;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+@SuppressWarnings("serial")
+@WebServlet(name = "fortune", value = "")
+public class FortuneServlet extends HttpServlet {
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
+ PrintWriter out = resp.getWriter();
+ String fortune = getFortune();
+ out.println(fortune);
+ }
+
+ private String getFortune() throws IOException {
+ File fort = new File("/usr/games/fortune");
+ if (!fort.exists()) {
+ return "It seems that the /usr/games/fortune application is not installed on your system.";
+ }
+ ProcessBuilder pb = new ProcessBuilder(fort.getAbsolutePath());
+ File file = File.createTempFile("tmp_fortune", null);
+ pb.redirectOutput(file);
+ Process process = pb.start();
+ try {
+ process.waitFor();
+ } catch (InterruptedException ex) {
+ return ex.getMessage();
+ }
+ String fortune = "";
+ String line;
+ BufferedReader br = new BufferedReader(new FileReader(file));
+ while ((line = br.readLine()) != null) {
+ fortune = fortune + " " + line;
+ }
+ br.close();
+ return fortune;
+ }
+}
diff --git a/flexible/java-8/gaeinfo/README.md b/flexible/java-8/gaeinfo/README.md
new file mode 100644
index 00000000000..7fc3f610dd4
--- /dev/null
+++ b/flexible/java-8/gaeinfo/README.md
@@ -0,0 +1,55 @@
+# Google App Engine Information
+
+
+
+
+## WARNING - this version runs on App Engine Flexible using the deprecated COMPAT runtime.
+## Most users will prefer to use the Metadata example for flex (in progress)
+This sample displays what's going on in your app. It dumps the environment and lots more.
+
+See the [Google App Engine standard environment documentation][ae-docs] for more
+detailed instructions.
+
+[ae-docs]: https://cloud.google.com/appengine/docs/java/
+
+## Setup
+
+Use either:
+
+* `gcloud init`
+* `gcloud auth application-default login`
+
+## Maven
+### Running locally
+
+ $ mvn appengine:run
+
+### Deploying
+
+ $ mvn clean package appengine:deploy
+
+
diff --git a/flexible/java-8/gaeinfo/pom.xml b/flexible/java-8/gaeinfo/pom.xml
new file mode 100644
index 00000000000..0283dc5c416
--- /dev/null
+++ b/flexible/java-8/gaeinfo/pom.xml
@@ -0,0 +1,108 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.appengine
+ gaeinfo-flex-compat
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+
+
+
+ com.google.appengine
+ appengine-api-1.0-sdk
+ 2.0.5
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+ com.squareup.okhttp3
+ okhttp
+ 4.9.3
+
+
+
+ com.google.code.gson
+ gson
+ 2.10
+
+
+
+ org.thymeleaf
+ thymeleaf
+ 3.1.1.RELEASE
+
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+
+
+ ${basedir}/src/main/webapp/WEB-INF
+ true
+ WEB-INF
+
+
+
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.4.4
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+ true
+ true
+
+
+
+
+
+
diff --git a/flexible/java-8/gaeinfo/src/main/java/com/example/appengine/flex_compat/GaeInfoServlet.java b/flexible/java-8/gaeinfo/src/main/java/com/example/appengine/flex_compat/GaeInfoServlet.java
new file mode 100644
index 00000000000..267b18a386d
--- /dev/null
+++ b/flexible/java-8/gaeinfo/src/main/java/com/example/appengine/flex_compat/GaeInfoServlet.java
@@ -0,0 +1,238 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.
+ */
+
+// CHECKSTYLE OFF: PackageName
+
+package com.example.appengine.flexcompat;
+
+// CHECKSTYLE ON: PackageName
+
+import com.google.appengine.api.appidentity.AppIdentityService;
+import com.google.appengine.api.appidentity.AppIdentityServiceFactory;
+import com.google.appengine.api.utils.SystemProperty;
+import com.google.apphosting.api.ApiProxy;
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.google.gson.JsonParser;
+import java.io.IOException;
+import java.util.Enumeration;
+import java.util.Map;
+import java.util.Properties;
+import java.util.TreeMap;
+import java.util.concurrent.TimeUnit;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.Cookie;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+import org.thymeleaf.TemplateEngine;
+import org.thymeleaf.context.WebContext;
+import org.thymeleaf.templateresolver.WebApplicationTemplateResolver;
+import org.thymeleaf.web.servlet.JavaxServletWebApplication;
+
+@SuppressWarnings({"serial"})
+// With @WebServlet annotation the webapp/WEB-INF/web.xml is no longer required.
+@WebServlet(
+ name = "GAEInfo",
+ description = "GAEInfo: Write info about GAE Standard",
+ urlPatterns = "/gaeinfo")
+public class GaeInfoServlet extends HttpServlet {
+
+ private final String[] metaPath = {
+ "/computeMetadata/v1/project/numeric-project-id", // (pending)
+ "/computeMetadata/v1/project/project-id",
+ "/computeMetadata/v1/instance/zone",
+ "/computeMetadata/v1/instance/service-accounts/default/aliases",
+ "/computeMetadata/v1/instance/service-accounts/default/",
+ "/computeMetadata/v1/instance/service-accounts/default/scopes",
+ // Tokens work - but are a security risk to display
+ // "/computeMetadata/v1/instance/service-accounts/default/token"
+ };
+
+ final String[] metaServiceAcct = {
+ "/computeMetadata/v1/instance/service-accounts/{account}/aliases",
+ "/computeMetadata/v1/instance/service-accounts/{account}/email",
+ "/computeMetadata/v1/instance/service-accounts/{account}/scopes",
+ // Tokens work - but are a security risk to display
+ // "/computeMetadata/v1/instance/service-accounts/{account}/token"
+ };
+
+ private final String metadata = "http://metadata.google.internal";
+ private TemplateEngine templateEngine;
+ private JavaxServletWebApplication application;
+
+ // Use OkHttp from Square as it's quite easy to use for simple fetches.
+ private final OkHttpClient ok =
+ new OkHttpClient.Builder()
+ .readTimeout(500, TimeUnit.MILLISECONDS) // Don't dawdle
+ .writeTimeout(500, TimeUnit.MILLISECONDS)
+ .build();
+
+ // Setup to pretty print returned json
+ private final Gson gson = new GsonBuilder().setPrettyPrinting().create();
+
+ // Fetch Metadata
+ String fetchMetadata(String key) throws IOException {
+ try {
+ Request request =
+ new Request.Builder()
+ .url(metadata + key)
+ .addHeader("Metadata-Flavor", "Google")
+ .get()
+ .build();
+
+ Response response = ok.newCall(request).execute();
+ return response.body().string();
+ } catch (Exception e) {
+ log("fetchMetadata - " + metadata + key + ": ", e);
+ }
+ return "";
+ }
+
+ String fetchJsonMetadata(String prefix) throws IOException {
+ String json = "";
+ try {
+ Request request =
+ new Request.Builder()
+ .url(metadata + prefix)
+ .addHeader("Metadata-Flavor", "Google")
+ .get()
+ .build();
+
+ Response response = ok.newCall(request).execute();
+ // Convert json to prety json
+ json = response.body().string();
+ return gson.toJson(JsonParser.parseString(json));
+ } catch (Exception e) {
+ log("fetchJsonMetadata - " + metadata + prefix + " : ", e);
+ }
+ return "{}";
+ }
+
+ @Override
+ public void init() {
+ // Setup ThymeLeaf
+ application = JavaxServletWebApplication.buildApplication(this.getServletContext());
+ WebApplicationTemplateResolver templateResolver =
+ new WebApplicationTemplateResolver(application);
+
+ templateResolver.setPrefix("/WEB-INF/templates/");
+ templateResolver.setSuffix(".html");
+ templateResolver.setCacheTTLMs(Long.valueOf(1200000L)); // TTL=20m
+
+ // Cache is set to true by default. Set to false if you want templates to
+ // be automatically updated when modified.
+ templateResolver.setCacheable(true);
+
+ templateEngine = new TemplateEngine();
+ templateEngine.setTemplateResolver(templateResolver);
+ }
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
+ String key = "";
+ final AppIdentityService appIdentity = AppIdentityServiceFactory.getAppIdentityService();
+ WebContext ctx = new WebContext(application.buildExchange(req, resp));
+ ctx.setLocale(req.getLocale());
+
+ resp.setContentType("text/html");
+
+ ctx.setVariable("production", SystemProperty.environment.value().name());
+ ctx.setVariable("ServiceAccountName", appIdentity.getServiceAccountName());
+ ctx.setVariable("gcs", appIdentity.getDefaultGcsBucketName());
+
+ ctx.setVariable("appId", SystemProperty.applicationId.get());
+ ctx.setVariable("appVer", SystemProperty.applicationVersion.get());
+ ctx.setVariable("version", SystemProperty.version.get());
+ ctx.setVariable("environment", SystemProperty.environment.get());
+
+ // Environment Atributes
+ ApiProxy.Environment env = ApiProxy.getCurrentEnvironment();
+ Map attr = env.getAttributes();
+ TreeMap m = new TreeMap<>();
+
+ for (String k : attr.keySet()) {
+ Object o = attr.get(k);
+
+ if (o.getClass().getCanonicalName().equals("java.lang.String")) {
+ m.put(k, (String) o);
+ } else if (o.getClass().getCanonicalName().equals("java.lang.Boolean")) {
+ m.put(k, ((Boolean) o).toString());
+ } else {
+ m.put(k, "a " + o.getClass().getCanonicalName());
+ }
+ }
+ ctx.setVariable("attribs", m);
+
+ m = new TreeMap<>();
+ for (Enumeration e = req.getHeaderNames(); e.hasMoreElements(); ) {
+ key = e.nextElement();
+ m.put(key, req.getHeader(key));
+ }
+ ctx.setVariable("headers", m);
+
+ Cookie[] cookies = req.getCookies();
+ m = new TreeMap<>();
+ if (cookies != null && cookies.length != 0) {
+ for (Cookie co : cookies) {
+ m.put(co.getName(), co.getValue());
+ }
+ }
+ ctx.setVariable("cookies", m);
+
+ Properties properties = System.getProperties();
+ m = new TreeMap<>();
+ for (Enumeration e = properties.propertyNames(); e.hasMoreElements(); ) {
+ key = (String) e.nextElement();
+ m.put(key, (String) properties.get(key));
+ }
+ ctx.setVariable("systemprops", m);
+
+ Map envVar = System.getenv();
+ m = new TreeMap<>(envVar);
+ ctx.setVariable("envvar", m);
+
+ // The metadata server is only on a production system
+ if (SystemProperty.environment.value() == SystemProperty.Environment.Value.Production) {
+
+ m = new TreeMap<>();
+ for (String k : metaPath) {
+ m.put(k, fetchMetadata(k));
+ }
+ ctx.setVariable("Metadata", m.descendingMap());
+
+ m = new TreeMap<>();
+ for (String k : metaServiceAcct) {
+ // substitute a service account for {account}
+ k = k.replace("{account}", appIdentity.getServiceAccountName());
+ m.put(k, fetchMetadata(k));
+ }
+ ctx.setVariable("sam", m.descendingMap());
+
+ // Recursivly get all info about service accounts -- Note tokens are leftout by default.
+ ctx.setVariable(
+ "rsa",
+ fetchJsonMetadata("/computeMetadata/v1/instance/service-accounts/?recursive=true"));
+ // Recursivly get all data on Metadata server.
+ ctx.setVariable("ram", fetchJsonMetadata("/?recursive=true"));
+ }
+
+ templateEngine.process("index", ctx, resp.getWriter());
+ }
+}
diff --git a/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/appengine-web.xml b/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/appengine-web.xml
new file mode 100644
index 00000000000..260cf30d241
--- /dev/null
+++ b/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/appengine-web.xml
@@ -0,0 +1,25 @@
+
+
+
+ true
+ true
+ flex
+
+
+
+
+
diff --git a/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/templates/index.html b/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/templates/index.html
new file mode 100644
index 00000000000..8b4a61fcebc
--- /dev/null
+++ b/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/templates/index.html
@@ -0,0 +1,99 @@
+
+
+
+
+ GAE standard Metadata
+
+
+
+
AppIdentity
+
+
ServiceAccountName
+
GCS Bucket
+
+
SystemProperties
+
+
appId
+
appVer
+
version
+
environment
+
+
Environment Attributes
+
+
+
+
+
+
+
Headers
+
+
+
+
+
+
+
+
Cookies
+
+
+
+
+
+
+
+
Java SystemProperties
+
+
+
+
+
+
+
+
Envirionment Variables
+
+
+
+
+
+
+
+
+
Metadata
+
+
+
+
+
+
+
ServiceAccount Metadata
+
+
+
+
+
+
+
Recursive service-accounts
+
+
Recursive all metadata
+
+
+
No Local Metadata Server
+
+
+
diff --git a/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/web.xml b/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 00000000000..e31839a606f
--- /dev/null
+++ b/flexible/java-8/gaeinfo/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,27 @@
+
+
+
+
+ gaeinfo
+
+
diff --git a/flexible/java-8/helloworld-springboot/README.md b/flexible/java-8/helloworld-springboot/README.md
new file mode 100644
index 00000000000..d4541b8215c
--- /dev/null
+++ b/flexible/java-8/helloworld-springboot/README.md
@@ -0,0 +1,99 @@
+# Spring Boot based Hello World app
+
+This sample shows how to run a [Spring Boot][spring-boot] application on [Google
+Cloud Platform][cloud-java]. It uses the [Google App Engine flexible
+environment][App Engine-flexible].
+
+[App Engine-flexible]: https://cloud.google.com/appengine/docs/flexible/
+[cloud-java]: https://cloud.google.com/java/
+[spring-boot]: http://projects.spring.io/spring-boot/
+
+
+## Before you begin
+
+This sample assumes you have [Java 8][java8] installed.
+
+[java8]: http://www.oracle.com/technetwork/java/javase/downloads/
+
+### Download Maven
+
+These samples use the [Apache Maven][maven] build system. Before getting
+started, be sure to [download][maven-download] and [install][maven-install] it.
+When you use Maven as described here, it will automatically download the needed
+client libraries.
+
+[maven]: https://maven.apache.org
+[maven-download]: https://maven.apache.org/download.cgi
+[maven-install]: https://maven.apache.org/install.html
+
+### Create a Project in the Google Cloud Platform Console
+
+If you haven't already created a project, create one now. Projects enable you to
+manage all Google Cloud Platform resources for your app, including deployment,
+access control, billing, and services.
+
+1. Open the [Cloud Platform Console][cloud-console].
+1. In the drop-down menu at the top, select **Create a project**.
+1. Give your project a name.
+1. Make a note of the project ID, which might be different from the project
+ name. The project ID is used in commands and in configurations.
+
+[cloud-console]: https://console.cloud.google.com/
+
+### Enable billing for your project.
+
+If you haven't already enabled billing for your project, [enable
+billing][enable-billing] now. Enabling billing allows the application to
+consume billable resources such as running instances and storing data.
+
+[enable-billing]: https://console.cloud.google.com/project/_/settings
+
+### Install the Google Cloud SDK.
+
+If you haven't already installed the Google Cloud SDK, [install and initialize
+the Google Cloud SDK][cloud-sdk] now. The SDK contains tools and libraries that
+enable you to create and manage resources on Google Cloud Platform.
+
+[cloud-sdk]: https://cloud.google.com/sdk/
+
+### Install the Google App Engine SDK for Java
+
+
+```
+gcloud components update app-engine-java
+gcloud components update
+```
+
+### Configure the `app.yaml` descriptor
+
+The [`app.yaml`][app-yaml] descriptor is used to describe URL
+dispatch and resource requirements. This example sets
+[`manual_scaling`][manual-scaling] to 1 to minimize possible costs.
+These settings should be revisited for production use.
+
+[app-yaml]: https://cloud.google.com/appengine/docs/flexible/java/configuring-your-app-with-app-yaml
+[manual-scaling]: https://cloud.google.com/appengine/docs/flexible/java/configuring-your-app-with-app-yaml#manual-scaling
+
+## Run the application locally
+
+1. Set the correct Cloud SDK project via `gcloud config set project
+ YOUR_PROJECT` to the ID of your application.
+1. Run `mvn spring-boot:run`
+1. Visit http://localhost:8080
+
+
+## Deploy to App Engine flexible environment
+
+1. `mvn clean package appengine:deploy`
+
+* Note: The `projectId` property for the `appengine-maven-plugin` is set to
+"GCLOUD_CONFIG" which will deploy using the gcloud settings for `projectId`.
+
+1. Visit `http://YOUR_PROJECT.appspot.com`.
+
+Note that deployment to the App Engine flexible environment requires the new
+[`com.google.cloud.tools:appengine-maven-plugin` plugin][new-maven-plugin].
+
+[new-maven-plugin]: https://cloud.google.com/appengine/docs/flexible/java/using-maven
+
+Java is a registered trademark of Oracle Corporation and/or its affiliates.
diff --git a/flexible/java-8/helloworld-springboot/pom.xml b/flexible/java-8/helloworld-springboot/pom.xml
new file mode 100644
index 00000000000..4927b67214a
--- /dev/null
+++ b/flexible/java-8/helloworld-springboot/pom.xml
@@ -0,0 +1,91 @@
+
+
+
+ 4.0.0
+ com.example.java
+ helloworld-springboot
+ 0.0.1-SNAPSHOT
+ helloworld-springboot
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-web
+ 2.7.6
+
+
+ org.springframework.boot
+ spring-boot-starter-actuator
+ 2.7.6
+
+
+ org.springframework.boot
+ spring-boot-starter-test
+ 2.7.6
+ test
+
+
+ org.junit.vintage
+ junit-vintage-engine
+
+
+
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+ 2.7.6
+
+
+
+ repackage
+
+
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.4.4
+
+
+ GCLOUD_CONFIG
+
+ GCLOUD_CONFIG
+
+
+
+
+
diff --git a/flexible/java-8/helloworld-springboot/src/main/appengine/app.yaml b/flexible/java-8/helloworld-springboot/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..c8b7b395422
--- /dev/null
+++ b/flexible/java-8/helloworld-springboot/src/main/appengine/app.yaml
@@ -0,0 +1,30 @@
+# [START_EXCLUDE]
+# Copyright 2015 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.
+# [END_EXCLUDE]
+#
+# This sample has manual_scaling set to 1.
+#
+runtime: java
+env: flex
+
+runtime_config: # Optional
+ jdk: openjdk8
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+manual_scaling:
+ instances: 1
diff --git a/flexible/java-8/helloworld-springboot/src/main/java/com/example/java/HelloController.java b/flexible/java-8/helloworld-springboot/src/main/java/com/example/java/HelloController.java
new file mode 100644
index 00000000000..af9c77a4ed6
--- /dev/null
+++ b/flexible/java-8/helloworld-springboot/src/main/java/com/example/java/HelloController.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2020 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.java;
+
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+public class HelloController {
+ @RequestMapping("/")
+ String index() {
+ return "Hello World!";
+ }
+
+ /**
+ * (Optional) App Engine health check endpoint mapping.
+ *
+ * @see
+ * If your app does not handle health checks, a HTTP 404 response is interpreted as a
+ * successful reply.
+ */
+ @RequestMapping("/_ah/health")
+ public String healthy() {
+ // Message body required though ignored
+ return "Still surviving.";
+ }
+}
diff --git a/flexible/java-8/helloworld-springboot/src/main/java/com/example/java/HelloWorldApplication.java b/flexible/java-8/helloworld-springboot/src/main/java/com/example/java/HelloWorldApplication.java
new file mode 100644
index 00000000000..304222d34b6
--- /dev/null
+++ b/flexible/java-8/helloworld-springboot/src/main/java/com/example/java/HelloWorldApplication.java
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2015 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.java;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class HelloWorldApplication {
+
+ public static void main(String[] args) {
+ SpringApplication.run(HelloWorldApplication.class, args);
+ }
+}
diff --git a/flexible/java-8/helloworld-springboot/src/main/resources/application.properties b/flexible/java-8/helloworld-springboot/src/main/resources/application.properties
new file mode 100644
index 00000000000..65b5c255b54
--- /dev/null
+++ b/flexible/java-8/helloworld-springboot/src/main/resources/application.properties
@@ -0,0 +1,13 @@
+# Copyright 2015 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.
diff --git a/flexible/java-8/helloworld-springboot/src/test/java/com/example/java/HelloControllerTest.java b/flexible/java-8/helloworld-springboot/src/test/java/com/example/java/HelloControllerTest.java
new file mode 100644
index 00000000000..e0c9f1f2887
--- /dev/null
+++ b/flexible/java-8/helloworld-springboot/src/test/java/com/example/java/HelloControllerTest.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2020 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.java;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.http.MediaType;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
+
+@SpringBootTest
+@AutoConfigureMockMvc
+public class HelloControllerTest {
+
+ @Autowired private MockMvc mvc;
+
+ @Test
+ public void getHello() throws Exception {
+ mvc.perform(MockMvcRequestBuilders.get("/").accept(MediaType.APPLICATION_JSON))
+ .andExpect(status().isOk())
+ .andExpect(content().string(equalTo("Hello World!")));
+ }
+
+ @Test
+ public void getHealth() throws Exception {
+ mvc.perform(MockMvcRequestBuilders.get("/_ah/health").accept(MediaType.APPLICATION_JSON))
+ .andExpect(status().isOk())
+ .andExpect(content().string(equalTo("Still surviving.")));
+ }
+}
diff --git a/flexible/java-8/helloworld/README.md b/flexible/java-8/helloworld/README.md
new file mode 100644
index 00000000000..af7b7b2e017
--- /dev/null
+++ b/flexible/java-8/helloworld/README.md
@@ -0,0 +1,35 @@
+# Appengine Helloworld sample for Google App Engine Flexible
+
+
+
+
+This sample is used as part of the [Quickstart for Java in the App Engine Flexible Environment](https://cloud.google.com/java/getting-started/hello-world)
+
+## Setup
+
+Use either:
+
+* `gcloud init`
+* `gcloud beta auth application-default login`
+
+## Maven
+### Running locally
+
+ $ mvn clean jetty:run-exploded
+
+### Deploying
+
+ $ mvn clean package appengine:deploy
+
+## Gradle
+### Running locally
+
+ $ gradle jettyRun
+
+If you do not have gradle installed, you can run using `./gradlew appengineRun`.
+
+### Deploying
+
+ $ gradle appengineDeploy
+
+If you do not have gradle installed, you can deploy using `./gradlew appengineDeploy`.
diff --git a/flexible/java-8/helloworld/build.gradle b/flexible/java-8/helloworld/build.gradle
new file mode 100644
index 00000000000..103d2356283
--- /dev/null
+++ b/flexible/java-8/helloworld/build.gradle
@@ -0,0 +1,63 @@
+// Copyright 2016 Google 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
+//
+// 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_flex_gradle]
+buildscript { // Configuration for building
+ repositories {
+ jcenter() // Bintray's repository - a fast Maven Central mirror & more
+ mavenCentral()
+ }
+ dependencies {
+ classpath 'com.google.cloud.tools:appengine-gradle-plugin:2.4.3'
+ classpath 'org.akhikhl.gretty:gretty:+'
+ }
+}
+
+repositories { // repositories for Jar's you access in your code
+ jcenter()
+ mavenCentral()
+}
+
+apply plugin: 'java'
+apply plugin: 'war'
+apply plugin: 'org.akhikhl.gretty'
+apply plugin: 'com.google.cloud.tools.appengine'
+
+dependencies {
+ providedCompile 'javax.servlet:javax.servlet-api:3.1.0'
+ providedCompile 'com.google.appengine:appengine:+'
+// Add your dependencies here.
+
+}
+
+// [START gae_flex_gretty]
+gretty {
+ servletContainer = 'jetty9' // What App Engine Flexible uses
+}
+// [END gae_flex_gretty]
+
+// [START gae_flex_model]
+ appengine {
+ deploy { // deploy configuration
+ stopPreviousVersion = true // default - stop the current version
+ promote = true // default - & make this the current version
+ }
+ }
+// [END gae_flex_model]
+
+group = 'com.example.appengine' // Generated output GroupId
+version = '1.0-SNAPSHOT' // Version in generated output
+
+sourceCompatibility = 1.8
+targetCompatibility = 1.8
+// [END gae_flex_gradle]
diff --git a/flexible/java-8/helloworld/gradle/wrapper/gradle-wrapper.properties b/flexible/java-8/helloworld/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 00000000000..b9b590a9d94
--- /dev/null
+++ b/flexible/java-8/helloworld/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,20 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.4.2-bin.zip
diff --git a/flexible/java-8/helloworld/gradlew b/flexible/java-8/helloworld/gradlew
new file mode 100755
index 00000000000..4c0d296b4f7
--- /dev/null
+++ b/flexible/java-8/helloworld/gradlew
@@ -0,0 +1,182 @@
+#!/usr/bin/env bash
+# Copyright 2023 Google 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
+#
+# 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.
+#
+##############################################################################
+##
+## Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+ ls=`ls -ld "$PRG"`
+ link=`expr "$ls" : '.*-> \(.*\)$'`
+ if expr "$link" : '/.*' > /dev/null; then
+ PRG="$link"
+ else
+ PRG=`dirname "$PRG"`"/$link"
+ fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS=""
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn ( ) {
+ echo "$*"
+}
+
+die ( ) {
+ echo
+ echo "$*"
+ echo
+ exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+ CYGWIN* )
+ cygwin=true
+ ;;
+ Darwin* )
+ darwin=true
+ ;;
+ MINGW* )
+ msys=true
+ ;;
+ NONSTOP* )
+ nonstop=true
+ ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD="$JAVA_HOME/jre/sh/java"
+ else
+ JAVACMD="$JAVA_HOME/bin/java"
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD="java"
+ which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+ MAX_FD_LIMIT=`ulimit -H -n`
+ if [ $? -eq 0 ] ; then
+ if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+ MAX_FD="$MAX_FD_LIMIT"
+ fi
+ ulimit -n $MAX_FD
+ if [ $? -ne 0 ] ; then
+ warn "Could not set maximum file descriptor limit: $MAX_FD"
+ fi
+ else
+ warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+ fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+ GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin ; then
+ APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+ CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+ JAVACMD=`cygpath --unix "$JAVACMD"`
+
+ # We build the pattern for arguments to be converted via cygpath
+ ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+ SEP=""
+ for dir in $ROOTDIRSRAW ; do
+ ROOTDIRS="$ROOTDIRS$SEP$dir"
+ SEP="|"
+ done
+ OURCYGPATTERN="(^($ROOTDIRS))"
+ # Add a user-defined pattern to the cygpath arguments
+ if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+ OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+ fi
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ i=0
+ for arg in "$@" ; do
+ CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+ CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
+
+ if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
+ eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+ else
+ eval `echo args$i`="\"$arg\""
+ fi
+ i=$((i+1))
+ done
+ case $i in
+ (0) set -- ;;
+ (1) set -- "$args0" ;;
+ (2) set -- "$args0" "$args1" ;;
+ (3) set -- "$args0" "$args1" "$args2" ;;
+ (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+ (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+ (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+ (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+ (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+ (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+ esac
+fi
+
+# Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules
+function splitJvmOpts() {
+ JVM_OPTS=("$@")
+}
+eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS
+JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME"
+
+# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
+if [[ "$(uname)" == "Darwin" ]] && [[ "$HOME" == "$PWD" ]]; then
+ cd "$(dirname "$0")"
+fi
+
+exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@"
diff --git a/flexible/java-8/helloworld/gradlew.bat b/flexible/java-8/helloworld/gradlew.bat
new file mode 100644
index 00000000000..e95643d6a2c
--- /dev/null
+++ b/flexible/java-8/helloworld/gradlew.bat
@@ -0,0 +1,84 @@
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS=
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto init
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto init
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:init
+@rem Get command-line arguments, handling Windows variants
+
+if not "%OS%" == "Windows_NT" goto win9xME_args
+
+:win9xME_args
+@rem Slurp the command line arguments.
+set CMD_LINE_ARGS=
+set _SKIP=2
+
+:win9xME_args_slurp
+if "x%~1" == "x" goto execute
+
+set CMD_LINE_ARGS=%*
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/flexible/java-8/helloworld/pom.xml b/flexible/java-8/helloworld/pom.xml
new file mode 100644
index 00000000000..020fd6c15a0
--- /dev/null
+++ b/flexible/java-8/helloworld/pom.xml
@@ -0,0 +1,86 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-helloworld
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
+
diff --git a/flexible/java-8/helloworld/src/main/appengine/app.yaml b/flexible/java-8/helloworld/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..05e813dba82
--- /dev/null
+++ b/flexible/java-8/helloworld/src/main/appengine/app.yaml
@@ -0,0 +1,21 @@
+# Copyright 2016 Google 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
+#
+# 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_flex_quickstart_yaml]
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+# [END gae_flex_quickstart_yaml]
diff --git a/flexible/java-8/helloworld/src/main/java/com/example/flexible/helloworld/HelloServlet.java b/flexible/java-8/helloworld/src/main/java/com/example/flexible/helloworld/HelloServlet.java
new file mode 100644
index 00000000000..95552d9cbfc
--- /dev/null
+++ b/flexible/java-8/helloworld/src/main/java/com/example/flexible/helloworld/HelloServlet.java
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.flexible.helloworld;
+
+// [START gae_flex_servlet]
+import java.io.IOException;
+import java.io.PrintWriter;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+@WebServlet(name = "helloworld", value = "")
+@SuppressWarnings("serial")
+public class HelloServlet extends HttpServlet {
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
+ PrintWriter out = resp.getWriter();
+ out.println("Hello, world - App Engine Flexible");
+ }
+}
+// [END gae_flex_servlet]
diff --git a/flexible/java-8/memcache/README.md b/flexible/java-8/memcache/README.md
new file mode 100644
index 00000000000..286b3197d42
--- /dev/null
+++ b/flexible/java-8/memcache/README.md
@@ -0,0 +1,10 @@
+# flexible/memcache
+
+
+
+
+How to use memcache on flexible.
+
+# NEEDS WORK
+
+This sample needs to be updated to use redis-memcache
diff --git a/flexible/java-8/memcache/pom.xml b/flexible/java-8/memcache/pom.xml
new file mode 100644
index 00000000000..7917b1f1b22
--- /dev/null
+++ b/flexible/java-8/memcache/pom.xml
@@ -0,0 +1,86 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ memcache
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+ com.googlecode.xmemcached
+ xmemcached
+ 2.4.7
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/memcache/src/main/appengine/app.yaml b/flexible/java-8/memcache/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..088f0927431
--- /dev/null
+++ b/flexible/java-8/memcache/src/main/appengine/app.yaml
@@ -0,0 +1,24 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+beta_settings:
+ use_memcache_proxy: true
diff --git a/flexible/java-8/memcache/src/main/java/com/example/memcache/MemcacheServlet.java b/flexible/java-8/memcache/src/main/java/com/example/memcache/MemcacheServlet.java
new file mode 100644
index 00000000000..ef22956dddf
--- /dev/null
+++ b/flexible/java-8/memcache/src/main/java/com/example/memcache/MemcacheServlet.java
@@ -0,0 +1,58 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.memcache;
+
+import java.io.IOException;
+import java.util.concurrent.TimeoutException;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import net.rubyeye.xmemcached.MemcachedClient;
+import net.rubyeye.xmemcached.MemcachedClientBuilder;
+import net.rubyeye.xmemcached.XMemcachedClientBuilder;
+import net.rubyeye.xmemcached.exception.MemcachedException;
+import net.rubyeye.xmemcached.utils.AddrUtil;
+
+@SuppressWarnings("serial")
+@WebServlet(name = "memcache", value = "")
+public class MemcacheServlet extends HttpServlet {
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException,
+ ServletException {
+ String addr =
+ System.getenv().containsKey("GAE_MEMCACHE_HOST")
+ ? System.getenv("GAE_MEMCACHE_HOST") : "localhost";
+ String port =
+ System.getenv().containsKey("GAE_MEMCACHE_HOST")
+ ? System.getenv("GAE_MEMCACHE_PORT") : "11211";
+ String key = "count";
+ MemcachedClientBuilder builder = new XMemcachedClientBuilder(
+ AddrUtil.getAddresses(addr + ":" + port));
+ MemcachedClient client = builder.build();
+ long count = 0L;
+ try {
+ count = client.incr(key, 1L, 0L);
+ } catch (TimeoutException | InterruptedException | MemcachedException e) {
+ throw new ServletException("Memcache error", e);
+ }
+ resp.setContentType("text/plain");
+ resp.getWriter().print("Value is " + count + "\n");
+ }
+}
diff --git a/flexible/java-8/postgres/README.md b/flexible/java-8/postgres/README.md
new file mode 100644
index 00000000000..a1cac6b5f13
--- /dev/null
+++ b/flexible/java-8/postgres/README.md
@@ -0,0 +1,51 @@
+# PostgreSQL sample for Google App Engine Flexible
+
+
+
+
+This sample demonstrates how to use [Cloud SQL](https://cloud.google.com/sql/) on Google App
+Engine Flexible
+
+## Setup
+
+* If you haven't already, Download and initialize the [Cloud SDK](https://cloud.google.com/sdk/)
+
+ `gcloud init`
+
+* If you haven't already, Create an App Engine app within the current Google Cloud Project
+
+ `gcloud app create`
+
+* If you haven't already, Setup
+[Application Default Credentials](https://developers.google.com/identity/protocols/application-default-credentials)
+
+ `gcloud auth application-default login`
+
+* [Create an instance](https://cloud.google.com/sql/docs/postgresql/create-instance)
+
+* [Create a Database](https://cloud.google.com/sql/docs/postgresql/create-manage-databases)
+
+* [Create a user](https://cloud.google.com/sql/docs/postgresql/create-manage-users)
+
+* Note the **Instance connection name** under Overview > properties
+
+Looks like: `projectID:region:instance`
+
+## Running locally
+
+```bash
+$ mvn clean jetty:run -DINSTANCE_CONNECTION_NAME=instanceConnectionName -Duser=root -Dpassword=myPassowrd -Ddatabase=myDatabase
+```
+
+## Deploying
+
+```bash
+$ mvn clean package appengine:deploy -DINSTANCE_CONNECTION_NAME=instanceConnectionName -Duser=root
+-Dpassword=myPassword -Ddatabase=myDatabase
+```
+
+
+## Cleaning up
+
+* [Delete your Instance](https://cloud.google.com/sql/docs/postgresql/delete-instance)
+
diff --git a/flexible/java-8/postgres/pom.xml b/flexible/java-8/postgres/pom.xml
new file mode 100644
index 00000000000..99b199df66e
--- /dev/null
+++ b/flexible/java-8/postgres/pom.xml
@@ -0,0 +1,127 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-postgres
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+
+
+ Project:Region:Instance
+ root
+ myPassword
+ sqldemo
+
+ 1.8
+ 1.8
+
+ false
+
+ 9.4.44.v20210927
+
+ jdbc:postgresql://google/${database}?useSSL=false&socketFactoryArg=${INSTANCE_CONNECTION_NAME}&socketFactory=com.google.cloud.sql.postgres.SocketFactory&user=${user}&password=${password}
+
+
+
+
+
+ com.google.api-client
+ google-api-client
+ 2.0.0
+
+
+ com.google.api-client
+ google-api-client-appengine
+ 2.1.1
+
+
+ com.google.api-client
+ google-api-client-servlet
+ 2.1.1
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+ org.postgresql
+ postgresql
+ 42.4.3
+
+
+
+ com.google.cloud.sql
+ postgres-socket-factory
+ 1.8.3
+
+
+
+
+
+
+
+ src/main/resources
+ true
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.4.4
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/postgres/src/main/appengine/app.yaml b/flexible/java-8/postgres/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..cf93894c4bf
--- /dev/null
+++ b/flexible/java-8/postgres/src/main/appengine/app.yaml
@@ -0,0 +1,24 @@
+# Copyright 2017 Google 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
+#
+# 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.
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+automatic_scaling:
+ min_num_instances: 1
+ max_num_instances: 2
diff --git a/flexible/java-8/postgres/src/main/java/com/example/postgres/PostgresSqlServlet.java b/flexible/java-8/postgres/src/main/java/com/example/postgres/PostgresSqlServlet.java
new file mode 100644
index 00000000000..8e600dfa047
--- /dev/null
+++ b/flexible/java-8/postgres/src/main/java/com/example/postgres/PostgresSqlServlet.java
@@ -0,0 +1,125 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.postgres;
+
+import com.google.common.base.Stopwatch;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.net.Inet4Address;
+import java.net.Inet6Address;
+import java.net.InetAddress;
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.sql.Timestamp;
+import java.util.Date;
+import java.util.Properties;
+import java.util.concurrent.TimeUnit;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+// [START gae_flex_postgres_app]
+@SuppressWarnings("serial")
+@WebServlet(name = "postgresql", value = "")
+public class PostgresSqlServlet extends HttpServlet {
+ Connection conn;
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+
+ final String createTableSql =
+ "CREATE TABLE IF NOT EXISTS visits ( visit_id SERIAL NOT NULL, "
+ + "user_ip VARCHAR(46) NOT NULL, ts timestamp NOT NULL, "
+ + "PRIMARY KEY (visit_id) );";
+ final String createVisitSql = "INSERT INTO visits (user_ip, ts) VALUES (?, ?);";
+ final String selectSql = "SELECT user_ip, ts FROM visits ORDER BY ts DESC " + "LIMIT 10;";
+
+ String path = req.getRequestURI();
+ if (path.startsWith("/favicon.ico")) {
+ return; // ignore the request for favicon.ico
+ }
+
+ PrintWriter out = resp.getWriter();
+ resp.setContentType("text/plain");
+
+ // store only the first two octets of a users ip address
+ String userIp = req.getRemoteAddr();
+ InetAddress address = InetAddress.getByName(userIp);
+ if (address instanceof Inet6Address) {
+ // nest indexOf calls to find the second occurrence of a character in a string
+ // an alternative is to use Apache Commons Lang: StringUtils.ordinalIndexOf()
+ userIp = userIp.substring(0, userIp.indexOf(":", userIp.indexOf(":") + 1)) + ":*:*:*:*:*:*";
+ } else if (address instanceof Inet4Address) {
+ userIp = userIp.substring(0, userIp.indexOf(".", userIp.indexOf(".") + 1)) + ".*.*";
+ }
+
+ Stopwatch stopwatch = Stopwatch.createStarted();
+ try (PreparedStatement statementCreateVisit = conn.prepareStatement(createVisitSql)) {
+ conn.createStatement().executeUpdate(createTableSql);
+ statementCreateVisit.setString(1, userIp);
+ statementCreateVisit.setTimestamp(2, new Timestamp(new Date().getTime()));
+ statementCreateVisit.executeUpdate();
+
+ try (ResultSet rs = conn.prepareStatement(selectSql).executeQuery()) {
+ stopwatch.stop();
+ out.print("Last 10 visits:\n");
+ while (rs.next()) {
+ String savedIp = rs.getString("user_ip");
+ String timeStamp = rs.getString("ts");
+ out.println("Time: " + timeStamp + " Addr: " + savedIp);
+ }
+ out.println("Elapsed: " + stopwatch.elapsed(TimeUnit.MILLISECONDS));
+ }
+ } catch (SQLException e) {
+ throw new ServletException("SQL error", e);
+ }
+ }
+
+ @Override
+ public void init() throws ServletException {
+ String url;
+
+ Properties properties = new Properties();
+ try {
+ properties.load(
+ getServletContext().getResourceAsStream("/WEB-INF/classes/config.properties"));
+ url = properties.getProperty("sqlUrl");
+ } catch (IOException e) {
+ log("no property", e); // Servlet Init should never fail.
+ return;
+ }
+
+ log("connecting to: " + url);
+ try {
+ Class.forName("org.postgresql.Driver");
+ conn = DriverManager.getConnection(url);
+ } catch (ClassNotFoundException e) {
+ throw new ServletException("Error loading JDBC Driver", e);
+ } catch (SQLException e) {
+ throw new ServletException("Unable to connect to PostGre", e);
+ } finally {
+ // Nothing really to do here.
+ }
+ }
+}
+// [END gae_flex_postgres_app]
diff --git a/flexible/java-8/postgres/src/main/resources/config.properties b/flexible/java-8/postgres/src/main/resources/config.properties
new file mode 100644
index 00000000000..7de1617057c
--- /dev/null
+++ b/flexible/java-8/postgres/src/main/resources/config.properties
@@ -0,0 +1,17 @@
+# Copyright 2017 Google 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
+#
+# 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_flex_postgres_config_properties]
+sqlUrl=${sqlURL}
+# [END gae_flex_postgres_config_properties]
diff --git a/flexible/java-8/pubsub/README.md b/flexible/java-8/pubsub/README.md
new file mode 100644
index 00000000000..c9b307aacdc
--- /dev/null
+++ b/flexible/java-8/pubsub/README.md
@@ -0,0 +1,63 @@
+# App Engine Flexible Environment - Pub/Sub Sample
+
+
+
+
+
+## Clone the sample app
+
+Copy the sample apps to your local machine, and cd to the pubsub directory:
+
+```
+git clone https://github.com/GoogleCloudPlatform/java-docs-samples
+cd java-docs-samples/flexible/pubsub
+```
+
+## Setup
+
+Make sure [`gcloud`](https://cloud.google.com/sdk/docs/) is installed and authenticated.
+
+Create a topic
+```
+gcloud pubsub topics create
+```
+
+Create a push subscription, to send messages to a Google Cloud Project URL
+ such as https://.appspot.com/push.
+```
+gcloud pubsub subscriptions create \
+ --topic \
+ --push-endpoint \
+ https://.appspot.com/pubsub/push?token= \
+ --ack-deadline 30
+```
+## Run
+
+Set the following environment variables and run using shown Maven command. You can then
+direct your browser to `http://localhost:8080/`
+
+```
+export PUBSUB_TOPIC=
+export PUBSUB_VERIFICATION_TOKEN=
+mvn jetty:run
+```
+
+
+### Send fake subscription push messages with:
+
+```
+curl -H "Content-Type: application/json" -i --data @sample_message.json
+"localhost:8080/pubsub/push?token="
+```
+
+## Deploy
+
+Update the environment variables `PUBSUB_TOPIC` and `PUBSUB_VERIFICATION_TOKEN` in [`app.yaml`](src/main/appengine/app.yaml),
+then:
+
+```
+mvn clean package appengine:deploy
+```
+
+The home page of this application provides a form to publish messages and also provides a view of the most recent messages
+received over the push endpoint and persisted in storage.
\ No newline at end of file
diff --git a/flexible/java-8/pubsub/pom.xml b/flexible/java-8/pubsub/pom.xml
new file mode 100644
index 00000000000..ea96e550ccf
--- /dev/null
+++ b/flexible/java-8/pubsub/pom.xml
@@ -0,0 +1,127 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ flexible-pubsub
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+ com.google.cloud
+ google-cloud-pubsub
+ 1.123.0
+
+
+ com.google.cloud
+ google-cloud-datastore
+ 2.13.2
+
+
+
+
+ com.google.appengine
+ appengine-api-stubs
+ 2.0.5
+ test
+
+
+ com.google.appengine
+ appengine-tools-sdk
+ 2.0.5
+ test
+
+
+
+ junit
+ junit
+ 4.13.2
+ test
+
+
+ org.mockito
+ mockito-all
+ 1.10.19
+ test
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/pubsub/sample_message.json b/flexible/java-8/pubsub/sample_message.json
new file mode 100644
index 00000000000..1c0e04caa1a
--- /dev/null
+++ b/flexible/java-8/pubsub/sample_message.json
@@ -0,0 +1 @@
+{"message":{"data":"dGVzdA==","attributes":{},"messageId":"91010751788941","publishTime":"2017-04-05T23:16:42.302Z"}}
diff --git a/flexible/java-8/pubsub/src/main/appengine/app.yaml b/flexible/java-8/pubsub/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..da60579ae5d
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/appengine/app.yaml
@@ -0,0 +1,27 @@
+# Copyright 2017 Google 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
+#
+# 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.
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+# [START gae_flex_pubsub_yaml]
+env_variables:
+ PUBSUB_TOPIC:
+ # This token is used to verify that requests originate from your
+ # application. It can be any sufficiently random string.
+ PUBSUB_VERIFICATION_TOKEN:
+# [END gae_flex_pubsub_yaml]
diff --git a/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/Message.java b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/Message.java
new file mode 100644
index 00000000000..587e594b8c0
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/Message.java
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+/**
+ * A message captures information from the Pubsub message received over the push endpoint and is
+ * persisted in storage.
+ */
+public class Message {
+ private String messageId;
+ private String publishTime;
+ private String data;
+
+ public Message(String messageId) {
+ this.messageId = messageId;
+ }
+
+ public String getMessageId() {
+ return messageId;
+ }
+
+ public void setMessageId(String messageId) {
+ this.messageId = messageId;
+ }
+
+ public String getPublishTime() {
+ return publishTime;
+ }
+
+ public void setPublishTime(String publishTime) {
+ this.publishTime = publishTime;
+ }
+
+ public String getData() {
+ return data;
+ }
+
+ public void setData(String data) {
+ this.data = data;
+ }
+}
diff --git a/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/MessageRepository.java b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/MessageRepository.java
new file mode 100644
index 00000000000..9f6c83d59f6
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/MessageRepository.java
@@ -0,0 +1,33 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+import java.util.List;
+
+public interface MessageRepository {
+
+ /** Save message to persistent storage. */
+ void save(Message message);
+
+ /**
+ * Retrieve most recent stored messages.
+ *
+ * @param limit number of messages
+ * @return list of messages
+ */
+ List retrieve(int limit);
+}
diff --git a/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/MessageRepositoryImpl.java b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/MessageRepositoryImpl.java
new file mode 100644
index 00000000000..d463ce454d1
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/MessageRepositoryImpl.java
@@ -0,0 +1,100 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+import com.google.cloud.datastore.Datastore;
+import com.google.cloud.datastore.DatastoreOptions;
+import com.google.cloud.datastore.Entity;
+import com.google.cloud.datastore.Key;
+import com.google.cloud.datastore.KeyFactory;
+import com.google.cloud.datastore.Query;
+import com.google.cloud.datastore.QueryResults;
+import com.google.cloud.datastore.StructuredQuery;
+import java.util.ArrayList;
+import java.util.List;
+
+/** Storage for Message objects using Cloud Datastore. */
+public class MessageRepositoryImpl implements MessageRepository {
+
+ private static MessageRepositoryImpl instance;
+
+ private String messagesKind = "messages";
+ private KeyFactory keyFactory = getDatastoreInstance().newKeyFactory().setKind(messagesKind);
+
+ @Override
+ public void save(Message message) {
+ // Save message to "messages"
+ Datastore datastore = getDatastoreInstance();
+ Key key = datastore.allocateId(keyFactory.newKey());
+
+ Entity.Builder messageEntityBuilder = Entity.newBuilder(key)
+ .set("messageId", message.getMessageId());
+
+ if (message.getData() != null) {
+ messageEntityBuilder = messageEntityBuilder.set("data", message.getData());
+ }
+
+ if (message.getPublishTime() != null) {
+ messageEntityBuilder = messageEntityBuilder.set("publishTime", message.getPublishTime());
+ }
+ datastore.put(messageEntityBuilder.build());
+ }
+
+ @Override
+ public List retrieve(int limit) {
+ // Get Message saved in Datastore
+ Datastore datastore = getDatastoreInstance();
+ Query query =
+ Query.newEntityQueryBuilder()
+ .setKind(messagesKind)
+ .setLimit(limit)
+ .addOrderBy(StructuredQuery.OrderBy.desc("publishTime"))
+ .build();
+ QueryResults results = datastore.run(query);
+
+ List messages = new ArrayList<>();
+ while (results.hasNext()) {
+ Entity entity = results.next();
+ Message message = new Message(entity.getString("messageId"));
+ String data = entity.getString("data");
+ if (data != null) {
+ message.setData(data);
+ }
+ String publishTime = entity.getString("publishTime");
+ if (publishTime != null) {
+ message.setPublishTime(publishTime);
+ }
+ messages.add(message);
+ }
+ return messages;
+ }
+
+ private Datastore getDatastoreInstance() {
+ return DatastoreOptions.getDefaultInstance().getService();
+ }
+
+ private MessageRepositoryImpl() {
+ }
+
+ // retrieve a singleton instance
+ public static synchronized MessageRepositoryImpl getInstance() {
+ if (instance == null) {
+ instance = new MessageRepositoryImpl();
+ }
+ return instance;
+ }
+}
diff --git a/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubHome.java b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubHome.java
new file mode 100644
index 00000000000..55ff7277c3b
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubHome.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+import java.util.List;
+
+public class PubSubHome {
+
+ private static MessageRepository messageRepository = MessageRepositoryImpl.getInstance();
+ private static int MAX_MESSAGES = 10;
+
+ /**
+ * Retrieve received messages in html.
+ *
+ * @return html representation of messages (one per row)
+ */
+ public static String getReceivedMessages() {
+ List messageList = messageRepository.retrieve(MAX_MESSAGES);
+ return convertToHtmlTable(messageList);
+ }
+
+ private static String convertToHtmlTable(List messages) {
+ StringBuilder sb = new StringBuilder();
+ for (Message message : messages) {
+ sb.append("
");
+ sb.append("
" + message.getMessageId() + "
");
+ sb.append("
" + message.getData() + "
");
+ sb.append("
" + message.getPublishTime() + "
");
+ sb.append("
");
+ }
+ return sb.toString();
+ }
+
+ private PubSubHome() { }
+}
diff --git a/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubPublish.java b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubPublish.java
new file mode 100644
index 00000000000..e76b681952e
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubPublish.java
@@ -0,0 +1,69 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+import com.google.cloud.ServiceOptions;
+import com.google.cloud.pubsub.v1.Publisher;
+import com.google.protobuf.ByteString;
+import com.google.pubsub.v1.ProjectTopicName;
+import com.google.pubsub.v1.PubsubMessage;
+import java.io.IOException;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.apache.http.HttpStatus;
+
+// [START gae_flex_pubsub_publish]
+@WebServlet(name = "Publish with PubSub", value = "/pubsub/publish")
+public class PubSubPublish extends HttpServlet {
+
+ @Override
+ public void doPost(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ Publisher publisher = this.publisher;
+ try {
+ String topicId = System.getenv("PUBSUB_TOPIC");
+ // create a publisher on the topic
+ if (publisher == null) {
+ publisher = Publisher.newBuilder(
+ ProjectTopicName.of(ServiceOptions.getDefaultProjectId(), topicId))
+ .build();
+ }
+ // construct a pubsub message from the payload
+ final String payload = req.getParameter("payload");
+ PubsubMessage pubsubMessage =
+ PubsubMessage.newBuilder().setData(ByteString.copyFromUtf8(payload)).build();
+
+ publisher.publish(pubsubMessage);
+ // redirect to home page
+ resp.sendRedirect("/");
+ } catch (Exception e) {
+ resp.sendError(HttpStatus.SC_INTERNAL_SERVER_ERROR, e.getMessage());
+ }
+ }
+ // [END gae_flex_pubsub_publish]
+
+ private Publisher publisher;
+
+ public PubSubPublish() { }
+
+ PubSubPublish(Publisher publisher) {
+ this.publisher = publisher;
+ }
+}
diff --git a/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubPush.java b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubPush.java
new file mode 100644
index 00000000000..33179e0c19d
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/java/com/example/flexible/pubsub/PubSubPush.java
@@ -0,0 +1,83 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+import com.google.gson.Gson;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonParser;
+import java.io.IOException;
+import java.util.Base64;
+import java.util.stream.Collectors;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+// [START gae_flex_pubsub_push]
+@WebServlet(value = "/pubsub/push")
+public class PubSubPush extends HttpServlet {
+
+ @Override
+ public void doPost(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ String pubsubVerificationToken = System.getenv("PUBSUB_VERIFICATION_TOKEN");
+ // Do not process message if request token does not match pubsubVerificationToken
+ if (req.getParameter("token").compareTo(pubsubVerificationToken) != 0) {
+ resp.setStatus(HttpServletResponse.SC_BAD_REQUEST);
+ return;
+ }
+ // parse message object from "message" field in the request body json
+ // decode message data from base64
+ Message message = getMessage(req);
+ try {
+ messageRepository.save(message);
+ // 200, 201, 204, 102 status codes are interpreted as success by the Pub/Sub system
+ resp.setStatus(HttpServletResponse.SC_OK);
+ } catch (Exception e) {
+ resp.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
+ }
+ }
+ // [END gae_flex_pubsub_push]
+
+ private Message getMessage(HttpServletRequest request) throws IOException {
+ String requestBody = request.getReader().lines().collect(Collectors.joining("\n"));
+ JsonElement jsonRoot = jsonParser.parse(requestBody);
+ String messageStr = jsonRoot.getAsJsonObject().get("message").toString();
+ Message message = gson.fromJson(messageStr, Message.class);
+ // decode from base64
+ String decoded = decode(message.getData());
+ message.setData(decoded);
+ return message;
+ }
+
+ private String decode(String data) {
+ return new String(Base64.getDecoder().decode(data));
+ }
+
+ private final Gson gson = new Gson();
+ private final JsonParser jsonParser = new JsonParser();
+ private MessageRepository messageRepository;
+
+ PubSubPush(MessageRepository messageRepository) {
+ this.messageRepository = messageRepository;
+ }
+
+ public PubSubPush() {
+ this.messageRepository = MessageRepositoryImpl.getInstance();
+ }
+}
diff --git a/flexible/java-8/pubsub/src/main/test/com/example/flexible/pubsub/PubSubPublishTest.java b/flexible/java-8/pubsub/src/main/test/com/example/flexible/pubsub/PubSubPublishTest.java
new file mode 100644
index 00000000000..1d8820c2b2c
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/test/com/example/flexible/pubsub/PubSubPublishTest.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+import static org.junit.Assert.assertNotNull;
+import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+import com.google.api.gax.core.SettableApiFuture;
+import com.google.cloud.pubsub.v1.Publisher;
+import com.google.protobuf.ByteString;
+import com.google.pubsub.v1.PubsubMessage;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.junit.Test;
+
+public class PubSubPublishTest {
+
+ @Test
+ public void servletPublishesPayloadMessage() throws Exception {
+ assertNotNull(System.getenv("PUBSUB_TOPIC"));
+ HttpServletRequest request = mock(HttpServletRequest.class);
+ when(request.getParameter("payload")).thenReturn("test-message");
+
+ HttpServletResponse response = mock(HttpServletResponse.class);
+ Publisher publisher = mock(Publisher.class);
+ PubsubMessage message = PubsubMessage.newBuilder()
+ .setData(ByteString.copyFromUtf8("test-message")).build();
+ when(publisher.publish(eq(message))).thenReturn(SettableApiFuture.create());
+ PubSubPublish pubSubPublish = new PubSubPublish(publisher);
+ // verify content of published test message
+ pubSubPublish.doPost(request, response);
+ verify(publisher, times(1)).publish(eq(message));
+ }
+}
diff --git a/flexible/java-8/pubsub/src/main/test/com/example/flexible/pubsub/PubSubPushTest.java b/flexible/java-8/pubsub/src/main/test/com/example/flexible/pubsub/PubSubPushTest.java
new file mode 100644
index 00000000000..5b57af5b116
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/test/com/example/flexible/pubsub/PubSubPushTest.java
@@ -0,0 +1,77 @@
+/*
+ * Copyright 2017 Google 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
+ *
+ * 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.flexible.pubsub;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+import static org.mockito.Matchers.any;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+import java.io.BufferedReader;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.Stream;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.junit.Test;
+
+/**
+ * Copyright 2017 Google 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
+ *
+ *
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.
+ */
+
+public class PubSubPushTest {
+
+ @Test
+ public void messageReceivedOverPushEndPointIsSaved() throws Exception {
+ MessageRepository messageRepository = mock(MessageRepository.class);
+ List messages = new ArrayList<>();
+ doAnswer((invocation) -> {
+ messages.add((Message)invocation.getArguments()[0]);
+ return null;
+ }
+ ).when(messageRepository).save(any(Message.class));
+ HttpServletRequest request = mock(HttpServletRequest.class);
+ assertNotNull(System.getenv("PUBSUB_VERIFICATION_TOKEN"));
+ when(request.getParameter("token"))
+ .thenReturn(System.getenv("PUBSUB_VERIFICATION_TOKEN"));
+
+ HttpServletResponse response = mock(HttpServletResponse.class);
+ BufferedReader reader = mock(BufferedReader.class);
+ when (request.getReader()).thenReturn(reader);
+ Stream requestBody = Stream.of(
+ "{\"message\":{\"data\":\"dGVzdA==\",\"attributes\":{},"
+ + "\"messageId\":\"91010751788941\",\"publishTime\":\"2017-04-05T23:16:42.302Z\"}}");
+ when(reader.lines()).thenReturn(requestBody);
+ PubSubPush servlet = new PubSubPush(messageRepository);
+ assertEquals(messages.size(), 0);
+ servlet.doPost(request, response);
+ assertEquals(messages.size(), 1);
+ }
+}
+
diff --git a/flexible/java-8/pubsub/src/main/webapp/index.jsp b/flexible/java-8/pubsub/src/main/webapp/index.jsp
new file mode 100644
index 00000000000..fa12f02a14d
--- /dev/null
+++ b/flexible/java-8/pubsub/src/main/webapp/index.jsp
@@ -0,0 +1,24 @@
+<%@ page import="com.example.flexible.pubsub.PubSubHome" %>
+
+
+
+
+ An example of using PubSub on App Engine Flex
+
+
Publish a message
+
+
Last received messages
+
+
+
Id
+
Data
+
PublishTime
+
+ <%= PubSubHome.getReceivedMessages() %>
+
+
+
diff --git a/flexible/java-8/sparkjava/README.md b/flexible/java-8/sparkjava/README.md
new file mode 100644
index 00000000000..692ede17b80
--- /dev/null
+++ b/flexible/java-8/sparkjava/README.md
@@ -0,0 +1,113 @@
+# SparkJava on App Engine Flexible Environment
+
+
+
+
+This app demonstrates how to use [Datastore with the Google Cloud client
+library](https://github.com/GoogleCloudPlatform/google-cloud-java/tree/main/google-cloud-datastore)
+from within an [App Engine flexible
+environment](https://cloud.google.com/appengine/docs/flexible/java/hello-world)
+project using [SparkJava](http://sparkjava.com/). The app allows you to create
+and modify a database of "users", which contains their ID, name, and email
+information.
+
+The Google Cloud client library is an idiomatic Java client for [Google Cloud
+Platform](https://cloud.google.com/) services. Read more about the library
+[here](https://github.com/GoogleCloudPlatform/google-cloud-java).
+
+Setup
+-----
+
+1. Create a Google Cloud project with the Datastore API enabled.
+ [Follow these
+ instructions](https://cloud.google.com/docs/authentication#preparation) to
+ get your project set up. If you wish to deploy this application, you will
+ also need to [enable
+ billing](https://support.google.com/cloud/?rd=2#topic=6288636).
+
+2. Set up the local development environment by [installing the Google Cloud
+ SDK](https://cloud.google.com/sdk/) and running the following commands in
+ command line: `gcloud auth application-default login` and `gcloud config set project [YOUR
+ PROJECT ID]`.
+
+3. Ensure that you have Maven installed and configured to use Java 8. See
+ installation instructions [here](https://maven.apache.org/install.html).
+
+Running locally
+---------------
+
+Run the application on your local machine by typing the following into your
+command line from the `sparkjava` directory: `mvn clean package exec:java`.
+Navigate to `localhost:8080` to view and interact with the application.
+
+Deploying
+---------
+
+If you've enabled billing (step 1 in [Setup](#Setup)), you can deploy the
+application to the web by running `mvn clean package appengine:deploy` from your command line
+(from the `sparkjava` directory).
+
+How does it work?
+-----------------
+
+You'll notice that the source code is split into three folders: `appengine`,
+`java/com/google/appengine/sparkdemo`, and `resource/public`. The `appengine`
+folder contains a `Dockerfile` and an `app.yaml`, necessary files to [configure
+the VM
+environment](https://cloud.google.com/appengine/docs/managed-vms/config). The
+`java/com/google/appengine/sparkdemo` folder contains the controller code,
+which uses the Google Cloud client library to modify the records in the Google Cloud
+Datastore. Finally, the `resource/public` folder contains the home webpage,
+which uses jQuery to send HTTP requests to create, remove, and update records.
+
+Spark runs the [`main`
+method](https://github.com/GoogleCloudPlatform/java-docs-samples/blob/main/managedvms/sparkjava-demo/src/main/java/com/google/appengine/sparkdemo/Main.java)
+upon server startup. The `main` method creates the controller,
+[`UserController`](https://github.com/GoogleCloudPlatform/java-docs-samples/blob/main/managedvms/sparkjava-demo/src/main/java/com/google/appengine/sparkdemo/UserController.java).
+The URIs used to send HTTP requests in the [home
+page](https://github.com/GoogleCloudPlatform/java-docs-samples/blob/main/managedvms/sparkjava-demo/src/main/resources/public/index.html)
+correspond to methods in the `UserController` class. For example, the
+`index.html` code for `create` makes a `POST` request to the path `/api/users`
+with a body containing the name and email of a user to add. `UserController`
+contains the following code to process that request:
+
+```java
+post("/api/users", (req, res) -> userService.createUser(
+ req.queryParams("name"),
+ req.queryParams("email),
+), json());
+```
+This code snippet gets the name and email of the user from the POST request and
+passes it to `createUser` (in
+[`UserService.java`](https://github.com/GoogleCloudPlatform/java-docs-samples/blob/main/managedvms/sparkjava-demo/src/main/java/com/google/appengine/sparkdemo/UserService.java))
+to create a database record using the Google Cloud client library. If you want
+a more in-depth tutorial on using Google Cloud client library Datastore client,
+see the [Getting
+Started](https://github.com/GoogleCloudPlatform/google-cloud-java/tree/main/google-cloud-datastore#getting-started)
+section of the client library documentation.
+
+Communication with the Google Cloud Datastore requires authentication and
+setting a project ID. When running locally, the Google Cloud client library
+automatically detects your credentials and project ID because you logged into
+the Google Cloud SDK and set your project ID. There are also many other options
+for authenticating and setting a project ID. To read more, see the
+[Authentication](https://github.com/GoogleCloudPlatform/google-cloud-java#authentication)
+and [Specifying a Project
+ID](https://github.com/GoogleCloudPlatform/google-cloud-java#specifying-a-project-id)
+sections of the client library documentation.
+
+You built and ran this application using Maven. To read more about using Maven
+with App Engine flexible environment, see the [Using Apache Maven
+documentation](https://cloud.google.com/appengine/docs/flexible/java/using-maven).
+While this particular project uses Maven, the Google Cloud client library
+packages can also be accessed using Gradle and SBT. See how to obtain the
+dependency in the [Quickstart
+section](https://github.com/GoogleCloudPlatform/google-cloud-java#quickstart)
+of the client library documentation.
+
+License
+-------
+
+Apache 2.0 - See
+[LICENSE](https://github.com/GoogleCloudPlatform/java-docs-samples/blob/main/LICENSE)
+for more information.
diff --git a/flexible/java-8/sparkjava/jenkins.sh b/flexible/java-8/sparkjava/jenkins.sh
new file mode 100755
index 00000000000..3ccdfa2e240
--- /dev/null
+++ b/flexible/java-8/sparkjava/jenkins.sh
@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+# Copyright 2017 Google 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
+#
+# 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.
+
+# Fail on non-zero return and print command to stdout
+set -xe
+
+# Jenkins Test Script
+function runtests () {
+ curl -X GET \
+ "https://${2}-dot-${1}.appspot.com/api/users" | \
+ tee "$ERROR_OUTPUT_DIR/response.json" | \
+ grep "^\\["
+}
+
+# Jenkins provides values for GOOGLE_PROJECT_ID and GOOGLE_VERSION_ID
+
+# Test with Maven
+mvn clean package appengine:deploy \
+ -Dapp.deploy.version="${GOOGLE_VERSION_ID}" \
+ -Dapp.deploy.promote=false
+
+# End-2-End tests
+runtests "${GOOGLE_PROJECT_ID}" "${GOOGLE_VERSION_ID}"
diff --git a/flexible/java-8/sparkjava/pom.xml b/flexible/java-8/sparkjava/pom.xml
new file mode 100644
index 00000000000..1efd60d8c40
--- /dev/null
+++ b/flexible/java-8/sparkjava/pom.xml
@@ -0,0 +1,117 @@
+
+
+
+ 4.0.0
+ com.google.appengine.sparkdemo
+ spark
+ 1.0
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ 2.4.3
+ ${project.build.directory}/spark-1.0-jar-with-dependencies.jar
+
+
+
+
+ com.sparkjava
+ spark-core
+ 2.9.3
+
+
+ org.slf4j
+ slf4j-simple
+ 1.8.0-beta4
+
+
+ com.google.code.gson
+ gson
+ 2.10
+
+
+ junit
+ junit
+ 4.13.2
+
+
+ com.google.cloud
+ google-cloud-datastore
+ 2.13.2
+
+
+
+
+
+ maven-assembly-plugin
+
+
+ package
+
+ single
+
+
+
+
+
+ jar-with-dependencies
+
+
+
+ com.google.appengine.sparkdemo.Main
+
+
+
+
+
+
+ org.codehaus.mojo
+ exec-maven-plugin
+ 3.1.0
+
+ com.google.appengine.sparkdemo.Main
+
+ -jar
+ ${app.stage.stagingDirectory}/spark-1.0-jar-with-dependencies.jar
+
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+
diff --git a/flexible/java-8/sparkjava/src/main/appengine/app.yaml b/flexible/java-8/sparkjava/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..731b06c68b7
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/main/appengine/app.yaml
@@ -0,0 +1,20 @@
+# Copyright 2023 Google 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
+#
+# 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.
+#
+
+runtime: java
+env: flex
+
+runtime_config:
+ jdk: openjdk8
diff --git a/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/Main.java b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/Main.java
new file mode 100644
index 00000000000..036751f80a4
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/Main.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.google.appengine.sparkdemo;
+
+import static spark.Spark.port;
+
+import com.google.cloud.datastore.DatastoreOptions;
+
+public class Main {
+
+ /**
+ * Starts the webapp on localhost:8080.
+ */
+ public static void main(String[] args) {
+ port(8080);
+ String kind = "DemoUser";
+ if (args != null) {
+ for (String arg : args) {
+ if (arg.startsWith("kind=")) {
+ kind = arg.substring("kind=".length());
+ }
+ }
+ }
+ UserController userController = new UserController(new UserService(
+ DatastoreOptions.getDefaultInstance().getService(), kind));
+ }
+}
diff --git a/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/ResponseError.java b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/ResponseError.java
new file mode 100644
index 00000000000..7654a80dbbc
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/ResponseError.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.google.appengine.sparkdemo;
+
+public class ResponseError {
+
+ private String message;
+
+ public ResponseError(String message, String... args) {
+ this.message = String.format(message, (Object) args);
+ }
+
+ public ResponseError(Exception ex) {
+ this.message = ex.getMessage();
+ }
+}
diff --git a/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/User.java b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/User.java
new file mode 100644
index 00000000000..2aa82c6c598
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/User.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.google.appengine.sparkdemo;
+
+import java.util.UUID;
+
+public class User {
+
+ private String id;
+ private String name;
+ private String email;
+
+ /**
+ * Construct a user given a name and email. An ID is auto-generated for the user.
+ */
+ public User(String name, String email) {
+ this(UUID.randomUUID().toString(), name, email);
+ }
+
+ /**
+ * Construct a user given an ID, name, and email.
+ */
+ public User(String id, String name, String email) {
+ this.id = id;
+ this.email = email;
+ this.name = name;
+ }
+
+ public String getId() {
+ return id;
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public String getEmail() {
+ return email;
+ }
+
+ void setId(String id) {
+ this.id = id;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ public void setEmail(String email) {
+ this.email = email;
+ }
+}
diff --git a/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/UserController.java b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/UserController.java
new file mode 100644
index 00000000000..53fee59e3ba
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/UserController.java
@@ -0,0 +1,71 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.google.appengine.sparkdemo;
+
+import static spark.Spark.after;
+import static spark.Spark.delete;
+import static spark.Spark.exception;
+import static spark.Spark.get;
+import static spark.Spark.post;
+import static spark.Spark.put;
+
+import com.google.gson.Gson;
+import spark.ResponseTransformer;
+import spark.Spark;
+
+public class UserController {
+
+ /**
+ * Creates a controller that maps requests to actions.
+ */
+ public UserController(final UserService userService) {
+ Spark.staticFileLocation("/public");
+
+ get("/api/users", (req, res) -> userService.getAllUsers(), json());
+
+ get("/api/users/:id", (req, res) -> userService.getUser(req.params(":id")), json());
+
+ post("/api/users",
+ (req, res) -> userService.createUser(req.queryParams("name"), req.queryParams("email")),
+ json());
+
+ put("/api/users/:id", (req, res) -> userService.updateUser(
+ req.params(":id"),
+ req.queryParams("name"),
+ req.queryParams("email")
+ ), json());
+
+ delete("/api/users/:id", (req, res) -> userService.deleteUser(req.params(":id")), json());
+
+ after((req, res) -> {
+ res.type("application/json");
+ });
+
+ exception(IllegalArgumentException.class, (error, req, res) -> {
+ res.status(400);
+ res.body(toJson(new ResponseError(error)));
+ });
+ }
+
+ private static String toJson(Object object) {
+ return new Gson().toJson(object);
+ }
+
+ private static ResponseTransformer json() {
+ return UserController::toJson;
+ }
+}
diff --git a/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/UserService.java b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/UserService.java
new file mode 100644
index 00000000000..d2661fc649c
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/main/java/com/google/appengine/sparkdemo/UserService.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.google.appengine.sparkdemo;
+
+import static com.google.common.base.Preconditions.checkArgument;
+
+import com.google.cloud.datastore.Datastore;
+import com.google.cloud.datastore.Entity;
+import com.google.cloud.datastore.Key;
+import com.google.cloud.datastore.KeyFactory;
+import com.google.cloud.datastore.Query;
+import com.google.cloud.datastore.QueryResults;
+import java.util.ArrayList;
+import java.util.List;
+
+public class UserService {
+
+ private final Datastore datastore;
+ private final KeyFactory keyFactory;
+ private final String kind;
+
+ /**
+ * Constructor for UserService.
+ *
+ * @param datastore service object to execute requests
+ * @param kind the kind for the Datastore entities in this demo
+ */
+ public UserService(Datastore datastore, String kind) {
+ this.datastore = datastore;
+ this.keyFactory = datastore.newKeyFactory().setKind(kind);
+ this.kind = kind;
+ }
+
+ /**
+ * Return a list of all users.
+ */
+ public List getAllUsers() {
+ Query query =
+ Query.newGqlQueryBuilder(Query.ResultType.ENTITY, "SELECT * FROM " + kind).build();
+ QueryResults results = datastore.run(query);
+ List users = new ArrayList<>();
+ while (results.hasNext()) {
+ Entity result = results.next();
+ users.add(
+ new User(result.getString("id"), result.getString("name"), result.getString("email")));
+ }
+ return users;
+ }
+
+ /**
+ * Return the user with the given id.
+ */
+ User getUser(String id) {
+ Entity entity = datastore.get(keyFactory.newKey(id));
+ return entity == null
+ ? null
+ : new User(entity.getString("id"), entity.getString("name"), entity.getString("email"));
+ }
+
+ /**
+ * Create a new user and add it to Cloud Datastore.
+ */
+ public User createUser(String name, String email) {
+ failIfInvalid(name, email);
+ User user = new User(name, email);
+ Key key = keyFactory.newKey(user.getId());
+ Entity entity = Entity.newBuilder(key)
+ .set("id", user.getId())
+ .set("name", name)
+ .set("email", email)
+ .build();
+ datastore.add(entity);
+ return user;
+ }
+
+ /**
+ * Delete a user from Cloud Datastore.
+ */
+ public String deleteUser(String id) {
+ Key key = keyFactory.newKey(id);
+ datastore.delete(key);
+ return "ok";
+ }
+
+ /**
+ * Updates a user in Cloud Datastore.
+ */
+ public User updateUser(String id, String name, String email) {
+ failIfInvalid(name, email);
+ Key key = keyFactory.newKey(id);
+ Entity entity = datastore.get(key);
+ if (entity == null) {
+ throw new IllegalArgumentException("No user with id '" + id + "' found");
+ } else {
+ entity = Entity.newBuilder(entity)
+ .set("id", id)
+ .set("name", name)
+ .set("email", email)
+ .build();
+ datastore.update(entity);
+ }
+ return new User(id, name, email);
+ }
+
+ private void failIfInvalid(String name, String email) {
+ checkArgument(name != null && !name.isEmpty(), "Parameter 'name' cannot be empty");
+ checkArgument(email != null && !email.isEmpty(), "Parameter 'email' cannot be empty");
+ }
+}
diff --git a/flexible/java-8/sparkjava/src/main/resources/public/index.html b/flexible/java-8/sparkjava/src/main/resources/public/index.html
new file mode 100644
index 00000000000..fceb22e9f35
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/main/resources/public/index.html
@@ -0,0 +1,187 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
User Database
+
Using App Engine Flexible, Google Cloud Datastore, and SparkJava.
+
+
+
All users
+
+
+
+
+
+
+
ID
+
Name
+
Email
+
Actions
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Add a user
+
+
+
+
+
+
+
+
+
+
diff --git a/flexible/java-8/sparkjava/src/test/java/com/google/appengine/sparkdemo/UserControllerTest.java b/flexible/java-8/sparkjava/src/test/java/com/google/appengine/sparkdemo/UserControllerTest.java
new file mode 100644
index 00000000000..6700600899c
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/test/java/com/google/appengine/sparkdemo/UserControllerTest.java
@@ -0,0 +1,134 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.google.appengine.sparkdemo;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.fail;
+
+import com.google.gson.Gson;
+import java.io.IOException;
+import java.net.HttpURLConnection;
+import java.net.URL;
+import java.util.UUID;
+import org.junit.After;
+import org.junit.AfterClass;
+import org.junit.Before;
+import org.junit.BeforeClass;
+import org.junit.Test;
+import spark.Spark;
+import spark.utils.IOUtils;
+
+public class UserControllerTest {
+
+ private static final String USER_NAME = "myName";
+ private static final String USER_EMAIL = "my@email.com";
+ private static String userId;
+
+ @BeforeClass
+ public static void beforeClass() {
+ Main.main(new String[] {"kind=DemoUser" + UUID.randomUUID().toString().replaceAll("-", "")});
+ Spark.awaitInitialization();
+ }
+
+ @Before
+ public void setUp() throws IOException {
+ userId = createUser(USER_NAME, USER_EMAIL).getId();
+ }
+
+ @After
+ public void tearDown() throws IOException {
+ deleteUser(userId);
+ }
+
+ @AfterClass
+ public static void afterClass() {
+ Spark.stop();
+ }
+
+ @Test
+ public void testGetAllUsers() throws IOException {
+ User[] users = getAllUsers();
+ assertTrue(users.length <= 1);
+ }
+
+ @Test
+ public void testCreateUser() throws IOException {
+ User user = createUser(USER_NAME, USER_EMAIL);
+ assertNotNull(user.getId());
+ assertEquals(USER_NAME, user.getName());
+ assertEquals(USER_EMAIL, user.getEmail());
+ }
+
+ @Test
+ public void testCreateUserInvalidRequest() {
+ try {
+ executeRequest("POST", "/api/users?name=&email=");
+ fail("Should fail due to an invalid request.");
+ } catch (IOException e) {
+ assertTrue(e.getMessage().startsWith("Server returned HTTP response code: 400 for URL"));
+ }
+ }
+
+ @Test
+ public void testDeleteUser() throws IOException {
+ assertNotNull(getUser(userId));
+ assertEquals("\"ok\"", deleteUser(userId));
+ assertNull(getUser(userId));
+ }
+
+ @Test
+ public void updateUser() throws IOException {
+ String newName = "myNewName";
+ String newEmail = "mynew@email.com";
+ String responseStr = executeRequest(
+ "PUT",
+ "/api/users/" + userId + "?id=" + userId + "&name=" + newName + "&email=" + newEmail);
+ User updatedUser = new Gson().fromJson(responseStr, User.class);
+ assertEquals(userId, updatedUser.getId());
+ assertEquals(newName, updatedUser.getName());
+ assertEquals(newEmail, updatedUser.getEmail());
+ }
+
+ private static String executeRequest(String method, String path) throws IOException {
+ URL url = new URL("http://localhost:8080" + path);
+ HttpURLConnection connection = (HttpURLConnection) url.openConnection();
+ connection.setRequestMethod(method);
+ connection.setDoOutput(true);
+ connection.connect();
+ return IOUtils.toString(connection.getInputStream());
+ }
+
+ private static User createUser(String name, String email) throws IOException {
+ return new Gson().fromJson(
+ executeRequest("POST", "/api/users?name=" + name + "&email=" + email), User.class);
+ }
+
+ private static String deleteUser(String id) throws IOException {
+ return executeRequest("DELETE", "/api/users/" + id);
+ }
+
+ private static User getUser(String id) throws IOException {
+ return new Gson().fromJson(executeRequest("GET", "/api/users/" + id), User.class);
+ }
+
+ private static User[] getAllUsers() throws IOException {
+ return new Gson().fromJson(executeRequest("GET", "/api/users"), User[].class);
+ }
+}
diff --git a/flexible/java-8/sparkjava/src/test/java/com/google/appengine/sparkdemo/UserServiceTest.java b/flexible/java-8/sparkjava/src/test/java/com/google/appengine/sparkdemo/UserServiceTest.java
new file mode 100644
index 00000000000..24c7f8677c8
--- /dev/null
+++ b/flexible/java-8/sparkjava/src/test/java/com/google/appengine/sparkdemo/UserServiceTest.java
@@ -0,0 +1,139 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.google.appengine.sparkdemo;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.Assert.fail;
+
+import com.google.cloud.datastore.Datastore;
+import com.google.cloud.datastore.DatastoreOptions;
+import com.google.cloud.datastore.Entity;
+import com.google.cloud.datastore.Key;
+import com.google.cloud.datastore.Query;
+import com.google.cloud.datastore.QueryResults;
+import com.google.cloud.datastore.StructuredQuery;
+import com.google.cloud.datastore.testing.LocalDatastoreHelper;
+import com.google.common.collect.Iterators;
+import java.io.IOException;
+import java.util.List;
+import java.util.concurrent.TimeoutException;
+import org.junit.AfterClass;
+import org.junit.Before;
+import org.junit.BeforeClass;
+import org.junit.Test;
+import org.threeten.bp.Duration;
+
+public class UserServiceTest {
+
+ private static final LocalDatastoreHelper HELPER = LocalDatastoreHelper.create(1.0);
+ private static final DatastoreOptions DATASTORE_OPTIONS = HELPER.getOptions();
+ private static final Datastore DATASTORE = DATASTORE_OPTIONS.getService();
+ private static final String KIND = "DemoUser";
+ private static final UserService USER_SERVICE = new UserService(DATASTORE, KIND);
+ private static final String USER_ID = "myId";
+ private static final String USER_NAME = "myName";
+ private static final String USER_EMAIL = "my@email.com";
+ private static final User USER = new User(USER_ID, USER_NAME, USER_EMAIL);
+ private static final Key USER_KEY =
+ Key.newBuilder(DATASTORE_OPTIONS.getProjectId(), KIND, USER_ID).build();
+ private static final Entity USER_RECORD = Entity.newBuilder(USER_KEY)
+ .set("id", USER_ID)
+ .set("name", USER_NAME)
+ .set("email", USER_EMAIL)
+ .build();
+
+ @BeforeClass
+ public static void beforeClass() throws IOException, InterruptedException {
+ HELPER.start();
+ }
+
+ @Before
+ public void setUp() {
+ StructuredQuery query = Query.newKeyQueryBuilder().build();
+ QueryResults result = DATASTORE.run(query);
+ DATASTORE.delete(Iterators.toArray(result, Key.class));
+ DATASTORE.add(USER_RECORD);
+ }
+
+ @AfterClass
+ public static void afterClass() throws IOException, InterruptedException, TimeoutException {
+ HELPER.stop(Duration.ofMinutes(1));
+ }
+
+ @Test
+ public void testGetAllUsers() {
+ List allUsers = USER_SERVICE.getAllUsers();
+ assertEquals(1, allUsers.size());
+ User actualUser = allUsers.get(0);
+ assertEquals(USER.getId(), actualUser.getId());
+ assertEquals(USER.getName(), actualUser.getName());
+ assertEquals(USER.getEmail(), actualUser.getEmail());
+ }
+
+ @Test
+ public void testCreateUser() {
+ String name = "myNewName";
+ String email = "mynew@email.com";
+ User actualUser = USER_SERVICE.createUser(name, email);
+ assertEquals(name, actualUser.getName());
+ assertEquals(email, actualUser.getEmail());
+ assertNotNull(actualUser.getId());
+ try {
+ USER_SERVICE.createUser(null, email);
+ fail("Expected to fail because name is null.");
+ } catch (IllegalArgumentException e) {
+ assertEquals("Parameter 'name' cannot be empty", e.getMessage());
+ }
+ try {
+ USER_SERVICE.createUser(name, null);
+ fail("Expected to fail because email is null.");
+ } catch (IllegalArgumentException e) {
+ assertEquals("Parameter 'email' cannot be empty", e.getMessage());
+ }
+ }
+
+ @Test
+ public void testDeleteUser() {
+ String result = USER_SERVICE.deleteUser(USER_ID);
+ assertEquals("ok", result);
+ assertNull(DATASTORE.get(USER_KEY));
+ }
+
+ @Test
+ public void testUpdateUser() {
+ String newName = "myNewName";
+ String newEmail = "mynew@email.com";
+ User updatedUser = USER_SERVICE.updateUser(USER_ID, newName, newEmail);
+ assertEquals(USER_ID, updatedUser.getId());
+ assertEquals(newName, updatedUser.getName());
+ assertEquals(newEmail, updatedUser.getEmail());
+ try {
+ USER_SERVICE.updateUser(USER_ID, null, USER_EMAIL);
+ fail("Expected to fail because name is null.");
+ } catch (IllegalArgumentException e) {
+ assertEquals("Parameter 'name' cannot be empty", e.getMessage());
+ }
+ try {
+ USER_SERVICE.updateUser(USER_ID, USER_NAME, null);
+ fail("Expected to fail because email is null.");
+ } catch (IllegalArgumentException e) {
+ assertEquals("Parameter 'email' cannot be empty", e.getMessage());
+ }
+ }
+}
diff --git a/flexible/java-8/static-files/pom.xml b/flexible/java-8/static-files/pom.xml
new file mode 100644
index 00000000000..7d2639c0874
--- /dev/null
+++ b/flexible/java-8/static-files/pom.xml
@@ -0,0 +1,83 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ staticfiles
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/static-files/src/main/appengine/app.yaml b/flexible/java-8/static-files/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..cd1d835c2d1
--- /dev/null
+++ b/flexible/java-8/static-files/src/main/appengine/app.yaml
@@ -0,0 +1,20 @@
+# Copyright 2023 Google 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
+#
+# 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.
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
diff --git a/flexible/java-8/static-files/src/main/webapp/index.html b/flexible/java-8/static-files/src/main/webapp/index.html
new file mode 100644
index 00000000000..d1643e9a6b1
--- /dev/null
+++ b/flexible/java-8/static-files/src/main/webapp/index.html
@@ -0,0 +1,10 @@
+
+
+
+Static Files
+
+
+
+
This is a static file serving example.
+
+
diff --git a/flexible/java-8/static-files/src/main/webapp/stylesheets/styles.css b/flexible/java-8/static-files/src/main/webapp/stylesheets/styles.css
new file mode 100644
index 00000000000..573f441093f
--- /dev/null
+++ b/flexible/java-8/static-files/src/main/webapp/stylesheets/styles.css
@@ -0,0 +1,4 @@
+body {
+ font-family: Verdana, Helvetica, sans-serif;
+ background-color: #CCCCFF;
+}
diff --git a/flexible/java-8/twilio/README.md b/flexible/java-8/twilio/README.md
new file mode 100644
index 00000000000..2091089d907
--- /dev/null
+++ b/flexible/java-8/twilio/README.md
@@ -0,0 +1,40 @@
+# Java Twilio Voice and SMS Sample for Google App Engine Flexible Environment
+
+
+
+
+This sample demonstrates how to use [Twilio](https://www.twilio.com) on [Google
+App flexible environment][aeflex-docs].
+
+See the [sample application documentaion][sample-docs] for more detailed
+instructions.
+
+For more information about Twilio, see their [Java quickstart
+tutorials](https://www.twilio.com/docs/quickstart/java).
+
+[aeflex-docs]: https://cloud.google.com/appengine/docs/flexible/
+[sample-docs]: https://cloud.google.com/appengine/docs/flexible/java/using-sms-and-voice-services-via-twilio
+
+
+## Setup
+
+Before you can run or deploy the sample, you will need to do the following:
+
+1. [Create a Twilio Account](http://ahoy.twilio.com/googlecloudplatform). Google
+ App Engine customers receive a complimentary credit for SMS messages and
+ inbound messages.
+1. Create a number on twilio, and configure the voice request URL to be
+ ``https://your-app-id.appspot.com/call/receive`` and the SMS request URL to
+ be ``https://your-app-id.appspot.com/sms/receive``.
+1. Configure your Twilio settings in the environment variables section in
+ ``src/main/appengine/app.yaml``.
+
+## Running locally
+
+You can run the application locally to test the callbacks and SMS sending. You
+will need to set environment variables before starting your application:
+
+ $ export TWILIO_ACCOUNT_SID=[your-twilio-accoun-sid]
+ $ export TWILIO_AUTH_TOKEN=[your-twilio-auth-token]
+ $ export TWILIO_NUMBER=[your-twilio-number]
+ $ mvn clean jetty:run
diff --git a/flexible/java-8/twilio/pom.xml b/flexible/java-8/twilio/pom.xml
new file mode 100644
index 00000000000..e685584bb09
--- /dev/null
+++ b/flexible/java-8/twilio/pom.xml
@@ -0,0 +1,85 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.flexible
+ twilio
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+
+ false
+
+ 2.4.3
+ 9.4.44.v20210927
+
+
+
+
+
+ com.twilio.sdk
+ twilio-java-sdk
+ 6.3.0
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ ${appengine.maven.plugin}
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty}
+
+
+
+
diff --git a/flexible/java-8/twilio/src/main/appengine/app.yaml b/flexible/java-8/twilio/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..9a1543fa5fc
--- /dev/null
+++ b/flexible/java-8/twilio/src/main/appengine/app.yaml
@@ -0,0 +1,27 @@
+# Copyright 2023 Google 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
+#
+# 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.
+
+runtime: java
+env: flex
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+# [START gae_flex_twilio_env]
+env_variables:
+ TWILIO_ACCOUNT_SID: YOUR-TWILIO-ACCOUNT-SID
+ TWILIO_AUTH_TOKEN: YOUR-TWILIO-AUTH-TOKEN
+ TWILIO_NUMBER: YOUR-TWILIO-NUMBER
+# [END gae_flex_twilio_env]
diff --git a/flexible/java-8/twilio/src/main/java/com/example/twilio/ReceiveCallServlet.java b/flexible/java-8/twilio/src/main/java/com/example/twilio/ReceiveCallServlet.java
new file mode 100644
index 00000000000..53c8874afa9
--- /dev/null
+++ b/flexible/java-8/twilio/src/main/java/com/example/twilio/ReceiveCallServlet.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.twilio;
+
+import com.twilio.sdk.verbs.Say;
+import com.twilio.sdk.verbs.TwiMLException;
+import com.twilio.sdk.verbs.TwiMLResponse;
+import java.io.IOException;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+// [START gae_flex_twilio_receive_call]
+@SuppressWarnings("serial")
+@WebServlet(name = "receivecall", value = "/call/receive")
+public class ReceiveCallServlet extends HttpServlet {
+
+ @Override
+ public void service(HttpServletRequest req, HttpServletResponse resp) throws IOException,
+ ServletException {
+ TwiMLResponse twiml = new TwiMLResponse();
+ Say say = new Say("Hello from Twilio!");
+ try {
+ twiml.append(say);
+ } catch (TwiMLException e) {
+ throw new ServletException("Twilio error", e);
+ }
+
+ resp.setContentType("application/xml");
+ resp.getWriter().print(twiml.toXML());
+ }
+}
+// [END gae_flex_twilio_receive_call]
diff --git a/flexible/java-8/twilio/src/main/java/com/example/twilio/ReceiveSmsServlet.java b/flexible/java-8/twilio/src/main/java/com/example/twilio/ReceiveSmsServlet.java
new file mode 100644
index 00000000000..65f99333bca
--- /dev/null
+++ b/flexible/java-8/twilio/src/main/java/com/example/twilio/ReceiveSmsServlet.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.twilio;
+
+import com.twilio.sdk.verbs.Message;
+import com.twilio.sdk.verbs.TwiMLException;
+import com.twilio.sdk.verbs.TwiMLResponse;
+import java.io.IOException;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+// [START gae_flex_twilio_receive_sms]
+@SuppressWarnings("serial")
+@WebServlet(name = "receivesms", value = "/sms/receive")
+public class ReceiveSmsServlet extends HttpServlet {
+
+ @Override
+ public void service(HttpServletRequest request, HttpServletResponse response) throws IOException,
+ ServletException {
+ String fromNumber = request.getParameter("From");
+ String body = request.getParameter("Body");
+ String message = String.format("Hello, %s, you said %s", fromNumber, body);
+
+ TwiMLResponse twiml = new TwiMLResponse();
+ Message sms = new Message(message);
+ try {
+ twiml.append(sms);
+ } catch (TwiMLException e) {
+ throw new ServletException("Twilio error", e);
+ }
+
+ response.setContentType("application/xml");
+ response.getWriter().print(twiml.toXML());
+ }
+}
+// [END gae_flex_twilio_receive_sms]
diff --git a/flexible/java-8/twilio/src/main/java/com/example/twilio/SendSmsServlet.java b/flexible/java-8/twilio/src/main/java/com/example/twilio/SendSmsServlet.java
new file mode 100644
index 00000000000..1fc2ff12418
--- /dev/null
+++ b/flexible/java-8/twilio/src/main/java/com/example/twilio/SendSmsServlet.java
@@ -0,0 +1,67 @@
+/*
+ * Copyright 2015 Google 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
+ *
+ * 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.twilio;
+
+import com.twilio.sdk.TwilioRestClient;
+import com.twilio.sdk.TwilioRestException;
+import com.twilio.sdk.resource.factory.MessageFactory;
+import com.twilio.sdk.resource.instance.Account;
+import com.twilio.sdk.resource.instance.Message;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+import javax.servlet.ServletException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.apache.http.NameValuePair;
+import org.apache.http.message.BasicNameValuePair;
+
+// [START gae_flex_twilio_send_sms]
+@SuppressWarnings("serial")
+@WebServlet(name = "sendsms", value = "/sms/send")
+public class SendSmsServlet extends HttpServlet {
+
+ @Override
+ public void service(HttpServletRequest req, HttpServletResponse resp) throws IOException,
+ ServletException {
+ final String twilioAccountSid = System.getenv("TWILIO_ACCOUNT_SID");
+ final String twilioAuthToken = System.getenv("TWILIO_AUTH_TOKEN");
+ final String twilioNumber = System.getenv("TWILIO_NUMBER");
+ final String toNumber = (String) req.getParameter("to");
+ if (toNumber == null) {
+ resp.getWriter()
+ .print("Please provide the number to message in the \"to\" query string parameter.");
+ return;
+ }
+ TwilioRestClient client = new TwilioRestClient(twilioAccountSid, twilioAuthToken);
+ Account account = client.getAccount();
+ MessageFactory messageFactory = account.getMessageFactory();
+ List params = new ArrayList();
+ params.add(new BasicNameValuePair("To", toNumber));
+ params.add(new BasicNameValuePair("From", twilioNumber));
+ params.add(new BasicNameValuePair("Body", "Hello from Twilio!"));
+ try {
+ Message sms = messageFactory.create(params);
+ resp.getWriter().print(sms.getBody());
+ } catch (TwilioRestException e) {
+ throw new ServletException("Twilio error", e);
+ }
+ }
+}
+// [END gae_flex_twilio_send_sms]
diff --git a/flexible/java-8/websocket-jetty/README.md b/flexible/java-8/websocket-jetty/README.md
new file mode 100644
index 00000000000..13df8d5d35f
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/README.md
@@ -0,0 +1,62 @@
+# App Engine Flexible Environment - Web Socket Example
+This sample demonstrates how to use [Websockets](https://tools.ietf.org/html/rfc6455) on [Google App Engine Flexible Environment](https://cloud.google.com/appengine/docs/flexible/java/) using Java.
+The sample uses the [native Jetty WebSocket Server API](http://www.eclipse.org/jetty/documentation/9.4.x/jetty-websocket-server-api.html) to create a server-side socket
+and the [native Jetty WebSocket Client API](http://www.eclipse.org/jetty/documentation/9.4.x/jetty-websocket-client-api.html).
+
+## Sample application workflow
+
+1. The sample application creates a server socket using the endpoint `/echo`.
+1. The homepage (`/`) provides a form to submit a text message to the server socket. This creates a client-side socket
+and sends the message to the server.
+1. The server on receiving the message, echoes the message back to the client.
+1. The message received by the client is stored in an in-memory cache and is viewable on the homepage.
+
+The sample also provides a Javascript [client](src/main/webapp/js_client.jsp)(`/js_client.jsp`) that you can use to test against the Websocket server.
+
+## Setup
+
+ - [Install](https://cloud.google.com/sdk/) and initialize GCloud SDK. This will
+ ```
+ gcloud init
+ ```
+- If this is your first time creating an app engine application
+ ```
+ gcloud appengine create
+ ```
+
+## Local testing
+
+Run using the [Jetty Maven plugin](http://www.eclipse.org/jetty/documentation/9.4.x/jetty-maven-plugin.html).
+```
+mvn jetty:run
+```
+You can then direct your browser to `http://localhost:8080/`
+
+To test the Javascript client, access `http://localhost:8080/js_client.jsp`
+
+## App Engine Flex Deployment
+
+#### `app.yaml` Configuration
+
+App Engine Flex deployment configuration is provided in [app.yaml](src/main/appengine/app.yaml).
+
+Set the environment variable `JETTY_MODULES_ENABLE:websocket` to enable the Jetty websocket module on the Jetty server.
+
+Manual scaling is set to a single instance as we are using an in-memory cache of messages for this sample application.
+
+For more details on configuring your `app.yaml`, please refer to [this resource](https://cloud.google.com/appengine/docs/flexible/nodejs/configuring-your-app-with-app-yaml).
+
+#### Deploy
+
+The sample application is packaged as a war, and hence will be automatically run using the [Java 8/Jetty 9 with Servlet 3.1 Runtime](https://cloud.google.com/appengine/docs/flexible/java/dev-jetty9).
+
+```
+mvn clean package appengine:deploy
+```
+You can then direct your browser to `https://YOUR_PROJECT_ID.appspot.com/`
+
+To test the Javascript client, access `https://YOUR_PROJECT_ID.appspot.com/js_client.jsp`
+
+Note: This application constructs a Web Socket URL using `getWebSocketAddress`
+in the [SendServlet Class](src/main/java/com/example/flexible/websocket/jettynative/SendServlet.java)
+. The application assumes the latest version of the service.
diff --git a/flexible/java-8/websocket-jetty/pom.xml b/flexible/java-8/websocket-jetty/pom.xml
new file mode 100644
index 00000000000..a572837edc3
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/pom.xml
@@ -0,0 +1,98 @@
+
+
+ 4.0.0
+
+ org.eclipse.jetty.demo
+ native-jetty-websocket-example
+ 1.0-SNAPSHOT
+ war
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+ false
+ 9.4.46.v20220331
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+ org.eclipse.jetty.websocket
+ websocket-client
+ ${jetty.version}
+
+
+ org.eclipse.jetty.websocket
+ websocket-servlet
+ ${jetty.version}
+ provided
+
+
+ com.google.guava
+ guava
+ 31.1-jre
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.4.4
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty.version}
+
+
+
+
diff --git a/flexible/java-8/websocket-jetty/src/main/appengine/app.yaml b/flexible/java-8/websocket-jetty/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..fad44e84857
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/src/main/appengine/app.yaml
@@ -0,0 +1,33 @@
+# Copyright 2018 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.
+
+runtime: java
+env: flex
+manual_scaling:
+ instances: 1
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+env_variables:
+ JETTY_MODULES_ENABLE: websocket
+
+
+# For applications which can take advantage of session affinity
+# (where the load balancer will attempt to route multiple connections from
+# the same user to the same App Engine instance), uncomment the folowing:
+
+# network:
+# session_affinity: true
diff --git a/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/ClientSocket.java b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/ClientSocket.java
new file mode 100644
index 00000000000..6514debeb98
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/ClientSocket.java
@@ -0,0 +1,62 @@
+/*
+ * Copyright 2018 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.flexible.websocket.jettynative;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.concurrent.ConcurrentLinkedDeque;
+import java.util.logging.Logger;
+import org.eclipse.jetty.websocket.api.Session;
+import org.eclipse.jetty.websocket.api.annotations.OnWebSocketClose;
+import org.eclipse.jetty.websocket.api.annotations.OnWebSocketConnect;
+import org.eclipse.jetty.websocket.api.annotations.OnWebSocketMessage;
+import org.eclipse.jetty.websocket.api.annotations.WebSocket;
+
+/**
+ * Basic Echo Client Socket.
+ */
+@WebSocket(maxTextMessageSize = 64 * 1024)
+public class ClientSocket {
+ private Logger logger = Logger.getLogger(ClientSocket.class.getName());
+ private Session session;
+ // stores the messages in-memory.
+ // Note : this is currently an in-memory store for demonstration,
+ // not recommended for production use-cases.
+ private static Collection messages = new ConcurrentLinkedDeque<>();
+
+ @OnWebSocketClose
+ public void onClose(int statusCode, String reason) {
+ logger.fine("Connection closed: " + statusCode + ":" + reason);
+ this.session = null;
+ }
+
+ @OnWebSocketConnect
+ public void onConnect(Session session) {
+ this.session = session;
+ }
+
+ @OnWebSocketMessage
+ public void onMessage(String msg) {
+ logger.fine("Message Received : " + msg);
+ messages.add(msg);
+ }
+
+ // Retrieve all received messages.
+ public static Collection getReceivedMessages() {
+ return Collections.unmodifiableCollection(messages);
+ }
+}
diff --git a/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/EchoServlet.java b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/EchoServlet.java
new file mode 100644
index 00000000000..66b177d8b30
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/EchoServlet.java
@@ -0,0 +1,44 @@
+/*
+ * Copyright 2018 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.flexible.websocket.jettynative;
+
+import javax.servlet.annotation.WebServlet;
+import org.eclipse.jetty.websocket.servlet.ServletUpgradeRequest;
+import org.eclipse.jetty.websocket.servlet.ServletUpgradeResponse;
+import org.eclipse.jetty.websocket.servlet.WebSocketCreator;
+import org.eclipse.jetty.websocket.servlet.WebSocketServlet;
+import org.eclipse.jetty.websocket.servlet.WebSocketServletFactory;
+
+/*
+ * Server-side WebSocket upgraded on /echo servlet.
+ */
+@SuppressWarnings("serial")
+@WebServlet(
+ name = "Echo WebSocket Servlet",
+ urlPatterns = {"/echo"})
+public class EchoServlet extends WebSocketServlet implements WebSocketCreator {
+ @Override
+ public void configure(WebSocketServletFactory factory) {
+ factory.setCreator(this);
+ }
+
+ @Override
+ public Object createWebSocket(
+ ServletUpgradeRequest servletUpgradeRequest, ServletUpgradeResponse servletUpgradeResponse) {
+ return new ServerSocket();
+ }
+}
diff --git a/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/SendServlet.java b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/SendServlet.java
new file mode 100644
index 00000000000..06fd362e646
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/SendServlet.java
@@ -0,0 +1,143 @@
+/*
+ * Copyright 2018 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.flexible.websocket.jettynative;
+
+import com.google.common.base.Preconditions;
+import java.io.IOException;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.util.concurrent.Future;
+import java.util.logging.Logger;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.eclipse.jetty.client.HttpClient;
+import org.eclipse.jetty.http.HttpStatus;
+import org.eclipse.jetty.util.ssl.SslContextFactory;
+import org.eclipse.jetty.websocket.api.Session;
+import org.eclipse.jetty.websocket.client.ClientUpgradeRequest;
+import org.eclipse.jetty.websocket.client.WebSocketClient;
+
+@WebServlet("/send")
+/** Servlet that sends the message sent over POST to over a websocket connection. */
+public class SendServlet extends HttpServlet {
+
+ private Logger logger = Logger.getLogger(SendServlet.class.getName());
+
+ private static final String ENDPOINT = "/echo";
+ private static final String WEBSOCKET_PROTOCOL_PREFIX = "ws://";
+ private static final String WEBSOCKET_HTTPS_PROTOCOL_PREFIX = "wss://";
+ private static final String APPENGINE_HOST_SUFFIX = ".appspot.com";
+
+ // GAE_INSTANCE environment is used to detect App Engine Flexible Environment
+ private static final String GAE_INSTANCE_VAR = "GAE_INSTANCE";
+ // GOOGLE_CLOUD_PROJECT environment variable is set to the GCP project ID on App Engine Flexible.
+ private static final String GOOGLE_CLOUD_PROJECT_ENV_VAR = "GOOGLE_CLOUD_PROJECT";
+ // GAE_SERVICE environment variable is set to the GCP service name.
+ private static final String GAE_SERVICE_ENV_VAR = "GAE_SERVICE";
+
+ private final HttpClient httpClient;
+ private final WebSocketClient webSocketClient;
+ private final ClientSocket clientSocket;
+
+ public SendServlet() {
+ this.httpClient = createHttpClient();
+ this.webSocketClient = createWebSocketClient();
+ this.clientSocket = new ClientSocket();
+ }
+
+ @Override
+ public void doPost(HttpServletRequest request, HttpServletResponse response) throws IOException {
+ String message = request.getParameter("message");
+ try {
+ sendMessageOverWebSocket(message);
+ response.sendRedirect("/");
+ } catch (Exception e) {
+ logger.severe("Error sending message over socket: " + e.getMessage());
+ e.printStackTrace(response.getWriter());
+ response.setStatus(HttpStatus.INTERNAL_SERVER_ERROR_500);
+ }
+ }
+
+ private HttpClient createHttpClient() {
+ HttpClient httpClient;
+ if (System.getenv(GAE_INSTANCE_VAR) != null) {
+ // If on HTTPS, create client with SSL Context
+ SslContextFactory sslContextFactory = new SslContextFactory();
+ httpClient = new HttpClient(sslContextFactory);
+ } else {
+ // local testing on HTTP
+ httpClient = new HttpClient();
+ }
+ return httpClient;
+ }
+
+ private WebSocketClient createWebSocketClient() {
+ return new WebSocketClient(this.httpClient);
+ }
+
+ private void sendMessageOverWebSocket(String message) throws Exception {
+ if (!httpClient.isRunning()) {
+ try {
+ httpClient.start();
+ } catch (URISyntaxException e) {
+ e.printStackTrace();
+ }
+ }
+ if (!webSocketClient.isRunning()) {
+ try {
+ webSocketClient.start();
+ } catch (URISyntaxException e) {
+ e.printStackTrace();
+ }
+ }
+ ClientUpgradeRequest request = new ClientUpgradeRequest();
+ // Attempt connection
+ Future future =
+ webSocketClient.connect(clientSocket, new URI(getWebSocketAddress()), request);
+ // Wait for Connect
+ Session session = future.get();
+ // Send a message
+ session.getRemote().sendString(message);
+ // Close session
+ session.close();
+ }
+
+ /**
+ * Returns the host:port/echo address a client needs to use to communicate with the server. On App
+ * engine Flex environments, result will be in the form wss://project-id.appspot.com/echo
+ */
+ public static String getWebSocketAddress() {
+ // Use ws://127.0.0.1:8080/echo when testing locally
+ String webSocketHost = "127.0.0.1:8080";
+ String webSocketProtocolPrefix = WEBSOCKET_PROTOCOL_PREFIX;
+
+ // On App Engine flexible environment, use wss://project-id.appspot.com/echo
+ if (System.getenv(GAE_INSTANCE_VAR) != null) {
+ String projectId = System.getenv(GOOGLE_CLOUD_PROJECT_ENV_VAR);
+ if (projectId != null) {
+ String serviceName = System.getenv(GAE_SERVICE_ENV_VAR);
+ webSocketHost = serviceName + "-dot-" + projectId + APPENGINE_HOST_SUFFIX;
+ }
+ Preconditions.checkNotNull(webSocketHost);
+ // Use wss:// instead of ws:// protocol when connecting over https
+ webSocketProtocolPrefix = WEBSOCKET_HTTPS_PROTOCOL_PREFIX;
+ }
+ return webSocketProtocolPrefix + webSocketHost + ENDPOINT;
+ }
+}
diff --git a/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/ServerSocket.java b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/ServerSocket.java
new file mode 100644
index 00000000000..ed82ca2b23a
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/src/main/java/com/example/flexible/websocket/jettynative/ServerSocket.java
@@ -0,0 +1,63 @@
+/*
+ * Copyright 2018 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.flexible.websocket.jettynative;
+
+import java.io.IOException;
+import java.util.logging.Logger;
+import org.eclipse.jetty.websocket.api.Session;
+import org.eclipse.jetty.websocket.api.WebSocketAdapter;
+import org.eclipse.jetty.websocket.api.annotations.OnWebSocketClose;
+import org.eclipse.jetty.websocket.api.annotations.OnWebSocketConnect;
+import org.eclipse.jetty.websocket.api.annotations.OnWebSocketError;
+import org.eclipse.jetty.websocket.api.annotations.OnWebSocketMessage;
+import org.eclipse.jetty.websocket.api.annotations.WebSocket;
+
+/*
+ * Server-side WebSocket : echoes received message back to client.
+ */
+@WebSocket(maxTextMessageSize = 64 * 1024)
+public class ServerSocket {
+ private Logger logger = Logger.getLogger(SendServlet.class.getName());
+ private Session session;
+
+ @OnWebSocketConnect
+ public void onWebSocketConnect(Session session) {
+ this.session = session;
+ logger.fine("Socket Connected: " + session);
+ }
+
+ @OnWebSocketMessage
+ public void onWebSocketText(String message) {
+ logger.fine("Received message: " + message);
+ try {
+ // echo message back to client
+ this.session.getRemote().sendString(message);
+ } catch (IOException e) {
+ logger.severe("Error echoing message: " + e.getMessage());
+ }
+ }
+
+ @OnWebSocketClose
+ public void onWebSocketClose(int statusCode, String reason) {
+ logger.fine("Socket Closed: [" + statusCode + "] " + reason);
+ }
+
+ @OnWebSocketError
+ public void onWebSocketError(Throwable cause) {
+ logger.severe("Websocket error : " + cause.getMessage());
+ }
+}
diff --git a/flexible/java-8/websocket-jetty/src/main/webapp/WEB-INF/jetty-web.xml b/flexible/java-8/websocket-jetty/src/main/webapp/WEB-INF/jetty-web.xml
new file mode 100644
index 00000000000..b7dcc424f62
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/src/main/webapp/WEB-INF/jetty-web.xml
@@ -0,0 +1,23 @@
+
+
+
+
+ true
+
+ -org.eclipse.jetty.
+
+
diff --git a/flexible/java-8/websocket-jetty/src/main/webapp/index.jsp b/flexible/java-8/websocket-jetty/src/main/webapp/index.jsp
new file mode 100644
index 00000000000..1f0db29e101
--- /dev/null
+++ b/flexible/java-8/websocket-jetty/src/main/webapp/index.jsp
@@ -0,0 +1,33 @@
+
+
+<%@ page import="com.example.flexible.websocket.jettynative.ClientSocket" %>
+
+
+
+
+ Send a message
+
+
+
+
+
+
diff --git a/flexible/java-8/websocket-jsr356/README.md b/flexible/java-8/websocket-jsr356/README.md
new file mode 100644
index 00000000000..a7b51ed57be
--- /dev/null
+++ b/flexible/java-8/websocket-jsr356/README.md
@@ -0,0 +1,57 @@
+# App Engine Flexible Environment - Web Socket Example
+This sample demonstrates how to use [Websockets](https://tools.ietf.org/html/rfc6455) on [Google App Engine Flexible Environment](https://cloud.google.com/appengine/docs/flexible/java/) using Java.
+The sample uses the [JSR-356](https://www.jcp.org/en/jsr/detail?id=356) Java API for the Websocket [client](https://mvnrepository.com/artifact/org.eclipse.jetty.websocket/javax-websocket-client-impl).
+
+## Sample application workflow
+
+1. The sample application creates a server socket using the endpoint `/echo`.
+1. The homepage (`/`) provides a form to submit a text message to the server socket. This creates a client-side socket
+and sends the message to the server.
+1. The server on receiving the message, echoes the message back to the client.
+1. The message received by the client is stored in an in-memory cache and is viewable on the homepage.
+
+The sample also provides a Javascript [client](src/main/webapp/js_client.jsp)(`/js_client.jsp`) that you can use to test against the Websocket server.
+
+## Setup
+
+ - [Install](https://cloud.google.com/sdk/) and initialize GCloud SDK. This will
+ ```
+ gcloud init
+ ```
+- If this is your first time creating an app engine application
+ ```
+ gcloud appengine create
+ ```
+
+## Local testing
+
+Run using the [Jetty Maven plugin](http://www.eclipse.org/jetty/documentation/9.4.x/jetty-maven-plugin.html).
+```
+mvn jetty:run
+```
+You can then direct your browser to `http://localhost:8080/`
+
+To test the Javascript client, access `http://localhost:8080/js_client.jsp`
+
+## App Engine Flex Deployment
+
+#### `app.yaml` Configuration
+
+App Engine Flex deployment configuration is provided in [app.yaml](src/main/appengine/app.yaml).
+
+Set the environment variable `JETTY_MODULES_ENABLE:websocket` to enable the Jetty websocket module on the Jetty server.
+
+Manual scaling is set to a single instance as we are using an in-memory cache of messages for this sample application.
+
+For more details on configuring your `app.yaml`, please refer to [this resource](https://cloud.google.com/appengine/docs/flexible/nodejs/configuring-your-app-with-app-yaml).
+
+#### Deploy
+
+The sample application is packaged as a war, and hence will be automatically run using the [Java 8/Jetty 9 with Servlet 3.1 Runtime](https://cloud.google.com/appengine/docs/flexible/java/dev-jetty9).
+
+```
+ mvn clean package appengine:deploy
+```
+You can then direct your browser to `https://YOUR_PROJECT_ID.appspot.com/`
+
+To test the Javascript client, access `https://YOUR_PROJECT_ID.appspot.com/js_client.jsp`
diff --git a/flexible/java-8/websocket-jsr356/pom.xml b/flexible/java-8/websocket-jsr356/pom.xml
new file mode 100644
index 00000000000..5b63f9442cd
--- /dev/null
+++ b/flexible/java-8/websocket-jsr356/pom.xml
@@ -0,0 +1,95 @@
+
+
+ 4.0.0
+ 1.0-SNAPSHOT
+ com.example.flexible
+ appengine-websocket-jsr356
+ war
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 1.8
+ 1.8
+ false
+ 9.4.46.v20220331
+
+
+
+
+ javax.servlet
+ javax.servlet-api
+ 3.1.0
+ jar
+ provided
+
+
+
+ org.eclipse.jetty.websocket
+ javax-websocket-client-impl
+ ${jetty.version}
+
+
+ javax
+ javaee-api
+ 8.0.1
+
+
+
+ com.google.guava
+ guava
+ 31.1-jre
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.3.2
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.4.4
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.eclipse.jetty
+ jetty-maven-plugin
+ ${jetty.version}
+
+
+
+
diff --git a/flexible/java-8/websocket-jsr356/src/main/appengine/app.yaml b/flexible/java-8/websocket-jsr356/src/main/appengine/app.yaml
new file mode 100644
index 00000000000..fad44e84857
--- /dev/null
+++ b/flexible/java-8/websocket-jsr356/src/main/appengine/app.yaml
@@ -0,0 +1,33 @@
+# Copyright 2018 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.
+
+runtime: java
+env: flex
+manual_scaling:
+ instances: 1
+
+handlers:
+- url: /.*
+ script: this field is required, but ignored
+
+env_variables:
+ JETTY_MODULES_ENABLE: websocket
+
+
+# For applications which can take advantage of session affinity
+# (where the load balancer will attempt to route multiple connections from
+# the same user to the same App Engine instance), uncomment the folowing:
+
+# network:
+# session_affinity: true
diff --git a/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/ClientSocket.java b/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/ClientSocket.java
new file mode 100644
index 00000000000..10ea0285cfd
--- /dev/null
+++ b/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/ClientSocket.java
@@ -0,0 +1,110 @@
+/*
+ * Copyright 2018 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.flexible.websocket.jsr356;
+
+import com.google.common.util.concurrent.SettableFuture;
+import java.net.URI;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.concurrent.ConcurrentLinkedDeque;
+import java.util.concurrent.ExecutionException;
+import java.util.logging.Logger;
+import javax.websocket.ClientEndpoint;
+import javax.websocket.CloseReason;
+import javax.websocket.ContainerProvider;
+import javax.websocket.OnClose;
+import javax.websocket.OnError;
+import javax.websocket.OnMessage;
+import javax.websocket.OnOpen;
+import javax.websocket.Session;
+import javax.websocket.WebSocketContainer;
+
+/**
+ * Web socket client example using JSR-356 Java WebSocket API. Sends a message to the server, and
+ * stores the echoed messages received from the server.
+ */
+@ClientEndpoint
+public class ClientSocket {
+
+ private static final Logger logger = Logger.getLogger(ClientSocket.class.getName());
+
+ // stores the messages in-memory.
+ // Note : this is currently an in-memory store for demonstration,
+ // not recommended for production use-cases.
+ private static Collection messages = new ConcurrentLinkedDeque<>();
+
+ private SettableFuture future = SettableFuture.create();
+ private Session session;
+
+ ClientSocket(URI endpointUri) {
+ try {
+ WebSocketContainer container = ContainerProvider.getWebSocketContainer();
+ session = container.connectToServer(this, endpointUri);
+ } catch (Exception e) {
+ throw new RuntimeException(e);
+ }
+ }
+
+ @OnOpen
+ public void onOpen(Session session) {
+ future.set(true);
+ }
+
+ /**
+ * Handles message received from the server.
+ *
+ * @param message server message in String format
+ * @param session current session
+ */
+ @OnMessage
+ public void onMessage(String message, Session session) {
+ logger.fine("Received message from server : " + message);
+ messages.add(message);
+ }
+
+ boolean waitOnOpen() throws InterruptedException, ExecutionException {
+ // wait on handling onOpen
+ boolean opened = future.get();
+ logger.fine("Connected to server");
+ return opened;
+ }
+
+ @OnClose
+ public void onClose(CloseReason reason, Session session) {
+ logger.fine("Closing Web Socket: " + reason.getReasonPhrase());
+ }
+
+ void sendMessage(String str) {
+ try {
+ // Send a message to the server
+ logger.fine("Sending message : " + str);
+ session.getAsyncRemote().sendText(str);
+ } catch (Exception e) {
+ logger.severe("Error sending message : " + e.getMessage());
+ }
+ }
+
+ // Retrieve all received messages.
+ public static Collection getReceivedMessages() {
+ return Collections.unmodifiableCollection(messages);
+ }
+
+ @OnError
+ public void logErrors(Throwable t) {
+ logger.severe(t.getMessage());
+ }
+}
diff --git a/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/SendServlet.java b/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/SendServlet.java
new file mode 100644
index 00000000000..0ea5a04a168
--- /dev/null
+++ b/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/SendServlet.java
@@ -0,0 +1,67 @@
+/*
+ * Copyright 2018 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.flexible.websocket.jsr356;
+
+import com.google.common.base.Preconditions;
+import java.io.IOException;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.util.logging.Logger;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.eclipse.jetty.http.HttpStatus;
+
+@WebServlet("/send")
+/** Servlet that converts the message sent over POST to be over websocket. */
+public class SendServlet extends HttpServlet {
+
+ private Logger logger = Logger.getLogger(SendServlet.class.getName());
+ private final String webSocketAddress = ServerSocket.getWebSocketAddress();
+ private ClientSocket clientSocket;
+
+ private void initializeWebSocket() throws Exception {
+ clientSocket = new ClientSocket(new URI(webSocketAddress));
+ clientSocket.waitOnOpen();
+ logger.info("REST service: open websocket client at " + webSocketAddress);
+ }
+
+ private void sendMessageOverWebSocket(String message) throws Exception {
+ if (clientSocket == null) {
+ try {
+ initializeWebSocket();
+ } catch (URISyntaxException e) {
+ e.printStackTrace();
+ }
+ }
+ clientSocket.sendMessage(message);
+ }
+
+ @Override
+ public void doPost(HttpServletRequest request, HttpServletResponse response) throws IOException {
+ String message = request.getParameter("message");
+ Preconditions.checkNotNull(message);
+ try {
+ sendMessageOverWebSocket(message);
+ response.sendRedirect("/");
+ } catch (Exception e) {
+ e.printStackTrace(response.getWriter());
+ response.setStatus(HttpStatus.INTERNAL_SERVER_ERROR_500);
+ }
+ }
+}
diff --git a/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/ServerSocket.java b/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/ServerSocket.java
new file mode 100644
index 00000000000..ba7a74de87a
--- /dev/null
+++ b/flexible/java-8/websocket-jsr356/src/main/java/com/example/flexible/websocket/jsr356/ServerSocket.java
@@ -0,0 +1,94 @@
+/*
+ * Copyright 2018 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.flexible.websocket.jsr356;
+
+import com.google.common.base.Preconditions;
+import java.io.IOException;
+import java.util.logging.Logger;
+import javax.websocket.CloseReason;
+import javax.websocket.OnClose;
+import javax.websocket.OnMessage;
+import javax.websocket.OnOpen;
+import javax.websocket.Session;
+import javax.websocket.server.ServerEndpoint;
+
+/**
+ * WebSocket server example using JSR-356 Java WebSocket API. Echoes back the message received over
+ * the websocket back to the client.
+ */
+@ServerEndpoint("/echo")
+public class ServerSocket {
+
+ private static final Logger logger = Logger.getLogger(ServerSocket.class.getName());
+ private static final String ENDPOINT = "/echo";
+ private static final String WEBSOCKET_PROTOCOL_PREFIX = "ws://";
+ private static final String WEBSOCKET_HTTPS_PROTOCOL_PREFIX = "wss://";
+ private static final String APPENGINE_HOST_SUFFIX = ".appspot.com";
+ // GAE_INSTANCE environment is used to detect App Engine Flexible Environment
+ private static final String GAE_INSTANCE_VAR = "GAE_INSTANCE";
+ // GOOGLE_CLOUD_PROJECT environment variable is set to the GCP project ID on App Engine Flexible.
+ private static final String GOOGLE_CLOUD_PROJECT_ENV_VAR = "GOOGLE_CLOUD_PROJECT";
+ // GAE_SERVICE environment variable is set to the GCP service name.
+ private static final String GAE_SERVICE_ENV_VAR = "GAE_SERVICE";
+
+ @OnOpen
+ public void onOpen(Session session) {
+ logger.info("WebSocket Opened: " + session.getId());
+ }
+
+ /**
+ * Handle a message received from the client, and echo back to the client.
+ *
+ * @param message Message in text format
+ * @param session Current active session
+ * @throws IOException error sending message back to client
+ */
+ @OnMessage
+ public void onMessage(String message, Session session) throws IOException {
+ logger.fine("Message Received : " + message);
+ // echo message back to the client
+ session.getAsyncRemote().sendText(message);
+ }
+
+ @OnClose
+ public void onClose(CloseReason reason, Session session) {
+ logger.fine("Closing WebSocket: " + reason.getReasonPhrase());
+ }
+
+ /**
+ * Returns the host:port/echo address a client needs to use to communicate with the server. On App
+ * engine Flex environments, result will be in the form wss://project-id.appspot.com/echo
+ */
+ public static String getWebSocketAddress() {
+ // Use ws://127.0.0.1:8080/echo when testing locally
+ String webSocketHost = "127.0.0.1:8080";
+ String webSocketProtocolPrefix = WEBSOCKET_PROTOCOL_PREFIX;
+
+ // On App Engine flexible environment, use wss://project-id.appspot.com/echo
+ if (System.getenv(GAE_INSTANCE_VAR) != null) {
+ String projectId = System.getenv(GOOGLE_CLOUD_PROJECT_ENV_VAR);
+ if (projectId != null) {
+ String serviceName = System.getenv(GAE_SERVICE_ENV_VAR);
+ webSocketHost = serviceName + "-dot-" + projectId + APPENGINE_HOST_SUFFIX;
+ }
+ Preconditions.checkNotNull(webSocketHost);
+ // Use wss:// instead of ws:// protocol when connecting over https
+ webSocketProtocolPrefix = WEBSOCKET_HTTPS_PROTOCOL_PREFIX;
+ }
+ return webSocketProtocolPrefix + webSocketHost + ENDPOINT;
+ }
+}
diff --git a/flexible/java-8/websocket-jsr356/src/main/webapp/index.jsp b/flexible/java-8/websocket-jsr356/src/main/webapp/index.jsp
new file mode 100644
index 00000000000..59de3a7c803
--- /dev/null
+++ b/flexible/java-8/websocket-jsr356/src/main/webapp/index.jsp
@@ -0,0 +1,33 @@
+
+
+<%@ page import="com.example.flexible.websocket.jsr356.ClientSocket" %>
+
+
+
+
+ Send a message
+
+
+
+
+This web app demonstrates using asynchronous servlet techniques to reduce server resources.
+
+The code for this tutorial is [here](https://github.com/GoogleCloudPlatform/java-docs-samples/tree/main/flexible/async-rest).
+
+
+## Initial Setup ##
+
+First, complete the following steps:
+
+- [Create your project](https://developers.google.com/appengine/docs/managed-vms/) and have it enabled for Managed VMs.
+- Obtain an app key for the Google Places WebService API.
+- Download and install [the Beta build of the Google Cloud SDK](https://developers.google.com/cloud/sdk/#Quick_Start).
+- Install the Cloud SDK `app-engine-java` component.
+- Authenticate wth the gcloud SDK: gcloud auth application-default login.
+- Install [Maven](http://maven.apache.org/download.cgi) if you haven't already.
+
+
+## Providing your Google Places API key ##
+
+To run locally, you need to edit the pom.xml file and replace YOUR_PLACES_APP_KEY with the value of your key:
+
+ 
"
+ + "
"
+ + "