com.google.gerrit.httpd.rpc

Class Handler<T>

java.lang.Object

com.google.gerrit.httpd.rpc.Handler<T>

Type Parameters:

T - type of result for AsyncCallback.onSuccess(Object) if the operation completed successfully.

All Implemented Interfaces:

java.util.concurrent.Callable<T>

Direct Known Subclasses:

ProjectAccessHandler

public abstract class Handler<T>
extends java.lang.Object
implements java.util.concurrent.Callable<T>

Base class for RPC service implementations.

Typically an RPC service implementation will extend this class and use Guice injection to manage its state. For example:

   class Foo extends Handler<Result> {
     interface Factory {
       Foo create(... args ...);
     }
     @Inject
     Foo(state, @Assisted args) { ... }
     Result get() throws Exception { ... }
   }
 

Constructor Summary

Constructors

Constructor and Description
Handler()

Method Summary

Modifier and Type	Method and Description
abstract T	call() Compute the operation result.
void	to(com.google.gwtjsonrpc.common.AsyncCallback<T> callback) Run the operation and pass the result to the callback.
static <T> Handler<T>	wrap(java.util.concurrent.Callable<T> r)

Methods inherited from class java.lang.Object

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

Constructor Detail

Handler

public Handler()

Method Detail

wrap

public static <T> Handler<T> wrap(java.util.concurrent.Callable<T> r)

to

public final void to(com.google.gwtjsonrpc.common.AsyncCallback<T> callback)

Run the operation and pass the result to the callback.

Parameters:

callback - callback to receive the result of call().

call

public abstract T call()
                throws java.lang.Exception

Compute the operation result.

Specified by:

call in interface java.util.concurrent.Callable<T>

Returns:

the result of the operation. Return VoidResult.INSTANCE if there is no meaningful return value for the operation.

Throws:

java.lang.Exception - the operation failed. The caller will log the exception and the stack trace, if it is worth logging on the server side.