In JPA 2.0 the specification extends the access type configuration. Access Type will be specified at the Entity Level or the Property Level. New annotations have also been added providing configuration in the Java Class along with orm.xml
See JPA 2.0 ED section 2.3 for details.
Our Entity Processing code must now process the entire entity as access type can be changed on a per property basis. The default and inheritance rules have not changed however and our current implementation can remain. The only exception to this rule is that inheritance subclasses can now explicitly specify the Access annotation and override the the inherited access type from (from the root. The root being the first parent that defines an inheritance strategy). So that will require a minor change to our current processing logic.
A quick break down of the processing would then look as follows:
- Determine the access type as we previously did taking into the consideration the entity @Access type mentioned above.
- An XML access setting on an entity will override an @Access specification on that same entity or a mapped superclass.
- If no access is specified, the entity will then be determined by an entity-mappings access specification, followed by a default-metadata access specification, followed by the default to where annotations are defined on the class.
- Process the accessors accordingly (and as we currently do)
- New processing step, process the inverse access type accessors. That is,
- If the access type is FIELD, process those properties that explicitly define Access(PROPERTY), ignore all others.
- If the access type is PROPERTY, process those fields that explicitly define Access(FIELD), ignore all others.
- At all stages of processing an exception will be thrown in the following cases:
- An Access(FIELD) is found on a property
- An Access(PROPERTY) is found on a field.
- Encountered during the entity processing and will continue to inherit it's access type from the owning entity. The exception case now being if the @Embeddable defines an access type.
- Processing of the embedable accessors will follow the processing logic defined for an entity.
- XML merging (an EclipseLink internal functionality) remains as implemented. No changes are necessary.
- Develop model for testing access type settings
- approx 2 days
- Update Processing to process entire table
- approx 3 days