通常你只需要为过滤器cell实现Cell接口。然而，因为我们要创建的过滤器cell是一个下拉列表，我们可以通过扩展 FilterDroplistCell来获得它已经提供的很多功能，FilterDroplistCell是发行包已经提供的cells之一。

我们需要覆盖FilterDroplistCell的唯一方法是getFilterDropList()。这是整个类的全部代码：

public class FilteredDroplistCell extends FilterDroplistCell {
    private static Log logger = LogFactory.getLog(FilterDroplistCell.class);
    
    protected List getFilterDropList(TableModel model, Column column) {
        List droplist = new ArrayList();
        
        String firstNameFilter = model.getLimit().getFilterSet().getValue("firstName");

        Collection beans = model.getCollectionOfBeans();
        for (Iterator iter = beans.iterator(); iter.hasNext();) {
            Object bean = iter.next();
            try {
                String firstName = BeanUtils.getProperty(bean, "firstName");
                if (StringUtils.isNotBlank(firstNameFilter) && !firstName.equals(firstNameFilter)) {
                    continue;
                }

                String lastName = BeanUtils.getProperty(bean, column.getProperty());
                if ((lastName != null) && !droplist.contains(lastName)) {
                    droplist.add(lastName);
                }
            } catch (Exception e) {
                logger.debug("Problems getting the droplist.", e);
            }
        }

        Collections.sort(droplist);

        return droplist;
    }
}

如果你比较这个类和父类，你会发现它们只有微小的区别。

首先需要注意的是我们需要找出first name是否已经被过滤了。

String firstNameFilter = model.getLimit().getFilterSet().getValue("firstName");

然后我们需要判断当前bean的first name值是否和first name过滤器值相同。如果相同，将当前的last name值 添加到droplist中。

String firstName = BeanUtils.getProperty(bean, "firstName");
if (StringUtils.isNotBlank(firstNameFilter) && !firstName.equals(firstNameFilter)) {
    continue;
}

如果last name将添加到droplist中，我们需要检查droplist中是否已经包含了这个值。如果没有，我们就把它添加到droplist中。

String lastName = BeanUtils.getProperty(bean, column.getProperty());
if ((lastName != null) && !droplist.contains(lastName)) {
    droplist.add(lastName);
}

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

column.filterCell.filteredDroplist=org.extremesite.cell.FilteredDroplistCell

在ColumnTag通过设置filterCell属性来使用FilteredDroplistCell。

<ec:column property="lastName" filterCell="filteredDroplist"/>

如果不清楚Preferences和ColumnTag定义语法请参考Preferences指南。

首先你需要做的是创建一个实现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 {
         
        ...
        
        if (filtered) {
            Collection collection = new ArrayList();
            Predicate filterPredicate = new ExactMatchFilterPredicate(model);
            CollectionUtils.select(rows, filterPredicate, collection);

            return collection;
        }

        ...

    }
}

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

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

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

<ec:table filterRowsCallback="exactMatch"/>

如果不清楚Preferences和ColumnTag定义语法请参考Preferences指南。

下面列出的是checkbox示例的完整代码。想要强调的主要事情是表标签form属性设置为presForm，它参照被称为presForm的form元素。

同时请注意表标签的autoIncludeParameters属性。进行排序、过滤、分页时，默认的eXtremeTable将保持所有传至JSP页面的参数。 这个特性对于内部其他的form进行排序、过滤、分页时，用于高效复制form元素同样有效。可以设置 autoIncludeParameters属性为false来固定它。

在这个form使用id属性是因为xhtm标准的要求，同时你也可以使用form的name属性。

