Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
EclipseLinkAttributeMappingOptions
Functional Specification: Dali Support for EclipseLink Attribute Mapping Options
bug 238441 - private owned support
bug 238455 - join fetch support
bug 238458 - mutable support
Document History
| Date | Author | Version Description & Notes |
|---|---|---|
| 6-25-2008 | Karen Butzke | Draft |
Project overview
This feature is about adding the new attribute level annotations supported by the EclipseLink JPA extension.
Goals:
- Add JPA Details view widgets for the PrivateOwned, JoinFetch, and Mutable annotations
- Add JPA Details view widgets for eclipselink-orm.xml private-owned, join-fetch, mutable elements
- Provide the appropriate defaults and validation for these settings
Concepts
Present any concepts relevant to the feature.
EclipseLink PrivateOwned annotation documentation
EclipseLink JoinFetch annotation documentation
EclipseLink Mutable annotation documentation
Requirements / Functionality
Private Owned
@PrivateOwned annotation is supported on OneToOne, OneToMany and VariableOneToOne mappings. The corresponding element in the eclipselink-orm.xml is private-owned.
Private owned options, to be displayed as tri-state check box:
- Default (False)
- True
- False
Join Fetch
@JoinFetch annotation is supported on OneToOne, OneToMany, ManyToOne, ManyToMany, BasicCollection, and BasicMap mappings. The corresponding element in the eclipselink-orm.xml is join-fetch. Join Fetch options, to be displayed as combo box:
- Default (Inner)
- Inner
- Outer
How do we handle no @JoinFetch annotation meaning no default? The Default of Inner is only if the @JoinFetch annotation exists and no JoinFetchType is specified. Should we use a check box and a combo box? We also have the same problem with the existing Enumerated widget.
Private owned and join fetch widgets on a OneToOne
Mutable
@Mutable annotation is supported on Id, Basic, Version, and Transformation mappings. The corresponding element in the eclipselink-orm.xml is mutable.
If attribute type is Serializable then mutable defaults to true, otherwise it defaults to false. If no Mutable annotation is specified and the type is a Date or Calendar the default is taken from the persistence unit property eclipselink.temporal.mutable 228042
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.