org.apache.hadoop.hbase.ipc

Class ServerRpcController

java.lang.Object

org.apache.hadoop.hbase.ipc.ServerRpcController

All Implemented Interfaces:

RpcController

public class ServerRpcController
extends Object
implements RpcController

Used for server-side protobuf RPC service invocations. This handler allows invocation exceptions to easily be passed through to the RPC server from coprocessor Service implementations.

When implementing Service defined methods, coprocessor endpoints can use the following pattern to pass exceptions back to the RPC client: public void myMethod(RpcController controller, MyRequest request, RpcCallback done) { MyResponse response = null; try { // do processing response = MyResponse.getDefaultInstance(); // or use a new builder to populate the response } catch (IOException ioe) { // pass exception back up ResponseConverter.setControllerException(controller, ioe); } done.run(response); }

Constructor Summary

Constructors

Constructor and Description
ServerRpcController()

Method Summary

Methods

Modifier and Type	Method and Description
void	checkFailed() Throws an IOException back out if one is currently stored.
String	errorText()
boolean	failed()
boolean	failedOnException() Returns whether or not a server exception was generated in the prior RPC invocation.
IOException	getFailedOn() Returns any exception thrown during service method invocation, or null if no exception was thrown.
boolean	isCanceled()
void	notifyOnCancel(RpcCallback<Object> objectRpcCallback)
void	reset()
void	setFailed(String message)
void	setFailedOn(IOException ioe) Sets an exception to be communicated back to the Service client.
void	startCancel()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServerRpcController

public ServerRpcController()

Method Detail

reset

public void reset()

Specified by:

reset in interface RpcController

failed

public boolean failed()

Specified by:

failed in interface RpcController

errorText

public String errorText()

Specified by:

errorText in interface RpcController

startCancel

public void startCancel()

Specified by:

startCancel in interface RpcController

setFailed

public void setFailed(String message)

Specified by:

setFailed in interface RpcController

isCanceled

public boolean isCanceled()

Specified by:

isCanceled in interface RpcController

notifyOnCancel

public void notifyOnCancel(RpcCallback<Object> objectRpcCallback)

Specified by:

notifyOnCancel in interface RpcController

setFailedOn

public void setFailedOn(IOException ioe)

Sets an exception to be communicated back to the Service client.

Parameters:

ioe - the exception encountered during execution of the service method

getFailedOn

public IOException getFailedOn()

Returns any exception thrown during service method invocation, or null if no exception was thrown. This can be used by clients to receive exceptions generated by RPC calls, even when RpcCallbacks are used and no ServiceException is declared.

failedOnException

public boolean failedOnException()

Returns whether or not a server exception was generated in the prior RPC invocation.

checkFailed

public void checkFailed()
                 throws IOException

Throws an IOException back out if one is currently stored.

Throws:

IOException