net.openhft.chronicle.wire

Class GenerateMethodBridge

java.lang.Object

net.openhft.chronicle.wire.AbstractClassGenerator<net.openhft.chronicle.wire.GenerateMethodBridge.MethodBridgeMetaData>

net.openhft.chronicle.wire.GenerateMethodBridge

public class GenerateMethodBridge
extends AbstractClassGenerator<net.openhft.chronicle.wire.GenerateMethodBridge.MethodBridgeMetaData>

Dynamically creates a class that implements a destination interface and forwards method calls to a collection of handler objects. Each handler may only implement a subset of the interface methods. When a method on the generated bridge is invoked the call is dispatched to every handler that declares a matching method. This allows one interface to be implemented by a composition of several partial implementations, or for multiple listeners to react to the same call.

Nested Class Summary

Nested classes/interfaces inherited from class net.openhft.chronicle.wire.AbstractClassGenerator

AbstractClassGenerator.MetaData<M extends AbstractClassGenerator.MetaData<M>>

Field Summary

Fields inherited from class net.openhft.chronicle.wire.AbstractClassGenerator

CACHED_COMPILER, importSet, sourceCode

Constructor Summary

Constructors

Constructor and Description
GenerateMethodBridge() Constructs a new instance with a fresh MethodBridgeMetaData.

Method Summary

Modifier and Type	Method and Description
static Object	bridgeFor(Class<?> destType, List<Object> toInvoke, net.openhft.chronicle.bytes.UpdateInterceptor ui) Builds and instantiates a method bridge for the supplied interface.
protected void	generateConstructors(SourceCodeFormatter mainCode) Generates the bridge constructor which initialises all handler fields and optionally stores an UpdateInterceptor.
protected void	generateFields(SourceCodeFormatter mainCode) Emits field declarations for all handler objects defined in the metadata.
protected void	generateMethod(Method method, StringBuilder params, List<String> paramList, SourceCodeFormatter mainCode) This method is responsible for generating the code for a given method.

Methods inherited from class net.openhft.chronicle.wire.AbstractClassGenerator

acquireClass, className, extendsClass, fieldCase, generateEnd, generateGenericType, generateMainCode, generateMethod, maxCode, maxCode, metaData, methodsToOverride, nameForClass, withLineNumber

Methods inherited from class java.lang.Object

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

Constructor Detail

GenerateMethodBridge

public GenerateMethodBridge()

Constructs a new instance with a fresh MethodBridgeMetaData.

Method Detail

bridgeFor

public static Object bridgeFor(Class<?> destType,
                               List<Object> toInvoke,
                               net.openhft.chronicle.bytes.UpdateInterceptor ui)

Builds and instantiates a method bridge for the supplied interface.

Parameters:

destType - the primary interface the bridge will implement

toInvoke - handler instances to receive forwarded calls

ui - optional UpdateInterceptor applied to bridge invocations

Returns:

a new instance of the generated bridge class

generateFields

protected void generateFields(SourceCodeFormatter mainCode)

Emits field declarations for all handler objects defined in the metadata. Field names are derived via AbstractClassGenerator.fieldCase(Class) and made unique if necessary.

Overrides:

generateFields in class AbstractClassGenerator<net.openhft.chronicle.wire.GenerateMethodBridge.MethodBridgeMetaData>

Parameters:

mainCode - The code formatter where the generated code is appended.

generateConstructors

protected void generateConstructors(SourceCodeFormatter mainCode)

Generates the bridge constructor which initialises all handler fields and optionally stores an UpdateInterceptor.

Overrides:

generateConstructors in class AbstractClassGenerator<net.openhft.chronicle.wire.GenerateMethodBridge.MethodBridgeMetaData>

Parameters:

mainCode - The code formatter where the generated code is appended.

generateMethod

protected void generateMethod(Method method,
                              StringBuilder params,
                              List<String> paramList,
                              SourceCodeFormatter mainCode)

This method is responsible for generating the code for a given method. The method checks if the provided method exists in each of the handler classes from the metaData. If the method exists in a handler class, the corresponding code is generated and appended to the mainCode.

Specified by:

generateMethod in class AbstractClassGenerator<net.openhft.chronicle.wire.GenerateMethodBridge.MethodBridgeMetaData>

Parameters:

method - The method for which the code needs to be generated.

params - The parameters of the method, formatted as a StringBuilder.

paramList - The list of parameters of the method.

mainCode - The SourceCodeFormatter where the generated code will be appended.