io.nexusrpc.handler

Class ServiceHandler

java.lang.Object

io.nexusrpc.handler.ServiceHandler

All Implemented Interfaces:

Handler

public class ServiceHandler
extends java.lang.Object
implements Handler

Handler that delegates to service implementations.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServiceHandler.Builder Builder for operation start details.

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.
java.util.Map<java.lang.String,ServiceImplInstance>	getInstances() Instances, by service name.
java.util.List<OperationMiddleware>	getOperationMiddlewares()
Serializer	getSerializer() Serializer used for input/output.
static ServiceHandler.Builder	newBuilder() Create a builder for a service handler.
static ServiceHandler.Builder	newBuilder(ServiceHandler handler) Create a builder for service handler from an existing service handler.
OperationStartResult<HandlerResultContent>	startOperation(OperationContext context, OperationStartDetails details, HandlerInputContent input) Handle the start of an operation.

Methods inherited from class java.lang.Object

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

Method Detail

newBuilder

public static ServiceHandler.Builder newBuilder()

Create a builder for a service handler.

newBuilder

public static ServiceHandler.Builder newBuilder(ServiceHandler handler)

Create a builder for service handler from an existing service handler.

getInstances

public java.util.Map<java.lang.String,ServiceImplInstance> getInstances()

Instances, by service name.

getSerializer

public Serializer getSerializer()

Serializer used for input/output.

getOperationMiddlewares

public java.util.List<OperationMiddleware> getOperationMiddlewares()

startOperation

public OperationStartResult<HandlerResultContent> startOperation(OperationContext context,
                                                                 OperationStartDetails details,
                                                                 HandlerInputContent input)
                                                          throws OperationUnsuccessfulException

Description copied from interface: Handler

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.

Specified by:

startOperation in interface Handler

Throws:

OperationUnsuccessfulException

fetchOperationResult

public HandlerResultContent fetchOperationResult(OperationContext context,
                                                 OperationFetchResultDetails details)
                                          throws OperationStillRunningException,
                                                 OperationUnsuccessfulException

Description copied from interface: Handler

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.

Specified by:

fetchOperationResult in interface Handler

Throws:

OperationStillRunningException

OperationUnsuccessfulException

fetchOperationInfo

public OperationInfo fetchOperationInfo(OperationContext context,
                                        OperationFetchInfoDetails details)

Description copied from interface: Handler

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

Specified by:

fetchOperationInfo in interface Handler

cancelOperation

public void cancelOperation(OperationContext context,
                            OperationCancelDetails details)

Description copied from interface: Handler

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

Specified by:

cancelOperation in interface Handler