Catatan: Python 2.7 telah mencapai akhir dukungan pada 31 Januari 2024. Aplikasi Python 2.7 Anda yang sudah ada akan terus berjalan dan menerima traffic. Namun, App Engine mungkin memblokir deployment ulang aplikasi yang menggunakan runtime setelah akhir tanggal dukungannya. Sebaiknya migrasikan ke Python versi terbaru yang didukung.

Pengendali Layanan WebApp

Fitur ini tidak digunakan lagi. Anda harus menggunakan Library Layanan WSGI yang lebih baru untuk memublikasikan layanan sebagai aplikasi WSGI.

Modul ini berisi class yang memublikasikan layanan RPC Google Protocol menggunakan webapp framework App Engine.

Paket protorpc.webapp.service_handlers menyediakan fungsi berikut:

service_mapping(services, registry_path=DEFAULT_REGISTRY_PATH)

Membuat pemetaan layanan untuk digunakan dengan webapp.

Membuat konfigurasi dan pendaftaran default dasar untuk layanan RPC Google Protocol. Setiap layanan yang tercantum dalam pemetaan layanan memiliki factory pengendali layanan standar yang dibuat untuk layanan tersebut.

Daftar pemetaan dapat berupa jalur eksplisit ke pemetaan layanan atau hanya layanan. Layanan akan otomatis dipetakan ke nama default-nya jika pemetaan hanyalah layanan. Contoh:

from protorpc import remote
from protorpc.webapp import service_handlers

package = 'my_package'

class MyService(remote.Service):
  ...

service_handlers.service_mapping(
    [('/my_path', MyService),  # Maps to /my_path
     MyService,                # Maps to /my_package/MyService
    ])

Biasanya, layanan dipetakan ke jalur URL dengan menentukan tuple (jalur, layanan), dengan jalur adalah jalur tempat layanan berada, dan layanan adalah class layanan atau factory layanan untuk membuat instance layanan baru. Untuk informasi selengkapnya tentang factory layanan, lihat remote.Service.new_factory.

Jika tuple tidak disediakan, sehingga tidak ada jalur yang ditentukan, jalur default akan dihitung menggunakan nama layanan yang sepenuhnya memenuhi syarat menggunakan pemisah jalur URL untuk setiap komponennya, bukan tanda '.'.

Argumen

service: Tuple (path, service), dengan path adalah jalur tempat layanan berada, dan service adalah class layanan atau factory layanan untuk membuat instance layanan baru. Untuk informasi selengkapnya tentang factory layanan, lihat remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH: Jalur yang akan diberikan ke layanan registry. Gunakan None untuk menonaktifkan layanan registry.

Menampilkan daftar tuple yang menentukan pemetaan pengendali permintaan yang kompatibel dengan aplikasi WebApp.

Memunculkan ServiceConfigurationError saat jalur duplikat diberikan.

run_services(services, registry_path=DEFAULT_REGISTRY_PATH)

Menangani permintaan CGI menggunakan pemetaan layanan.

Argumen

service: Tuple (path, service), dengan path adalah jalur tempat layanan berada, dan service adalah class layanan atau factory layanan untuk membuat instance layanan baru. Untuk informasi selengkapnya tentang factory layanan, lihat remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH: Jalur yang akan diberikan ke layanan registry. Gunakan None untuk menonaktifkan layanan registry.