service
DEPRECATED: 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.
RpcChannel
Bases: object
Abstract 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)
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 |
|
CallMethod(method_descriptor, rpc_controller, request, response_class, done)
Calls 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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
219 220 221 222 223 224 225 226 227 228 |
|
RpcController
Bases: object
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).
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 |
|
ErrorText()
If Failed is true, returns a human-readable description of the error.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
152 153 154 |
|
Failed()
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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
142 143 144 145 146 147 148 149 150 |
|
IsCanceled()
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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
180 181 182 183 184 185 186 187 |
|
NotifyOnCancel(callback)
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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
189 190 191 192 193 194 195 196 197 198 199 200 |
|
Reset()
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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
134 135 136 137 138 139 140 |
|
SetFailed(reason)
Sets 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().
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
169 170 171 172 173 174 175 176 177 178 |
|
StartCancel()
Initiate 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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
156 157 158 159 160 161 162 163 164 165 |
|
RpcException
Bases: Exception
Exception raised on failed blocking RPC method call.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
46 47 48 |
|
Service
Bases: object
Abstract 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).
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 |
|
CallMethod(method_descriptor, rpc_controller, request, done)
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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
|
GetDescriptor()
Retrieves this service's descriptor.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
61 62 63 |
|
GetRequestClass(method_descriptor)
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)
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
95 96 97 98 99 100 101 102 103 104 105 106 107 108 |
|
GetResponseClass(method_descriptor)
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.
Source code in client/ayon_hiero/vendor/google/protobuf/service.py
110 111 112 113 114 115 116 117 |
|