Sobre o Cloud Endpoints Frameworks para Java

Nesta página, você encontra descrições das bibliotecas e ferramentas, além de outras informações para começar a usar o Endpoints Frameworks para Java. Consulte Sobre o Endpoints Frameworks para uma visão geral da arquitetura do Endpoints Frameworks.

Bibliotecas e ferramentas

O Cloud Endpoints Frameworks para o ambiente padrão do App Engine fornece as bibliotecas e ferramentas a seguir:

• O Endpoints Frameworks está disponível no Maven Central Repository (em inglês) no grupo com.google.endpoints. O arquivo .jar de base necessário está no artefato endpoints-framework. Consulte o Javadoc da API para mais detalhes.
• A ferramenta de linha de comando endpoints (para Linux) ou endpoints.cmd (para Windows) que pode ser usada para gerar pacotes de biblioteca de cliente e documentos Discovery, que permitem que apps Android e outros tipos de aplicativos clientes acessem sua API.
• Os plug-ins Maven do Endpoints Frameworks e Gradle do Endpoints Frameworks, que são usados para gerar:
  • pacotes de bibliotecas de cliente e documentos Discovery;
  • Arquivos de configuração da OpenAPI, que são usados para fornecer funcionalidades de gerenciamento de APIs, como monitoramento, geração de registros e validação de chaves da API.

Observação: como o back-end da API é um aplicativo do App Engine, os desenvolvedores podem usar serviços e recursos disponíveis no ambiente padrão do App Engine, como o Datastore, Cloud Storage, E-mail, Busca de URLs, Filas de tarefas e assim por diante. Ao usar o App Engine no back-end, os desenvolvedores não precisam fazer o trabalho administrativo do sistema, o balanceamento de carga, o dimensionamento e a manutenção de servidores.

Requisitos

Para usar o Endpoints Frameworks, siga o processo ensinado no Tutorial.

É preciso que você saiba desenvolver o cliente escolhido, como clientes Web em JavaScript ou de dispositivos móveis como Android.

Observação: não é possível chamar a API do Cloud Endpoints diretamente de uma fila de tarefas push ou de um cron job.

Processo de desenvolvimento

O fluxo de trabalho geral para desenvolver um aplicativo usando o Endpoints Frameworks é:

1. Crie o projeto da API e escreva o código.
2. Anote a API para que classes e bibliotecas de cliente sejam geradas a partir dela.
3. Gere o arquivo de configuração OpenAPI e implante-o conforme descrito no tutorial.
4. Como opção, teste a API localmente.
5. Implante a API.
6. Gere a biblioteca de cliente.
7. Crie o aplicativo cliente usando a biblioteca de cliente ao fazer chamadas para a API.

Primeiros passos

Para começar, siga o Tutorial para configurar, implantar e enviar solicitações a uma API de amostra. Em seguida, volte para esta seção e encontre as informações necessárias para configurar, implantar e testar sua própria API.

Como migrar do Endpoints 1.0

Se você já desenvolveu um back-end de API usando a versão anterior do Endpoints, siga o Guia de migração para migrar o app para o Endpoints 2.0.