3.6.6.5.1. External Values
Externalization often takes simple constant values and transforms them to constant values of a different type.
An example would be storing a boolean field as a char, where true and false would be stored in the database as 'T' and 'F' respectively.
OpenJPA allows you to define these simple translations in metadata, so that the field behaves as in full-fledged externalization without requiring externalizer and factory methods. External values supports translation of pre-defined simple types (primitives, primitive wrappers, and Strings), to other pre-defined simple values.
Use the OpenJPA
org.apache.openjpa.persistence.ExternalValues annotation to define external value translations.
The values are defined in a format similar to that of configuration plugins, except that the value pairs represent Java and datastore values.
To convert the Java boolean values of true and false to the character values T and F, for example, you would use the extension value: true=T,false=F.
If the type of the datastore value is different from the field’s type, use the org.apache.openjpa.persistence.Type annotation to define the datastore type.
This example uses external value translation to transform a string field to an integer in the database.
public class Magazine {
@ExternalValues({"SMALL=5", "MEDIUM=8", "LARGE=10"})
@Type(int.class)
private String sizeWidth;
...
}