io.nexusrpc.handler

Interface Handler

All Known Implementing Classes:

ServiceHandler

public interface Handler

Top-level handler for service calls.

Method Summary

Modifier and Type	Method and Description
void	cancelOperation(OperationContext context, OperationCancelDetails details) Cancel the asynchronously started operation.
OperationInfo	fetchOperationInfo(OperationContext context, OperationFetchInfoDetails details) Fetch information about the asynchronously started operation.
HandlerResultContent	fetchOperationResult(OperationContext context, OperationFetchResultDetails details) Fetch the result for an asynchronously started operation.
OperationStartResult<HandlerResultContent>	startOperation(OperationContext context, OperationStartDetails details, HandlerInputContent input) Handle the start of an operation.

Method Detail

startOperation

OperationStartResult<HandlerResultContent> startOperation(OperationContext context,
                                                          OperationStartDetails details,
                                                          HandlerInputContent input)
                                                   throws OperationException,
                                                          HandlerException

Handle the start of an operation. See OperationHandler.start(io.nexusrpc.handler.OperationContext, io.nexusrpc.handler.OperationStartDetails, T) for operation details.

The implementation here should not close the input stream, that will be done by the caller.

If the result is an output stream, it will be closed later by the caller.

Throws:

OperationException

HandlerException

fetchOperationResult

HandlerResultContent fetchOperationResult(OperationContext context,
                                          OperationFetchResultDetails details)
                                   throws OperationStillRunningException,
                                          OperationException,
                                          HandlerException

Fetch the result for an asynchronously started operation. See OperationHandler.fetchResult(io.nexusrpc.handler.OperationContext, io.nexusrpc.handler.OperationFetchResultDetails) for operation details.

If the result is an output stream, it will be closed later by the caller.

Throws:

OperationStillRunningException

OperationException

HandlerException

fetchOperationInfo

OperationInfo fetchOperationInfo(OperationContext context,
                                 OperationFetchInfoDetails details)
                          throws HandlerException

Fetch information about the asynchronously started operation. See OperationHandler.fetchInfo(io.nexusrpc.handler.OperationContext, io.nexusrpc.handler.OperationFetchInfoDetails) for details.

Throws:

HandlerException

cancelOperation

void cancelOperation(OperationContext context,
                     OperationCancelDetails details)
              throws HandlerException

Cancel the asynchronously started operation. See OperationHandler.cancel(io.nexusrpc.handler.OperationContext, io.nexusrpc.handler.OperationCancelDetails) for details.

Throws:

HandlerException