Con l'API Capabilities, la tua applicazione può rilevare interruzioni e tempi di inattività pianificati per specifiche funzionalità API. 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 separatamente per la disponibilità di letture e scritture di Datastore. Il seguente esempio mostra come rilevare la disponibilità delle scritture Datastore e, durante il tempo 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 in Java 8
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, ovvero 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
Attualmente, l'API supporta le seguenti funzionalità:
| Capacità | Argomenti per getStatus |
|---|---|
| Disponibilità del blobstore | Capability.BLOBSTORE |
| Letture Datastore | Capability.DATASTORE |
| Scritture datastore | Capability.DATASTORE_WRITE |
| Disponibilità del servizio Immagini | Capability.IMAGES |
| Disponibilità del servizio di posta | Capability.MAIL |
| Disponibilità del servizio Memcache | Capability.MEMCACHE |
| Disponibilità del servizio Task Queue | Capability.TASKQUEUE |
| Disponibilità del servizio di recupero URL | Capability.URL_FETCH |