eXtremeComponents的eXtremeTable分页特性

下面是我使用的例子：

<ec:table items="users" var="user" action="" imagePath="${ctx}/widgets/extremecomponents/images/table/zh_CN/*.gif" cellpadding="1" title="用户名" 
 locale="zh_CN" rowsDisplayed="10"> 
     <ec:exportXls fileName="UserList.xls" tooltip="Export Excel"/>
     <ec:exportPdf fileName="UserList.pdf" tooltip="输出PDF文件" headerColor="blue" headerBackgroundColor="blue" headerTitle="人员表"/> 
   <ec:exportCsv fileName="UserList.txt" tooltip="输出CSV文件" delimiter="|"/> 

   <ec:row>
    <ec:column property="rowcount" cell="rowCount" sortable="false" title=" No." width="50"/>
    <ec:column property="username" title="姓 名" width="200"/>
    <ec:column property="firstName"  title="firstName" width="200"/>
    <ec:column property="lastName"  title="lastName" width="200"/>
   </ec:row>
  </ec:table>

Action

import java.util.List;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import com.ygsoft.propertyright.service.UserManager;
import com.ygsoft.propertyright.webapp.util.BeanUtil;

public class TestAction extends BaseAction ...{
    UserManager userManager = (UserManager)BeanUtil.getBean("userManager");
    
    public ActionForward testPage(ActionMapping mapping, ActionForm form, 
            HttpServletRequest request, HttpServletResponse response) throws Exception ...{
        List users = getUsers();
        request.setAttribute("users", users);
        return mapping.findForward("test");
    }

    public List getUsers() throws Exception ...{
                 return userManager.getUsers(null);    
                     }
}

              其中ecoAttrs是一个collection（List），放入pojo。action里面写你这个页面的访问方法（如我的页面是一个action，其他的如.do或者.jsp什么的都可以）。rowsDisplayed是默认显示条数，它可以自动实现分页。
下面的三个<ec:export>是导出三种格式用的，不用的话可以不写（写了需要在web.xml配置相应的filter）。
<ec:column>里面放属性，property指向pojo的相应属性，而title是表头显示的信息，这个标签需要用<ec:row>包起来（1.0.1 m4以后）

这里有一套中文图标：
http://tiny.51.net/extremecomponent/zh_CN.rar

web.xml配置

<filter> 
     <filter-name>eXtremeExport</filter-name> 
    <filter-class> org.extremecomponents.table.filter.ExportFilter </filter-class> 
</filter> 

<!-- 输出excel,pdf,csv的时候用 -->
<filter-mapping> 
<filter-name>eXtremeExport</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


<!-- 其实这个配置可不要，已经在放在jar里面了loading的时候自动会加进来- -->
<taglib> 
<taglib-uri>/extremecomponents</taglib-uri> 
<taglib-location>/WEB-INF/tld/extremecomponents.tld</taglib-location>
<!--tld拷贝到相应目录去-> 
</taglib> 

中文问题

export里面的excel和pdf默认不支持中文，需要手工修改源码，excel的比较简单：
修改org.extremecomponents.table.view.XlsView.java（我指的是1.0.1-M4-A14的相应代码）
102行：
HSSFCell hssfCell = hssfRow.createCell(cellnum);
hssfCell.setEncoding(HSSFCell.ENCODING_UTF_16);（就是添加这一行）
122行：
HSSFCell cell = row.createCell(cellnum);
cell.setEncoding(HSSFCell.ENCODING_UTF_16);（就是添加这一行）
这个在使用UTF-8时工作正常。如果其他Unicode环境可以尝试HSSFCell.ENCODING_COMdivSSED_UNICODE。

编译后将对应.class放到WEB-INF/classes相应目录就可以了。

pdf view的比较麻烦，还没尝试，解决方法参照这个帖子：
http://extremecomponents.org/forum/viewtopic.php?t=139&highlight=chinese+filter
http://www-128.ibm.com/developerworks/cn/xml/x-ospdf/index.html

以使用Struts为例,说明一下如何使用eXtremeTable的分页特性

 

   这一切都可以在Action中完成,在Action会用到JSP中eXtremeTable的table标签的属性'tableId' 和'item','tableId'用于完成eXtremeTable的分页,'item'用于返回你分页的结果集,不多不少,刚好是你需要查看的那一页的结果集,比如说,你一页是10条记录,那你访问第20页的时候,'item'的结果集就只有第201条到第210条记录.还有就是在request中加入totalRows的属性,表示本次查询结果的数量

另外,JSP的中,eXtremeTable的table标签要retrieveRowsCallback属性,将该属性设为 org.extremecomponents.table.callback.LimitCallback,这是它默认的分页回调类,你也可以写自已的回调类.设置了该默认的回调类以后,你在Action里就需要向request加入totalRows属性,值为你的查询结果总记录数,这样才会产生翻页的效果.

现在就你的DisplayAction中加分页的特性了,如下:

Limit limit = LimitFactory.createInstanceOfLimit(request, TABLEID);
LimitFactory.setLimitPageAndRowAttr(limit,PAGE_SIZE,TOTAL_SIZE);

这里的TABLEID就是JSP页上标签的属性tableId, PAGE_SIZE是你一页的记录数,TOTAL_SIZE是你查询数据的总数

然后设置totalRow属性,它的值被要求为Integer类型的,转换一下:

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

将分页后的结果集(一页的内容)放到request的resultList(此为JSP中item属性设置的值)属性中去:

request.setAttribute("resultList", getTestData(limit.getCurrentRowsDisplayed(),limit.getPage()));

上面得到分页数据的函数原形为getTestData(int pageSize,int paget),通过指定一页的记录数和第几页来获得所需的数据,这可以根据数据库的分页特性,或者通过滑动游标的方式来得到,这里不再傲述.

以下为部分代码:

JSP部分:

<ec:table
 items="resultList" var="item" tableId="youTableId"
        retrieveRowsCallback="org.extremecomponents.table.callback.LimitCallback"
        filterRowsCallback="org.extremecomponents.table.callback.LimitCallback"
        sortRowsCallback="org.extremecomponents.table.callback.LimitCallback"
 action="${pageContext.request.contextPath}/DisplayAction.do"
 imagePath="${pageContext.request.contextPath}/images/table/*.gif"
 title="TEST"
 width="100%"
 rowsDisplayed="10"
        sortable="false"
        filterable="false"
 >
        <ec:column property="name" title="姓名"/>
        <ec:column property="nickName" title="别名"/>
</ec:table>

 

Action部分代码:

Limit limit = LimitFactory.createInstanceOfLimit(request, TABLEID);
LimitFactory.setLimitFilterAndSortAttr(limit);
LimitFactory.setLimitPageAndRowAttr(limit,PAGE_SIZE,TOTAL_SIZE);
request.setAttribute("resultList",getTestData(limit.getCurrentRowsDisplayed(),limit.getPage()));
request.setAttribute("totalRows",new Integer(TOTAL_SIZE));

,标签里的rowDisplayed属性要和Action中的PAGE_SIZE一致,不然会有问题...

其他资源
extremecomponents 用AJAX:
http://extremecomponents.org/wiki/index.php/AJAX_enabled_eXtremeTable_Tutorial
extremecomponents Group:
http://groups.google.com:80/group/eXtremeComponents_CN
资源
http://www.blogjava.net:80/lucky/category/7508.html
官方网站
http://www.extremecomponents.org

本文来源：http://blog.csdn.net/GOALSTAR/archive/2007/07/27/1711822.aspx