ru.vyarus.guice.ext.core.generator

Class DynamicClassGenerator

java.lang.Object

ru.vyarus.guice.ext.core.generator.DynamicClassGenerator

public final class DynamicClassGenerator
extends java.lang.Object

Dynamically generates new class from abstract class or interface. Resulted class may be used as implementation in guice. Generated class will be tied to class loader of original type. It is safe to to use with dynamic class loaders (like play dev mode).

Guice will be able to apply aop to generated class methods. Annotations are copied from original class, to let aop mechanisms work even for interfaces. As a result you may forget about class generation and think of abstract class or interface as usual guice bean.

Abstract methods will not be implemented: abstract method call error will be thrown if you try to call it. All abstract methods must be covered by guice aop.

It may be used directly in guice module to register interface or abstract class: bind(MyType.class).to(DynamicClassGenerator.generate(MyType.class)). Another option is to use DynamicClassProvider: annotate type with @ProvidedBy(DynamicClassProvider.class) and either rely on JIT (don't register type at all) or simply register type: @{code bind(MyType.class)}. If used with injectors hierarchy or within private modules, use "anchor" dependency to prevent bubbling up for resulted binding (see for example anchor implementation for use with @ProvidedBy annotation GeneratorAnchorModule).

Don't use scope annotations directly - instead wrap them into ScopeAnnotation, because guice doesn't allow scope definition on abstract types.

Since:

10.12.2014

See Also:

DynamicClassProvider

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DYNAMIC_CLASS_POSTFIX Postfix applied to interface or abstract class name to get generated class name.

Method Summary

Modifier and Type	Method and Description
static <T> java.lang.Class<T>	generate(java.lang.Class<T> type) Shortcut for generate(Class, Class, Class) method to create default scoped classes.
static <T> java.lang.Class<T>	generate(java.lang.Class<T> type, java.lang.Class<? extends java.lang.annotation.Annotation> scope) Shortcut for generate(Class, Class, Class) method to create classes with provided scope (and without extra anchor).
static <T> java.lang.Class<T>	generate(java.lang.Class<T> type, java.lang.Class<? extends java.lang.annotation.Annotation> scope, java.lang.Class<?> anchor) Generates dynamic class, which guice may use as implementation and generate proxy above it, correctly applying aop features.

Methods inherited from class java.lang.Object

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

Field Detail

DYNAMIC_CLASS_POSTFIX

public static final java.lang.String DYNAMIC_CLASS_POSTFIX

Postfix applied to interface or abstract class name to get generated class name.

See Also:

Constant Field Values

Method Detail

generate

public static <T> java.lang.Class<T> generate(java.lang.Class<T> type)

Shortcut for generate(Class, Class, Class) method to create default scoped classes.

Method is thread safe.

Type Parameters:

T - type

Parameters:

type - interface or abstract class

Returns:

implementation class for provided type (will not generate if class already exist)

generate

public static <T> java.lang.Class<T> generate(java.lang.Class<T> type,
                                              java.lang.Class<? extends java.lang.annotation.Annotation> scope)

Shortcut for generate(Class, Class, Class) method to create classes with provided scope (and without extra anchor).

Method is thread safe.

Type Parameters:

T - type

Parameters:

type - interface or abstract class

scope - scope annotation to apply on generated class (may be null for default prototype scope)

Returns:

implementation class for provided type (will not generate if class already exist)

generate

public static <T> java.lang.Class<T> generate(java.lang.Class<T> type,
                                              java.lang.Class<? extends java.lang.annotation.Annotation> scope,
                                              java.lang.Class<?> anchor)

Generates dynamic class, which guice may use as implementation and generate proxy above it, correctly applying aop features.

New class will inherit type annotations and constructor with annotations (if base class use constructor injection). Also constructor inherits all annotations, including parameters annotations. If anchor is provided then it will be added as last constructor parameter or (when abstract type has no constructor) new constructor added with one parameter (anchor).

Method is thread safe.

Type Parameters:

T - type

Parameters:

type - interface or abstract class

scope - scope annotation to apply on generated class (may be null for default prototype scope)

anchor - existing binding to depend generated class on (to prevent binding bubbling up to root injector)

Returns:

implementation class for provided type (will not generate if class already exist)

See Also:

for more details about anchor usage