幸せのちから

平凡的世界
看似平常实崎岖
成如容易却艰辛

Limit指南

Limit指南


1. 引言

在你需要处理大量数据时你应该考虑使用eXtremeTable的Limit特性。Limit这个名字来自MySQL的limit 命令,Limit接口的目的就是如何对表的结果集进行limit处理。Limit实现知道当排序、过滤、分页、导出时,用户如何与表互相作用。有了这些信息你 将能够使用可能是最有效的方式显示正确的过滤、排序后的请求页面。

为了示范Limit特性,我将要做的工作将分解为JSP、Controller、Service和DAO。这示范了一种使用分层的方式来处理 Limit。你可以根据自己的需要来增加或减少层。本示例也使用了Spring框架来重新得到使用Spring的JDBC取得的数据,因此你的代码看起来可能有点不同。eXtremeTable的一个特点就是不依赖任何框架和容器。

1.1. JSP

为了使用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条数据,以此类推。在经过一段时间分页后,他们常常使用过滤来提炼数据。 即使他们不这样做,他们也必须在此之前对大量的数据进行分页,这将影响效率。当然如果允许用户点击最后页,那么所有的数据都将被取出,这将非常影响效率。

1.2. Controller

提示: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));

1.3. Service

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

1.3.1. 取得总行数

controller需要到第一条信息就是总行数。

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;
}

service和dao一起来过滤结果集,它的工作方式是在Where语句后面增加更多的AND语句来修改查询字符串。为此,你需要和Limit FilterSet一起工作。

FilterSet是一个过滤器对象数组,一个过滤器包括一个bean property和这个过滤器的值。或者,简单的说就是用户想要过滤的行和他们输入的值。这使得它非常容易交互。service只需要迭代所有的 FilterSet并调用dao来拼接查询语句。(译者注:过滤的实现方式是:在Where后面增加And语句来改变查询语句以达到对数据进行过滤的效果)

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;
}

query修改包括了filter信息,总行数。在一些情况下这就足够,但是当用户导出数据时仍然存在一个潜在的问题。为了保持高效 service不允许导出超出一个最大行数的数据。

1.3.2. 取得Collection

controller需要到第二条信息就是Collection。

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);
}

和前面一样,service和dao一起来过滤结果集。

另外query字符串需要扩展ORDER BY语句以便数据按照正确的方式进行排序。Sort包含一个bean property和 sortOrder值(正序还是逆序)。service仅仅需要使用Sort来调用dao。

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);
}

query字符串最后需要的修改就是增加数据库特别的指令来limit将要被返回的结果集。这就是limitQuery() 方法的作用。

1.4. DAO

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

1.4.1. 定义Query字符串

为了真正理解dao,query字符串需要被展示。

这就是得到数据的presidents query字符串:

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 ";

这是得到总行数的query字符串:

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

1.4.2. Filter 和 Sort Query 字符串

两个最有趣的方法就是过滤和排序。

filter看起来像这样:

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();
}

filterQuery()方法需要增加正确的AND语句到query字符串。

sort看起来非常类似:

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();
}

sortQuery()方法需要增加正确的ORDER BY语句到query字符串。

1.4.3. Limit Query String

现在query字符串修改能够正确的进行filter和sort,它还需要修改以便只取页面显示相关的数据。MySQL为s the limit命令。

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

1.4.4. 取回总行数和Collection.

service需要的唯一东西就是:总行数和Collection。

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);
}

ResultReader是一个帮助处理JDBC查询的Spring特殊类,作为一个callback来处理JDBC ResultSet。jdbcTemplate是对JDBC连接的抽象。

1.4.5. 默认的Sort顺序

最后,这是service需要的默认sort顺序:

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

posted on 2006-02-23 10:34 Lucky 阅读(2056) 评论(8)  编辑  收藏 所属分类: extremeComponents

评论

# re: Limit指南 2006-05-16 13:48 悠哥

版本:eXtremeComponents-1.0.1-RC2
环境:JSF

文件:departments.jsp
<f:view>
<f:loadBundle var="text" basename="#{departmentList.bundleName}"/>
<h:form id="editDepartment">
<ec:table
items="departmentList.departments"
action="${pageContext.request.contextPath}/hr/departments.html"
imagePath="${pageContext.request.contextPath}/images/table/*.gif"
title="${text['userList.title']}"
rowsDisplayed="10"
form="editDepartment" var="department"
retrieveRowsCallback="limit"
filterRowsCallback="limit"
sortRowsCallback="limit"
view="limit"
autoIncludeParameters="false">
<ec:row highlightRow="true">
<ec:column title="${text['department.name']}" property="name"/>
</ec:row>
</ec:table>
</h:form>
</f:view>

文件:DepartmentList.java
public List getDepartments() {
Context context = new HttpServletRequestContext(getRequest());
LimitFactory limitFactory = new TableLimitFactory(context);
Limit limit = new TableLimit(limitFactory);

//int pageSize = limit.getCurrentRowsDisplayed();
//可能是一个bug,生成 limit 的时候,并没有给 currentRowsDisplayed 赋值
int pageSize = limitFactory.getCurrentRowsDisplayed(0, 10);

FilterSet filter = limit.getFilterSet();

Page page = new PageHibernate(limit.getPage(), pageSize);
page.setFilters(FilterUtil.convert(filter));

page = departmentManager.getDepartments(page);

List list = page.getThisPageElements();

limit.setRowAttributes(page.getTotalNumberOfElements(), page.getPageSize());

getRequest().setAttribute("totalRows", new Integer(page.getTotalNumberOfElements()));
return list;
}

结果:
1.从limit中取不到pagesize,可能是一个bug,跟踪TableLimit原码,初始化的时候,并没有给 currentRowsDisplayed 赋值
2.没有显示“最后一页”,这个按钮  回复  更多评论   

# re: Limit指南 2006-05-16 14:03 悠哥

3.不能生成 excel 文件  回复  更多评论   

# re: Limit指南 2006-05-16 14:14 xplucky

我没用过JSF,你可以sina的免费邮箱中找到extremesite实例,用户名、密码: extremetable。  回复  更多评论   

# re: Limit指南 2006-09-20 20:56 Jkallen

呵呵 我正在看英文的tutoails而头疼呢!

支持!以后常来  回复  更多评论   

# re: Limit指南 2006-09-20 21:03 Jkallen

对了,这个ResultReader是spring哪个版本的啊?

现在我们公司的都是:
ecTableRowMapper implements RowMapper
这样来将resultset中的结果放到map中(当然也可以放到一个DTO中)  回复  更多评论   

# re: Limit指南 2006-10-16 18:23 孙建彬

在创建limit之前:
你是在哪里定义defaultRowsDisplayed的,然后怎么样取得的?
发个e-mail:volcano_hosan@sina.com,多谢!  回复  更多评论   

# re: Limit指南 2006-10-17 16:23 sLAmbBkiNg

如何解决使用LIMIT后“最后一页”按钮不显示问题?
M5版本据说解决了导出EXCEL和PDF中文文件名问题,M5版本在哪里下载?
BLOG上的连接不能下  回复  更多评论   

# re: Limit指南 2007-07-20 10:25 assd

去掉页面中的 view="limit"  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 
<2006年9月>
272829303112
3456789
10111213141516
17181920212223
24252627282930
1234567

导航

随笔分类(125)

文章分类(5)

日本語

搜索

积分与排名

最新随笔

最新评论