Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 313788 - Query Hint default behavior needs explanation
Summary: Query Hint default behavior needs explanation
Status: RESOLVED FIXED
Alias: None
Product: z_Archived
Classification: Eclipse Foundation
Component: Eclipselink (show other bugs)
Version: unspecified   Edit
Hardware: PC Windows XP
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: Nobody - feel free to take it CLA
QA Contact:
URL: http://wiki.eclipse.org/Using_Eclipse...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-05-20 14:38 EDT by Shaun Smith CLA
Modified: 2022-06-09 10:34 EDT (History)
1 user (show)

See Also:
rick.sapir: documentation+
rick.sapir: juno+


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Shaun Smith CLA 2010-05-20 14:38:07 EDT
The defaults for various query hints needs to be documented.  The current docs say what the default is but there are more than one defaults at work.  Default query behavior is not the same as the hint default.  For example, by default a query will "maintain cache", i.e., TRUE.  This can be altered using eclipselink.maintain-cache.  The default for eclipselink.maintain-cache is FALSE.  We now have two seemingly contradictory defaults.  The default for the hint is only used when the value of the hint is not provided.  E.g., 

    .setHint(QueryHints.MAINTAIN_CACHE, "")

is the same as
   
    .setHint(QueryHints.MAINTAIN_CACHE, HintValues.FALSE)

because the default for the hint is FALSE--but the query default is TRUE.  Confused yet? :-)
Comment 1 Doug Clarke CLA 2010-06-03 16:48:05 EDT
Many PU properties are not documented. This will not make the 2.1 deadline but will be addressed shortly after.
Comment 2 Rick Sapir CLA 2010-06-18 11:35:17 EDT
To be added to 2.1.0 wiki JPA guide: http://wiki.eclipse.org/EclipseLink/UserGuide/JPA/Basic_JPA_Development/Query_Hints
Comment 3 Rick Sapir CLA 2012-09-21 05:17:22 EDT
Information on query hints now included in the EclipseLink JPA Extensions Guide: 
http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/queryhints.htm
Comment 4 Eclipse Webmaster CLA 2022-06-09 10:34:16 EDT
The Eclipselink project has moved to Github: https://github.com/eclipse-ee4j/eclipselink