Scrittura e annotazione del codice

Questa pagina descrive come strutturare e annotare il codice di Cloud Endpoints Frameworks. Per un elenco completo di tutte le annotazioni supportate, vedi Annotazioni.

Prima di iniziare

  1. Configura l'ambiente di sviluppo.

  2. Clona l'esempio di scheletro di Endpoints Frameworks:

     git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git

  3. L'esempio di scheletro di Endpoints Frameworks si trova in:

     cd appengine-java8/endpoints-v2-skeleton/

Per spiegare come funzionano le annotazioni, questo documento utilizza l'esempio endpoints-v2-backend per mostrare le annotazioni e 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, utilizzato in Guida introduttiva a Endpoints Frameworks su App Engine.

Creazione e annotazione del codice

Per annotare il codice:

  1. Cambia directory nella directory di origine Java del progetto, ad esempio src/main/java/com/example/skeleton.
  2. Crea un file di classe JavaBean denominato Message.java che contenga il seguente codice: 
    public class Message {

  private String message;

  public String getMessage() {
    return this.message;
  }

  public void setMessage(String message) {
    this.message = message;
  }
}
  3. Modifica il file MyApi.java contenuto nell'esempio di scheletro. Modifica l'annotazione di definizione @Api con la seguente: 
    @Api(
    name = "echo",
    version = "v1",
    namespace =
    @ApiNamespace(
        ownerDomain = "echo.example.com",
        ownerName = "echo.example.com",
        packagePath = ""
    ),
    // ...
)

    L'attributo version = "v1" specifica la versione dell'API di esempio. Il valore che inserisci diventa parte del percorso nell'URL dell'API. Per ulteriori informazioni sulle versioni, vedi Gestione del controllo delle versioni dell'API.

  4. Aggiungi il seguente echo metodo come primo endpoint API e il doEcho metodo helper a MyApi.java. 
    @ApiMethod(name = "echo")
public Message echo(Message message, @Named("n") @Nullable Integer n) {
  return doEcho(message, n);
}
     
    private Message doEcho(Message request, Integer n) {
  Message response = new Message();
  if (n != null && n >= 0) {
    StringBuilder sb = new StringBuilder();
    for (int i = 0; i < n; i++) {
      if (i > 0) {
        sb.append(' ');
      }
      sb.append(request.getMessage());
    }
    response.setMessage(sb.toString());
  }
  return response;
}
  5. Copia tutti gli import da Echo.java e incollali in MyApi.java.

  6. Maven

    Compila il progetto:

    mvn clean package

    Gradle

    Compila il progetto:

    gradle clean build

Nozioni di base sulle annotazioni

Esistono tre annotazioni di uso comune nelle API di backend:

  • @Api contiene i dettagli di configurazione dell'API di backend.
  • @ApiMethod contrassegna un metodo di classe che fa parte dell'API di backend. I metodi non contrassegnati con @ApiMethod non vengono inclusi quando generi librerie client e documenti di rilevamento. L'annotazione @ApiMethod può essere utilizzata anche per sostituire la 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 di Endpoints Frameworks, vedi Annotazioni e sintassi.

Passaggi successivi