When the collection use an association table as a relational representation, you might want to apply the filter condition to the association table itself or to the target entity table. To apply the constraint on the target entity, use the regular @Filter annotation. However, if you want to target the association table, use the @FilterJoinTable annotation.

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 the <filter-def/> element within a <hibernate-mapping/> element:

This filter can then be attached to a class or collection (or, to both or multiples of each at the same time):

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 的其他部分也大多有这个特性。

下面是一个比较完整的例子，使用了记录生效日期模式过滤有时效的数据：

<filter-def name="effectiveDate">

    <filter-param name="asOfDate" type="date"/>

</filter-def>



<class name="Employee" ...>

...

    <many-to-one name="department" column="dept_id" class="Department"/>

    <property name="effectiveStartDate" type="date" column="eff_start_dt"/>

    <property name="effectiveEndDate" type="date" column="eff_end_dt"/>

...

    <!--

        Note that this assumes non-terminal records have an eff_end_dt set to

        a max db date for simplicity-sake

    -->

    <filter name="effectiveDate"

            condition=":asOfDate BETWEEN eff_start_dt and eff_end_dt"/>

</class>



<class name="Department" ...>

...

    <set name="employees" lazy="true">

        <key column="dept_id"/>

        <one-to-many class="Employee"/>

        <filter name="effectiveDate"

                condition=":asOfDate BETWEEN eff_start_dt and eff_end_dt"/>

    </set>

</class>

定义好后，如果想要保证取回的都是目前处于生效期的记录，只需在获取雇员数据的操作之前先开启过滤器即可：

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 定义之后,它可能被附加到多个实体和/或集合类,每个都有自己的条件。假若这些条件都是一样的，每次都要定义就显得很繁琐。因此，<filter-def/> 被用来定义一个默认条件，它可能作为属性或者 CDATA 出现：

<filter-def name="myFilter" condition="abc > xyz">...</filter-def>

<filter-def name="myOtherFilter">abc=xyz</filter-def>

当这个 filter 被附加到任何目的地，而又没有指明条件时，这个缺省条件就会被使用。注意，换句话说，你可以通过给 filter 附加特别的条件来重载默认条件。