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:

  1. 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>

  2. 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.