Sie müssen Ihre Anwendungen auf die neueste unterstützte Laufzeitversion aktualisieren, um weiterhin Sicherheitsupdates zu erhalten und Anspruch auf technischen Support zu haben.
Das Upgradeprozess einer vorhandenen Anwendung hängt von der Laufzeitversion ab, die Ihre Anwendung derzeit verwendet:
Java 8: Sie müssen Ihre App zur neuesten unterstützten Java-Version migrieren. Java 8 hat das Ende des Supports am 31. Januar 2024 erreicht. Ihre vorhandenen Java 8-Anwendungen werden weiterhin ausgeführt und erhalten Traffic. Sie können jedoch keine neuen Anwendungen bereitstellen oder vorhandene Anwendungen aktualisieren, die Laufzeiten verwenden, für die der Support abgelaufen ist.
Java-Laufzeiten der zweiten Generation (nach Ende der Unterstützung): Wenn Sie ein Upgrade auf eine unterstützte Java-Version durchführen möchten, gehen Sie so vor:
Aktualisieren Sie die
app.yaml
-Datei, indem Sie eine Java-Version angeben, mit der Ihre App ausgeführt werden soll. Beispiel:runtime: javaVERSION
Dabei ist VERSION die
MAJOR
-Versionsnummer. Wenn Sie beispielsweise die neueste Java-Version (Java 21) verwenden möchten, geben Sie21
an. Weitere Informationen finden Sie in der Java-Laufzeitübersicht.Wenn Sie gebündelte Legacy-Dienste verwenden, müssen Sie Ihre Anwendungen aktualisieren, dass sie auf einem der Folgenden ausgeführt werden:
Java Enterprise Edition 10 (EE10 – Standard, empfohlen): Java EE10 unterstützt keine
javax.servlet.*
APIs und erfordert die Aktualisierung Ihrer Anwendungen und Drittanbieterabhängigkeiten, um neuere Java-Artefakte wie NamespaceJakarta
zu verwenden.Java Enterprise Edition 8 (EE8): Mit Java EE8 können Sie
javax.servlet.*
APIs verwenden. Sie müssen jedoch kleinere Konfigurationsänderungen an der Dateiappengine-web.xml
vornehmen.Alle Optionen finden Sie unter Upgrade auf Java 21 für gebündelte Legacy-Dienste.
Java 17:
Diese Version wird von der App Engine unterstützt. So führen Sie ein Upgrade auf die neueste unterstützte Version durch:
Aktualisieren Sie die Datei
app.yaml
, indem Sie eine Java-Version angeben, mit der Ihre App ausgeführt werden soll. Beispiel:runtime: javaVERSION
Dabei ist VERSION die
MAJOR
-Versionsnummer. Wenn Sie beispielsweise die neueste Java-Version (Java 21) verwenden möchten, geben Sie21
an. Weitere Informationen finden Sie in der Java-Laufzeitübersicht.Wenn Sie gebündelte Legacy-Dienste verwenden, müssen Sie Ihre Anwendungen aktualisieren, dass sie auf einem der Folgenden ausgeführt werden:
Java Enterprise Edition 10 (EE10 – Standard, empfohlen): Java EE10 unterstützt keine
javax.servlet.*
APIs und erfordert die Aktualisierung Ihrer Anwendungen und Drittanbieterabhängigkeiten, um neuere Java-Artefakte wie NamespaceJakarta
zu verwenden.Java Enterprise Edition 8 (EE8): Mit Java EE8 können Sie
javax.servlet.*
APIs verwenden. Sie müssen jedoch kleinere Konfigurationsänderungen an der Dateiappengine-web.xml
vornehmen.
Alle Optionen finden Sie unter Upgrade auf Java 21 für gebündelte Legacy-Dienste.
Upgrade auf Java 21 für gebündelte Legacy-Dienste
Java-Laufzeitkompatibilität
In der folgenden Tabelle sehen Sie, welche Java-Versionen mit Ihren Jetty- und Servlet-Versionen kompatibel sind:
Enterprise Edition (EE) | Jetty-Version | Java-Version | Servlet | Kompatibilität |
---|---|---|---|---|
EE7 | 9.4 | 11 | 2.5 oder 3.1 | |
EE7 | 9.4 | 17 | 2.5 oder 3.1 | |
EE8 | 12 | 21 | 2.5 und höher | Java EE8 ist abwärtskompatibel mit Java EE6 und höher. Weitere Informationen finden Sie unter Upgrade auf Java 21 in EE8. |
EE10 | 12 | 21 | 6.0 empfohlen Java 21 ist standardmäßig für die Ausführung von EE10 konfiguriert. | Wenn Sie Java EE10 verwenden möchten, müssen Sie die Servlets und Abhängigkeiten Ihrer Anwendung so aktualisieren, dass der Jakarta -Namespace enthalten ist. Weitere Informationen finden Sie unter Java 21 in EE10 upgraden. |
Upgrade auf Java 21 in EE10
Wenn Sie Java 21 in Enterprise Edition 10 (EE10) verwenden möchten, müssen Sie die Servlets und Abhängigkeiten Ihrer Anwendung in Ihren Maven- und Gradle-Dateien so aktualisieren, dass der Namespace Jakarta
enthalten ist:
Ändern Sie die Versionsnummer in der Konfigurationsdatei
web.xml
inversion=6.0
. Beispiel:<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd" version="6.0"> ... </web-app>
Benennen Sie die Servlets und Abhängigkeiten Ihrer Anwendung von
javax.servlet.*
injakarta.servlet.*
um:import jakarta.servlet.ServletException; import jakarta.servlet.annotation.WebServlet; import jakarta.servlet.http.Cookie; import jakarta.servlet.http.HttpServlet; import jakarta.servlet.http.HttpServletRequest; import jakarta.servlet.http.HttpServletResponse; @WebServlet(name = "viewer", urlPatterns = {"/view"}) public class MyServlet extends HttpServlet { ......
Aktualisieren Sie je nach
Jakarta
-Namespace die verbleibenden Anwendungs-Drittanbieter-Abhängigkeiten auf neuere Java-Artefakte.Optional: Java 21 unterstützt virtuelle Threads. Wenn Sie virtuelle Threads aktivieren möchten, fügen Sie der Datei
appengine-web.xml
das Attributappengine.use.virtualthreads
im Tagsystem-properties
hinzu.
Upgrade auf Java 21 in EE8
Sie können javax.servlet.*
APIs unter Java EE 8 weiterhin ohne größere Änderungen an der Anwendungskonfiguration verwenden, da Jetty 12 rückwärtskompatibel mit Java EE 6 und höher ist. Zur Ausführung Ihrer Anwendungen auf Java EE8 müssen Sie ein neues system-properties
-Tag in Ihrer appengine-web.xml
-Datei mit dem nicht standardmäßigen app.engine.use.EE8
Konfiguration deklarieren.:
<?xml version="1.0" encoding="utf-8"?>
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
<runtime>java21</runtime>
<system-properties>
<property name="appengine.use.EE8" value="true"/>
</system-properties>
<app-engine-apis>true</app-engine-apis>
</appengine-web-app>
Optional: Java 21 unterstützt virtuelle Threads. Wenn Sie virtuelle Threads aktivieren möchten, fügen Sie die Eigenschaft appengine.use.virtualthreads
in das Tag system-properties
ein. Beispiel:
<property name="appengine.use.virtualthreads" value="true"/>