<form id="presForm" action="<c:url value="selectedPresidentsListedController.run"/>" method="post">

 Enter your name: 
 <input 
  type="text" 
  name="userName" 
  style="font-family:verdana,arial,helvetica,sans-serif;font-size:11px;"
  value="<c:out value="${param.userName}"/>"
  />

 <ec:table 
  items="presidents"
  action="${pageContext.request.contextPath}/selectedPresidentsController.run"  
  view="compact"
  imagePath="${pageContext.request.contextPath}/images/table/compact/*.gif"
  rowsDisplayed="8"
  autoIncludeParameters="false"
  form="presForm"
  >
  <ec:exportPdf 
    fileName="output.pdf" 
    tooltip="Export PDF" 
    headerColor="black" 
    headerBackgroundColor="#b6c2da" 
    headerTitle="Presidents"
   />
  <ec:row>
   <ec:column 
      alias="checkbox"
      title=" " 
      width="5px" 
      filterable="false" 
      sortable="false" 
      viewsAllowed="compact"
      cell="selectedPresident"
      />
   <ec:column property="fullName" title="Name"/>
   <ec:column property="nickName" />
   <ec:column property="term" />
  </ec:row>
 </ec:table>

 <input
     type="button"
     name="sel"
     class="button"
     value="List Selected Presidents"
     onclick="document.forms.presForm.submit();"
     />

   <script type="text/javascript">
   function setPresidentState(chkbx) {
    //make sure that always know the state of the checkbox
    if (chkbx.checked) {
     eval('document.forms.presForm.chkbx_' + chkbx.name).value='SELECTED';
    } else {
     eval('document.forms.presForm.chkbx_' + chkbx.name).value='UNSELECTED';
    }
   }
   </script>

</form>

column.cell.selectedPresident=org.extremesite.cell.SelectedPresidentCell

<ec:column 
      alias="checkbox"
      title=" " 
      width="5px" 
      filterable="false" 
      sortable="false" 
      viewsAllowed="compact"
      cell="org.extremesite.cell.SelectedPresidentCell"
      />

定制的cell被用来生成checkbox，另外它也创建一个隐藏元素用来表示这个checkbox元素是否被选中。 当用户进行排序、过滤、分页时，被选中的数据集合将被放到session里。

getExportDisplay()方法没有返回值，因为治理只需要Html显示。

public class SelectedPresidentCell implements Cell {
  public String getExportDisplay(TableModel model, Column column) {
      return null;
  }

  public String getHtmlDisplay(TableModel model, Column column) {
      HtmlBuilder html = new HtmlBuilder();
      
      CellBuilder.tdStart(html, column);
      
      try {
          Object bean = model.getCurrentRowBean();
          String presidentId = BeanUtils.getProperty(bean, "presidentId");
          
          Collection selectedPresidentsIds = (Collection)model.getContext().getSessionAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS);
          if (selectedPresidentsIds != null && selectedPresidentsIds.contains(presidentId)) {
              html.input("hidden").name("chkbx_" + presidentId).value(SelectedPresidentsConstants.SELECTED).xclose();
              html.input("checkbox").name(BeanUtils.getProperty(bean, "presidentId"));
              html.onclick("setPresidentState(this)");
              html.checked();
              html.xclose();
          } else {
              html.input("hidden").name("chkbx_" + presidentId).value(SelectedPresidentsConstants.UNSELECTED).xclose();
              html.input("checkbox").name(BeanUtils.getProperty(bean, "presidentId"));
              html.onclick("setPresidentState(this)");
              html.xclose();
          }
      } catch (Exception e) {}
      
      CellBuilder.tdEnd(html);
      
      return html.toString();
  }
}

提示：Spring框架的Controller和Struts框架的Action非常相像。

当在另外的form中使用eXtremeTable时，你可能有1个或2个controllers。当form被提交时，你需要一个controller 来处理用户的输入并重新定向到另外的JSP页面。当排序、过滤、分页时，你可能有另外的controller来得到表使用的数据集合并重定向会本页。或者你可以在同一个controller中分别处理。

checkbox示例里我使用一个controller来关联表标签的action属性。我也使用另外一个controller来关联form元素的动作。

SelectedPresidentsUtils.saveSelectedPresidentsIDs(request);
Collection presidents = presidentsService.getPresidents();
request.setAttribute("presidents", presidents);

