Difference between revisions of "EclipseLink/Development/Dynamic/def1"

Revision as of 14:33, 31 August 2009

Dynamic Persistence

Dynamic Persistence is defined as the ability to create a persistent entity class and use it within an application without a-priori the Java class existing (no .java or .class files).

Dynamic Persistence is - in essence - a trick with ClassLoaders. EclipseLink's meta-data describes a persistent entity in terms of a Descriptor which owns one or more Mappings that represent a class' member fields. The class' info is string-based - for instance in Java code:

RelationalDescriptor addressDescriptor = new RelationalDescriptor();
addressDescriptor.setAlias("address");
addressDescriptor.setJavaClassName("com.foo.bar.Address");

or XML:

<?xml version="1.0" encoding="UTF-8"?>
<object-persistence version="Eclipse Persistence Services - {some version}"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:eclipselink="http://www.eclipse.org/eclipselink/xsds/persistence"
  >
  <name>relationships</name>
  <class-mapping-descriptors>
    <class-mapping-descriptor xsi:type="xml-class-mapping-descriptor">
      <class>com.foo.bar.Address</class>
      <alias>address</alias>

Because almost any value can be specified for the <class>-tag (within the limits of Java naming conventions), there is the possibility that the class cannot be found. The trick then is to provide a custom ClassLoader that upon detecting that com.foo.bar.Address does not exist, uses a bytecode manipulation library (such as ASM or some other framework) to create a class that agrees with the meta-data - in terms of the number of Mappings, their types, etc.