Como configurar o Objectify ao executar aplicativos localmente

Observação: as ferramentas do Cloud para Eclipse são compatíveis apenas com o ambiente de execução do Java 8 do App Engine, que vai chegar ao fim da compatibilidade em 31 de janeiro de 2024. Após essa data, os aplicativos Java 8 existentes continuarão sendo executados e recebendo tráfego. No entanto, não é possível implantar aplicativos novos ou atualizar os atuais que usam ambientes de execução após o término da data de compatibilidade. Recomendamos que você migre para a versão compatível mais recente do Java.

O Objectify (em inglês) é uma biblioteca de terceiros para interação com o Datastore a partir de aplicativos Java. O Cloud Tools for Eclipse permite que os usuários adicionem o Objectify, bem como outras bibliotecas do Google Cloud, aos seus projetos.

Neste documento, descrevemos como configurar o Cloud Tools for Eclipse para usar o Objectify ao executar o aplicativo localmente.

Como configurar o Eclipse

Se você quiser configurar o Cloud Tools for Eclipse para usar o Objectify, faça o seguinte:

1. No Eclipse, selecione Run > Run Configurations.

2. Na caixa de diálogo Run Configurations, selecione uma configuração de inicialização existente App Engine Local Server ou clique no botão New launch configuration para criar uma.

3. Selecione a guia Cloud Platform da sua configuração de execução.

4. Selecione uma conta.

5. Selecione um projeto para atribuir um código a ser usado na execução local. O projeto selecionado não é importante porque você não se conectará a ele.

   1. Como alternativa, se você não estiver logado ou não tiver um projeto do Cloud, poderá definir a variável de ambiente GOOGLE_CLOUD_PROJECT como uma sequência legal, como MyProjectId, na guia Ambiente da configuração de execução.

Como alternar o emulador do Datastore

O Objectify 6 pode ter um problema ao trabalhar com o emulador de armazenamento de dados incluído no dev_appserver, mas funciona com o emulador de armazenamento de dados baseado em beta gcloud.

Para usar o emulador baseado em gcloud:

1. Inicie um terminal e execute:

   gcloud beta emulators datastore start
   

2. Quando o emulador for iniciado, uma mensagem semelhante a esta será exibida:

   [datastore] API endpoint: http://localhost:8081  
   [datastore] If you are using a library that supports the DATASTORE_EMULATOR_HOST environment variable, run:  
   [datastore]  
   [datastore]   export DATASTORE_EMULATOR_HOST=localhost:8081  
   [datastore]  
   [datastore] Dev App Server is now running.  
   

3. No Eclipse, inclua a variável de ambiente DATASTORE_EMULATOR_HOST em sua configuração de execução na guia Ambiente.

   1. Neste exemplo, configure o nome para DATASTORE_EMULATOR_HOST e o valor para localhost:8081.

   Se você usar o emulador do armazenamento de dados baseado em gcloud, não encontrará dados na página de administração do Datastore para o local dev_appserver.

A seguir

• Explore o código do plug-in e informe problemas no GitHub ou faça uma pergunta no Stack Overflow.