Collection selectedPresidentsIds = SelectedPresidentsUtils.saveSelectedPresidentsIDs(request);
Collection selectedPresidents = SelectedPresidentsUtils.getSelectedPresidents(presidentsService.getPresidents(), selectedPresidentsIds);
request.setAttribute("selected", selectedPresidents);
request.getSession().removeAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS);

public static Collection saveSelectedPresidentsIDs(HttpServletRequest request) {
    Collection presidents = (Collection) request.getSession().getAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS);
    
    if (presidents == null) {
        presidents = new ArrayList();
        request.getSession().setAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS, presidents);
    }

    Enumeration parameterNames = request.getParameterNames();
    while (parameterNames.hasMoreElements()) {
        String parameterName = (String) parameterNames.nextElement();
        if (parameterName.startsWith("chkbx_")) {
            String presidentId = StringUtils.substringAfter(parameterName, "chkbx_");
            String parameterValue = request.getParameter(parameterName);
            if (parameterValue.equals(SelectedPresidentsConstants.SELECTED)) {
                if (!presidents.contains(presidentId)) {
                    presidents.add(presidentId);
                }
            } else {
                presidents.remove(presidentId);
            }
        }
    }

    return presidents;
}

实现View接口的类有3次插入内容的机会。beforeBody()方法会被立刻调用，body()方法在每一行的每一列处理的时候调用。 afterBody()方法是被eXtremeTable调用的最后方法，它将返回代表视图的一个对象。在这个HTML视图示例里，它将是一个字符串。

public interface View {
    public void beforeBody(TableModel model);
    public void body(TableModel model， Column column);
    public Object afterBody(TableModel model);
}

在这篇指南里我将直接修改工具条来实现这网站上Messages示例的定制视图。

public class MessagesView extends AbstractHtmlView { 
    protected void toolbar(TableModel model) {
        TwoColumnTableLayout toolbar = new MessagesToolbar();
        toolbar.layout(getHtmlBuilder()， model);
    }

    protected void statusBar(TableModel model) {
        TwoColumnRowLayout statusBar = new MessagesStatusBar();
        statusBar.layout(getHtmlBuilder()， model);
    }
}

这里使用的是默认视图，因此它扩展了虚拟视图来修改工具条和状态条。如何修改工具条和（或）状态条也是开发人员问的最多问题。

默认视图的工具条位于表的上方包括翻页链接和标题。工具条使用TwoColumnTableLayout，它是一个用于提供在自己表中实现左右两列布局的虚拟类。 它将实现能够浮在表上方的完美布局。下面就是你需要关心的虚拟方法，在实际的html视图中已经为你完成了这个布局。

public abstract class TwoColumnTableLayout {
    protected abstract boolean showLayout(TableModel model);
    protected abstract void columnLeft(HtmlBuilder html， TableModel model);
    protected abstract void columnRight(HtmlBuilder html， TableModel model);
}

showLayout()方法用来阻止或导致布局的展现。在我的定制视图中如果翻页或（和）导出显示那么工具条将展现。

protected boolean showLayout(TableModel model) {
    boolean showPagination = BuilderUtils.showPagination(model);
    boolean showExports = BuilderUtils.showExports(model);
    if (!showPagination && !showExports) {
        return false;
    }

    return true;
}

下面显示了左列和右列的部分代码。注意在我的定制视图中首页和前一页使用了文字来替代图片显示。我真正希望示范的是你需要做的：找到正确的构造器类并且仅仅是扩展HtmlBuilder的标签。 构造器类对于示范如何找到模型里的信息（以便你能够做比他们能够提供的更多的定制工作）也非常有用，。

protected void columnLeft(HtmlBuilder html， TableModel model) {
   html.td(2).close();
   TableBuilder.title(html， model);
   html.tdEnd();
}

