Jump to: navigation, search

EclipseLinkAttributeMappingOptions

Revision as of 15:13, 16 October 2008 by Paul.fullbright.oracle.com (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Functional Specification: Dali Support for EclipseLink Attribute Mapping Options

bug 238441 - private owned support for java

bug 248756 - ... for eclipselink-orm.xml

bug 238455 - join fetch support for java

bug 249055 - ... for eclipselink-orm.xml

bug 238458 - mutable support for java

bug 249106 - ... for eclipselink-orm.xml

Document History

Date Author Version Description & Notes
6-25-2008 Karen Butzke Draft
10-16-2008 Paul Fullbright Added eclipselink-orm.xml bug links

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 a check box:

  • 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 a combo box:

  • Default (Inner)
  • Inner
  • Outer

A checkbox is used to enabled Join Fetch, if you check it the JoinFetch annotation is added and the combo box is enabled and displays Default(inner).


OneToOneJoinFetchPrivateOwned.jpg

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. Where should this setting go in the EclipseLink persistence.xml editor?

Possibly put a hyperlink from Mutable to the global setting in the persistence.xml editor, could do this for other settings as well. 241265

BasicMutable.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.