O SDK para Java do Google App Engine inclui um servidor da web para desenvolvimento para testar o seu aplicativo no seu computador. O servidor da web para desenvolvimento simula o ambiente de execução em Java do Google App Engine e todos os seus serviços, incluindo o armazenamento de dados. O Plug-in do Google para o Eclipse pode executar o servidor no depurador do Eclipse. Você também pode executar o servidor de desenvolvimento a partir da linha de comando.
Se você estiver usando o Eclipse e o Plug-in do Google, poderá executar o servidor da web para desenvolvimento no depurador do Eclipse. Para executar o servidor com a configuração padrão, selecione o menu Run (Executar), Debug As (Depurar como) > Web Application (Aplicativo da web). Para ter mais controle sobre como o servidor é iniciado, como qual porta o servidor usa, crie uma nova configuração de depuração usando o tipo de configuração "Web Application" (Aplicativo da web). Para obter mais informações, consulte Plug-in do Google para o Eclipse.
Você também pode executar o servidor da web para desenvolvimento a partir de um prompt de comando. O comando a ser executado está no diretório appengine-java-sdk/bin/ do SDK.
Se você estiver usando o Windows, o comando será o seguinte:
appengine-java-sdk\bin\dev_appserver.cmd [options] war-location
Se você estiver usando o Mac OS X ou o Linux, o comando será o seguinte:
appengine-java-sdk/bin/dev_appserver.sh [options] war-location
O comando usa o local do diretório WAR do seu aplicativo como um argumento.
Para interromper o servidor da web, pressione Control-C (no Windows, Mac ou Linux).
Esses comandos são scripts de empacotador do SO que executam a classe Java com.google.appengine.tools.KickStart no appengine-java-sdk/lib/appengine-tools-api.jar.
O servidor da web para desenvolvimento simula o armazenamento de dados do Google App Engine usando um arquivo do seu computador. O arquivo é chamado local_db.bin e é criado no diretório WAR do seu aplicativo, no diretório WEB-INF/appengine-generated/ (ele não é enviado com o seu aplicativo).
Esse arquivo persiste entre as chamadas do servidor da web. Portanto, os dados armazenados ainda estarão disponíveis na próxima vez que você executar o servidor da web. Para limpar o conteúdo do armazenamento de dados, encerre o servidor e, em seguida, exclua esse arquivo.
Conforme descrito na Configuração do índice do armazenamento de dados, o servidor de desenvolvimento pode gerar a configuração para os índices do armazenamento de dados necessária ao seu aplicativo, determinada pelas consultas que realiza durante o teste. Isso gera um arquivo chamado datastore-indexes-auto.xml no diretório WEB-INF/appengine-generated/ no WAR. Para desativar a configuração automática do índice, crie ou edite o arquivo datastore-indexes.xml no diretório WEB-INF/, usando o atributo autoGenerate="false" para o elemento <datastore-indexes>. Consulte a Configuração do índice do armazenamento de dados para obter mais informações.
O servidor da web para desenvolvimento simula as contas do Google, com suas próprias páginas de login e saída. Durante a execução no servidor da web para desenvolvimento, os métodos que geram URLs de login e logoff retornam URLs para /_ah/login e /_ah/logout no servidor local.
A página de login do servidor para desenvolvimento inclui um formulário no qual você pode digitar um endereço de e-mail. Sua sessão usa o endereço de e-mail que você digitou como o usuário ativo.
Para que o aplicativo acredite que o usuário que fez login é um administrador, marque a caixa de seleção "Sign in as Administrator" (Fazer login como administrador) no formulário.
Quando seu aplicativo usa a API de obtenção de URL para fazer uma solicitação HTTP, o servidor da web para desenvolvimento faz a solicitação diretamente do seu computador. O comportamento pode ser diferente de quando seu aplicativo é executado no Google App Engine, caso você use um servidor proxy para acessar sites.
O comando do servidor de desenvolvimento suporta os seguintes argumentos de linha de comando:
|
--port=...O número da porta que será usado com o servidor. O padrão é 8080.
--address=...O endereço do host que será usado com o servidor. Você pode ter que configurá-lo para poder acessar o servidor de desenvolvimento a partir de outro computador de sua rede. O endereço 0.0.0.0 permite acesso via host local e nome do host. O padrão é localhost.
--sdk_root=...Um caminho para o SDK para Java do Google App Engine, se for diferente do local da ferramenta.
--disable_update_checkSe for determinado, o servidor de desenvolvimento não entrará em contato com o Google App Engine para verificar a disponibilidade de uma nova versão do SDK. Por padrão, o servidor verifica se há uma nova versão na inicialização e imprime uma mensagem se uma nova versão estiver disponível.
--helpImprime uma mensagem útil e sai.