protected void columnRight(HtmlBuilder html， TableModel model) {
    boolean showPagination = BuilderUtils.showPagination(model);
    ...
    if (showPagination) {
        html.td(4).close();
        ToolbarBuilder.firstPageItemAsText(html， model);
        html.tdEnd();

        html.td(4).close();
        ToolbarBuilder.prevPageItemAsText(html， model);
        html.tdEnd();
        ...
    }
    ...
}

为了使用这个视图你需要在Preferences定义一个别名。 你可以省略这部而在JSP直接给出这个视图的完整有效的类名，不过Preferences更为简洁。

table.view.messages=org.extremesite.view.MessagesView

TableTag也将设置视图属性来使用MessagesView视图。

<ec:table view="messages">

如果不清楚Preferences和TableTag定义语法请参考Preferences指南。

下面列出了具有拦截特性的标签和他们需要被实现的接口，Bean栏显示了被模型创建的Bean。

示范拦截特性的完美示例就是根据一定的标准来对行进行高亮显示，这也是我们将要完成的示例。它很短也很简单，不过它实现的概念同样适用于每一个拦截器接口。

我们需要做的第一件事就是实现InterceptRow接口。你会注意到这个接口有两个方法：addRowAttributes() 和modifyRowAttributes()。addRowAttributes方法在行bean创建的时候被调用， modifyRowAttributes方法在表处理当前页面行的时候被调用。

public class MarkerIntercept implements InterceptRow {
    public void addRowAttributes(TableModel tableModel, Row row) {
    }

    public void modifyRowAttributes(TableModel model, Row row) {
        President president = (President) model.getCurrentRowBean();
        String career = president.getCareer();
        if (StringUtils.contains(career, "Soldier")) {
            row.setStyle("background-color:#fdffc0;");
        } else {
            row.setStyle("");
        }
    }
}

在Preferences里你应该定义这个行拦截器的别名。

row.intercept.marker=org.extremesite.intercept.MarkerIntercept

这样就可以在行标签中使用拦截器MarkerIntercept了。

<ec:row intercept="marker">

如果不清楚Preferences和TableTag定义语法请参考Preferences指南。

为了使用Limit特性，eXtremeTable需要使用limit特定的RetrieveRowsCallback、 FilterRowsCallback和SortRowsCallback接口。eXtremeComponents提供了每个接口的一个实现，可以简单地通过设置每个属性值为limit来简单来使用。

<ec:table 
   items="presidents"
   retrieveRowsCallback="limit"
   filterRowsCallback="limit"
   sortRowsCallback="limit"
   view="limit"
   >
...

另外视图属性参照一个名为limit的定制视图。这是一个简单修改默认eXtremeTable视图，不包含最后页工具条的实现。这仅仅关系到你是否能取得确切需要的行。 一些数据库例如Oracle和MySQL都提供了一种得到确定行的特性，但是，其他的数据库例如：Sybase没有提供特性。在我的示例中我考虑最坏的情况你的数据库不支持这种特性。

即使你的数据库不提供取得特定行的特性，当你考虑用户如何和表协同工作时，Limit仍然非常有意义。用户通常会对一些数据进行排序、过滤和分页。 这个例子中15条数据构成一页，第一页需要15条数据，第二页需要30条数据，第三页需要45条数据，以此类推。在经过一段时间分页后，他们常常使用过滤来提炼数据。 即使他们不这样做，他们也必须在此之前对大量的数据进行分页，这将影响效率。当然如果允许用户点击最后页，那么所有的数据都将被取出，这将非常影响效率。

提示：Spring框架的Controller和Struts框架的Action非常相像。

controller首先需要创建一个Limit。为了完成这个你需要得到一些关于Context和LimitFactory的帮助。

Context context = new HttpServletRequestContext(request);
LimitFactory limitFactory = new TableLimitFactory(context);
Limit limit = new TableLimit(limitFactory);

Context是一个处理取得属性的接口，LimitFactory使用Context来找出用户如何和eXtremeTable交互。 然后Limit使用LimitFactory来组装自己。

