자바 8용 Capabilities API 개요

Capabilities API를 사용하면 애플리케이션이 특정 API 기능의 서비스 중단 및 예정된 다운타임을 감지할 수 있습니다. 이 API를 사용하면 특정 기능을 사용할 수 없을 때 이를 감지하고 해당 기능을 우회하여 애플리케이션의 다운타임을 줄일 수 있습니다.

예를 들어 Images API를 사용하여 이미지 크기를 조정할 때, Capabilities API를 사용하면 Images API를 사용할 수 없을 때 이를 감지하여 크기 조정을 건너뛸 수 있습니다.

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.
}

Datastore 읽기 및 쓰기 가능 여부도 별도로 쿼리할 수 있습니다. 다음 샘플은 Datastore 쓰기 가능 여부를 감지하는 방법을 보여주고, 다운타임 중 사용자에게 메시지를 제공합니다.

CapabilityStatus status =
    service.getStatus(Capability.DATASTORE_WRITE).getStatus();

if (status == CapabilityStatus.DISABLED) {
    // Datastore is in read-only mode.
}

자바 8에서 Capabilities API 사용

각 Capability는 Capability 클래스에서 정적 상수로 표시됩니다(예: Capability.DATASTORE_WRITE). 각 기능에는 CapabilitiesService.getStatus(Capability)에서 검색 가능한 상태가 포함되어 있습니다. 각 상태는 특정 기능의 가용성을 나타내는 열거형 값인 ENABLED 또는 DISABLED를 포함합니다. 이 API에서 현재 사용 설정된 서비스 목록은 아래를 참조하세요.

지원되는 기능

이 API에서 현재 지원되는 기능은 다음과 같습니다.

기능 getStatus에 대한 인수
blobstore 사용 가능 여부 Capability.BLOBSTORE
Datastore 읽기 Capability.DATASTORE
Datastore 쓰기 Capability.DATASTORE_WRITE
이미지 서비스 사용 가능 여부 Capability.IMAGES
메일 서비스 사용 가능 여부 Capability.MAIL
Memcache 서비스 사용 가능 여부 Capability.MEMCACHE
태스크 큐 서비스 사용 가능 여부 Capability.TASKQUEUE
URL Fetch 서비스 사용 가능 여부 Capability.URL_FETCH