U
|
£ý°dÀ- ã @ sL d Z dZG dd deZG dd deZG dd deZG dd d eZd
|
S ) a* Contains metaclasses used to create protocol service and service stub
|
classes from ServiceDescriptor objects at runtime.
|
|
The GeneratedServiceType and GeneratedServiceStubType metaclasses are used to
|
inject all useful functionality into the classes output by the protocol
|
compiler at compile-time.
|
z petar@google.com (Petar Petrov)c @ s e Zd ZdZdZdd ZdS )ÚGeneratedServiceTypea Metaclass for service classes created at runtime from ServiceDescriptors.
|
|
Implementations for all methods described in the Service class are added here
|
by this class. We also create properties to allow getting/setting all fields
|
in the protocol message.
|
|
The protocol compiler currently uses this metaclass to create protocol service
|
classes at runtime. Clients can also manually create their own classes at
|
runtime, as in this example::
|
|
mydescriptor = ServiceDescriptor(.....)
|
class MyProtoService(service.Service):
|
__metaclass__ = GeneratedServiceType
|
DESCRIPTOR = mydescriptor
|
myservice_instance = MyProtoService()
|
# ...
|
Ú
|
DESCRIPTORc C s4 t j|krdS |t j }t|}| | ¡ || _dS )a
Creates a message service class.
|
|
Args:
|
name: Name of the class (ignored, but required by the metaclass
|
protocol).
|
bases: Base classes of the class being constructed.
|
dictionary: The class dictionary of the class being constructed.
|
dictionary[_DESCRIPTOR_KEY] must contain a ServiceDescriptor object
|
describing this protocol service type.
|
N)r Ú_DESCRIPTOR_KEYÚ_ServiceBuilderÚ BuildServicer )ÚclsÚnameÚbasesÚ
|
dictionaryÚ
|
descriptorZservice_builder© r úYd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\google/protobuf/service_reflection.pyÚ__init__@ s
|
|
|
z GeneratedServiceType.__init__N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r r r r r r r * s r c s$ e Zd ZdZdZ fddZ ZS )ÚGeneratedServiceStubTypezÁMetaclass for service stubs created at runtime from ServiceDescriptors.
|
|
This class has similar responsibilities as GeneratedServiceType, except that
|
it creates the service stub classes.
|
r c sB t t| |||¡ tj|kr"dS |tj }t|}| | ¡ dS )a` Creates a message service stub class.
|
|
Args:
|
name: Name of the class (ignored, here).
|
bases: Base classes of the class being constructed.
|
dictionary: The class dictionary of the class being constructed.
|
dictionary[_DESCRIPTOR_KEY] must contain a ServiceDescriptor object
|
describing this protocol service type.
|
N)Úsuperr r r Ú_ServiceStubBuilderÚBuildServiceStub)r r r r r
|
Zservice_stub_builder©Ú __class__r r r ` s
|
|
|
z!GeneratedServiceStubType.__init__)r r r r r r Ú __classcell__r r r r r V s r c @ sH e Zd ZdZdd Zdd Zdd Zdd Zd
|
d Zd d Z dd Z
|
dS )r aD This class constructs a protocol service class using a service descriptor.
|
|
Given a service descriptor, this class constructs a class that represents
|
the specified service descriptor. One service builder instance constructs
|
exactly one service class. That means all instances of that class share the
|
same builder.
|
c C s
|
|| _ dS )z¥Initializes an instance of the service class builder.
|
|
Args:
|
service_descriptor: ServiceDescriptor to use when constructing the
|
service class.
|
N©r
|
©ÚselfZservice_descriptorr r r r s z_ServiceBuilder.__init__c s| fdd} fdd} fdd}| _ ||_t fdd|_d |j_||_||_ jjD ]}t ||j
|
|¡ q^d
|
S ) z\Constructs the service class.
|
|
Args:
|
cls: The class that will be constructed.
|
c s | ||||¡S ©N)Ú _CallMethod)r Úmethod_descriptorÚrpc_controllerÚrequestÚdone©Úbuilderr r Ú_WrapCallMethod s
|
ÿz5_ServiceBuilder.BuildService.<locals>._WrapCallMethodc s
|
|¡S r )Ú_GetRequestClass©r r r" r r Ú_WrapGetRequestClass s z:_ServiceBuilder.BuildService.<locals>._WrapGetRequestClassc s
|
|¡S r )Ú_GetResponseClassr& r" r r Ú_WrapGetResponseClass s z;_ServiceBuilder.BuildService.<locals>._WrapGetResponseClassc s j S r r r r" r r Ú<lambda> ó z._ServiceBuilder.BuildService.<locals>.<lambda>z Returns the service descriptor.N) r Ú
|
CallMethodÚ staticmethodZ GetDescriptorr ZGetRequestClassZGetResponseClassr
|
ÚmethodsÚsetattrr Ú _GenerateNonImplementedMethod)r# r r$ r' r) Úmethodr r" r r s z _ServiceBuilder.BuildServicec C s, |j | jkrtdt||j}||||S )a Calls the method described by a given method descriptor.
|
|
Args:
|
srvc: Instance of the service for which this method is called.
|
method_descriptor: Descriptor that represent the method to call.
|
rpc_controller: RPC controller to use for this method's execution.
|
request: Request protocol message.
|
callback: A callback to invoke after the method has completed.
|
z<CallMethod() given method descriptor for wrong service type.)Úcontaining_servicer
|
Ú RuntimeErrorÚgetattrr )r Zsrvcr r r Úcallbackr1 r r r r § s ÿ z_ServiceBuilder._CallMethodc C s |j | jkrtd|jjS )a Returns the class of the request protocol message.
|
|
Args:
|
method_descriptor: Descriptor of the method for which to return the
|
request protocol message class.
|
|
Returns:
|
A class that represents the input protocol message of the specified
|
method.
|
zAGetRequestClass() given method descriptor for wrong service type.)r2 r
|
r3 Z
|
input_typeÚ_concrete_classr& r r r r% ¸ s
|
ÿz _ServiceBuilder._GetRequestClassc C s |j | jkrtd|jjS )a Returns the class of the response protocol message.
|
|
Args:
|
method_descriptor: Descriptor of the method for which to return the
|
response protocol message class.
|
|
Returns:
|
A class that represents the output protocol message of the specified
|
method.
|
zBGetResponseClass() given method descriptor for wrong service type.)r2 r
|
r3 Ú output_typer6 r& r r r r( È s
|
ÿz!_ServiceBuilder._GetResponseClassc s fddS )zøGenerates and returns a method that can be set for a service methods.
|
|
Args:
|
method: Descriptor of the service method for which a method is to be
|
generated.
|
|
Returns:
|
A method that can be added to the service class.
|
c s j||¡S r )Ú_NonImplementedMethodr ©Úinstr r r5 ©r1 r r r r* â s z?_ServiceBuilder._GenerateNonImplementedMethod.<locals>.<lambda>r ©r r1 r r; r r0 Ø s
|
z-_ServiceBuilder._GenerateNonImplementedMethodc C s | d| ¡ |d dS )a
|
The body of all methods in the generated service class.
|
|
Args:
|
method_name: Name of the method being executed.
|
rpc_controller: RPC controller used to execute this method.
|
callback: A callback which will be invoked when the method finishes.
|
zMethod %s not implemented.N)Z SetFailed)r Ú method_namer r5 r r r r8 å s z%_ServiceBuilder._NonImplementedMethodN) r r r r r r r r% r( r0 r8 r r r r r u s r c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
|
S ) r a Constructs a protocol service stub class using a service descriptor.
|
|
Given a service descriptor, this class constructs a suitable stub class.
|
A stub is just a type-safe wrapper around an RpcChannel which emulates a
|
local implementation of the service.
|
|
One service stub builder instance constructs exactly one class. It means all
|
instances of that class share the same service stub builder.
|
c C s
|
|| _ dS )z§Initializes an instance of the service stub class builder.
|
|
Args:
|
service_descriptor: ServiceDescriptor to use when constructing the
|
stub class.
|
Nr r r r r r ý s z _ServiceStubBuilder.__init__c C s: dd }|| _ ||_| jjD ]}t||j| |¡ q dS )zYConstructs the stub class.
|
|
Args:
|
cls: The class that will be constructed.
|
c S s
|
|| _ d S r )Ú rpc_channel)Ústubr> r r r Ú_ServiceStubInit s z>_ServiceStubBuilder.BuildServiceStub.<locals>._ServiceStubInitN)r r r
|
r. r/ r Ú_GenerateStubMethod)r r r@ r1 r r r r s
|
z$_ServiceStubBuilder.BuildServiceStubc s d fdd S )Nc s | |||¡S r )Ú _StubMethodr9 r; r r r* s z9_ServiceStubBuilder._GenerateStubMethod.<locals>.<lambda>)Nr r< r r; r rA s z'_ServiceStubBuilder._GenerateStubMethodc C s |j ||||jj|¡S )a The body of all service methods in the generated stub class.
|
|
Args:
|
stub: Stub instance.
|
method_descriptor: Descriptor of the invoked method.
|
rpc_controller: Rpc controller to execute the method.
|
request: Request protocol message.
|
callback: A callback to execute when the method finishes.
|
Returns:
|
Response message (in case of blocking call).
|
)r> r, r7 r6 )r r? r r r r5 r r r rB s þz _ServiceStubBuilder._StubMethodN)r r r r r r rA rB r r r r r ñ s
|
|
r N)r Ú
|
__author__Útyper r Úobjectr r r r r r Ú<module> s
|
, |
|
