Konfigurasi Uji Layanan Kemampuan

Fitur pengujian kemampuan dirancang untuk dijalankan terhadap server web pengembangan App Engine untuk tujuan pengujian. Dengan alat ini, Anda dapat mengubah status layanan, seperti datastore, blobstore, dll., untuk menentukan apakah aplikasi Anda berperilaku dengan baik saat menemukan berbagai kemungkinan status layanan. Misalnya, dengan mengubah status layanan datastore menjadi nonaktif, Anda dapat menguji apakah aplikasi menangani ketidaktersediaan datastore dengan cara yang baik.

Ada beberapa cara untuk menggunakan fitur pengujian kemampuan:

Mengubah Status Kemampuan Menggunakan Console

Untuk mengubah kemampuan di konsol,

  1. Saat aplikasi Anda berjalan di server pengembangan, akses konsol dengan mengunjungi URL /_ah/admin di server Anda, misalnya: http://localhost:8888/_ah/admin.
  2. Di konsol, klik Capabilities Status di kiri bawah konsol.
  3. Di halaman Konfigurasi Status Kemampuan, cari layanan yang digunakan oleh aplikasi Anda dan yang statusnya ingin Anda ubah; klik menu dropdown di samping nama layanan dan pilih status yang ingin Anda uji pada layanan tersebut:

Layanan tersebut kini mencerminkan setelan yang telah Anda pilih saat aplikasi Anda mengaksesnya lagi. Jalankan aplikasi Anda dan amati perilakunya.

Mengubah Status Kemampuan Menggunakan Command Line

Jika menggunakan Eclipse, Anda dapat menyetel satu atau beberapa kemampuan menggunakan opsi command line debug.

Untuk mengubah setelan kemampuan menggunakan argumen command line VM di Eclipse

  1. Setelah Eclipse terbuka, pilih project Anda, klik kanan, lalu pilih Debug As > Debug Configurations.
  2. Buka tab Arguments, lalu masukkan opsi yang diinginkan di kotak teks Argumen VM. Format pilihannya adalah

    -Dcapability.status.capabilityname.*=statusname

    , dengan capabilityname diganti dengan nama layanan (lihat Nama Kemampuan (Layanan)) dan statusname diganti dengan status kemampuan yang ingin Anda gunakan (lihat Kemampuan Nilai Status).

    Catatan: Untuk kemampuan tulis datastore, ganti capabilityname dengan datastore_v3 dan tanda bintang (*) dengan write, seperti ini: Dcapability.status.datastore_v3.write. Untuk kemampuan lainnya, biarkan tanda bintang seperti yang ditunjukkan.

    Screenshot di bawah ini menunjukkan dua kemampuan (datastore dan gambar) yang dinonaktifkan dari command line:

  3. Klik Terapkan untuk menyimpan perubahan.
  4. Klik Debug untuk menjalankan aplikasi dengan setelan tersebut.

Nama Kemampuan (Layanan)

Nama Kemampuan di API Nama Kemampuan ditampilkan di Console Deskripsi
blobstore BLOBSTORE Layanan blobstore
datastore_v3 DATASTORE Layanan datastore untuk kueri
datastore_v3,write DATASTORE_WRITE Layanan datastore untuk permintaan tulis
images GAMBAR Layanan gambar
mail MAIL Layanan email
memcache MEMCACHE Layanan memcache
taskqueue TASKQUEUE Layanan taskqueue
urlfetch URLFETCH Layanan urlfetch

Nilai Status Kemampuan

Nilai Status untuk Semua Kemampuan Deskripsi
DISABLED Kemampuan dinonaktifkan.
ENABLED Kemampuan tersedia dan saat ini tidak ada rencana pemeliharaan.
SCHEDULED_MAINTENANCE Kemampuan tersedia, tetapi dijadwalkan untuk pemeliharaan.
UNKNOWN Status layanan ini tidak diketahui.

Mengubah Status Kemampuan Menggunakan Capabilities API

Untuk menggunakan fitur pengujian kemampuan layanan lokal di API, gunakan class LocalCapabilitiesServiceTestConfig. Untuk mengetahui informasi selengkapnya dan contoh kode, lihat Menulis Pengujian Kemampuan Layanan Lokal.