Package net.officefloor.compile.classes

Class OfficeFloorJavaCompiler

java.lang.Object

net.officefloor.compile.classes.OfficeFloorJavaCompiler

Direct Known Subclasses:

OfficeFloorJavaCompilerImpl

public abstract class OfficeFloorJavaCompiler
extends java.lang.Object

Java compiler to avoid Proxy implementations.

Author:

Daniel Sagenschneider

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	OfficeFloorJavaCompiler.ClassField	Class Field.
static interface	OfficeFloorJavaCompiler.ClassName	Class name.
static interface	OfficeFloorJavaCompiler.ConstructorWriter	Writes the Constructor for the wrapping implementation.
static interface	OfficeFloorJavaCompiler.ConstructorWriterContext	Context for the OfficeFloorJavaCompiler.ConstructorWriter.
static interface	OfficeFloorJavaCompiler.ImplementationRunnable<T extends java.lang.Throwable>	Runnable to use with the specified OfficeFloorJavaCompiler implementation.
static interface	OfficeFloorJavaCompiler.JavaSource	Java source.
static interface	OfficeFloorJavaCompiler.JavaSourceContext	Context for the OfficeFloorJavaCompiler.JavaSourceWriter.
static interface	OfficeFloorJavaCompiler.JavaSourceWriter	Provides means to including source.
static interface	OfficeFloorJavaCompiler.MethodWriter	Writes each Method required by implementing interfaces.
static interface	OfficeFloorJavaCompiler.MethodWriterContext	Context for the OfficeFloorJavaCompiler.MethodWriterContext.
static interface	OfficeFloorJavaCompiler.NonCompilerOperation<T extends java.lang.Throwable>	Operation undertaken without the Java compiler being available.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	DEFAULT_OFFICE_FLOOR_JAVA_COMPILER_IMPLEMENTATION	Default OfficeFloorJavaCompiler implementation Class name.
static java.lang.String	SYSTEM_PROPERTY_JAVA_COMPILING	System property to indicate if Java compiling active for OfficeFloor.

Constructor Summary

Constructors

Constructor	Description
OfficeFloorJavaCompiler()

Method Summary

Modifier and Type	Method	Description
abstract OfficeFloorJavaCompiler.JavaSource	addSource(java.lang.String className, java.lang.String source)	Adds a OfficeFloorJavaCompiler.JavaSource.
OfficeFloorJavaCompiler.JavaSource	addSource(OfficeFloorJavaCompiler.ClassName className, java.lang.String source)	Adds a OfficeFloorJavaCompiler.JavaSource.
abstract OfficeFloorJavaCompiler.JavaSource	addWrapper(java.lang.Class<?>[] wrappingTypes, java.lang.Class<?> delegateType, java.lang.String delegateExtraction, OfficeFloorJavaCompiler.ConstructorWriter constructorWriter, OfficeFloorJavaCompiler.MethodWriter methodWriter, OfficeFloorJavaCompiler.JavaSourceWriter... additionalSourceWriter)	Adds a wrapper OfficeFloorJavaCompiler.JavaSource.
OfficeFloorJavaCompiler.JavaSource	addWrapper(java.lang.Class<?> type, OfficeFloorJavaCompiler.MethodWriter methodWriter, OfficeFloorJavaCompiler.JavaSourceWriter... additionalSourceWriter)	Adds a wrapper OfficeFloorJavaCompiler.JavaSource.
abstract java.util.Map<OfficeFloorJavaCompiler.JavaSource,java.lang.Class<?>>	compile()	Compiles all the added OfficeFloorJavaCompiler.JavaSource instances.
abstract OfficeFloorJavaCompiler.ClassName	createClassName(java.lang.String name)	Generates a unique OfficeFloorJavaCompiler.ClassName.
abstract OfficeFloorJavaCompiler.ClassField	createField(java.lang.Class<?> fieldType, java.lang.String fieldName)	Creates the OfficeFloorJavaCompiler.ClassField.
abstract java.lang.String	getSourceName(java.lang.Class<?> type)	Obtains the source name for the Class.
static OfficeFloorJavaCompiler	newInstance(SourceContext sourceContext)	Creates a new instance of the OfficeFloorJavaCompiler.
static <T extends java.lang.Throwable> void	runWithImplementation(java.lang.String officeFloorJavaCompilerImplementationClassName, OfficeFloorJavaCompiler.ImplementationRunnable<T> runnable)	Runs with a particular OfficeFloorJavaCompiler implementation.
static <T extends java.lang.Throwable> void	runWithoutCompiler(OfficeFloorJavaCompiler.NonCompilerOperation<T> operation)	Undertakes the OfficeFloorJavaCompiler.NonCompilerOperation without making the Java compiler available.
abstract void	writeConstructor(java.lang.Appendable appendable, java.lang.String className, OfficeFloorJavaCompiler.ClassField... fields)	Writes the Constructor.
abstract void	writeDelegateMethodCall(java.lang.Appendable source, java.lang.String delegate, java.lang.reflect.Method method)	Writes the delegate Method call.
abstract void	writeMethodImplementation(java.lang.Appendable source, java.lang.String delegate, java.lang.reflect.Method method)	Writes the Method implementation by invoking the delegate.
abstract boolean	writeMethodSignature(java.lang.Appendable appendable, java.lang.reflect.Method method)	Writes the Method signature to the Appendable.

