Configuração do teste do serviço de capacidades
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
- 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.
- No console, clique em Status das capacidades na parte inferior esquerda.
- 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:
- Com o Eclipse aberto, selecione seu projeto, clique com o botão direito do mouse e selecione Debug As > Debug Configurations.
- 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:
- Clique em Apply para salvar as alterações.
- Clique em Debug para executar seu aplicativo com essas configurações.
Nomes de capacidades (serviços)
| Nome da capacidade na API |
Nome da capacidade exibido no console |
Descrição |
blobstore |
BLOBSTORE |
O serviço blobstore |
datastore_v3 |
DATASTORE |
O serviço de armazenamento de dados para consultas |
datastore_v3,write |
DATASTORE_WRITE |
O serviço de armazenamento de dados para solicitações de gravação |
images |
IMAGES |
O serviço de imagens |
mail |
MAIL |
O serviço de correio |
memcache |
MEMCACHE |
O serviço memcache |
taskqueue |
TASKQUEUE |
O serviço taskqueue |
urlfetch |
URLFETCH |
O serviço urlfetch |
Valores de status de capacidades
| Valores de status para todas as capacidades |
Descrição |
DISABLED |
A capacidade está desativada. |
ENABLED |
A capacidade está disponível e atualmente não há manutenção planejada. |
SCHEDULED_MAINTENANCE |
A capacidade está disponível, mas há manutenção agendada. |
UNKNOWN |
O status deste serviço é desconhecido. |
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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-04 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThe capabilities test feature allows you to modify the status of App Engine services (like datastore and blobstore) on the development web server to test how your application handles different service states.\u003c/p\u003e\n"],["\u003cp\u003eYou can change the status of services using the console by accessing \u003ccode\u003e/_ah/admin\u003c/code\u003e on your development server and navigating to the \u003cstrong\u003eCapabilities Status\u003c/strong\u003e page.\u003c/p\u003e\n"],["\u003cp\u003eEclipse users can adjust capability statuses by adding specific VM arguments in the \u003cstrong\u003eDebug Configurations\u003c/strong\u003e dialog, allowing you to disable or change the status of services such as \u003ccode\u003edatastore_v3.write\u003c/code\u003e or \u003ccode\u003eimages\u003c/code\u003e for testing.\u003c/p\u003e\n"],["\u003cp\u003eThe available capability status values are \u003ccode\u003eDISABLED\u003c/code\u003e, \u003ccode\u003eENABLED\u003c/code\u003e, \u003ccode\u003eSCHEDULED_MAINTENANCE\u003c/code\u003e, and \u003ccode\u003eUNKNOWN\u003c/code\u003e, providing various testing scenarios for service availability.\u003c/p\u003e\n"],["\u003cp\u003eThe LocalCapabilitiesServiceTestConfig class is available in the API to use the local service capabilities test feature.\u003c/p\u003e\n"]]],[],null,["# Capabilities Service Test Configuration\n\nThe capabilities test feature is designed to run against the App Engine [development web server](/appengine/docs/legacy/standard/java/tools/using-local-server) for testing purposes. It enables you to change the status of services, such as datastore, blobstore, etc., to determine whether your application behaves properly when it encounters the various possible statuses of the service. For example, by changing the datastore service status to disabled, you can test whether your app handles datastore unavailability in a graceful manner.\n\nThere are several ways to use the capabilities test feature:\n\nChange Capabilities Status Using the Console\n--------------------------------------------\n\nTo change capabilities in the console,\n\n1. With your app running on the development server, access the console by visiting the URL `/_ah/admin` on your server, for example: \u003chttp://localhost:8888/_ah/admin\u003e.\n2. In the console, click **Capabilities Status** in the bottom left of the console.\n3. In the **Capabilities Status Configuration** page, locate the service or services that are used by your app and whose status you wish to change; click the dropdown menu next to the service name and select the status you want to test on that service:\n\nThe services now reflect the settings you have chosen the next time your app accesses them. Run your app and observe its behavior.\n\nChange Capabilities Status Using the Command Line\n-------------------------------------------------\n\nIf you use Eclipse, you can set one or more capabilities using the debug command line options.\n\nTo change capability settings using the VM command line arguments in Eclipse\n\n1. With Eclipse open, select your project, right-click, then select **Debug As \\\u003e Debug Configurations**.\n2. Go to the **Arguments** tab and enter the desired option in the **VM arguments** textbox. The format of the option is\n\n `-Dcapability.status.`*capabilityname* `.*=`*statusname*\n , where *capabilityname* is replaced by the name of the service (see [Capability (Service) Names](#Capability_(Service)_Names)) and `statusname` is replaced by the capability status you want to use (see [Capability Status Values](#Capability_Status_Values)).\n\n \u003cbr /\u003e\n\n **Note:** For the datastore write capability, replace *capabilityname* with `datastore_v3` and the asterisk (`*`) with `write`, like this: `Dcapability.status.datastore_v3.write`. For the other capabilities, leave the asterisk as shown.\n\n The screen capture below shows two capabilities (datastore and images) being disabled from the command line:\n\n3. Click **Apply** to save your changes\n4. Click **Debug** to run your app with those settings.\n\n### Capability (Service) Names\n\n### Capability Status Values\n\nChange Capabilities Status Using the Capabilities API\n-----------------------------------------------------\n\nTo use the local service capabilities test feature in the API, you use the [LocalCapabilitiesServiceTestConfig](/appengine/docs/legacy/standard/java/tools/localunittesting/javadoc/com/google/appengine/tools/development/testing/LocalCapabilitiesServiceTestConfig) class. For more information and a code sample, see [Writing Local Service Capabilities Tests](/appengine/docs/legacy/standard/java/tools/localunittesting#capabilities-testing)."]]
