Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

HHH-11066 - Documentation regarding the reason @Filter is not supported with @Cache for collections 

(cherry picked from commit 95ac619bce)
This commit is contained in:
Vlad Mihalcea 2016-10-13 14:34:35 +03:00 committed by Gail Badner
parent 84135d4c0f
commit 612c0606db
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
documentation/src/main/asciidoc/userguide/chapters/domain/basic_types.adoc
View File

@ -1383,6 +1383,17 @@ include::{extrasdir}/basic/mapping-filter-collection-query-example.sql[]
The main advantage of `@Filter` over teh `@Where` clause is that the filtering criteria can be customized at runtime. The main advantage of `@Filter` over teh `@Where` clause is that the filtering criteria can be customized at runtime.
==== ====
[WARNING]
====
It's not possible to combine the `@Filter` and `@Cache` collection annotations.
This limitation is due to ensuring consistency and because the filtering information is not stored in the second-level cache.
If caching was allowed for a currently filtered collection, then the second-level cache would store only a subset of the whole collection.
Afterward, every other Session will get the filtered collection from the cache, even if the Session-level filters have not been explicitly activated.
For this reason, the second-level collection cache is limited to storing whole collections, and not subsets.
====
[[mapping-column-any]] [[mapping-column-any]]
==== @Any mapping ==== @Any mapping