Remarque : Python 2.7 n'est plus compatible à partir du 31 janvier 2024. Vos applications Python 2.7 existantes continueront à fonctionner et à recevoir du trafic. Toutefois, App Engine peut bloquer le redéploiement des applications qui utilisent des environnements d'exécution après leur date de fin de compatibilité. Nous vous recommandons de migrer vers la dernière version compatible de Python.

Gestionnaires de services WebApp

Cette fonctionnalité est obsolète. Pour publier le service en tant qu'application WSGI, vous devez utiliser la dernière version de la bibliothèque de services WSGI.

Ce module contient des classes qui publient un service Google Protocol RPC à l'aide de l'environnement logiciel WebApp d'App Engine.

Le package protorpc.webapp.service_handlers comprend les fonctions suivantes :

service_mapping(services, registry_path=DEFAULT_REGISTRY_PATH)

Crée un mappage de services à utiliser avec webapp.

Crée la configuration et l'enregistrement de base par défaut pour les services RPC du protocole Google. Chaque service répertorié dans le mappage comporte une fabrique de gestionnaires de services standard créée pour lui.

La liste des mappages peut représenter un chemin explicite vers un mappage de services ou simplement les services. Dans ce dernier cas, les services sont mappés automatiquement à leur nom par défaut. Exemple :

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

En principe, les services sont mappés aux chemins d'URL par l'indication d'un tuple (chemin, service), où le chemin correspond au chemin d'accès au service, et le service, à la fabrique ou à la classe de services de création de nouvelles instances du service. Pour en savoir plus sur les fabriques de services, consultez la section remote.Service.new_factory.

Si aucun tuple n'est fourni, et que par conséquent aucun chemin n'est indiqué, un chemin par défaut est calculé à l'aide du nom de service complet utilisant un séparateur de chemin d'URL pour chacun de ses composants au lieu d'un ".".

Arguments

services: Tuple (chemin, service), où path correspond au chemin d'accès au service et service, à la fabrique ou à la classe de services pour la création de nouvelles instances du service. Pour en savoir plus sur les fabriques de services, consultez la section remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH: Chemin d'accès à fournir au service de registre. La valeur None permet de désactiver le service de registre.

Renvoie une liste de tuples définissant un mappage de gestionnaires de requêtes compatibles avec une application WebApp.

Génère une erreur ServiceConfigurationError lorsqu'il existe des chemins en double.

run_services(services, registry_path=DEFAULT_REGISTRY_PATH)

Gère la demande CGI à l'aide d'un mappage de service.

Arguments

services: Tuple (chemin, service), où path correspond au chemin d'accès au service et service, à la fabrique ou à la classe de services pour la création de nouvelles instances du service. Pour en savoir plus sur les fabriques de services, consultez la section remote.Service.new_factory.
registry_path=DEFAULT_REGISTRY_PATH: Chemin d'accès à fournir au service de registre. La valeur None permet de désactiver le service de registre.