Bugzilla – Full Text Bug Listing
| Summary: | Query Hint default behavior needs explanation | ||
|---|---|---|---|
| Product: | z_Archived | Reporter: | Shaun Smith <shaun.smith> |
| Component: | Eclipselink | Assignee: | Nobody - feel free to take it <nobody> |
| Status: | RESOLVED FIXED | QA Contact: | |
| Severity: | normal | ||
| Priority: | P3 | CC: | douglas.clarke |
| Version: | unspecified | Flags: | rick.sapir:
documentation+
rick.sapir: juno+ |
| Target Milestone: | --- | ||
| Hardware: | PC | ||
| OS: | Windows XP | ||
| URL: | http://wiki.eclipse.org/Using_EclipseLink_JPA_Extensions_(ELUG)#How_to_Use_EclipseLink_JPA_Query_Hints | ||
| Whiteboard: | |||
Many PU properties are not documented. This will not make the 2.1 deadline but will be addressed shortly after. To be added to 2.1.0 wiki JPA guide: http://wiki.eclipse.org/EclipseLink/UserGuide/JPA/Basic_JPA_Development/Query_Hints Information on query hints now included in the EclipseLink JPA Extensions Guide: http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/queryhints.htm The Eclipselink project has moved to Github: https://github.com/eclipse-ee4j/eclipselink |
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? :-)