Java 8 Runtime Environment

Con App Engine puoi creare applicazioni web che utilizzano i servizi e l'infrastruttura scalabili di Google. App Engine esegue la tua applicazione web utilizzando una JVM Java 8. Per app Engine richiama le classi servlet dell'app per gestire le richieste e prepararsi risposte in questo ambiente.

La piattaforma App Engine offre molti strumenti servizi API che il tuo codice può chiamare. L'applicazione può anche configurare attività pianificate che vengono eseguite alle a determinati intervalli.

Specifica il runtime Java 8 per la tua app

Per fare in modo che la tua app utilizzi il runtime Java 8, aggiungi la seguente riga al file appengine-web.xml:

<runtime>java8</runtime>

Il file appengine-api.jar incluso in Google Cloud CLI in platform/google_appengine/google/appengine/tools/java/lib/impl/appengine-api.jar rappresenta l'API App Engine per Java. Puoi anche accedere a questo file utilizzando il repository Maven, che elenca tutte le versioni.

Selezioni la versione dell'API utilizzata dall'applicazione includendo questo JAR nel WEB-INF/lib/ dell'applicazione oppure usa Maven per gestire le dipendenze. Se un nuovo dell'ambiente di runtime Java che introduce modifiche non sono compatibili con le app esistenti, l'ambiente avrà un nuovo numero di versione principale.

Utilizzo di Maven per gestire le dipendenze

Puoi utilizzare Maven per gestire tutte le dipendenze. Ad esempio, questo La voce pom.xml include la versione più recente dell'API App Engine (Rappengine-api-1.0-sdk) disponibile da Maven Central:

<dependency>
    <groupId>com.google.appengine</groupId>
    <artifactId>appengine-api-1.0-sdk</artifactId>
    <version></version>
</dependency>

Ok

Sabbiera

Il runtime Java di App Engine distribuisce le richieste per le applicazioni tra in più server web e impedisce che un'applicazione interferisca con un'altra. Un'app di App Engine non deve rispondere lentamente. Una richiesta web a un'applicazione deve essere gestita entro il limite di timeout della richiesta. I processi che superano questo limite di risposta vengono interrotti per evitare di sovraccaricare il server web.

Tieni presente che l'unico luogo in cui gli utenti possono scrivere file è la directory/tmp. I file in /tmp utilizzeranno la memoria allocata all'istanza. I file memorizzati in questa posizione sono disponibili solo per questa istanza e solo per la durata di questa istanza specifica.

In genere, l'applicazione ottiene i file di risorse pacchettizzando i file utilizzi la tua applicazione in WEB-INF, quindi le carichi dall'app utilizzando Class.getResource(), ServletContext.getResource() o metodi simili. Per impostazione predefinita, tutti i file nel file WAR sono "file di risorse". Puoi escludere i file da questo insieme utilizzando il file appengine-web.xml.

Ordinamento dei file JAR del caricatore di classi

A volte, potrebbe essere necessario ridefinire l'ordine in cui i file JAR vengono sottoposti a scansione per individuare le classi al fine di risolvere le collisioni tra i nomi delle classi. In questi casi, la priorità di caricamento può essere concessa a file JAR specifici aggiungendo un elemento <class-loader-config> contenente elementi <priority-specifier> nel file appengine-web.xml. Ad esempio:

<class-loader-config>
  <priority-specifier filename="mailapi.jar"/>
</class-loader-config>

In questo modo, "mailapi.jar" è il primo file JAR in cui cercare le classi, tranne quelle nella directory war/WEB-INF/classes/.

Se a più file JAR viene assegnata una priorità, verrà utilizzato il loro ordine di caricamento originale (tra loro). In altre parole, l'ordine degli elementi<priority-specifier> non è importante.

Thread

Con il runtime Java 8, puoi creare thread utilizzando API ThreadManager e le API integrate di Java, ad esempio new Thread(). Al momento, se vuoi chiamare le API App Engine (com.google.appengine.api.*), devi chiamarle da un thread di richiesta o da un thread creato utilizzando l'API ThreadManager.

Nota: se utilizzi API di creazione di thread Java, Cloud Trace non mostrerà l'ID richiesta correttamente. Google sta lavorando a una soluzione a questo problema.

Un'applicazione può

• Implementa java.lang.Runnable.
• Crea una fabbrica di thread chiamando com.google.appengine.api.ThreadManager.currentRequestThreadFactory().
• Chiama il metodo newRequestThread del produttore, passando il valore Runnable, newRequestThread(runnable) oppure utilizza l'oggetto di fabbrica restituito da com.google.appengine.api.ThreadManager.currentRequestThreadFactory() con ExecutorService (ad es., chiama Executors.newCachedThreadPool(factory)).

