数据过滤并不是一种常规的数据查询方法,而是一种整体的筛选方法。
如果一旦启用了数据过滤器,则不管数据查询还是数据加载,该过滤器将自动作用于所有数据,只有满足过滤条件的记录才会被选出来。
过滤器使用分为三步:
- 定义过滤器。使用Hibernate提供的@FilterDef注解定义过滤器。如果需要定义多个过滤器。还需要使用@FilterDefs注解来组合多个@FilterDef。
- 使用过滤器。使用@Filter元素应用过滤器。
- 在代码中通过Session启用过滤器。
@FilterDef通常用于修饰持久化类,用于定义注解;@Filter则通常用于修饰持久化类或集合属性(包括关联实体),表示对指定持久化类或集合属性(包括关联实体)应用过滤器。
一个持久化类或集合可以使用多个过滤器,而一个过滤器也可以作用于多个持久化类或集合属性(包括关联实体)。
定义过滤器时完全可以不指定过滤条件,过滤器的过滤条件要等到使用过滤器时才确定,@Filter的condition属性用于指定过滤条件,只有满足该条件的记录才会被抓取。
系统默认不启用过滤器,必须通过Session的enableFilter(String filterName)才可以启用过滤器,该方法返回一个Filter实例,Filter包含setParameter()方法用于为过滤器参数赋值。
一旦启用了过滤器,过滤器就在整个Session内有效,所有的数据加载将自动应用过滤条件,直到调用disableFilter()方法。
对于在SQL语句中使用行内表达式、视图的地方,也可以考虑使用过滤器。
在一个持久化注解中定义的过滤器,完全可以在其他不同的持久化类中使用。前提是这些持久化类由一个SessionFactory负责加载并管理。