API Capabilities per servizi in bundle legacy

Con l'API Capabilities, l'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 quindi bypassando la relativa. .

Ad esempio, se utilizzi l'API Images per ridimensionare le immagini, puoi usare l'API Capabilities per rilevare quando l'API Images non è disponibile e ignorare 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 sulla disponibilità di letture e scritture di Datastore. L'esempio seguente mostra come rilevare la disponibilità delle scritture di 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 Capability è 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. Consulta l'elenco dei servizi attualmente abilitati per questa API.

Funzionalità supportate

L'API supporta attualmente le seguenti funzionalità:

Capacità Argomenti per getStatus
Disponibilità dell'archivio BLOB Capacità.BLOBSTORE
Letture datastore Capacità.DATASTORE
Scritture datastore Capacità.DATASTORE_WRITE
Disponibilità del servizio Immagini Capacità.IMAGE
Disponibilità del servizio di posta Capacità.MAIL
Disponibilità del servizio memcache Capacità.MEMCACHE
Disponibilità del servizio coda delle attività Capacità.TASKQUEUE
Disponibilità del servizio di recupero URL Capacità.URL_FETCH