Escrever e anotar o código

Esta página descreve como estruturar e anotar o código do Cloud Endpoints Frameworks. Para ver uma lista completa de todas as anotações suportadas, consulte o artigo Anotações.

Antes de começar

  1. Configure o seu ambiente de desenvolvimento.

  2. Clone o exemplo de frameworks de pontos finais de estrutura:

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

  3. O exemplo de estrutura do Endpoints básico encontra-se em:

     cd appengine-java8/endpoints-v2-skeleton/

Para ajudar a explicar como funcionam as anotações, este documento usa o exemplo endpoints-v2-backend para mostrar as anotações e outro código que tem de adicionar ao exemplo endpoints-v2-skeleton para o compilar. No final, o exemplo endpoints-v2-skeletonmodificado comporta-se da mesma forma que o exemplo endpoints-v2-backend, que é usado no artigo Introdução aos frameworks de pontos finais no App Engine.

Criar e anotar código

Para anotar o seu código:

  1. Altere os diretórios para o diretório de origem Java do projeto, por exemplo: src/main/java/com/example/skeleton.
  2. Crie um ficheiro de classe JavaBean denominado Message.java que contenha o seguinte código: 
    public class Message {

  private String message;

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

  public void setMessage(String message) {
    this.message = message;
  }
}
  3. Edite o ficheiro MyApi.java contido no exemplo de estrutura. Altere a anotação de definição de @Api com o seguinte: 
    @Api(
    name = "echo",
    version = "v1",
    namespace =
    @ApiNamespace(
        ownerDomain = "echo.example.com",
        ownerName = "echo.example.com",
        packagePath = ""
    ),
    // ...
)

    O atributo version = "v1" especifica a versão da API de exemplo. O valor que introduzir passa a fazer parte do caminho no URL para a sua API. Para mais informações sobre versões, consulte o artigo Processamento do controlo de versões da API.

  4. Adicione o método echo seguinte como o primeiro ponto final da API e o método auxiliar doEcho ao seu 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. Copie todas as importações de Echo.java e cole-as no seu MyApi.java.

  6. Maven

    Crie o projeto:

    mvn clean package

    Gradle

    Crie o projeto:

    gradle clean build

Noções básicas de anotações

Existem três anotações usadas frequentemente em APIs de back-end:

  • @Api contém os detalhes de configuração da API de back-end.
  • @ApiMethod marca um método de classe que faz parte da API de back-end. Os métodos que não estão marcados com @ApiMethod não são incluídos quando gera bibliotecas de cliente e documentos de descoberta. A anotação @ApiMethod também pode ser usada para substituir a configuração da API para um método específico.
  • @Named tem de ser adicionado a todos os parâmetros transmitidos aos métodos do lado do servidor, a menos que o parâmetro seja um tipo de entidade.

Para ver uma lista completa de todas as anotações do Frameworks de pontos finais, consulte o artigo Anotações e sintaxe.

O que se segue?