Questa pagina descrive come strutturare e annotare il codice dei framework Cloud Endpoints. Per un elenco completo di tutte le annotazione supportate, consulta Annotazioni.
Prima di iniziare
- Configura l'ambiente di sviluppo.
Clona l'esempio di Endpoints Frameworks scheletro:
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
L'esempio di Endpoints Frameworks scheletro si trova in:
cd appengine-java8/endpoints-v2-skeleton/
Per spiegare il funzionamento delle annotazioni, questo documento utilizza l'esempio endpoints-v2-backend
per mostrare le annotazioni e l'altro codice che devi aggiungere all'esempio endpoints-v2-skeleton
per compilarlo. Alla fine,
l'esempio endpoints-v2-skeleton
modificato si comporta come
l'esempio endpoints-v2-backend
, che viene utilizzato in
Introduzione ai framework di endpoint su App Engine.
Creazione e annotazione del codice
Per annotare il codice:
-
Cambia directory nella directory del codice sorgente Java del progetto, ad esempio:
src/main/java/com/example/skeleton
. -
Crea un file di classe JavaBean chiamato
Message.java
contenente il seguente codice: -
Modifica il file
MyApi.java
contenuto nell'esempio di scheletro. Modifica l'annotazione della definizione di@Api
con quanto segue:L'attributo
version = "v1"
specifica la versione dell'API di esempio. Il valore inserito diventa parte del percorso nell'URL della tua API. Per ulteriori informazioni sulle versioni, consulta Gestire il controllo delle versioni dell'API. -
Aggiungi il seguente metodo
echo
come primo endpoint dell'API e il metodo di assistenzadoEcho
aMyApi.java
. -
Copia tutte le importazioni da
Echo.java
e incollale inMyApi.java
. -
Maven
Compila il progetto:
mvn clean package
Gradle
Compila il progetto:
gradle clean build
Nozioni di base sulle annotazioni
Esistono tre annotazioni comunemente utilizzate nelle API di backend:
@Api
contiene i dettagli di configurazione dell'API di backend.@ApiMethod
indica un metodo di classe che fa parte dell'API di backend. I metodi non contrassegnati con@ApiMethod
non sono inclusi quando generi librerie client e documenti di rilevamento. L'annotazione@ApiMethod
può essere utilizzata anche per eseguire l'override della configurazione dell'API per un metodo specifico.@Named
deve essere aggiunto a tutti i parametri passati ai metodi lato server, a meno che il parametro non sia un tipo di entità.
Per un elenco completo di tutte le annotazioni dei framework di endpoint, consulta Annotazioni e sintassi.
Passaggi successivi
- Scopri di più sull'aggiunta della gestione delle API.
- Scopri i tipi di parametri e di valori restituiti supportati.
- Scopri di più su eccezioni e codici di stato.