Jump to: navigation, search

EclipseLink/UserGuide/JPA/Advanced JPA Development/Customizers

< EclipseLink‎ | UserGuide‎ | JPA‎ | Advanced JPA Development
Revision as of 14:13, 3 May 2012 by James.sutherland.oracle.com (Talk | contribs) (DescriptorCustomizer)

EclipseLink JPA


EclipseLink allows extended configuration of the persistence unit meta-data through Java code. EclipseLink provides a descriptor and mapping API that allows its meta-data to be accessed and configured through Java code. EclipseLink also provides a session API that allows the persistence unit meta-data to be accessed and configured through Jacva code. The APIs allows access to certain extended features not provided through annotations or XML. They also allow usage of custom extensions, allow configurations that are only possible through code, and allow easier configuration of defaults and computed configurations.

EclipseLink provides two types of customizers:

  • DescriptorCustomizer : defines an interface to customize the mapping meta-data for a class.
  • SessionCustomizer : defines an interface to customize the meta-data for a persistence unit, or a set of its classes.


DescriptorCustomizer is an interface that allows the customization of a class' meta-data through Java code. The interface defines a single method, customize(ClassDescriptor). The ClassDescriptor argument represents the meta-data for a class. The actually descriptor will be an instance of either RelationalDescriptor for relational data, or an EISDescriptor for NoSQL data.

A DescriptorCustomizer can be set on an Entity or Embeddable class using the @Customizer annotation or <customizer> XML element.

DescriptorCustomizer example

public class MyCustomizer implements DescriptorCustomizer {
  public void customize(ClassDescriptor descriptor) {
    DirectToFieldMapping genderMapping = (DirectToFieldMapping)descriptor.getMappingForAttributeName("gender");
    ObjectTypeConverter converter = new ObjectTypeConverter();
    convert.addConversionValue("M", Gender.MALE);
    convert.addConversionValue("F", Gender.FEMALE);
public class Employee {

Version: 2.4.0 DRAFT
Other versions...