Note: It is recommended that you use the newer WSGI Service Library to publish the service as a WSGI application, rather than using the older webapp framework.

This module contains classes that publish a Google Protocol RPC service using the App Engine Webapp framework.

The protorpc.webapp.service_handlers package provides the following functions:

service_mapping ( services , registry_path = DEFAULT_REGISTRY_PATH )

Creates a services mapping for use with webapp.

Creates basic default configuration and registration for Google Protocol RPC services. Each service listed in the service mapping has a standard service handler factory created for it.

The list of mappings can either be an explicit path to service mapping or just services. If mappings are just services, they will automatically be mapped to their default name. For example:

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

Normally, services are mapped to URL paths by specifying a tuple (path, service), where path is the path where the service resides, and service is the service class or service factory for creating new instances of the service. For more information about service factories, please see remote.Service.new_factory .

If no tuple is provided, and therefore no path specified, a default path is calculated by using the fully qualified service name using a URL path separator for each of its components instead of a '.'.

Arguments

services

A tuple (path, service), where path is the path where the service resides, and service is the service class or service factory for creating new instances of the service. For more information about service factories, please see remote.Service.new_factory .

registry_path = DEFAULT_REGISTRY_PATH

Path to provide to the registry service. Use None to disable registry service.

Returns a list of tuples defining a mapping of request handlers compatible with a WebApp application.

Raises a ServiceConfigurationError when duplicate paths are provided.

run_services ( services , registry_path = DEFAULT_REGISTRY_PATH )

Handles CGI request using service mapping.

Arguments

services

A tuple (path, service), where path is the path where the service resides, and service is the service class or service factory for creating new instances of the service. For more information about service factories, please see remote.Service.new_factory .

registry_path = DEFAULT_REGISTRY_PATH

Path to provide to the registry service. Use None to disable registry service.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License , and code samples are licensed under the Apache 2.0 License . For details, see our Site Policies .