Se crei un ThreadPoolExecutor con currentRequestThreadFactory(), shutdown() deve essere chiamato esplicitamente prima del completamento della richiesta del servlet. Mancata attestazione la richiesta non verrà completata e il server delle app non andrà a buon fine. Tieni presente che alcune librerie potrebbero creare ThreadPoolExecutors per te.

Un'applicazione può eseguire operazioni sul thread corrente, ad esempio thread.interrupt().

Ogni richiesta è limitata a 50 thread di richieste dell'API App Engine simultanei.

Quando utilizzi i thread, usa la contemporaneità di alto livello. oggetti, come Executor e Runnable. Questi si occupano di molti dettagli sottili, ma importanti, della concorrenza, come le interruzioni, la pianificazione e la contabilità.

Il numero massimo di thread in background simultanei creati dal L'API App Engine è pari a 10 per istanza. Questo limite non si applica ai thread Java comuni non correlati all'API App Engine.

Strumenti

Nota: Google consiglia a tutti i nuovi progetti di utilizzare gcloud CLI, che supporta Maven, Gradle e Intellij.

Anche l'SDK App Engine per Java (con supporto per il plug-in Maven e il plug-in Gradle) è completamente supportato ed è consigliato per i progetti esistenti che non sono pronti per la migrazione all'interfaccia a riga di comando gcloud.

IDE supportati

Cloud Tools for IntelliJ ti consente di eseguire e eseguire il debug delle applicazioni App Engine all'interno di IntelliJ IDEA. Puoi eseguire il deployment dei progetti App Engine in produzione senza uscire dall'IDE.

Strumenti di compilazione supportati

Per velocizzare il processo di sviluppo, puoi utilizzare i plug-in App Engine per Apache Maven o Gradle:

• Plug-in Apache Maven basato sull'interfaccia a riga di comando gcloud
• plug-in Gradle basato su gcloud CLI

Server di sviluppo locale

Il server di sviluppo esegue l'applicazione sul computer locale per lo sviluppo test. Il server simula i servizi Datastore. Il server di sviluppo può anche generare la configurazione per gli indici Datastore in base alle query eseguite dall'app durante il test.

Concorrenza e latenza

La latenza della tua applicazione ha l'impatto maggiore sul numero di istanze necessarie per gestire il tuo traffico. Se elabori le richieste rapidamente, gestire molte richieste.

Le istanze a thread singolo possono gestire una richiesta in parallelo. Pertanto, esiste una relazione diretta tra la latenza e il numero di richieste che possono essere gestite nell'istanza al secondo. Ad esempio, una latenza di 10 ms equivale a 100 richieste/secondo/istanza.

Le istanze multi-thread possono gestire molte richieste in parallelo. Pertanto, è una relazione diretta tra la CPU consumata e il numero richieste/secondo.

Le app Java supportano le richieste contemporaneamente, pertanto una singola istanza può gestire nuove richieste in attesa del completamento di altre richieste. La concorrenza riduce notevolmente il numero di istanze richieste dall'app, ma devi progettarla per il multithreading.

Ad esempio, se un B4 istanza (circa 2,4 GHz) consuma 10 Mcicli/richiesta, è possibile elaborare 240 richieste/secondo/istanza. Se consuma 100 Mcycle/richiesta, puoi elaborare 24 richieste/secondo/istanza. Questi numeri rappresentano il caso ideale, ma sono abbastanza realistici in termini di ciò che puoi realizzare in un'istanza.

Release Java di App Engine

Tutti gli elementi rilasciati che iniziano con la versione 2.x.x utilizzano il meccanismo di rilascio open source. Gli elementi pubblicati che iniziano con la versione 1.9.9xx o precedente utilizzano il sistema di compilazione interno. Per maggiori dettagli, consulta il repository GitHub.

Variabili di ambiente

Le seguenti variabili di ambiente sono impostate dal runtime:

Variabile di ambiente	Descrizione
GAE_APPLICATION	L'ID della tua applicazione App Engine. Questo ID è preceduto da "region code~", ad esempio "e~" per le applicazioni di cui è stato eseguito il deployment in Europa.
GAE_DEPLOYMENT_ID	L'ID del deployment attuale.
GAE_ENV	L'ambiente App Engine. Impostata su standard.
GAE_INSTANCE	L'ID dell'istanza su cui è attualmente in esecuzione il servizio.
GAE_RUNTIME	Il runtime specificato nel file app.yaml.
GAE_SERVICE	Il nome del servizio specificato nel file app.yaml. Se non viene specificato alcun nome di servizio, viene impostato su default.
GAE_VERSION	L'etichetta della versione corrente del servizio.
GOOGLE_CLOUD_PROJECT	L'ID progetto Google Cloud associato alla tua applicazione.
PORT	La porta che riceve le richieste HTTP.

Puoi definire variabili di ambiente aggiuntive nel file app.yaml, ma i valori precedenti non possono essere sostituiti.