Spade
Mini Shell
| Directory:~$ /proc/self/root/usr/lib/python2.7/site-packages/google/protobuf/ |
| [Home] [System Details] [Kill Me] |
�
Q�,Qc@shdZdZdefd��YZdefd��YZdefd��YZdefd ��YZd
S( seDEPRECATED: Declares the RPC service interfaces.
This module declares the abstract interfaces underlying proto2 RPC
services. These are intended to be independent of any particular RPC
implementation, so that proto2 services can be used on top of a variety
of implementations. Starting with version 2.3.0, RPC implementations
should
not try to build on these, but should instead provide code generator
plugins
which generate code specific to the particular RPC implementation. This
way
the generated code can be more appropriate for the implementation in use
and can avoid unnecessary layers of indirection.
s petar@google.com (Petar Petrov)t RpcExceptioncBseZdZRS(s4Exception
raised on failed blocking RPC method call.(t__name__t
__module__t__doc__(((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyR.stServicecBs2eZdZd�Zd�Zd�Zd�ZRS(sjAbstract
base interface for protocol-buffer-based RPC services.
Services themselves are abstract classes (implemented either by servers
or as
stubs), but they subclass this base interface. The methods of this
interface can be used to call the methods of the service without knowing
its exact type at compile time (analogous to the Message interface).
cCs
t�dS(s$Retrieves this service's
descriptor.N(tNotImplementedError(((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyt
GetDescriptor=scCs
t�dS(s>Calls a method of the service specified by
method_descriptor.
If "done" is None then the call is blocking and the response
message will be returned directly. Otherwise the call is asynchronous
and "done" will later be called with the response value.
In the blocking case, RpcException will be raised on error.
Preconditions:
* method_descriptor.service == GetDescriptor
* request is of the exact same classes as returned by
GetRequestClass(method).
* After the call has started, the request must not be modified.
* "rpc_controller" is of the correct type for the RPC
implementation being
used by this Service. For stubs, the "correct type"
depends on the
RpcChannel which the stub is using.
Postconditions:
* "done" will be called when the method is complete. This
may be
before CallMethod() returns or it may be at some point in the future.
* If the RPC failed, the response value passed to "done" will
be None.
Further details about the failure can be found by querying the
RpcController.
N(R(tselftmethod_descriptortrpc_controllertrequesttdone((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyt
CallMethodAscCs
t�dS(s�Returns the class of the request message for the specified
method.
CallMethod() requires that the request is of a particular subclass of
Message. GetRequestClass() gets the default instance of this required
type.
Example:
method = service.GetDescriptor().FindMethodByName("Foo")
request = stub.GetRequestClass(method)()
request.ParseFromString(input)
service.CallMethod(method, request, callback)
N(R(RR((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pytGetRequestClass]s
cCs
t�dS(s Returns the class of the response message for the specified
method.
This method isn't really needed, as the RpcChannel's
CallMethod constructs
the response protocol message. It's provided anyway in case it is
useful
for the caller to know the response type in advance.
N(R(RR((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pytGetResponseClassls(RRRRR R
R(((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyR3s
t
RpcControllercBsMeZdZd�Zd�Zd�Zd�Zd�Zd�Zd�Z RS(s�An
RpcController mediates a single method call.
The primary purpose of the controller is to provide a way to manipulate
settings specific to the RPC implementation and to find out about
RPC-level
errors. The methods provided by the RpcController interface are intended
to be a "least common denominator" set of features which we
expect all
implementations to support. Specific implementations may provide more
advanced features (e.g. deadline propagation).
cCs
t�dS(s�Resets the RpcController to its initial state.
After the RpcController has been reset, it may be reused in
a new call. Must not be called while an RPC is in progress.
N(R(R((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pytReset�scCs
t�dS(s>Returns true if the call failed.
After a call has finished, returns true if the call failed. The
possible
reasons for failure depend on the RPC implementation. Failed() must
not
be called before a call has finished. If Failed() returns true, the
contents of the response message are undefined.
N(R(R((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pytFailed�scCs
t�dS(sEIf Failed is true, returns a human-readable description of the
error.N(R(R((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyt ErrorText�scCs
t�dS(sInitiate cancellation.
Advises the RPC system that the caller desires that the RPC call be
canceled. The RPC system may cancel it immediately, may wait awhile
and
then cancel it, or may not even cancel the call at all. If the call is
canceled, the "done" callback will still be called and the
RpcController
will indicate that the call failed at that time.
N(R(R((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyt StartCancel�s cCs
t�dS(sWSets a failure reason.
Causes Failed() to return true on the client side. "reason"
will be
incorporated into the message returned by ErrorText(). If you find
you need to return machine-readable information about failures, you
should incorporate it into your response protocol buffer and should
NOT call SetFailed().
N(R(Rtreason((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyt SetFailed�s cCs
t�dS(s�Checks if the client cancelled the RPC.
If true, indicates that the client canceled the RPC, so the server may
as well give up on replying to it. The server should still call the
final "done" callback.
N(R(R((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyt
IsCanceled�scCs
t�dS(s�Sets a callback to invoke on cancel.
Asks that the given callback be called when the RPC is canceled. The
callback will always be called exactly once. If the RPC completes
without
being canceled, the callback will be called after completion. If the
RPC
has already been canceled when NotifyOnCancel() is called, the callback
will be called immediately.
NotifyOnCancel() must be called no more than once per request.
N(R(Rtcallback((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pytNotifyOnCancel�s (
RRRRRRRRRR(((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyRvs
t
RpcChannelcBseZdZd�ZRS(s4Abstract interface for an RPC channel.
An RpcChannel represents a communication line to a service which can be
used
to call that service's methods. The service may be running on
another
machine. Normally, you should not use an RpcChannel directly, but instead
construct a stub {@link Service} wrapping it. Example:
Example:
RpcChannel channel =
rpcImpl.Channel("remotehost.example.com:1234")
RpcController controller = rpcImpl.Controller()
MyService service = MyService_Stub(channel)
service.MyMethod(controller, request, callback)
cCs
t�dS(sbCalls the method identified by the descriptor.
Call the given method of the remote service. The signature of this
procedure looks the same as Service.CallMethod(), but the requirements
are less strict in one important way: the request object doesn't
have to
be of any specific class as long as its descriptor is
method.input_type.
N(R(RRR R
tresponse_classR ((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyR �s (RRRR (((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyR�sN(Rt
__author__t ExceptionRtobjectRRR(((s;/usr/lib/python2.7/site-packages/google/protobuf/service.pyt<module>)s
CS