Module org.eclipse.persistence.core
Package org.eclipse.persistence.dynamic
Class DynamicClassLoader
java.lang.Object
java.lang.ClassLoader
org.eclipse.persistence.dynamic.DynamicClassLoader
- Direct Known Subclasses:
DynamicRestClassLoader
,ReflectiveDynamicClassLoader
,XRDynamicClassLoader
This custom ClassLoader provides support for dynamically generating classes
within an EclipseLink application using byte codes created using a
DynamicClassWriter
. A DynamicClassLoader requires a parent or
delegate class-loader which is provided to the constructor. This delegate
class loader handles the lookup and storage of all created classes.- Since:
- EclipseLink 1.2
-
Nested Class Summary
-
Field Summary
Modifier and TypeFieldDescriptionprotected Map
<String, EclipseLinkClassWriter> Map ofDynamicClassWriter
used to dynamically create a class in thefindClass(String)
call.Default writer to use if one is not specified.protected Map
<String, DynamicClassLoader.EnumInfo> -
Constructor Summary
ConstructorDescriptionDynamicClassLoader
(ClassLoader delegate) Create a DynamicClassLoader providing the delegate loader and leaving the defaultWriter asDynamicClassWriter
DynamicClassLoader
(ClassLoader delegate, DynamicClassWriter writer) Create a DynamicClassLoader providing the delegate loader and a defaultDynamicClassWriter
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Register a class to be dynamically created using the defaultDynamicClassWriter
.void
Register a class to be dynamically created using a copy of defaultDynamicClassWriter
but specifying a different parent class.void
addClass
(String className, EclipseLinkClassWriter writer) Register a class to be dynamically created using the providedDynamicClassWriter
.void
protected Class
<?> checkAssignable
(Class<?> clz) void
createDynamicAdapter
(String className) Create an adapter for givenclassName
Class
<?> createDynamicClass
(String className) Create a new dynamic entity type for the specified name assuming the use of the default writer and its default parent class.Class
<?> createDynamicClass
(String className, Class<?> parentClass) Create a new dynamic entity type for the specified name with the specified parent class.Class
<?> createDynamicClass
(String className, DynamicClassWriter writer) Create a dynamic class registering a writer and then forcing the provided class name to be loaded.void
createDynamicCollectionAdapter
(String className) Create a collection adapter for givenclassName
void
createDynamicReferenceAdapter
(String className) Create a reference for givenclassName
protected Class
<?> defineDynamicClass
(String name, byte[] b) Converts an array of bytes into an instance of classClass
.protected Class
<?> Create a new dynamic class if a ClassWriter is registered for the provided className.getClassWriter
(String className) protected Map
<String, EclipseLinkClassWriter> static DynamicClassLoader
Lookup the DynamicConversionManager for the given session.Methods inherited from class java.lang.ClassLoader
clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findResource, findResources, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners
-
Field Details
-
classWriters
Map ofDynamicClassWriter
used to dynamically create a class in thefindClass(String)
call. The application must register classes using addClass or createDynameClass prior to thefindClass(String)
being invoked.The map of writers is maintained for the life of this DynamicClassLoader instance to ensure additional requests to create dynamic classes of the same name are properly verified. Duplicate requests for dynamic classes of the same name, same writer type, and the same parent class are permitted but different parent classes or different writer types are not.
-
enumInfoRegistry
-
defaultWriter
Default writer to use if one is not specified.
-
-
Constructor Details
-
DynamicClassLoader
Create a DynamicClassLoader providing the delegate loader and leaving the defaultWriter asDynamicClassWriter
-
DynamicClassLoader
Create a DynamicClassLoader providing the delegate loader and a defaultDynamicClassWriter
.
-
-
Method Details
-
getDefaultWriter
-
getClassWriters
-
getClassWriter
-
addEnum
-
addClass
Register a class to be dynamically created using the defaultDynamicClassWriter
.- See Also:
-
addClass
Register a class to be dynamically created using a copy of defaultDynamicClassWriter
but specifying a different parent class.- See Also:
-
addClass
Register a class to be dynamically created using the providedDynamicClassWriter
. The registered writer is used when thefindClass(String)
method is called back on this loader from theClassLoader.loadClass(String)
call.If a duplicate request is made for the same className and the writers are not compatible a
DynamicException
will be thrown. If the duplicate request contains a compatible writer then the second request is ignored as the class may already have been generated.- Throws:
DynamicException
- See Also:
-
createDynamicClass
Create a dynamic class registering a writer and then forcing the provided class name to be loaded. -
checkAssignable
-
createDynamicClass
Create a new dynamic entity type for the specified name assuming the use of the default writer and its default parent class.- See Also:
-
createDynamicClass
Create a new dynamic entity type for the specified name with the specified parent class.- See Also:
-
createDynamicAdapter
Create an adapter for givenclassName
-
createDynamicCollectionAdapter
Create a collection adapter for givenclassName
-
createDynamicReferenceAdapter
Create a reference for givenclassName
-
findClass
Create a new dynamic class if a ClassWriter is registered for the provided className. This code is single threaded to ensure only one class is created for a given name and that the ClassWriter is removed afterwards.- Overrides:
findClass
in classClassLoader
- Throws:
ClassNotFoundException
-
defineDynamicClass
Converts an array of bytes into an instance of classClass
. Before theClass
can be used it must be resolved. -
lookup
Lookup the DynamicConversionManager for the given session. If the existing ConversionManager is not an instance of DynamicConversionManager then create a new one and replace the existing one.
-