Questa guida mostra come scrivere un servizio web Java da eseguire nell'ambiente standard di App Engine. Per scoprire di più sul runtime Java e sul suo funzionamento, consulta Java Runtime Environment.
Prima di iniziare
Se non lo hai già fatto:
- Installa la versione più recente del Java Development Kit (JDK) per la versione del runtime di App Engine che prevedi di utilizzare.
- Scarica e installa Apache Maven per creare, eseguire ed eseguire il deployment dell'app di esempio.
Punti chiave
- App Engine avvia l'applicazione caricando un'applicazione JAR eseguibile.
- L'applicazione deve avere una classe principale che avvii un server web che risponde alle richieste HTTP sulla porta specificata dalla variabile di ambiente PORT, in genere 8080.
- Hai bisogno di un file
app.yaml
per eseguire il deployment del servizio in App Engine. - Puoi utilizzare le dipendenze elencandole nel tuo file
pom.xml
. Per ulteriori informazioni, consulta la sezione Utilizzo delle librerie Java.
Creazione di un corso principale
Il cuore del tuo servizio web è il server HTTP. Il codice campione in questa guida utilizza il framework Spring Boot per gestire le richieste HTTP, ma puoi usare liberamente un framework web di tua scelta.
Genera un progetto Spring Boot per Java che utilizza il sistema di compilazione Maven e contiene la dipendenza Spring Web. Per iniziare, fai clic sul seguente link:
In Spring Initializer, fai clic sul pulsante Genera per generare e scaricare il tuo progetto.
Nel progetto scaricato, modifica la classe dell'applicazione in modo che includa le importazioni e il codice seguenti:
La classe modificata è un controller che avvia il server Tomcat incorporato di Spring Boot e risponde alle richieste
GET
nel percorso principale ('/'
) con il testo "Hello world!".
Esecuzione del server in locale
Per eseguire il server localmente:
Avviare un server web locale utilizzando il plug-in Maven di Spring Boot.
mvn spring-boot:run
Nel browser web, inserisci il seguente indirizzo:
http://localhost:8080
Nella pagina viene visualizzato il messaggio Hello World dell'app di esempio. Nella finestra del terminale, premi Ctrl+C per uscire dal server web.
Creazione del file app.yaml
in corso...
Per specificare le impostazioni per la tua app nell'ambiente di runtime di App Engine:
Crea un file denominato
app.yaml
nella seguente directory:
my-java-service/src/main/appengine/
Aggiungi i seguenti contenuti al file:
Java 17
runtime: java17
Java 11
Il file
app.yaml
può anche specificare le impostazioni di rete, di scalabilità e altro ancora. Per maggiori informazioni, consulta la documentazione di riferimento diapp.yaml
.
Se hai utilizzato il link Spring Initializr riportato sopra, ora dovresti avere una struttura del file simile alla seguente:
my-java-service/
pom.xml
src/main/
appengine/
app.yaml
java/com/example/appengine/springboot/
SpringbootApplication.java
Passaggi successivi
Ora che hai creato un semplice server web Java che rimane in ascolto della porta corretta e hai specificato il runtime in un file app.yaml
, puoi iniziare a eseguire il deployment del tuo servizio su App Engine.