[OPENJPA-878] Support default query hint for query timeout

• Type: Sub-task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.0.0-M2
• Fix Version/s: 2.0.0-M2
• Component/s: query
• Assignee: Donald Woods
• Reporter: Donald Woods
• Created: 29/Jan/09 21:11
• Updated: 02/May/13 06:29
• Resolved: 26/Mar/09 00:01

Description

Support default query hint for query timeout as defined in section 3.6.4 of the spec.
A new hint can be supplied for Java SE and Java EE environments -
javax.persistence.query.timeout // query timeout in seconds
Can be used in the following:
Methods - Query.setHint()
Annotations (via QueryHint) - NamedQuery, NativeNamedQuery
Properties - Persistence.createEntityManagerFactory, persistence.xml
The following methods can return a javax.persistence.QueryTimeoutException: getResultList(), getSingleResult(), executeUpdate().
If a QTE is thrown, the current transaction (if active) should not be marked for rollback.
If the DB query timeout causes a rollback, then a PersistenceException should be thrown instead (see 3.6.1).

Issue Links

• depends upon: OPENJPA-927 Fix definition of javax.persistence.query.timeout property
• is depended upon by: OPENJPA-972 Support standard provider properties in PersistenceProvider class
• is related to: OPENJPA-849 Add metadata-type getter methods to EntityManager
• relates to: OPENJPA-957 Support lock timeout hint on applicable methods
• relates to: OPENJPA-1000 Consistent usage of serialVersionUID