Configuração do teste do serviço de capacidades

O recurso de teste de capacidade foi projetado para ser executado tendo como referência o servidor da Web de desenvolvimento do App Engine para fins de teste. Ele permite que você altere o status dos serviços, como armazenamento de dados, blobstore etc., para determinar se o aplicativo se comporta adequadamente quando encontra os vários status possíveis do serviço. Por exemplo, alterando o status do serviço de armazenamento de dados para desativado, você pode testar se o aplicativo gerencia a indisponibilidade do armazenamento de dados da maneira adequada.

Há várias maneiras de usar o recurso de teste de capacidades:

Alterar status das capacidades usando o console

Para alterar as capacidades no console:

1. Execute o aplicativo no servidor de desenvolvimento e acesse o console pelo URL /_ah/admin no seu servidor, por exemplo: http://localhost:8888/_ah/admin.
2. No console, clique em Status das capacidades na parte inferior esquerda.
3. Na página Configuração do status das capacidades, localize os serviços que são utilizados pelo aplicativo com o status você quer mudar. Clique no menu suspenso ao lado do nome do serviço e selecione o status que quer testar nesse serviço:

Agora, os serviços irão refletir as configurações que você escolheu na próxima vez que seu aplicativo acessá-los. Execute seu aplicativo e observe o comportamento dele.

Alterar status das capacidades usando a linha de comando

Se você usa o Eclipse, pode configurar um ou mais recursos usando as opções de depuração da linha de comando.

Para alterar as configurações de capacidade usando os argumentos da linha de comando da VM no Eclipse:

1. Com o Eclipse aberto, selecione seu projeto, clique com o botão direito do mouse e selecione Debug As > Debug Configurations.
2. Vá para a guia Arguments e insira a opção desejada na caixa de texto VM arguments. O formato da opção é:

   -Dcapability.status.capabilityname.*=statusname

   , em que capabilityname é substituído pelo nome do serviço (consulte Nomes de capacidades (serviços)) e statusname é substituído pelo status da capacidade que você pretende usar (consulte Valores de status das capacidades).

   Observação: Para a capacidade de gravação do armazenamento de dados, substitua capabilityname por datastore_v3 e o asterisco (*) por write, como este: Dcapability.status.datastore_v3.write. Para as outras capacidades, deixe o asterisco como mostrado.

   Na captura de tela abaixo, mostramos duas capacidades, armazenamento de dados e imagens, que estão sendo desativadas a partir da linha de comando:

   

3. Clique em Apply para salvar as alterações.
4. Clique em Debug para executar seu aplicativo com essas configurações.

Nomes de capacidades (serviços)

Valores de status de capacidades

Alterar o status das capacidades usando a Capabilities API

Para usar o recurso de teste de capacidades do serviço local na API, use a classe LocalCapabilitiesServiceTestConfig. Para mais informações e um exemplo de código, consulte Como gravar testes de capacidades do serviço local.