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,
- Saat aplikasi Anda berjalan di server pengembangan, akses konsol dengan mengunjungi URL
/_ah/admin
di server Anda, misalnya: http://localhost:8888/_ah/admin. - Di konsol, klik Capabilities Status di kiri bawah konsol.
- 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
- Setelah Eclipse terbuka, pilih project Anda, klik kanan, lalu pilih Debug As > Debug Configurations.
- Buka tab Arguments, lalu masukkan opsi yang diinginkan di kotak teks Argumen VM. Format pilihannya adalah
-Dcapability.status.capabilityname.*=statusname
capabilityname
diganti dengan nama layanan (lihat Nama Kemampuan (Layanan)) danstatusname
diganti dengan status kemampuan yang ingin Anda gunakan (lihat Kemampuan Nilai Status).Catatan: Untuk kemampuan tulis datastore, ganti
capabilityname
dengandatastore_v3
dan tanda bintang (*
) denganwrite
, 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:
- Klik Terapkan untuk menyimpan perubahan.
- 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 |
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.