Methods inherited from class java.lang.Object

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

Field Detail

SYSTEM_PROPERTY_JAVA_COMPILING

public static final java.lang.String SYSTEM_PROPERTY_JAVA_COMPILING

System property to indicate if Java compiling active for OfficeFloor.

See Also:

Constant Field Values

DEFAULT_OFFICE_FLOOR_JAVA_COMPILER_IMPLEMENTATION

public static final java.lang.String DEFAULT_OFFICE_FLOOR_JAVA_COMPILER_IMPLEMENTATION

Default OfficeFloorJavaCompiler implementation Class name.

See Also:

Constant Field Values

Constructor Detail

OfficeFloorJavaCompiler

public OfficeFloorJavaCompiler()

Method Detail

runWithImplementation

public static <T extends java.lang.Throwable> void runWithImplementation(java.lang.String officeFloorJavaCompilerImplementationClassName,
                                                                         OfficeFloorJavaCompiler.ImplementationRunnable<T> runnable)
                                                                  throws T extends java.lang.Throwable

Runs with a particular OfficeFloorJavaCompiler implementation.

Parameters:

officeFloorJavaCompilerImplementationClassName - Class name of the OfficeFloorJavaCompiler implementation.

runnable - OfficeFloorJavaCompiler.ImplementationRunnable.

Throws:

T - Possible Throwable from OfficeFloorJavaCompiler.ImplementationRunnable.

T extends java.lang.Throwable

newInstance

public static OfficeFloorJavaCompiler newInstance(SourceContext sourceContext)

Creates a new instance of the OfficeFloorJavaCompiler.

Parameters:

sourceContext - SourceContext.

Returns:

OfficeFloorJavaCompiler or null if Java compiling not available.

runWithoutCompiler

public static <T extends java.lang.Throwable> void runWithoutCompiler(OfficeFloorJavaCompiler.NonCompilerOperation<T> operation)
                                                               throws T extends java.lang.Throwable

Undertakes the OfficeFloorJavaCompiler.NonCompilerOperation without making the Java compiler available.

This is useful for testing non Java compile solutions.

Type Parameters:

T - Possible Throwable type.

Parameters:

operation - OfficeFloorJavaCompiler.NonCompilerOperation.

Throws:

T - Possible failure.

T extends java.lang.Throwable

createClassName

public abstract OfficeFloorJavaCompiler.ClassName createClassName(java.lang.String name)

Generates a unique OfficeFloorJavaCompiler.ClassName.

Parameters:

name - Seed name.

Returns:

OfficeFloorJavaCompiler.ClassName.

getSourceName

public abstract java.lang.String getSourceName(java.lang.Class<?> type)

Obtains the source name for the Class.

Parameters:

type - Class.

Returns:

Name used in source to reference the type.

createField

public abstract OfficeFloorJavaCompiler.ClassField createField(java.lang.Class<?> fieldType,
                                                               java.lang.String fieldName)

Creates the OfficeFloorJavaCompiler.ClassField.

Parameters:

fieldType - Field type.

fieldName - Field name.

Returns:

OfficeFloorJavaCompiler.ClassField.

writeConstructor

public abstract void writeConstructor(java.lang.Appendable appendable,
                                      java.lang.String className,
                                      OfficeFloorJavaCompiler.ClassField... fields)
                               throws java.io.IOException

Writes the Constructor.

Parameters:

appendable - Appendable.

