net.openhft.chronicle.wire

Class GenerateMethodDelegate

java.lang.Object

net.openhft.chronicle.wire.AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

net.openhft.chronicle.wire.GenerateMethodDelegate

public class GenerateMethodDelegate
extends AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

Dynamically generates a class that implements MethodDelegate and the additional interfaces supplied in AbstractClassGenerator.MetaData.interfaces(). Calls to those interfaces are forwarded to a delegate instance set via MethodDelegate.delegate(Object).

The generated class allows the delegate to be swapped or wrapped at run time, providing a lightweight means of adapting behaviour. This generator extends AbstractClassGenerator and produces a typed wrapper that forwards every method invocation to the current delegate.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GenerateMethodDelegate.GMDMetaData Metadata for GenerateMethodDelegate.

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
GenerateMethodDelegate() Creates a generator with the default metadata.

Method Summary

Modifier and Type	Method and Description
<T> Class<T>	acquireClass(ClassLoader classLoader) Ensures MethodDelegate is always included before delegating to the superclass to create or load the proxy class.
protected void	generateConstructors(SourceCodeFormatter mainCode) Uses the implicit no-arg constructor; no constructors are generated.
protected void	generateFields(SourceCodeFormatter mainCode) Emits the field that stores the current delegate instance.
protected String	generateGenericType() Creates the generic type signature in the form <OUT extends Object & Interface1 & Interface2 & MethodDelegate<OUT>>.
protected void	generateMethod(Method method, SourceCodeFormatter mainCode) Generates a concrete implementation of each method.
protected void	generateMethod(Method method, StringBuilder params, List<String> paramList, SourceCodeFormatter mainCode) Writes the body of a delegated method.
protected SourceCodeFormatter	getDelegate(SourceCodeFormatter mainCode, Method method) Appends the delegate to the main code.
protected String	getDelegateType() Returns the name used for the delegate type in generated code.

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

className, extendsClass, fieldCase, generateEnd, generateMainCode, 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

GenerateMethodDelegate

public GenerateMethodDelegate()

Creates a generator with the default metadata.

Method Detail

acquireClass

public <T> Class<T> acquireClass(ClassLoader classLoader)

Ensures MethodDelegate is always included before delegating to the superclass to create or load the proxy class.

Overrides:

acquireClass in class AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

Type Parameters:

T - The type of the generated class.

Parameters:

classLoader - The class loader to be used for loading the generated class.

Returns:

The generated and loaded class.

generateGenericType

protected String generateGenericType()

Creates the generic type signature in the form <OUT extends Object & Interface1 & Interface2 & MethodDelegate<OUT>>.

Overrides:

generateGenericType in class AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

Returns:

The generic type as a String, or null if there's none.

generateFields

protected void generateFields(SourceCodeFormatter mainCode)

Emits the field that stores the current delegate instance.

Overrides:

generateFields in class AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

Parameters:

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

getDelegateType

protected String getDelegateType()

Returns the name used for the delegate type in generated code.

generateConstructors

protected void generateConstructors(SourceCodeFormatter mainCode)

Uses the implicit no-arg constructor; no constructors are generated.

Overrides:

generateConstructors in class AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

Parameters:

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

generateMethod

protected void generateMethod(Method method,
                              SourceCodeFormatter mainCode)

Generates a concrete implementation of each method. The delegate(Object) method stores the delegate, while all other methods are handled by the superclass.

Overrides:

generateMethod in class AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

Parameters:

method - The method whose code is being generated.

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

generateMethod

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

Writes the body of a delegated method. The parameters and their list are passed in so the invocation can be constructed correctly.

Specified by:

generateMethod in class AbstractClassGenerator<GenerateMethodDelegate.GMDMetaData>

Parameters:

method - The method whose body is being generated.

params - The parameters of the method in a StringBuilder.

paramList - The list of parameter names.

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

getDelegate

protected SourceCodeFormatter getDelegate(SourceCodeFormatter mainCode,
                                          Method method)

Appends the delegate to the main code.

Parameters:

mainCode - The SourceCodeFormatter to append the delegate.

method - The associated method.

Returns:

Updated SourceCodeFormatter with delegate appended.