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 seguintes bibliotecas e ferramentas:

• 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. Veja mais detalhes no Javadoc da API.
• A ferramenta de linha de comando endpoints para Linux ou endpoints.cmd para Windows que podem ser usadas para gerar pacotes de biblioteca de cliente e documentos Discovery. Com eles, os apps para Android e outros tipos de aplicativos clientes podem acessar sua API.
• Os plug-ins Maven do Endpoints Frameworks e Gradle do Endpoints Frameworks são usados para gerar o seguinte:
  • pacotes de bibliotecas de cliente e documentos Discovery;
  • Arquivos de configuração OpenAPI (em inglês), 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, incluindo 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 uma API 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 clientes sejam geradas a partir dela.
3. Gere o arquivo de configuração da especificaçã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.

Como começar

Para começar, siga o Tutorial para configurar, implantar e enviar solicitações para 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á tiver desenvolvido 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.