A biblioteca de serviços remotos

Este módulo contém classes úteis para criar serviços remotos que estão em conformidade com um modelo de pedido e resposta padrão. Para estar em conformidade com este modelo, um serviço tem de ser semelhante à seguinte classe:

# Each service instance only handles a single request and is then discarded.
# Make these objects light weight.
class Service(object):

    # It must be possible to construct service objects without any parameters.
    # If your constructor needs extra information you should provide a
    # no-argument factory function to create service instances.
    def __init__(self):
        ...

    # Each remote method must use the 'remote' decorator, passing the request
    # and response message types.  The remote method itself must take a single
    # parameter which is an instance of RequestMessage and return an instance
    # of ResponseMessage.
    @method(RequestMessage, ResponseMessage)
    def remote_method(self, request):
        # Return an instance of ResponseMessage.

    # A service object may optionally implement a 'initialize_request_state'
    # method that takes as a parameter a single instance of a RequestState.  If
    # a service does not implement this method it will not receive the request
    # state.
    def initialize_request_state(self, state):
        ...

A classe Service é uma classe base conveniente que oferece a funcionalidade acima. Implementa todos os métodos obrigatórios e opcionais para um serviço. Também tem métodos convenientes para criar funções de fábrica que podem transmitir o estado global persistente a uma nova instância de serviço.

O decorador remoto é usado para declarar que métodos de uma classe se destinam a prestar serviços de RPCs. Embora este decorador não seja responsável pela entrega de sockets e vários protocolos RPC subjacentes. O decorator garante que está a usar o tipo de pedido correto, mas não verifica a inicialização.

Quando o decorador remoto é usado num método, o método wrapper tem uma propriedade "remote" associada. Esta propriedade contém os valores request_type e response_type esperados pela implementação do método.

Por si só, o decorator remoto não oferece suporte para subclasses de métodos remotos. Para estender um serviço, use os métodos de subclasse para redecorar. Por exemplo:

class MyService(Service):

    @method(DoSomethingRequest, DoSomethingResponse)
    def do_something(self, request):
        ... implement do-something ...

class MyBetterService(MyService):

    @method(DoSomethingRequest, DoSomethingResponse)
    def do_something(self, request):
        response = super(MyBetterService, self).do_something.remote.method(request)
        ... do something with response ...
        return response