Skip to main content
Jump to: navigation, search

Difference between revisions of "EclipseLinkCachingAndLocking"

(Caching)
(Project overview)
Line 19: Line 19:
 
== Project overview ==
 
== Project overview ==
  
This feature is entity/mapped superclass level caching and optimistic locking supported by the EclipseLink JPA extension.
+
This feature covers entity/mapped superclass level caching and optimistic locking supported by the EclipseLink JPA extension.
  
 
Goals:
 
Goals:
  
 
* Add JPA Details view widgets for the Cache, ExistenceChecking, OptimisticLocking annotations
 
* Add JPA Details view widgets for the Cache, ExistenceChecking, OptimisticLocking annotations
* Add JPA Details view widgets for eclipselink-orm.xml cache, esistence-checking and optimistic-locking elements
+
* Add JPA Details view widgets for eclipselink-orm.xml cache, existence-checking and optimistic-locking elements
 
* Provide the appropriate defaults and validation for these settings
 
* Provide the appropriate defaults and validation for these settings
  

Revision as of 15:47, 17 July 2008

Functional Specification: Dali Support for EclipseLink Caching and Optimistic Locking

bug 239137 - cache support

bug 239148 - optimistic locking support

Document History

Date Author Version Description & Notes
7-1-2008 Karen Butzke Draft

Project overview

This feature covers entity/mapped superclass level caching and optimistic locking supported by the EclipseLink JPA extension.

Goals:

  • Add JPA Details view widgets for the Cache, ExistenceChecking, OptimisticLocking annotations
  • Add JPA Details view widgets for eclipselink-orm.xml cache, existence-checking and optimistic-locking elements
  • Provide the appropriate defaults and validation for these settings

Concepts

Present any concepts relevant to the feature.

EclipseLink Cache annotation documentation

EclipseLink OptimisticLocking annotation documentation

Requirements / Functionality

Caching

  • @Cache supported in Entity and MappedSuperclass classes.
  • @ExistenceChecking supported in Entity and MappedSuperclass classes.


Entity 'Caching' section

EntityCaching.jpg


For reference, 'Caching' tab from the MW

MWCaching.jpg


For reference, 'Refreshing Cache Options' section from the MW

MWCaching2.jpg

Optimistic Locking

  • @OptimisticLocking supported in Entity and MappedSuperclass classes.
  • Type Options
    • Default (Version Column)
    • All Columns -> OptimisticLockingType.ALL_COLUMNS
    • Changed Columns -> OptimisticLockingType.CHANGED_COLUMNS
    • Selected Columns -> OptimisticLockingType.SELECTED_COLUMNS
    • Version Column -> OptimisticLockingType.VERSION_COLUMN
  • Validation
    • Type is 'Selected Columns' but no columns are selected
    • Selected Columns must be mapped and must not be primary keys
    • If using Optimistic Locking with anything other than Version Column, the @Version annotation will be ignored (warning, not error, for this)
    • If Cascade is set and type is not Version Column, warning that it is not supported.


Option 1 for Optimistic Locking section

EntityOptimisticLocking.jpg


Option 2 for Optimistic Locking section

  • None is chosen if no @Version annotaiton on an attribute and no @OptimisticLocking on the Entity
  • Default (Version Column) is chosen if @Version exists on an attribute and @OptimisticLocking does not exist on the Entity
  • Choose a Column under Version Column or Default(Version Column) and the @Version annotation will be added to the attribute that corresponds to that Column and removed from other attributes

EntityOptimisticLocking2.jpg


For Reference, Locking tab from MW

MWLocking.jpg

API

Issues

This section lists the open issues that are still pending that must be decided prior to fully implementing this project's requirements.

Issue # Owner Description / Notes Decision

Future Considerations

During the research for this project the following items were identified as out of scope but are captured here as potential future enhancements. If agreed upon during the review process these should be logged in the bug system.

Back to the top