Observação: o Python 2.7 chegou ao fim do suporte em 31 de janeiro de 2024. Os aplicativos Python 2.7 atuais continuarão a ser executados e a receber tráfego. No entanto, o App Engine pode bloquear a reimplantação de aplicativos que usam ambientes de execução após o término da data de suporte. Recomendamos que você migre para a versão compatível mais recente do Python.

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

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.