Con l'API Capabilities, la tua applicazione può rilevare interruzioni e tempi di inattività pianificati per funzionalità API specifiche. Puoi utilizzare questa API per ridurre i tempi di inattività nella tua applicazione rilevando quando una funzionalità non è disponibile e ignorandola.
Ad esempio, se utilizzi l'API Images per ridimensionare le immagini, puoi utilizzare l'API Capabilities per rilevare quando l'API Images non è disponibile e saltare il ridimensionamento:
import com.google.appengine.api.capabilities.*;
CapabilitiesService service =
CapabilitiesServiceFactory.getCapabilitiesService();
CapabilityStatus status = service.getStatus(Capability.IMAGES).getStatus();
if (status == CapabilityStatus.DISABLED) {
// Images API is not available.
}
Puoi eseguire query separate per la disponibilità delle operazioni di lettura e scrittura di Datastore. Il seguente esempio mostra come rilevare la disponibilità delle operazioni di scrittura di Datastore e, durante i tempi di inattività, fornire un messaggio agli utenti:
CapabilityStatus status =
service.getStatus(Capability.DATASTORE_WRITE).getStatus();
if (status == CapabilityStatus.DISABLED) {
// Datastore is in read-only mode.
}
Utilizzo dell'API Capabilities
Ogni funzionalità è rappresentata come una costante statica nella classe Capability,
ad esempio
Capability.DATASTORE_WRITE.
Ogni funzionalità ha uno stato, che puoi recuperare da
CapabilitiesService.getStatus(Capability).
Ogni stato ha uno stato, che è un'enumerazione che riflette la disponibilità di una funzionalità: ENABLED o DISABLED. Di seguito è riportato l'
elenco dei servizi attualmente abilitati in questa API.
Funzionalità supportate
L'API supporta attualmente le seguenti funzionalità:
| Capacità | Argomenti per getStatus |
|---|---|
| Disponibilità di Blobstore | Capability.BLOBSTORE |
| Operazioni di lettura Datastore | Capability.DATASTORE |
| Operazioni di scrittura Datastore | Capability.DATASTORE_WRITE |
| Disponibilità del servizio Images | Capability.IMAGES |
| Disponibilità del servizio Mail | Capability.MAIL |
| Disponibilità del servizio Memcache | Capability.MEMCACHE |
| Disponibilità del servizio Coda delle attività | Capability.TASKQUEUE |
| Disponibilità del servizio di recupero URL | Capability.URL_FETCH |