ExtremeTable使用指南：定制FilterRowsCallback

1. 引言

FilterRowsCallback被用来过滤传给eXtremeTable的Beans的Collection。 FilterRowsCallback的默认实现是得到Beans或Maps的Collection，然后通过实现jakarta Predicate接口来进行过滤。当然，如果你需要进行一些定制你可以插接自己的实现。

首先声明，本示例代码包含一些从原包中剪切、粘贴的代码(虽然不是很多)。在最初的最终发行包之后，值过滤得到进一步改善使得更具复用性并更容易实现，可能和定制cell代码行数相同。当然，我被要求并非常乐意示范如何在当前代码基础上实现定制过滤。这有非常清晰的hooks实现，并且很容易实现。

本示例示范了如何调整代码为过滤器提供一个精确的比较功能。当前的实现是通过使用StringUtils.contains()方法进行模糊比较。 本示例将使用StringUtils.equals()方法。你可以按照你的需要来调整代码进行更多定制。
1.1. 定制FilterRowsCallback示例

首先你需要做的是创建一个实现Predicate接口的定制类。Predicate要求我们实现evaluate()方法来判断是否包含当前bean。因为你仅仅调整现在已有的功能，首先得到filterPredicate的源代码（在发行包的callback包下），拷贝到你的工程里。然后向下面展示的一样将 StringUtils.contains()方法修改为StringUtils.equals()方法：

public final class ExactMatchFilterPredicate implements Predicate {
    private boolean isSearchMatch(String value, String search) {
       
        ...

        else if (StringUtils.equals(value, search)) {
            return true;
        }

        ...

    }
}

然后我们需要实现和Predicate共同作用的FilterRowsCallback接口。再一次从发行包的callback包下拷贝 ProcessRowsCallback源代码到你的工程里。 请参照我们创建的定制的ExactMatchFilterPredicate 类来确认仅仅实现了FilterRowsCallback和修改Predicate。

public class ExactMatchFilterRows implements FilterRowsCallback {
    public Collection filterRows(TableModel model, Collection rows) throws Exception {
        
        ...
        ...

    }
}

为了使用这个FilterRowsCallback你应该在Preferences中声明一个别名。当然，你可以省略这步而在JSP中提供这个FilterRowsCallback实现类的全路径，但是使用Preferences更简洁。

table.filterRowsCallback.exactMatch=org.extremesite.callback.ExactMatchFilterRows

在TableTag通过设置filterRowsCallback属性来使用ExactMatchFilterRows。

<ec:table filterRowsCallback="exactMatch"/>

如果不清楚Preferences和ColumnTag定义语法请参考Preferences指南。
Retrieved from "http://extremecomponents.org/wiki/index.php/Simplified_Chinese_Tutorials_FilterRowsCallback"