为了初始化Limit，它将包含所有的有用的信息。这些信息包括数据将被如何排序和过滤，哪一页将被显示和是否允许被导出。

然而，Limit仍然需要得到行的信息，这样正确的信息页面才能被显示给用户。行信息包括开始行、结束行、当前显示行。 controller必须从service得到这些信息，而Service将从dao中得到这些信息。这里我只给出Controller端的代码。

int totalRows = presidentsService.getTotalPresidents(limit.getFilterSet(), limit.isExported());
limit.setRowAttributes(totalRows, defaultRowsDisplayed);

limit需要得到所有的行来得到行的信息。service需要知道那些被过滤，不管这些数据是否要导出。为了设置行信息，默认的一页显示的行数需要被设置。 这可以通过对TableTag的rowsDisplayed属性设置一个确定的数值来实现。

现在我们只需要从services得到Collection数据。

Collection presidents = presidentsService.getPresidents(limit.getFilterSet(), limit.getSort(), limit.getRowEnd());

因为limit已经包含所有信息，这将十分容易。所有需要做的就是传入过滤器，排序和最后行的信息。 最后要做的是将Collections和totalRow这些信息传送回JSP以便eXtremeTable知道如何显示这些信息。

request.setAttribute("presidents", presidents);
request.setAttribute("totalRows", new Integer(totalRows));

service需要和dao进行交互来得到总行数和Collection。

public int getTotalPresidents(FilterSet filterSet, boolean isExported) {
    String totalQuery = presidentsDao.getTotalPresidentsQuery();
    String modTotalQuery = filterQuery(filterSet, totalQuery);
    int totalRows = presidentsDao.getTotalPresidents(modTotalQuery);
    if (isExported && totalRows > maxExportRows) {
        totalRows = maxExportRows;
    }
    return totalRows;
}

private String filterQuery(FilterSet filterSet, String query) {
    if (!filterSet.isFiltered() || filterSet.isCleared()) {
        return query;
    }
    
    Filter filters[] = filterSet.getFilters();
    for (int i = 0; i < filters.length; i++) {
        Filter filter = filters[i];
        String property = filter.getProperty();
        String value = filter.getValue();
        query = presidentsDao.filterQuery(query, property, value);
    }

    return query;
}

public Collection getPresidents(FilterSet filterSet, Sort sort, int rowEnd) {
    String patientsQuery = presidentsDao.getPresidentsQuery();
    String modPatientsQuery = filterQuery(filterSet, patientsQuery);
    modPatientsQuery = sortQuery(sort, modPatientsQuery);
    modPatientsQuery = presidentsDao.limitQuery(rowEnd, modPatientsQuery);
    return presidentsDao.getPresidents(modPatientsQuery);
}

private String sortQuery(Sort sort, String query) {
    if (!sort.isSorted()) {
        String defaultSortOrder = presidentsDao.getDefaultSortOrder();
        if (StringUtils.isNotBlank(defaultSortOrder)) {
            return query + defaultSortOrder;
        }
        
        return query;
    }

    String property = sort.getProperty();
    String sortOrder = sort.getSortOrder();
    
    return presidentsDao.sortQuery(query, property, sortOrder);
}

dao为service负责底层数据工作。

private final static String presidentsQuery = 
        " SELECT " +
        "    president_id presidentId, " + 
        "    first_name firstName, " +
        "    last_name lastName, " +
        "    nick_name nickName,  " +
        "    concat(first_name, ' ',last_name) fullName, " +
        "    term,  " +
        "    born,  " +
        "    died,  " +
        "    education, " + 
        "    career,  " +
        "    political_party politicalParty " +
        " FROM presidents ";

private final static String totalPresidentsQuery = 
        " SELECT count(*) FROM presidents ";

