Java 8 ha raggiunto la fine del supporto e verrà ritirato il 31 gennaio 2026. Dopo il ritiro, non potrai eseguire il deployment di applicazioni Java 8, anche se la tua organizzazione ha utilizzato in precedenza un criterio dell'organizzazione per riattivare i deployment di runtime legacy. Le tue applicazioni Java 8 esistenti continueranno a essere eseguite e a ricevere traffico dopo la data di ritiro. Ti consigliamo di eseguire la migrazione all'ultima versione supportata di Java.

Questa pagina è stata tradotta dall'API Cloud Translation.

Migrazione da Java 7 a Java 8 Runtime

Questa pagina descrive come eseguire la migrazione della tua app App Engine esistente dal runtime Java 7 al runtime Java 8. Tieni presente che i runtime Java di App Engine si basano su OpenJDK.

Specifica del runtime Java 8 per la tua app

Per eseguire l'app nel runtime Java 8:

Aggiungi <runtime>java8</runtime> al file appengine-web.xml:

<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <runtime>java8</runtime>
  <threadsafe>true</threadsafe>
</appengine-web-app>

Esegui nuovamente il deployment dell'app.

Migrazione da servizi non supportati

Alcuni servizi ritirati disponibili per il runtime Java 7 non sono supportati dal runtime Java 8. Google consiglia di eseguire la migrazione dell'applicazione alle alternative consigliate e di testare l'app nell'ambiente di runtime Java 7 con queste modifiche prima di eseguire la migrazione a Java 8.

I seguenti servizi ritirati non sono disponibili nel runtime Java 8:

Servizio ritirato	Alternativa consigliata
Cloud Endpoints v1	Esegui la migrazione alla v2. Il prodotto è stato rinominato Cloud Endpoints Frameworks. Tieni presente che potrebbe essere necessario modificare le applicazioni web, Android o iOS.
AppStats (file JAR appengine-api-labs)	Esegui la migrazione a Cloud Trace. L'SDK genera un errore per le app che utilizzano la classe `com.google.appengine.tools.AppstatsFilter` nel runtime Java 8. Assicurati di eliminare tutti i riferimenti a `AppstatsFilter` dal tuo `web.xml`.

Le classi ricompattate richiederanno nuovi percorsi di importazione su Java 8. Ad esempio, se la tua app utilizzava com.google.appengine.repackaged.com.google.common.base.Optional, dovrai importare com.google.appengine.repackaged.com.google.common.base.$Optional, con $ anteposto al nome della classe.

Migrazione delle app gratuite che utilizzano java.net.HttpURLConnection

Se la tua app non ha la fatturazione abilitata ed effettua richieste HTTP(S) utilizzando la classe java.net.HttpURLConnection o una libreria client Google che utilizza questa classe, si verificheranno errori di runtime. Per evitare questo problema, imposta <url-stream-handler> su urlfetch in appengine-web.xml della tua app:

<?xml version="1.0" encoding="utf-8"?>
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <!-- ... -->
  <url-stream-handler>urlfetch</url-stream-handler>
  <!-- ... -->
</appengine-web-app>

In alternativa, anziché specificare urlfetch, puoi attivare la fatturazione per la tua applicazione e utilizzare l'impostazione native predefinita. L'app non deve comportare alcun aumento dei costi derivanti dall'esecuzione su Java 7. Tieni presente che se la tua app si basa sull'intestazione HTTP X-Appengine-Inbound-Appid (utilizzata per la comunicazione da modulo a modulo), deve essere utilizzato urlfetch.

Modifica della codifica dei file predefinita

App Engine ha modificato la codifica predefinita dei file da US-ASCII in Java 7 a UTF-8 in Java 8. Per ripristinare la codifica predefinita su US-ASCII in Java 8, aggiungi quanto segue a appengine-web.xml:

 <system-properties>
   <property name="appengine.file.encoding" value="US-ASCII"/>
 </system-properties>

Potrebbero verificarsi errori se alcuni caratteri non sono nel set ASCII e la tua applicazione fa determinate ipotesi, ad esempio someString.getBytes().length == someString.length(). Nella codifica US-ASCII questo è vero perché i caratteri non ASCII vengono mappati su "?", ma non è necessariamente vero con la codifica UTF-8.

Ad esempio, se stampi i byte esadecimali dalla chiamata Éamonn.getBytes(), con UTF-8 sarà: c3 89 61 6d 6f 6e 6e (Éamonn), mentre con US-ASCII otterrai: 3f 61 6d 6f 6e 6e (?amonn) a causa del diverso valore di codifica di É.

Sfruttare al meglio le funzionalità del runtime Java 8

Di seguito è riportato un elenco parziale dei vantaggi della migrazione al runtime Java 8:

Jetty 9 supporta le applicazioni web Servlet 2.5 e 3.1, incluse le annotazioni servlet.
Tutte le classi Java standard sono ora disponibili e non esiste un elenco consentito di classi.
Il filesystem /tmp è scrivibile, il che occupa l'allocazione della RAM dell'app.
L'I/O di rete ora può essere eseguito su qualsiasi thread Java. Le chiamate API App Engine richiedono ancora di trovarsi in un thread di richiesta o in un thread creato dall'API Thread Manager.
Ora è supportato il linguaggio Java 8 completo, incluse l'API Stream, le espressioni lambda e l'API Date / Time.