Java 8 ha raggiunto la fine del supporto
e verrà
ritirato
il 31 gennaio 2026. Dopo il ritiro, non potrai eseguire il deployment di applicazioni Java 8, anche se la tua organizzazione ha utilizzato in precedenza un criterio dell'organizzazione per riattivare i deployment di runtime legacy. Le tue applicazioni Java 8 esistenti continueranno a essere eseguite e a ricevere traffico dopo la
data di ritiro. Ti consigliamo di
eseguire la migrazione all'ultima versione supportata di Java.
Configurazione del test del servizio Capabilities
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La funzionalità di test delle funzionalità è progettata per essere eseguita sul server web di sviluppo di App Engine a scopo di test. Ti consente di modificare lo stato dei servizi, come datastore, blobstore e così via, per determinare se la tua applicazione si comporta correttamente quando rileva i vari possibili stati del servizio. Ad esempio, modificando lo stato del servizio del datastore in disabilitato, puoi verificare se la tua app gestisce l'interruzione del datastore in modo corretto.
Esistono diversi modi per utilizzare la funzionalità di test delle funzionalità:
Modificare lo stato delle funzionalità utilizzando la console
Per modificare le funzionalità nella console:
- Con l'app in esecuzione sul server di sviluppo, accedi alla console visitando l'URL
/_ah/admin sul server, ad esempio: http://localhost:8888/_ah/admin.
- Nella console, fai clic su Stato funzionalità in basso a sinistra.
- Nella pagina Configurazione dello stato delle funzionalità, individua il servizio o i servizi utilizzati dalla tua app e di cui vuoi modificare lo stato; fai clic sul menu a discesa accanto al nome del servizio e seleziona lo stato che vuoi testare su quel servizio:
La prossima volta che l'app accederà ai servizi, questi rifletteranno le impostazioni che hai scelto. Esegui l'app e osserva il suo comportamento.
Modificare lo stato delle funzionalità utilizzando la riga di comando
Se utilizzi Eclipse, puoi impostare una o più funzionalità utilizzando le opzioni della riga di comando di debug.
Per modificare le impostazioni delle funzionalità utilizzando gli argomenti della riga di comando della VM in Eclipse
- Con Eclipse aperto, seleziona il progetto, fai clic con il tasto destro del mouse e seleziona Esegui il debug come > Configurazioni di debug.
- Vai alla scheda Argomenti e inserisci l'opzione che preferisci nella casella di testo Argomenti VM. Il formato dell'opzione è
-Dcapability.status.capabilityname.*=statusname
, dove capabilityname viene sostituito dal nome del servizio (vedi Nomi delle funzionalità (servizi)) e statusname viene sostituito dallo stato della funzionalità che vuoi utilizzare (vedi Valori dello stato della funzionalità).
Nota: per la funzionalità di scrittura del datastore, sostituisci capabilityname con datastore_v3 e l'asterisco (*) con write, come segue: Dcapability.status.datastore_v3.write. Per le altre funzionalità, lascia l'asterisco come mostrato.
L'acquisizione dello schermo di seguito mostra due funzionalità (datastore e immagini) disattivate dalla riga di comando:
- Fai clic su Applica per salvare le modifiche.
- Fai clic su Debug per eseguire l'app con queste impostazioni.
Nomi delle funzionalità (servizi)
| Nome della funzionalità nell'API |
Nome della funzionalità visualizzato nella console |
Descrizione |
blobstore |
BLOBSTORE |
Il servizio blobstore |
datastore_v3 |
DATASTORE |
Il servizio datastore per le query |
datastore_v3,write |
DATASTORE_WRITE |
Il servizio datastore per le richieste di scrittura |
images |
IMMAGINI |
Il servizio di immagini |
mail |
POSTA |
Il servizio postale |
memcache |
MEMCACHE |
Il servizio memcache |
taskqueue |
TASKQUEUE |
Il servizio taskqueue |
urlfetch |
URLFETCH |
Il servizio urlfetch |
Valori dello stato della funzionalità
| Valori di stato per tutte le funzionalità |
Descrizione |
DISABLED |
La funzionalità è disattivata. |
ENABLED |
La funzionalità è disponibile e al momento non è prevista alcuna manutenzione. |
SCHEDULED_MAINTENANCE |
La funzionalità è disponibile, ma è in programma la manutenzione. |
UNKNOWN |
Lo stato di questo servizio è sconosciuto. |
Modificare lo stato delle funzionalità utilizzando l'API Capabilities
Per utilizzare la funzionalità di test delle funzionalità dei servizi locali nell'API, utilizza la classe LocalCapabilitiesServiceTestConfig. Per ulteriori informazioni e un esempio di codice, consulta Scrivere test delle funzionalità di Servizi locali.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-04 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
