WebApp 服務處理常式

這項功能已不適用,請您使用較新的 WSGI 服務程式庫將服務發布為 WSGI 應用程式。

此模組含有使用 App Engine Webapp 架構來發布 Google Protocol RPC 服務的類別。

protorpc.webapp.service_handlers 套件提供下列函式:

service_mapping(services, registry_path=DEFAULT_REGISTRY_PATH)

建立可供網路應用程式使用的服務對應。

建立 Google Protocol RPC 服務的基本預設設定和登錄作業。服務對應中列出的每個服務都有專門為其建立的標準服務處理常式 Factory。

對應清單可能是服務對應的明確路徑,或是服務本身。如果對應是服務本身,則會自動對應至服務的預設名稱。例如:

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
    ])

一般來說,服務是藉由指定組合 (path、service) 來對應至網址路徑,其中 path 是指服務所在的路徑,而 service 則是指建立服務的新執行個體時所使用的服務類別和服務 Factory。如要進一步瞭解服務 Factory,請參閱 remote.Service.new_factory

如果未提供元組,因此未指定路徑,系統會使用完整的服務名稱計算預設路徑,並為每個元件使用網址路徑分隔符號,而非 '.'。

引數
services
元組 (路徑、服務),其中 path 是服務所在的路徑,而 service 是用於建立服務新執行個體的服務類別或服務工廠。如要進一步瞭解服務 Factory,請參閱 remote.Service.new_factory
registry_path=DEFAULT_REGISTRY_PATH
提供給登錄檔服務的路徑。使用 None 即可停用登錄服務。

傳回用於定義對應要求處理常式且與 WebApp 應用程式相容的組合清單。

提供重複的路徑時,發出 ServiceConfigurationError 訊息。

run_services(services, registry_path=DEFAULT_REGISTRY_PATH)

使用服務對應處理 CGI 要求。

引數
services
元組 (路徑、服務),其中 path 是服務所在的路徑,而 service 是用於建立服務新執行個體的服務類別或服務工廠。如要進一步瞭解服務 Factory,請參閱 remote.Service.new_factory
registry_path=DEFAULT_REGISTRY_PATH
提供給登錄檔服務的路徑。使用 None 即可停用登錄服務。