com.google.protobuf.RpcController Interface Reference

Public Member Functions
String	errorText ()
String	errorText ()
boolean	failed ()
boolean	failed ()
boolean	isCanceled ()
boolean	isCanceled ()
void	notifyOnCancel (RpcCallback< Object > callback)
void	notifyOnCancel (RpcCallback< Object > callback)
void	reset ()
void	reset ()
void	setFailed (String reason)
void	setFailed (String reason)
void	startCancel ()
void	startCancel ()

Detailed Description

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.

Starting with version 2.3.0, RPC implementations should not try to build on this, 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.

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

Author

kento.nosp@m.n@go.nosp@m.ogle..nosp@m.com Kenton Varda

Definition at line 49 of file bloaty/third_party/protobuf/java/core/src/main/java/com/google/protobuf/RpcController.java.

Member Function Documentation

errorText() [1/2]

String com.google.protobuf.RpcController.errorText

(

)

If

failed() 

is

true 

, returns a human-readable description of the error.

errorText() [2/2]

String com.google.protobuf.RpcController.errorText

(

)

If

failed() 

is

true 

, returns a human-readable description of the error.

failed() [1/2]

boolean com.google.protobuf.RpcController.failed

(

)

After a call has finished, returns true if the call failed. The possible reasons for failure depend on the RPC implementation.

failed() 

most only be called on the client side, and must not be called before a call has finished.

failed() [2/2]

boolean com.google.protobuf.RpcController.failed

(

)

After a call has finished, returns true if the call failed. The possible reasons for failure depend on the RPC implementation.

failed() 

most only be called on the client side, and must not be called before a call has finished.

isCanceled() [1/2]

boolean com.google.protobuf.RpcController.isCanceled

(

)

If

true 

, indicates that the client canceled the RPC, so the server may as well give up on replying to it. This method must be called on the server side only. The server should still call the final "done" callback.

isCanceled() [2/2]

boolean com.google.protobuf.RpcController.isCanceled

(

)

If

true 

, indicates that the client canceled the RPC, so the server may as well give up on replying to it. This method must be called on the server side only. The server should still call the final "done" callback.

notifyOnCancel() [1/2]

void com.google.protobuf.RpcController.notifyOnCancel

(

RpcCallback< Object >

callback

)

Asks that the given callback be called when the RPC is canceled. The parameter passed to the callback will always be

null 

. 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. It must be called on the server side only.

notifyOnCancel() [2/2]

void com.google.protobuf.RpcController.notifyOnCancel

(

RpcCallback< Object >

callback

)

Asks that the given callback be called when the RPC is canceled. The parameter passed to the callback will always be

null 

. 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. It must be called on the server side only.

reset() [1/2]

void com.google.protobuf.RpcController.reset

(

)

Resets the RpcController to its initial state so that it may be reused in a new call. This can be called from the client side only. It must not be called while an RPC is in progress.

reset() [2/2]

void com.google.protobuf.RpcController.reset

(

)

Resets the RpcController to its initial state so that it may be reused in a new call. This can be called from the client side only. It must not be called while an RPC is in progress.

setFailed() [1/2]

void com.google.protobuf.RpcController.setFailed

(

String

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

.

setFailed() [2/2]

void com.google.protobuf.RpcController.setFailed

(

String

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

.

startCancel() [1/2]

void com.google.protobuf.RpcController.startCancel

(

)

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.

startCancel() [2/2]

void com.google.protobuf.RpcController.startCancel

(

)

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.

---

The documentation for this interface was generated from the following file:

• bloaty/third_party/protobuf/java/core/src/main/java/com/google/protobuf/RpcController.java