Aviso: nos próximos meses, vamos reorganizar o site de documentação do App Engine para facilitar a localização de conteúdo e o alinhamento ao restante dos produtos do Google Cloud. O mesmo conteúdo estará disponível, mas a navegação agora corresponderá ao restante dos produtos do Cloud.

O Python 2 não é mais compatível com a comunidade. Recomendamos que você migre aplicativos do Python 2 para o Python 3.

Manipuladores de serviço de WebApp

Este recurso está obsoleto. Use a Biblioteca de Serviços WSGI mais recente para publicar o serviço como um aplicativo WSGI.

Este módulo contém classes para a publicação de um serviço do protocolo de RPC do Google com o framework do 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 a ser usado com o aplicativo da web.

Cria a configuração e o registro padrão básicos para os serviços do protocolo de RPC do Google. Cada serviço listado no mapeamento de serviços tem uma fábrica de manipulador de serviço padrão criada para ele.

A lista de mapeamentos pode ser um caminho explícito para o mapeamento do serviço ou somente serviços. Se os mapeamentos forem somente serviços, eles serão mapeados automaticamente para o nome padrão. 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
    ])

Geralmente os serviços são mapeados para caminhos de URL com a especificação de uma tupla (caminho, serviço). O caminho é onde o serviço se localiza e o serviço é a classe ou a fábrica do serviço usada para a criação de novas instâncias do serviço. Para mais informações sobre fábricas de serviços, consulte remote.Service.new_factory.

Se não for fornecida uma tupla e, portanto, não houver caminho especificado, um caminho padrão é calculado a partir do nome de serviço totalmente qualificado, usando um separador de caminho do URL para cada um dos componentes dele em vez de um ".".

Argumentos

services: Uma tupla (caminho, serviço) na qual path é o caminho em que o serviço reside, e service é a classe do serviço ou a fábrica do serviço para criar novas instâncias do serviço. Para mais informações sobre fábricas de serviços, consulte remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH: Caminho para fornecer ao serviço de registro. Use "None" para desativar o serviço de registro.

Uma lista de tuplas que definem um mapeamento de gerenciadores de solicitações compatíveis com um aplicativo do WebApp é retornada.

Gera um ServiceConfigurationError quando caminhos duplicados são fornecidos.

run_services(services, registry_path=DEFAULT_REGISTRY_PATH)

Manipula solicitações CGI usando o mapeamento de serviço.

Argumentos

services: Uma tupla (caminho, serviço) na qual path é o caminho em que o serviço reside, e service é a classe do serviço ou a fábrica do serviço para criar novas instâncias do serviço. Para mais informações sobre fábricas de serviços, consulte remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH: Caminho para fornecer ao serviço de registro. Use "None" para desativar o serviço de registro.