uk.co.strangeskies.reflection.codegen

Class ClassRegister

java.lang.Object

uk.co.strangeskies.reflection.codegen.ClassRegister

public class ClassRegister
extends java.lang.Object

Loading stub-classes first then overriding with full implementations as a two-step process means we can inject into existing class loaders without any of the circularity restrictions present in other solutions. Think about how we can achieve clever re-definition abilities here by loading existing classes into the class definition space and then modifying them. Remember that we can then use instrumentation to reload the classes into the same class loader if we really need to. Load classes into ClassDefinitionSpace so we can reuse their methods: - ClassDefinition.withMethodsFrom(Class) - ClassDefinition.withMethodFrom(Class, String)

Constructor Summary

Constructors

Modifier	Constructor and Description
	ClassRegister()
	ClassRegister(java.lang.ClassLoader classLoader)
protected	ClassRegister(java.util.Map<java.lang.String,ClassDeclaration<?,?>> classDeclarations, java.util.Map<java.lang.String,byte[]> classBytecodes, java.util.Map<MethodDeclaration<?,?>,MethodImplementation<?>> methodDefinitions, java.util.Set<MethodDeclaration<?,?>> undefinedMethods, boolean allowPartialImplementation, java.lang.ClassLoader classLoader, ByteArrayClassLoader stubClassLoader)

Method Summary

Modifier and Type	Method and Description
ClassRegister	asPartialImplementation() partialImplementation defaults to true.
java.util.Map<java.lang.String,byte[]>	generateClasses()
<T> java.util.Optional<ClassDefinition<?,T>>	getClassDefinition(ClassSignature<T> classSignature)
java.util.Optional<ClassDefinition<?,?>>	getClassDefinition(java.lang.String className)
java.lang.ClassLoader	getClassLoader()
boolean	isClassOverridingSupported()
boolean	isFullyImplemented()
boolean	isPartiallyImplemented() Is the class space not fully implemented, and is partial implementation allowed and possible.
java.lang.ClassLoader	loadClasses() Generate the classes and load them into the runtime.
void	validate()
<T> ClassDefinition<java.lang.Void,T>	withClassSignature(ClassSignature<T> classSignature)
ClassRegister	withClassSignatures(ClassSignature<?>... classSignatures)
ClassRegister	withPartialImplementation(boolean allowPartialImplementation) Derive a class space allowing for partial implementation.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassRegister

public ClassRegister()

ClassRegister

public ClassRegister(java.lang.ClassLoader classLoader)

ClassRegister

protected ClassRegister(java.util.Map<java.lang.String,ClassDeclaration<?,?>> classDeclarations,
                        java.util.Map<java.lang.String,byte[]> classBytecodes,
                        java.util.Map<MethodDeclaration<?,?>,MethodImplementation<?>> methodDefinitions,
                        java.util.Set<MethodDeclaration<?,?>> undefinedMethods,
                        boolean allowPartialImplementation,
                        java.lang.ClassLoader classLoader,
                        ByteArrayClassLoader stubClassLoader)

Method Detail

withClassSignature

public <T> ClassDefinition<java.lang.Void,T> withClassSignature(ClassSignature<T> classSignature)

withClassSignatures

public ClassRegister withClassSignatures(ClassSignature<?>... classSignatures)

isClassOverridingSupported

public boolean isClassOverridingSupported()

getClassLoader

public java.lang.ClassLoader getClassLoader()

getClassDefinition

public <T> java.util.Optional<ClassDefinition<?,T>> getClassDefinition(ClassSignature<T> classSignature)

getClassDefinition

public java.util.Optional<ClassDefinition<?,?>> getClassDefinition(java.lang.String className)

validate

public void validate()

isFullyImplemented

public boolean isFullyImplemented()

isPartiallyImplemented

public boolean isPartiallyImplemented()

Is the class space not fully implemented, and is partial implementation allowed and possible.

Returns:

true if the class space is partially implemented, false otherwise

asPartialImplementation

public ClassRegister asPartialImplementation()

partialImplementation defaults to true.

See Also:

withPartialImplementation(boolean)

withPartialImplementation

public ClassRegister withPartialImplementation(boolean allowPartialImplementation)

Derive a class space allowing for partial implementation.

Partial implementation will attempt to still generate valid classes when some method implementations are not provided. This is achieved by providing default implementations to throw an error on invocation.

Parameters:

allowPartialImplementation - true if partial implementation should be allowed, false otherwise

Returns:

the derived class space

generateClasses

public java.util.Map<java.lang.String,byte[]> generateClasses()

loadClasses

public java.lang.ClassLoader loadClasses()

Generate the classes and load them into the runtime.

Returns:

the class loader containing, or allowing the loading of, the generated classes