net.openhft.chronicle.bytes

Class BytesMethodReaderBuilder

java.lang.Object

net.openhft.chronicle.bytes.BytesMethodReaderBuilder

All Implemented Interfaces:

MethodReaderBuilder

public class BytesMethodReaderBuilder
extends Object
implements MethodReaderBuilder

Builder for BytesMethodReader instances. It allows configuration of the lookup mechanism for method decoders (MethodEncoderLookup), the handler for unknown method calls (BytesParselet) and logging behaviour for unrecognised methods. Implements MethodReaderBuilder.

Constructor Summary

Constructors

Constructor and Description
BytesMethodReaderBuilder(BytesIn<?> in)

Method Summary

Modifier and Type	Method and Description
BytesMethodReader	build(Object... objects) Constructs and returns a new BytesMethodReader configured with the settings from this builder and the provided handler objects.
BytesParselet	defaultParselet() Returns the BytesParselet to use when a message ID is encountered for which no specific handler is registered.
BytesMethodReaderBuilder	defaultParselet(BytesParselet defaultParselet) Sets the default BytesParselet for this builder.
MethodReaderBuilder	exceptionHandlerOnUnknownMethod(net.openhft.chronicle.core.onoes.ExceptionHandler exceptionHandler) Sets the ExceptionHandler instance to use when an unknown method is encountered.
MethodReaderBuilder	metaDataHandler(Object... components) This builder does not support metadata handlers.
MethodEncoderLookup	methodEncoderLookup() Returns the currently configured MethodEncoderLookup strategy used to find decoders for method calls.
BytesMethodReaderBuilder	methodEncoderLookup(MethodEncoderLookup methodEncoderLookup) Sets the MethodEncoderLookup function for this builder.
MethodReaderBuilder	methodReaderInterceptorReturns(MethodReaderInterceptorReturns methodReaderInterceptorReturns) This builder does not support interceptors for method reader returns.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.bytes.MethodReaderBuilder

predicate, warnMissing

Constructor Detail

BytesMethodReaderBuilder

public BytesMethodReaderBuilder(BytesIn<?> in)

Parameters:

in - the BytesIn stream from which serialised method calls will be read. Must not be null.

Throws:

NullPointerException - if in is null

net.openhft.chronicle.core.io.ClosedIllegalStateException - if in has been released

net.openhft.chronicle.core.io.ThreadingIllegalStateException - if in is accessed by multiple threads unsafely

Method Detail

exceptionHandlerOnUnknownMethod

public MethodReaderBuilder exceptionHandlerOnUnknownMethod(net.openhft.chronicle.core.onoes.ExceptionHandler exceptionHandler)

Sets the ExceptionHandler instance to use when an unknown method is encountered. This instance controls how the builder handles unknown methods.

Specified by:

exceptionHandlerOnUnknownMethod in interface MethodReaderBuilder

Parameters:

exceptionHandler - the ExceptionHandler instance

Returns:

this builder for chained invocation

methodEncoderLookup

public MethodEncoderLookup methodEncoderLookup()

Returns the currently configured MethodEncoderLookup strategy used to find decoders for method calls.

methodEncoderLookup

public BytesMethodReaderBuilder methodEncoderLookup(MethodEncoderLookup methodEncoderLookup)

Sets the MethodEncoderLookup function for this builder.

Parameters:

methodEncoderLookup - the MethodEncoderLookup function

Returns:

this builder for chained invocation

defaultParselet

public BytesParselet defaultParselet()

Returns the BytesParselet to use when a message ID is encountered for which no specific handler is registered. If not explicitly set, it is initialised based on the exceptionHandlerOnUnknownMethod(ExceptionHandler) configuration.

defaultParselet

public BytesMethodReaderBuilder defaultParselet(BytesParselet defaultParselet)

Sets the default BytesParselet for this builder.

Parameters:

defaultParselet - the default BytesParselet

Returns:

this builder for chained invocation

methodReaderInterceptorReturns

public MethodReaderBuilder methodReaderInterceptorReturns(MethodReaderInterceptorReturns methodReaderInterceptorReturns)

This builder does not support interceptors for method reader returns.

Specified by:

methodReaderInterceptorReturns in interface MethodReaderBuilder

Parameters:

methodReaderInterceptorReturns - the interceptor instance

Returns:

the builder instance for method chaining

Throws:

UnsupportedOperationException - always

metaDataHandler

public MethodReaderBuilder metaDataHandler(Object... components)

This builder does not support metadata handlers.

Specified by:

metaDataHandler in interface MethodReaderBuilder

Parameters:

components - the metadata handlers

Returns:

the builder instance for method chaining

Throws:

UnsupportedOperationException - always

build

public BytesMethodReader build(Object... objects)

Constructs and returns a new BytesMethodReader configured with the settings from this builder and the provided handler objects.

Specified by:

build in interface MethodReaderBuilder

Parameters:

objects - the target objects whose methods will be invoked

Returns:

a new configured BytesMethodReader