This is a repository that contains Java code samples for Google App Engine standard environment Java 11 Bundled Services. The Google App Engine standard environment Java 11 Bundled Services is an environment as close as possible as the original Google App Engine standard environment Java 8 which is using WAR packaging, GAE APIs and configured via appengine-web.xml instead of app.yaml

These samples use the Apache Maven build system. Before getting started, be sure to download and install it. When you use Maven as described here, it will automatically download the needed client libraries.

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.
2. In the drop-down menu at the top, select Create a project.
3. Give your project a name.
4. 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.

The only differences between a Java8 application and a Java11 application are the addition of the bundled services JAR, and an added line in the appengine-web.xml file where you need to define the Java11 runtime and declare you need the App Engine APIs:

In appengine-web.xml:

<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
    <runtime>java11</runtime>
    <app-engine-apis>true</app-engine-apis>
</appengine-web-app>

In your pom.xml's <dependencies>:

<dependency>
    <groupId>com.google.appengine</groupId>
    <artifactId>appengine-api-1.0-sdk</artifactId>
    <version>2.0.4</version> <!-- or later-->
</dependency>

 mvn appengine:deploy

Everything else should remain the same in terms of App Engine APIs access, WAR project packaging, and deployment. This way, it should be easy to migrate your existing GAE Java8 applications to GAE Java11.

This sample demonstrates how to use the App Engine Datastore APIs in a Java11 web application on Google App Engine Java11.

• Documentation
• Code

You can execute the following steps to transform the java8 appengine-web.xml file to a java11 appengine-web.xml file:

git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
cd java-docs-samples
cp -pr appengine-java8 /tmp/java11-samples
cd /tmp/java11-samples
# On Linux:
shopt -s globstar dotglob
for f in **/appengine-web.xml; do sed -i 's.<runtime>java8</runtime>.<runtime>java11</runtime><app-engine-apis>true</app-engine-apis>.' ${f}; done 
# on MacOS
for f in **/appengine-web.xml; do sed -i'' -e 's.<runtime>java8</runtime>.<runtime>java11</runtime><app-engine-apis>true</app-engine-apis>.' ${f}; done

You will see in the tmp/java11 directory all the correct code samples to compile and deploy to the Java11 AppEngine runtime, with bundled services. Just follow the same documentation as the Java8 samples.