Class DynamicClassWriter
- All Implemented Interfaces:
EclipseLinkClassWriter
- Direct Known Subclasses:
MetadataDynamicClassWriter
,XRClassWriter
The intent is to provide a common writer for dynamic JPA entities but also allow for subclasses of this to be used in more complex writing situations such as SDO and DBWS.
Instances of this class and any subclasses are maintained within the
DynamicClassLoader.getClassWriters()
and
DynamicClassLoader.defaultWriter
for the life of the class loader so
it is important that no unnecessary state be maintained that may effect
memory usage.
- Since:
- EclipseLink 1.2
-
Field Summary
-
Constructor Summary
ConstructorDescriptionDynamicClassWriter
(Class<?> parentClass) DynamicClassWriter
(String parentClassName) Create using a loader and class name so that the parent class can be lazily loaded when the writer is used to generate a dynamic class. -
Method Summary
Modifier and TypeMethodDescriptionprotected void
addFields
(ClassWriter cw, String parentClassType) Allow subclasses to add additional state to the dynamic entity.protected void
addInterface
(String intf) Allow subclasses to add additional interfaces to the dynamic entity.protected void
addMethods
(ClassWriter cw, String parentClassType) Allow subclasses to add additional methods to the dynamic entity.protected DynamicClassWriter
createCopy
(Class<?> parentClass) Create a copy of thisDynamicClassWriter
but with a different parent class.protected byte[]
createEnum
(DynamicClassLoader.EnumInfo enumInfo) protected String[]
Interfaces the dynamic entity class implements.Class
<?> boolean
isCompatible
(EclipseLinkClassWriter writer) Verify that the provided writer is compatible with the current writer.toString()
protected boolean
verify
(Class<?> dynamicClass, ClassLoader loader) Verify that the provided class meets the requirements of the writer.byte[]
writeClass
(DynamicClassLoader loader, String className)
-
Field Details
-
DYNAMIC_PROPERTIES_MANAGER_CLASSNAME_SLASHES
-
INIT
- See Also:
-
CLINIT
- See Also:
-
parentClass
-
parentClassName
Name of parent class. This is used only when the parent class is not known at the time the dynamic class writer is registered. This is generally only required when loading from an XML mapping file where the order of class access is not known. -
ICONST
public static int[] ICONST
-
-
Constructor Details
-
DynamicClassWriter
public DynamicClassWriter() -
DynamicClassWriter
-
DynamicClassWriter
Create using a loader and class name so that the parent class can be lazily loaded when the writer is used to generate a dynamic class.The loader must not be null and the parentClassName must not be null and not an empty String. The parentClassName will be converted to a class using the provided loader lazily.
- See Also:
-
-
Method Details
-
getParentClass
- Specified by:
getParentClass
in interfaceEclipseLinkClassWriter
-
getParentClassName
- Specified by:
getParentClassName
in interfaceEclipseLinkClassWriter
-
writeClass
- Specified by:
writeClass
in interfaceEclipseLinkClassWriter
- Throws:
ClassNotFoundException
-
addInterface
Allow subclasses to add additional interfaces to the dynamic entity.- Parameters:
intf
- additional interface
-
addFields
Allow subclasses to add additional state to the dynamic entity. -
addMethods
Allow subclasses to add additional methods to the dynamic entity. -
createEnum
-
verify
Verify that the provided class meets the requirements of the writer. In the case ofDynamicClassWriter
this will ensure that the class is a subclass of theparentClass
- Throws:
ClassNotFoundException
-
getInterfaces
Interfaces the dynamic entity class implements. By default this is none but in the case of SDO a concrete interface must be implemented. Subclasses should override this as required.- Returns:
- Interfaces implemented by Dynamic class. May be null
-
createCopy
Create a copy of thisDynamicClassWriter
but with a different parent class.- See Also:
-
isCompatible
Verify that the provided writer is compatible with the current writer. Returning true means that the bytes that would be created using this writer are identical with what would come from the provided writer.Used in
DynamicClassLoader.addClass(String, EclipseLinkClassWriter)
to verify if a duplicate request of the same className can proceed and return the same class that may already exist.- Specified by:
isCompatible
in interfaceEclipseLinkClassWriter
-
toString
-