className - Simple name of the Class.

fields - OfficeFloorJavaCompiler.ClassField instances.

Throws:

java.io.IOException - If fails to write the Constructor.

writeMethodSignature

public abstract boolean writeMethodSignature(java.lang.Appendable appendable,
                                             java.lang.reflect.Method method)
                                      throws java.io.IOException

Writes the Method signature to the Appendable.

Parameters:

appendable - Appendable.

method - Method.

Returns:

true if returns a value (false for void Method return).

Throws:

java.io.IOException - If fails to write the Method signature.

writeDelegateMethodCall

public abstract void writeDelegateMethodCall(java.lang.Appendable source,
                                             java.lang.String delegate,
                                             java.lang.reflect.Method method)
                                      throws java.io.IOException

Writes the delegate Method call.

Parameters:

source - Appendable.

delegate - Means to access delegate.

method - Method.

Throws:

java.io.IOException - If fails write delegate Method call.

writeMethodImplementation

public abstract void writeMethodImplementation(java.lang.Appendable source,
                                               java.lang.String delegate,
                                               java.lang.reflect.Method method)
                                        throws java.io.IOException

Writes the Method implementation by invoking the delegate.

Parameters:

source - Appendable.

delegate - Means to access delegate.

method - Method.

Throws:

java.io.IOException - If fails write delegate Method implementation.

addSource

public OfficeFloorJavaCompiler.JavaSource addSource(OfficeFloorJavaCompiler.ClassName className,
                                                    java.lang.String source)

Adds a OfficeFloorJavaCompiler.JavaSource.

Parameters:

className - OfficeFloorJavaCompiler.ClassName.

source - Source for the Class.

Returns:

OfficeFloorJavaCompiler.JavaSource.

addSource

public abstract OfficeFloorJavaCompiler.JavaSource addSource(java.lang.String className,
                                                             java.lang.String source)

Adds a OfficeFloorJavaCompiler.JavaSource.

Parameters:

className - Class name.

source - Source for the Class.

Returns:

OfficeFloorJavaCompiler.JavaSource.

addWrapper

public OfficeFloorJavaCompiler.JavaSource addWrapper(java.lang.Class<?> type,
                                                     OfficeFloorJavaCompiler.MethodWriter methodWriter,
                                                     OfficeFloorJavaCompiler.JavaSourceWriter... additionalSourceWriter)
                                              throws java.io.IOException

Adds a wrapper OfficeFloorJavaCompiler.JavaSource.

Parameters:

type - Type being wrapped.

methodWriter - OfficeFloorJavaCompiler.MethodWriter. May be null to use default implementation.

additionalSourceWriter - OfficeFloorJavaCompiler.JavaSourceWriter instances.

Returns:

OfficeFloorJavaCompiler.JavaSource for the wrapper.

Throws:

java.io.IOException - If fails to write the wrapper.

addWrapper

public abstract OfficeFloorJavaCompiler.JavaSource addWrapper(java.lang.Class<?>[] wrappingTypes,
                                                              java.lang.Class<?> delegateType,
                                                              java.lang.String delegateExtraction,
                                                              OfficeFloorJavaCompiler.ConstructorWriter constructorWriter,
                                                              OfficeFloorJavaCompiler.MethodWriter methodWriter,
                                                              OfficeFloorJavaCompiler.JavaSourceWriter... additionalSourceWriter)
                                                       throws java.io.IOException

Adds a wrapper OfficeFloorJavaCompiler.JavaSource.

Parameters:

wrappingTypes - Wrapping types.

delegateType - Delegate type.

delegateExtraction - Means to extract the wrapped implementation from the delegate. May be null to use default.

constructorWriter - OfficeFloorJavaCompiler.ConstructorWriter. May be null to use default Constructor.

methodWriter - OfficeFloorJavaCompiler.MethodWriter. May be null to use default implementation.

additionalSourceWriter - OfficeFloorJavaCompiler.JavaSourceWriter instances.

Returns:

OfficeFloorJavaCompiler.JavaSource for the wrapper.

Throws:

java.io.IOException - If fails to write the wrapper.

compile

public abstract java.util.Map<OfficeFloorJavaCompiler.JavaSource,java.lang.Class<?>> compile()

Compiles all the added OfficeFloorJavaCompiler.JavaSource instances.

Returns:

Map of OfficeFloorJavaCompiler.JavaSource to its Class.