Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Anda harus mengupgrade aplikasi ke versi runtime terbaru yang didukung agar dapat terus menerima update keamanan
dan memenuhi syarat untuk mendapatkan dukungan teknis.
Proses mengupgrade aplikasi yang sudah ada bergantung pada versi runtime yang
saat ini digunakan aplikasi Anda:
Java 8: Anda harus memigrasikan aplikasi ke versi Java terbaru yang didukung. Java 8 telah mencapai akhir dukungan pada 31 Januari 2024. Aplikasi
Java 8 yang ada akan terus berjalan dan menerima traffic. Namun,
Anda tidak dapat men-deploy aplikasi baru atau mengupdate aplikasi yang ada yang menggunakan runtime setelah tanggal akhir dukungannya.
Runtime Java generasi kedua (setelah akhir dukungan): Untuk mengupgrade ke
versi Java yang didukung,
lakukan tindakan berikut:
Update file app.yaml dengan menentukan versi Java yang ingin dijalankan
aplikasi Anda. Contoh:
runtime:javaVERSION
Dengan VERSION adalah nomor versi MAJOR.
Misalnya, untuk menggunakan versi Java terbaru, Java 21,
tentukan 21.
Untuk mengetahui informasi selengkapnya, lihat
ringkasan runtime Java.
Jika menggunakan layanan paket lama, Anda harus mengupgrade aplikasi agar dapat berjalan
di:
Java Enterprise Edition 10 (EE10 - default, direkomendasikan): Java EE10
tidak mendukung javax.servlet.* API dan mengharuskan Anda mengupdate
aplikasi dan dependensi pihak ketiga untuk menggunakan artefak Java yang lebih baru
seperti namespace Jakarta.
Java Enterprise Edition 8 (EE8): Java EE8 memungkinkan Anda menggunakan API javax.servlet.*, tetapi Anda harus melakukan perubahan konfigurasi kecil pada file appengine-web.xml.
App Engine mendukung versi ini. Untuk terus mengupgrade ke
versi dukungan terbaru, lakukan hal berikut:
Update file app.yaml dengan menentukan versi Java yang ingin dijalankan
aplikasi Anda. Contoh:
runtime:javaVERSION
Dengan VERSION adalah nomor versi MAJOR.
Misalnya, untuk menggunakan versi Java terbaru, Java 21,
tentukan 21.
Untuk mengetahui informasi selengkapnya, lihat
ringkasan runtime Java.
Jika menggunakan layanan paket lama, Anda harus mengupgrade aplikasi agar dapat berjalan
di:
Java Enterprise Edition 10 (EE10 - default, direkomendasikan): Java EE10
tidak mendukung javax.servlet.* API dan mengharuskan Anda mengupdate
aplikasi dan dependensi pihak ketiga untuk menggunakan artefak Java yang lebih baru
seperti namespace Jakarta.
Java Enterprise Edition 8 (EE8): Java EE8 memungkinkan Anda menggunakan
javax.servlet.* API, tetapi Anda harus melakukan perubahan konfigurasi kecil
pada file appengine-web.xml.
Lihat tabel berikut untuk memahami versi Java yang kompatibel
dengan versi servlet Anda:
Enterprise Edition (EE)
Versi Java
Servlet
Kompatibilitas
EE7
11
2.5 atau 3.1
Tidak ada dukungan komunitas untuk EE7. Java 11 telah mencapai akhir dukungan. Sebaiknya upgrade aplikasi Anda untuk menggunakan Java versi terbaru.
EE7
17
2.5 atau yang lebih baru
Tidak ada dukungan komunitas untuk EE7. Sebaiknya upgrade aplikasi Anda untuk menggunakan EE8.
EE8
17/21
2.5 dan yang lebih baru
Java EE8 kompatibel dengan Java EE6 dan yang lebih baru. Untuk informasi selengkapnya, lihat Mengupgrade ke Java 21 di EE8.
EE10
17/21
6.0 (direkomendasikan). Java 21 dikonfigurasi untuk menjalankan EE10 secara default.
Untuk menggunakan Java EE10, Anda harus mengupdate servlet dan dependensi aplikasi untuk menyertakan namespace Jakarta. Untuk informasi selengkapnya, lihat Mengupgrade Java 21 di EE10.
Mengupgrade ke Java 21 di EE10
Untuk menggunakan Java 21 di Enterprise Edition 10 (EE10),
Anda harus mengupgrade servlet dan dependensi aplikasi dalam file Maven dan Gradle
untuk menyertakan namespace Jakarta:
Ubah nomor versi di file konfigurasi web.xml menjadi version=6.0. Contoh:
Opsional: Java 21 menyertakan dukungan untuk thread virtual. Untuk mengaktifkan
thread virtual, Anda menambahkan
properti appengine.use.virtualthreads dalam tag system-properties
dalam file
appengine-web.xml.
Mengupgrade ke Java 17 atau 21 di EE8
Anda dapat terus menggunakan javax.servlet.* API di Java EE8 tanpa perubahan konfigurasi
aplikasi utama, karena EE8 menawarkan kompatibilitas mundur untuk Java EE6
dan yang lebih baru. Untuk menjalankan aplikasi di Java EE8, Anda harus mendeklarasikan tag system-properties baru dalam file appengine-web.xml dengan konfigurasi app.engine.use.EE8 non-default:
Opsional: Java 21 menyertakan dukungan untuk thread virtual. Untuk mengaktifkan
thread virtual, Anda menambahkan properti appengine.use.virtualthreads
dalam tag system-properties. Contoh:
<property name="appengine.use.virtualthreads" value="true"/>
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eApplications must be upgraded to the latest supported Java runtime version to receive security updates and technical support.\u003c/p\u003e\n"],["\u003cp\u003eJava 8 applications have reached end of support and while they will continue to run, new deployments or updates to Java 8 applications are not permitted.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading to a supported Java version involves updating the \u003ccode\u003eapp.yaml\u003c/code\u003e file to specify the desired Java version, such as Java 21, by using the \u003ccode\u003eruntime: javaVERSION\u003c/code\u003e configuration.\u003c/p\u003e\n"],["\u003cp\u003eIf using legacy bundled services, applications must be upgraded to either Java Enterprise Edition 10 (EE10), which requires using the \u003ccode\u003eJakarta\u003c/code\u003e namespace, or Java Enterprise Edition 8 (EE8), which requires minor \u003ccode\u003eappengine-web.xml\u003c/code\u003e configuration changes to use \u003ccode\u003ejavax.servlet.*\u003c/code\u003e APIs.\u003c/p\u003e\n"],["\u003cp\u003eJava 21 supports virtual threads, which can be enabled by adding the \u003ccode\u003eappengine.use.virtualthreads\u003c/code\u003e property in the \u003ccode\u003eappengine-web.xml\u003c/code\u003e file.\u003c/p\u003e\n"]]],[],null,["# Upgrade an existing application\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\nYou must upgrade your applications to the [latest supported runtime version](/appengine/docs/standard/lifecycle/support-schedule#java) to continue receiving security updates\nand be eligible for technical support.\n\nThe process of upgrading an existing app depends on the runtime version that\nyour app currently uses:\n\n- **Java 8** : You must migrate your app to the [latest supported Java version](/appengine/docs/standard/lifecycle/support-schedule#java). Java 8 has reached [end of support](/appengine/docs/standard/lifecycle/runtime-lifecycle#end_of_support) on January 31,2024. Your\n existing Java 8 applications will continue to run and receive traffic. However,\n you cannot deploy new or update existing applications that use runtimes [after their end of support date](/appengine/docs/standard/lifecycle/support-schedule#java).\n\n- **Java second-generation runtimes (after end of support)** : To upgrade to a\n [supported version of Java](/appengine/docs/standard/lifecycle/support-schedule#java),\n do the following:\n\n - Update the `app.yaml` file by specifying a version of Java that you want your\n app to run. For example:\n\n runtime: java\u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e\n\n Where \u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e is the `MAJOR` version number.\n For example, to use the latest Java version, Java 21,\n specify `21`.\n For more information, see the\n [Java runtime overview](/appengine/docs/standard/java-gen2/runtime).\n - If you use legacy bundled services, you must upgrade your apps to run\n on either:\n\n - Java Enterprise Edition 10 (EE10 - default, recommended): Java EE10\n does not support `javax.servlet.*` APIs and requires you to update\n your apps and third-party dependencies to use newer Java artifacts\n like the `Jakarta` namespace.\n\n - Java Enterprise Edition 8 (EE8): Java EE8 lets you use `javax.servlet.*`\n APIs, but you must make minor configuration changes\n to your `appengine-web.xml` file.\n\n See [Upgrade to Java 21 for legacy bundled services](#update_for_bundled_services) for all options.\n- **Java 17**:\n\n App Engine supports this version. To continue to upgrade to the\n latest support version, do the following:\n - Update the `app.yaml` file by specifying a version of Java that you want your\n app to run. For example:\n\n runtime: java\u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e\n\n Where \u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e is the `MAJOR` version number.\n For example, to use the latest Java version, Java 21,\n specify `21`.\n For more information, see the\n [Java runtime overview](/appengine/docs/standard/java-gen2/runtime).\n - If you use legacy bundled services, you must upgrade your apps to run\n on either:\n\n - Java Enterprise Edition 10 (EE10 - default, recommended): Java EE10\n does not support `javax.servlet.*` APIs and requires you to update\n your apps and third-party dependencies to use newer Java artifacts\n like the `Jakarta` namespace.\n\n - Java Enterprise Edition 8 (EE8): Java EE8 lets you use\n `javax.servlet.*` APIs, but you must make minor configuration changes\n to your `appengine-web.xml` file.\n\n See [Upgrade to Java 21 for legacy bundled services](#update_for_bundled_services) for all options.\n\nUpgrade to Java 21 for legacy bundled services\n----------------------------------------------\n\n| **Important:** The `javax.servlet.*` APIs reached the [end of community support](https://github.com/jetty/jetty.project/issues/7958). We recommend that you update to [EE10](#ee10).\n\n### Java runtime compatibility\n\nRefer to the following table to understand which Java versions are compatible\nwith your versions of servlet:\n\n### Upgrade to Java 21 on EE10\n\nTo use Java 21 on [Enterprise Edition 10 (EE10)](https://jakarta.ee/release/10/),\nyou must upgrade your application servlets and dependencies in your Maven and Gradle\nfiles to include the `Jakarta` namespace:\n\n1. Change the version number in your `web.xml` configuration file to `version=6.0`. For example:\n\n \u003cweb-app xmlns=\"https://jakarta.ee/xml/ns/jakartaee\"\n xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n xsi:schemaLocation=\"https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd\"\n version=\"6.0\"\u003e\n ...\n \u003c/web-app\u003e\n\n2. Rename your application servlets and dependencies from `javax.servlet.*` to\n `jakarta.servlet.*`:\n\n import jakarta.servlet.ServletException;\n import jakarta.servlet.annotation.WebServlet;\n import jakarta.servlet.http.Cookie;\n import jakarta.servlet.http.HttpServlet;\n import jakarta.servlet.http.HttpServletRequest;\n import jakarta.servlet.http.HttpServletResponse;\n\n @WebServlet(name = \"viewer\", urlPatterns = {\"/view\"})\n public class MyServlet extends HttpServlet {\n ......\n\n3. Update your remaining application third-party dependencies to newer Java artifacts\n depending on the `Jakarta` namespace.\n\n4. Add the following system property in your [`appengine-web.xml`](/appengine/docs/standard/java-gen2/config/appref-xml#system_properties) file:\n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cappengine-web-app xmlns=\"http://appengine.google.com/ns/1.0\"\u003e\n \u003cruntime\u003ejava21\u003c/runtime\u003e \u003c!-- or java17 --\u003e\n \u003csystem-properties\u003e\n \u003cproperty name=\"appengine.use.EE10\" value=\"true\"/\u003e\n \u003c/system-properties\u003e\n \u003capp-engine-apis\u003etrue\u003c/app-engine-apis\u003e\n \u003c/appengine-web-app\u003e\n\n5. Optional: Java 21 includes support for virtual threads. To enable\n virtual threads, you add the\n `appengine.use.virtualthreads` property within the `system-properties` tag\n in your [`appengine-web.xml`](/appengine/docs/standard/java-gen2/config/appref-xml#system_properties)\n file.\n\n### Upgrade to Java 17 or 21 on EE8\n\nYou can continue using `javax.servlet.*` APIs on Java EE8 without major application\nconfiguration changes, because EE8 offers backward compatibility for Java EE6\nand later. To run your applications on Java EE8, you must declare a new\n`system-properties` tag in your\n[`appengine-web.xml`](/appengine/docs/standard/java-gen2/config/appref-xml#system_properties)\nfile with the non-default `app.engine.use.EE8` configuration: \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cappengine-web-app xmlns=\"http://appengine.google.com/ns/1.0\"\u003e\n \u003cruntime\u003ejava21\u003c/runtime\u003e \u003c!-- or java17 --\u003e\n \u003csystem-properties\u003e\n \u003cproperty name=\"appengine.use.EE8\" value=\"true\"/\u003e\n \u003c/system-properties\u003e\n \u003capp-engine-apis\u003etrue\u003c/app-engine-apis\u003e\n \u003c/appengine-web-app\u003e\n\nOptional: Java 21 includes support for virtual threads. To enable\nvirtual threads, you add the `appengine.use.virtualthreads` property\nwithin the `system-properties` tag. Example:\n`\u003cproperty name=\"appengine.use.virtualthreads\" value=\"true\"/\u003e`"]]
