Configuración de la prueba de funciones de servicio
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La función de prueba de capacidades se diseñó para ejecutarse en el servidor web de desarrollador de App Engine con fines de pruebas. Te permite cambiar el estado de los servicios, como almacén de datos, Blobstore, etc., para determinar si tu aplicación se comporta de forma correcta cuando se encuentra con los distintos estados posibles del servicio. Por ejemplo, si cambias el estado del servicio de almacén de datos a inhabilitado, puedes probar si tu app puede controlar la falta de disponibilidad del almacén de datos de forma estable.
Hay varias formas de usar la característica de prueba de capacidades:
Cambia el estado de las capacidades con la consola
Para cambiar las funciones en la consola, haz lo siguiente:
- Una vez que la app se ejecute en el servidor de desarrollador, visita la URL
/_ah/admin en tu servidor para acceder a la consola, por ejemplo: http://localhost:8888/_ah/admin.
- En la consola, haz clic en Capabilities Status, que se encuentra en la parte inferior izquierda.
- En la página Configuración del estado de las capacidades, localiza el servicio o los servicios que tu aplicación usa y los estados que deseas cambiar. Luego, haz clic en el menú desplegable al lado del nombre del servicio y selecciona el estado que quieres probar en ese servicio:
Los servicios reflejarán la configuración que elegiste la próxima vez que tu app acceda a ellos. Ejecútala y observa su comportamiento.
Cambia el estado de las capacidades con la línea de comandos
Si usas Eclipse, puedes establecer una o más capacidades con las opciones de depuración de la línea de comandos.
Para cambiar la configuración de las capacidades con los argumentos de la línea de comandos de VM en Eclipse, haz lo siguiente:
- Procura tener Eclipse abierto; luego, selecciona tu proyecto, haz clic derecho y selecciona Depurar como > Configuración de depuración.
- Dirígete a la pestaña Argumentos y, luego, ingresa la opción deseada en el cuadro de texto argumentos de VM. El formato de la opción es el siguiente:
-Dcapability.status.capabilityname.*=statusname
En el ejemplo anterior, capabilityname se reemplaza por el nombre del servicio (consulta Nombres de funciones [del servicio]), y statusname se reemplaza por el estado de la función que quieres usar (consulta Valores de estado de función).
Nota: Para la función de escritura del almacén de datos, reemplaza capabilityname por datastore_v3, y el asterisco (*) por write, de la siguiente manera: Dcapability.status.datastore_v3.write. Para otras funciones, deja el asterisco como se muestra.
En la captura de pantalla a continuación, se muestran dos capacidades (imágenes y almacén de datos) inhabilitadas desde la línea de comandos:
- Haz clic en Aplicar para guardar los cambios
- Haz clic en Depurar para ejecutar tu app con esa configuración.
Nombres de capacidad (del servicio)
| Nombre de capacidad en la API |
Nombre de capacidad que se muestra en Console |
Descripción |
blobstore |
BLOBSTORE |
El servicio de Blobstore |
datastore_v3 |
DATASTORE |
El servicio de Datastore para consultas |
datastore_v3,write |
DATASTORE_WRITE |
El servicio de Datastore para solicitudes de escrituras |
images |
IMAGES |
El servicio de imágenes |
mail |
MAIL |
El servicio de correo electrónico |
memcache |
MEMCACHE |
El servicio de Memcache |
taskqueue |
TASKQUEUE |
El servicio de lista de tareas en cola |
urlfetch |
URLFETCH |
El servicio de urlfetch |
Valores de estado de capacidad
| Valores de estado para todas las capacidades |
Descripción |
DISABLED |
La capacidad está inhabilitada. |
ENABLED |
La capacidad está disponible y no hay mantenimientos planeados. |
SCHEDULED_MAINTENANCE |
La capacidad está disponible, pero tiene un mantenimiento programado. |
UNKNOWN |
Se desconoce el estado de este servicio. |
Cambia el estado de las capacidades con la API de funciones
Para usar la característica de prueba de capacidades de servicio local en la API, debes usar la clase LocalCapabilitiesServiceTestConfig. Para obtener más información y un código de muestra, consulta Escribe pruebas de funciones de servicio local.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-04 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
