通常你只需要为过滤器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="http://blog.techweb.com.cn/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="http://blog.techweb.com.cn/${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关联的情况下。本示例就属于这种情况。