Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "EclipseLink/Development/JPA 2.0/properties processing"
(→Functional Requirements) |
(→JPA 2.0: Property Processing) |
||
Line 27: | Line 27: | ||
== Functional Requirements == | == Functional Requirements == | ||
− | === Two groups of properties === | + | === Entity Manager Properties === |
+ | ==== Two groups of properties ==== | ||
Only properties passed to createEM method guaranteed to take effect right away. | Only properties passed to createEM method guaranteed to take effect right away. | ||
Line 41: | Line 42: | ||
### Even if the em is new, some application servers (was, oc4j) would have already created uow (they likely call em.joinTransaction()). | ### Even if the em is new, some application servers (was, oc4j) would have already created uow (they likely call em.joinTransaction()). | ||
− | ==== First group: properies applicable to existing uow ==== | + | ===== First group: properies applicable to existing uow ===== |
# JOIN_EXISTING_TRANSACTION | # JOIN_EXISTING_TRANSACTION | ||
# PERSISTENCE_CONTEXT_CLOSE_ON_COMMIT | # PERSISTENCE_CONTEXT_CLOSE_ON_COMMIT | ||
Line 50: | Line 51: | ||
# FLUSH_CLEAR_CACHE | # FLUSH_CLEAR_CACHE | ||
− | ==== Second group: properies that require new uow ==== | + | ===== Second group: properies that require new uow ===== |
# PERSISTENCE_CONTEXT_REFERENCE_MODE | # PERSISTENCE_CONTEXT_REFERENCE_MODE | ||
# ORACLE_PROXY_TYPE | # ORACLE_PROXY_TYPE | ||
Line 63: | Line 64: | ||
# CONNECTION_POLICY | # CONNECTION_POLICY | ||
− | === getSupportedProperties limitation === | + | ==== getSupportedProperties limitation ==== |
The method doesn't cover (nor should it) the properties defined elsewhere. | The method doesn't cover (nor should it) the properties defined elsewhere. | ||
# ORACLE_PROXY_TYPE properties dictates usage of other Oracle Proxy Authentication properties: | # ORACLE_PROXY_TYPE properties dictates usage of other Oracle Proxy Authentication properties: |
Revision as of 16:36, 21 September 2009
JPA 2.0: Property Processing
Date | Committer(s) | Description |
---|---|---|
March 24, 2009 | gyorke | Initial feature template |
Summary
The JPA 2.0 Specification provides functionality to set properties on the EntityManager at runtime. Before that feature can be completed we must define what properties can be set on the Entity Manager and when. This will allow use to clearly communicate to our customers how and when certain configurations can be applied. We must also update our property processing to ensure properties can be processed on a per property basis and that the property processing functionality is complete and available.
Work Estimate
- Define all properties and when they apply
- 1 day
- Update property processing to account for lifecycle and validation
- 4 days
- write tests to verify validation and lifecycle
- 2 days
Functional Requirements
Entity Manager Properties
Two groups of properties
Only properties passed to createEM method guaranteed to take effect right away.
Some EntityManager properties could be applied to the unit of work which already exists, other can't. For each property that should be clearly listed in EntityManagerProperty class comments.
- For each property of the first group, property value processed immediately as setProperty called.
- Each time getActivePersistenceContext is called the processed property value is set in the uow.
- Obvious optimization to add a flag indicating whether any of first group properties has changed since being last time set into the uow.
- Each time getActivePersistenceContext is called the processed property value is set in the uow.
- Properties of the second group processed and applied only when the new uow is created.
- User have to call em.clear() unless property applied to a brand new EntityManager.
- Even if the em is new, some application servers (was, oc4j) would have already created uow (they likely call em.joinTransaction()).
- User have to call em.clear() unless property applied to a brand new EntityManager.
First group: properies applicable to existing uow
- JOIN_EXISTING_TRANSACTION
- PERSISTENCE_CONTEXT_CLOSE_ON_COMMIT
- PERSISTENCE_CONTEXT_PERSIST_ON_COMMIT
- PERSISTENCE_CONTEXT_COMMIT_WITHOUT_PERSIST_RULES
- PERSISTENCE_CONTEXT_FLUSH_MODE
- VALIDATE_EXISTENCE
- FLUSH_CLEAR_CACHE
Second group: properies that require new uow
- PERSISTENCE_CONTEXT_REFERENCE_MODE
- ORACLE_PROXY_TYPE
- EXCLUSIVE_CONNECTION_MODE
- EXCLUSIVE_CONNECTION_IS_LAZY
- JTA_DATASOURCE
- NON_JTA_DATASOURCE
- JDBC_DRIVER
- JDBC_URL
- JDBC_USER
- JDBC_PASSWORD
- CONNECTION_POLICY
getSupportedProperties limitation
The method doesn't cover (nor should it) the properties defined elsewhere.
- ORACLE_PROXY_TYPE properties dictates usage of other Oracle Proxy Authentication properties:
- if the value OracleConnection.PROXYTYPE_USER_NAME then OracleConnection.PROXY_USER_NAME property should also be specified;
- if the value OracleConnection.PROXYTYPE_DISTINGUISHED_NAME then OracleConnection.PROXY_DISTINGUISHED_NAME property should also be specified;
- if the value OracleConnection.PROXYTYPE_CERTIFICATE then OracleConnection.OracleConnection.PROXY_CERTIFICATE property should also be specified;
- Also OracleConnection.PROXY_USER_PASSWORD and OracleConnection.PROXY_ROLES may be used.
- May be more proxy properties will be defined in the future?
- All of these properties handled by OracleConnection.openProxySession method
- Eclipselink passes all the properties to it, and the method processes the relevant properties, ignores all others.
- getSupportedProperties currently returns only ORACLE_PROXY_TYPE, which I believe is correct.
- Even more precize would be not returning ORACLE_PROXY_TYPE unless the database platform is Oracle9Platform or higher.
- Return either JTA_DATASOURCE or NON_JTA_DATASOURCE depending on whether external transaction controller is used or not.
Existing Feature Impact
Feature | Supported | Notes |
---|