参考链接:https://blog.csdn.net/Lanna_w/article/details/106265917
参考链接:http://www.360doc.com/edit/editartnew.aspx?articleid=1134425353
非常厉害的博主:http://www.360doc.com/userhome/26211242
Hibernate3 提供了一种创新的方式来处理具有“显性(visibility)”规则的数据,那就是使用Hibernate 过滤器。Hibernate 过滤器是全局有效的、具有名字、可以带参数的过滤器,对于某个特定的 Hibernate session 您可以选择是否启用(或禁用)某个过滤器。
例 19.1. @FilterDef and @Filter annotations
@Entity
@FilterDef(name="minLength", parameters=@ParamDef( name="minLength", type="integer" ) )
@Filters( {
@Filter(name="betweenLength", condition=":minLength <= length and :maxLength >= length"),
@Filter(name="minLength", condition=":minLength <= length")
} )
public class Forest { ... }
例 19.2. Using@FilterJoinTablefor filterting on the association table
@OneToMany
@JoinTable
//filter on the target entity table
@Filter(name="betweenLength", condition=":minLength <= length and :maxLength >= length")
//filter on the association table
@FilterJoinTable(name="security", condition=":userlevel >= requredLevel")
public Set getForests() { ... }
Using Hibernate mapping files for defining filters the situtation is very similar. The filters must first be defined and then attached to the appropriate mapping elements. To define a filter, use theelement within aelement:
例 19.3. Defining a filter definition via
This filter can then be attached to a class or collection (or, to both or multiples of each at the same time):
例 19.4. Attaching a filter to a class or collection using
...
Session对象中会用到的方法有:enableFilter(String filterName),getEnabledFilter(String filterName),和disableFilter(String filterName)。Session 中默认是不启用过滤器的,必须通过Session.enabledFilter()方法显式的启用。该方法返回被启用的Filter的实例。以上文定义的过滤器为例:
session.enableFilter("myFilter").setParameter("myFilterParam", "some-value");
注意,org.hibernate.Filter 的方法允许链式方法调用。(类似上面例子中启用 Filter 之后设定 Filter 参数这个“方法链”) Hibernate 的其他部分也大多有这个特性。
下面是一个比较完整的例子,使用了记录生效日期模式过滤有时效的数据:
...
...
...
定义好后,如果想要保证取回的都是目前处于生效期的记录,只需在获取雇员数据的操作之前先开启过滤器即可:
Session session = ...;
session.enableFilter("effectiveDate").setParameter("asOfDate", new Date());
List results = session.createQuery("from Employee as e where e.salary > :targetSalary")
.setLong("targetSalary", new Long(1000000))
.list();
在上面的 HQL 中,虽然我们仅仅显式的使用了一个薪水条件,但因为启用了过滤器,查询将仅返回那些目前雇用关系处于生效期的,并且薪水高于一百万美元的雇员的数据。
注意:如果你打算在使用外连接(或者通过 HQL 或 load fetching)的同时使用过滤器,要注意条件表达式的方向(左还是右)。最安全的方式是使用左外连接(left outer joining)。并且通常来说,先写参数,然后是操作符,最后写数据库字段名。
在 Filter 定义之后,它可能被附加到多个实体和/或集合类,每个都有自己的条件。假若这些条件都是一样的,每次都要定义就显得很繁琐。因此,被用来定义一个默认条件,它可能作为属性或者 CDATA 出现:
xyz">...abc=xyz
当这个 filter 被附加到任何目的地,而又没有指明条件时,这个缺省条件就会被使用。注意,换句话说,你可以通过给 filter 附加特别的条件来重载默认条件。