Configuration du test de service des fonctionnalités
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La fonctionnalité de test des fonctionnalités est conçue pour s'exécuter sur le serveur Web de développement App Engine à des fins de test. Elle vous permet de modifier l'état de services, tels que le datastore, le blobstore, etc., afin de déterminer si l'application se comporte correctement lorsqu'elle rencontre les différents états possibles du service. Par exemple, la désactivation de l'état du service du datastore permet de vérifier si l'application gère l'indisponibilité du datastore de manière transparente.
Il existe plusieurs façons d'utiliser la fonctionnalité de test des fonctionnalités :
Modifier l'état des fonctionnalités à l'aide de la console
Pour modifier les fonctionnalités de la console, procédez comme suit :
- Lorsque votre application s'exécute sur le serveur de développement, accédez à la console en vous rendant sur l'URL
/_ah/admin sur votre serveur ; par exemple : http://localhost:8888/_ah/admin.
- Dans la console, cliquez sur État des fonctionnalités en bas à gauche de la console.
- Sur la page Configuration de l'état des fonctionnalités, localisez le ou les services utilisés par l'application et dont vous souhaitez modifier l'état. Cliquez sur le menu déroulant à côté du nom du service et sélectionnez l'état que vous souhaitez tester sur ce service :
Les services reflètent désormais les paramètres que vous avez choisis la prochaine fois que l'application y accède. Exécutez l'application et observez son comportement.
Modifier l'état des fonctionnalités à l'aide de la ligne de commande
Si vous utilisez Eclipse, vous pouvez définir une ou plusieurs fonctionnalités à l'aide des options de ligne de commande de débogage.
Pour modifier les paramètres des fonctionnalités à l'aide des arguments de ligne de commande de VM dans Eclipse :
- Une fois Eclipse ouvert, sélectionnez votre projet, cliquez avec le bouton droit de la souris, puis sélectionnez Déboguer en tant que > Configurations de débogage.
- Accédez à l'onglet Arguments et entrez l'option souhaitée dans la zone de texte Arguments de VM. Le format de l'option est :
-Dcapability.status.capabilityname.*=statusname
où capabilityname est remplacé par le nom du service (consultez la section Noms (de service) des fonctionnalités) et statusname par l'état de la fonctionnalité que vous souhaitez utiliser (consultez la section Valeurs d'état des fonctionnalités).
Remarque : Pour la fonctionnalité d'écriture du datastore, remplacez capabilityname par datastore_v3 et l'astérisque (*) par write, comme suit : Dcapability.status.datastore_v3.write. Pour les autres fonctionnalités, laissez l'astérisque tel quel.
La capture d'écran ci-dessous montre deux fonctionnalités (Datastore et Images) désactivées à l'aide de la ligne de commande :
- Cliquez sur Appliquer pour enregistrer vos modifications.
- Cliquez sur Déboguer pour exécuter l'application avec ces paramètres.
Noms (de service) des fonctionnalités
| Nom de la fonctionnalité dans l'API |
Nom de la fonctionnalité affiché dans la console |
Description |
blobstore |
BLOBSTORE |
Service Blobstore |
datastore_v3 |
DATASTORE |
Service Datastore pour les requêtes |
datastore_v3,write |
DATASTORE_WRITE |
Service Datastore pour les requêtes d'écriture |
images |
IMAGES |
Service Images |
mail |
MAIL |
Service de messagerie |
memcache |
MEMCACHE |
Service Memcache |
taskqueue |
TASKQUEUE |
Service TaskQueue |
urlfetch |
URLFETCH |
Service UrlFetch |
Valeurs d'état des fonctionnalités
| Valeurs d'état de toutes les fonctionnalités |
Description |
DISABLED |
La capacité est désactivée. |
ENABLED |
La capacité est disponible, et aucune maintenance la concernant n'est actuellement planifiée. |
SCHEDULED_MAINTENANCE |
La capacité est disponible, mais une période de maintenance la concernant a été planifiée. |
UNKNOWN |
L'état du service est inconnu. |
Modifier l'état des fonctionnalités à l'aide de l'API Capabilities
Pour utiliser la fonctionnalité de test des fonctionnalités du service local dans l'API, utilisez la classe LocalCapabilitiesServiceTestConfig. Pour en savoir plus et obtenir un exemple de code, consultez la section Writing Local Service Capabilities Tests (Écrire des tests de fonctionnalités de service local).
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
