WebApp 服务处理程序

此功能已弃用。您应该使用较新的 WSGI 服务库,将服务作为 WSGI 应用进行发布。

本模块包含使用 App Engine 网络应用框架发布 Google Protocol RPC 服务的类。

protorpc.webapp.service_handlers 软件包提供以下函数:

service_mapping(services, registry_path=DEFAULT_REGISTRY_PATH)

创建用于网络应用的服务映射。

为 Google Protocol RPC 服务创建基本的默认配置和注册。服务映射中列出的每个服务都有一个为其创建的标准服务处理程序工厂。

映射列表可以是指向服务映射的显式路径,也可以只是服务。如果映射只是服务,系统会自动将它们映射到其默认名称。例如:

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 是用于创建新服务实例的服务类或服务工厂。如需详细了解服务工厂,请参阅 remote.Service.new_factory

如果未提供元组,进而导致未指定路径,那么将使用完全限定的服务名称(针对每个组件使用网址路径分隔符,而不使用“.”)来计算默认路径。

参数
项服务
元组 (path, service),其中 path 是服务所在的路径,而 service 是用于创建新服务实例的服务类或服务工厂。如需详细了解服务工厂,请参阅 remote.Service.new_factory
registry_path=DEFAULT_REGISTRY_PATH
提供注册表服务的路径。使用 None 可停用注册表服务。

返回元组列表,这些元组定义了与 WebApp 应用兼容的请求处理程序的映射。

如果提供重复路径,则会引发 ServiceConfigurationError。

run_services(services, registry_path=DEFAULT_REGISTRY_PATH)

使用服务映射处理 CGI 请求。

参数
项服务
元组 (path, service),其中 path 是服务所在的路径,而 service 是用于创建新服务实例的服务类或服务工厂。如需详细了解服务工厂,请参阅 remote.Service.new_factory
registry_path=DEFAULT_REGISTRY_PATH
提供注册表服务的路径。使用 None 可停用注册表服务。