Controladores de serviços de apps Web

Esta funcionalidade foi descontinuada. Deve usar a biblioteca de serviços WSGI mais recente para publicar o serviço como uma aplicação WSGI.

Este módulo contém classes que publicam um serviço RPC de protocolo Google através da framework Webapp do App Engine.

O pacote protorpc.webapp.service_handlers oferece as seguintes funções:

service_mapping(services, registry_path=DEFAULT_REGISTRY_PATH)

Cria um mapeamento de serviços para utilização com a app Web.

Cria a configuração e o registo predefinidos básicos para os serviços de RPC do Protocol Buffer da Google. Cada serviço listado no mapeamento de serviços tem uma fábrica de processadores de serviços padrão criada para ele.

A lista de mapeamentos pode ser um caminho explícito para o mapeamento de serviços ou apenas serviços. Se os mapeamentos forem apenas serviços, são mapeados automaticamente para o respetivo nome predefinido. Por exemplo:

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

Normalmente, os serviços são mapeados para caminhos de URL especificando uma tupla (caminho, serviço), em que caminho é o caminho onde o serviço reside e serviço é a classe de serviço ou a fábrica de serviços para criar novas instâncias do serviço. Para mais informações sobre as fábricas de serviços, consulte remote.Service.new_factory.

Se não for fornecida nenhuma tupla e, por conseguinte, nenhum caminho especificado, é calculado um caminho predefinido usando o nome do serviço totalmente qualificado com um separador de caminho do URL para cada um dos respetivos componentes, em vez de ".".

Argumentos
serviços
Uma tupla (caminho, serviço), onde path é o caminho onde o serviço reside e service é a classe de serviço ou a fábrica de serviços para criar novas instâncias do serviço. Para mais informações sobre as fábricas de serviços, consulte remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH
Caminho a fornecer ao serviço de registo. Use Nenhum para desativar o serviço de registo.

Devolve uma lista de tuplos que definem um mapeamento de controladores de pedidos compatíveis com uma aplicação WebApp.

Gera um ServiceConfigurationError quando são fornecidos caminhos duplicados.

run_services(services, registry_path=DEFAULT_REGISTRY_PATH)

Processa pedidos CGI através do mapeamento de serviços.

Argumentos
serviços
Uma tupla (caminho, serviço), onde path é o caminho onde o serviço reside e service é a classe de serviço ou a fábrica de serviços para criar novas instâncias do serviço. Para mais informações sobre as fábricas de serviços, consulte remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH
Caminho a fornecer ao serviço de registo. Use Nenhum para desativar o serviço de registo.