public String filterQuery(String query, String property, String value) {
    StringBuffer result = new StringBuffer(query);

    if (query.indexOf("WHERE") == -1) {
        result.append(" WHERE 1 = 1 "); //stub WHERE clause so can just append AND clause
    }
        
    if (property.equals("fullName")) {
        result.append(" AND concat(first_name, ' ',last_name) like '%" + value + "%'");
    } else if (property.equals("nickName")) {
        result.append(" AND nick_name like '%" + value + "%'");
    } else {
        result.append(" AND " + property + " like '%" + value + "%'");
    }
        
    return result.toString();
}

public String sortQuery(String query, String property, String sortOrder) {
    StringBuffer result = new StringBuffer(query + " ORDER BY ");
        
    if (property.equals("fullName")) {
        result.append("concat(first_name, ' ',last_name) " + sortOrder);
    } else {
        result.append(property + " " + sortOrder);
    }

    return result.toString();
}

public String limitQuery(int rowEnd, String query) {
    return query + " limit " + rowEnd;
}

public Collection getPresidents(final String query) {
    return jdbcTemplate.query(query, new ResultReader() {
        List results = new ArrayList();
         public List getResults() {
            return results;
        }

        public void processRow(ResultSet rs)
                throws SQLException {
            President president = new President();
            president.setPresidentId(new Integer(rs.getInt("presidentId")));
            president.setFirstName(rs.getString("firstName"));
            president.setLastName(rs.getString("lastName"));
            president.setNickName(rs.getString("nickName"));
            president.setFullName(rs.getString("fullName"));
            president.setTerm(rs.getString("term"));
            president.setBorn(rs.getDate("born"));
            president.setDied(rs.getDate("died"));
            president.setEducation(rs.getString("education"));
            president.setCareer(rs.getString("career"));
            president.setPoliticalParty(rs.getString("politicalParty"));
            results.add(president);
        }
    });        
}

public int getTotalPresidents(final String query) {
    return jdbcTemplate.queryForInt(query);
}

public String getDefaultSortOrder() {
    return " ORDER BY concat(first_name, ' ', last_name) ";        
}

下面列出的是可以在Preferences中申明的所有接口。Tag列展示的是eXtremeTable的标签，Attribute 列展示的是相关标签的对应属性。Interface列展示的是需要被实现的Java接口。Preference Key列展示的是 Preferences里对应的健。

提示：当在写作本指南的时候，我意识到我忘记了让标签ColumnsTag的autoGenerateColumns 属性和Preferences协同工作。这将在下一版修正。

上表展示了如何声明preference键，但是没有解释如何指定有意义的别名。如果你注意到preference键提供了一致的语法 tag.attribute，指定键的别名仅仅是在它的基础上进行扩展。它的语法为： tag.attribute.alias。

eXtremeTable提供了一个名为RowCountCell定制的cell，它的作用是现实当前的行数。我将在Preferences里使用ColumnTag cell声明来示范RowCountCell的使用。

首先通过实现Cell接口或者扩展AbstractCell来编写具体的实现类。

public class RowCountCell extends AbstractCell {
    protected String getCellValue(TableModel model, Column column) {
        int rowcount = ((model.getLimit().getPage() - 1) 
                * model.getLimit().getCurrentRowsDisplayed()) 
                + model.getRowHandler().getRow().getRowCount();
        return String.valueOf(rowcount);
    }
}

然后在Preferences (属性文件)进行声明并给出别名。eXtremeTable在一个Preferences里保存所有的配置信息，你可以通过使用本地 Preferences的来覆盖任何的这些属性。

RowCountCell默认的别名是rowCount：

column.cell.rowCount=org.extremecomponents.table.cell.RowCountCell

在ColumnTag中通过别名引用Cell：

<ec:column alias="count" cell="rowCount"/>

现在你可以通过rowCount来引用这个Cell，如果包名改变了你只需要对Preferences进行修改。

提示：本示例中我使用了ColumnTag的别名属性。别名属性应用在有两列使用同样的property，也应用在列不直接和列的 bean property关联的情况下。本示例就属于这种情况。