构建自己的通用分页组件（下）

zhangshixi

浏览: 675298 次
性别:
来自: 上海

最近访客更多访客>>

dogeren

米斯特才

九九牛

bbmmhjjwanm

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

ToolKit

Apache JSP DAO Servlet 搜索引擎

在阅读本文之前，请先参考：构建自己的通用分页组件（上）。

1. 需求：

   在前一篇文章中，我们通过分析常见的分页需求，构建了一个通用的分页类Page和页面范围类PageScope，在此基础上完成了分页查询的前后台交互。但是取得当前页面的数据及其他分页页码信息后，最终还是要展示到页面上。
   一种常用的方法就是将分页查询后返回的page对象传递给页面，页面通过一些判断逻辑来进行相应的展示。但是这种方式不方便复用，即使将其单独独立出来，并在需要分页的页面分别导入，也不是很好的做法，因为在页面中写判断逻辑总是不太合适的。
   本文将以Jsp为例，使用Jsp的自定义标签，来实现一个页面分页标签处理程序，最终使得在需要分页的页面中能够简单、容易的复用。

2. 设计：
首先我们来预览一下我们需要实现的功能，如下图：

为使设计更加灵活，从上述图片中，我们可以将这新展示内容抽象为：首页、末页、上一页、下一页、当前页、当前页之前的页数、当前页之后的页数、页码的链接地址、展示样式、分页信息等。而且，我们希望这些参数可由调用者自由设置，并根据调用者提供的参数不同，进行不同的展示，譬如：

根据这种实际需求，我们在PageTag类中定义如下属性：

public class PageTag extends TagSupport {

    private static final long serialVersionUID = 3441235160861303080L;
    // 首页
    private String homePage;
    // 末页
    private String lastPage;
    // 上一页
    private String previousPage;
    // 当前页之前的页数，默认为4。
    private int beforeNum = 4;
    // 当前页之后的页数，默认为5。
    private int afterNum = 5;
    // 分页对象
    private Page page;
    // 链接地址
    private String url;
    // 下一页
    private String nextPage;
    // 当前页码
    private String pageIndex;
    // 页面大小
    private String pageSize;
    // 外层div样式
    private String divClass;
    // 是否进行动态补足，默认为true。
    private boolean supplement = true;
}

从上面的代码中可以看出，除了我们之前描述的需求外，我还定义了当前页码和页面大小的Url参数，这样做是为了可以在用户给定的Url后面动态加上当前页面页码及页面大小的参数。比如：用户设定的url链接为http://zhangshixi.iteye.com ，那么添加参数后的动态url为http://zhangshixi.iteye.com?pageIndex=6&pageSize=15 。另外，细心的读者还会发现，我们还定义了一个名为supplement的boolean型属性，用以标识是否对设定的当前页面之前和之后的页数进行动态补足。比如说：总页数为15页，当前为第2页，设定当前页之前显示4个页码，当前页之后显示5个页码，供10个页码。若不进行动态补足，将显示：1 2 3 4 5 6 7 这些页码，但若进行动态补足，由于前面页码不足，将从后面进行补充，反之亦然，那么补足后显示的页码将为：1 2 3 4 5 6 7 8 9 10 。

3. 实现：
通过上面的分析和设计，下面我们继承Jsp提供的自定义标签TagSupport来实现自定义我们的分页标签PageTag。通过重写父类TagSupport的doStartTag()和doEndTag()方法，并在此方法中实现分页处理逻辑。

/**
 * 标签处理开始，构造一个存放分页信息的字符串缓冲区。
 * @return SKIP_BODY，忽略标签之间的内容。
 * @throws javax.servlet.jsp.JspException Jsp异常。
 */
@Override
public int doStartTag() throws JspException {
    buff = new StringBuilder();
    return SKIP_BODY;
}

/**
 * 标签实际分页处理逻辑。
 * @return EVAL_PAGE，按正常的流程继续执行Jsp页面。
 * @throws javax.servlet.jsp.JspException Jsp异常。
 */
@Override
public int doEndTag() throws JspException {
    if (page == null) {
        log.info("page is null.");
        return EVAL_PAGE;
    }

    // 写入开始DIV
    writeBeginDiv();
    // 写入分页信息
    writePageInfo();
    // 写入结束DIV
    writeEndDiv();
    // 记录日志
    writeDebugLog();
    // 输出到页面
    printToPage();

    return EVAL_PAGE;
}

然后我们在分别完成各个子方法的实现即可。下面略举一二，最后将所有代码一并奉上。

/**
 * 写入实际的分页信息。
 * 调用者可自行设定是否显示首页、末页、上一页、下一页
 * 以及当前页面之前和之后的页数、是否进行动态补足等。
 */
private void writePageInfo() {
    int beforeCount = countBefore();
    int afterCount = countAfter();

    // 如果定义了动态补足，则对当前页之前和之后的页数进行动态补足。
    if (supplement) {
        beforeCount = fixBeforeCount(beforeCount, afterCount);
        afterCount = fixAfterCount(beforeCount, afterCount);
    }

    int index = page.getPageIndex();
    // 首页
    writeHomePage(index);
    // 上一页
    writePreviousPage(index);
    // 当前页之前的页码
    writeBeforePageIndex(index, beforeCount);
    // 当前页
    writeCurrentPageIndex(index);
    // 当前页之后的页码
    writeAfterPageIndex(index, afterCount);
    // 下一页
    writeNextPage(index);
    // 末页
    writeLastPage(index);
}

/**
 * 计算当前页之前的页数。
 * @return 当前页之前的页数。
 */
private int countBefore() {
    int beforeCount = 0;
    if (page.getPageIndex() - 1 > beforeNum) {
        beforeCount = beforeNum;
    } else {
        beforeCount = page.getPageIndex() - 1;
    }

    return beforeCount;
}

/**
 * 动态补足当前页之前的页数。
 * @param beforeCount 当前页之前的页数。
 * @param afterCount 当前页之后的页数。
 * @return 修正后的当前页之前的页数。
 */
private int fixBeforeCount(int beforeCount, int afterCount) {
    int totalNum = beforeNum + afterNum + 1;
    int useNum = beforeCount + afterCount + 1;

    if (useNum < totalNum) {
        int befores = page.getPageIndex() - 1;
        int margin = befores - beforeCount;
        if (margin > 0) {
            int needNum = totalNum - useNum;
            beforeCount += margin > needNum ? needNum : margin;
        }
    }

    return beforeCount;
}

/**
 * 写入首页信息，如果设定了显示首页。
 * @param index 当前页码。
 */
private void writeHomePage(int index) {
    if (homePage == null || homePage.isEmpty()) {
        return;
    }

    buff.append(LABEL_START);
    int homeIndex = 1;
    if (index > homeIndex) {
        writeUrlPageIndex(homeIndex, page.getPageSize(), homePage);
    } else {
        buff.append(homePage);
    }
    buff.append(LABEL_END);
}

/**
 * 写入当前页之前的页码。
 * @param index 当前页码。
 * @param beforeCount 前页之前的页数。
 */
private void writeBeforePageIndex(int index, int beforeCount) {
    int beginIndex = index - beforeCount < 0 ? 1 : index - beforeCount;
    for (int i = beginIndex; i < index; i++) {
        buff.append(LABEL_START);
        writeUrlPageIndex(i, page.getPageSize(), String.valueOf(i));
        buff.append(LABEL_END);
    }
}

/**
 * 将分页信息输入到页面上。
 */
private void printToPage() {
    try {
        pageContext.getOut().write(buff.toString());
    } catch (IOException ex) {
        log.error(ex.getMessage(), ex);
    }
}

4. 测试：
针对此分页标签的实现，写了一个简单的测试代码来测试其正确性，如下：

public class PageTagTest {

    @Test
    public void writePage() throws JspException {
        PageTag instance = new PageTag();

        Page page = new Page(7, 10);
        page.setTotalData(75);

        instance.setPage(page);
        instance.setDivClass("divClass");
        instance.setHomePage("首页");
        instance.setLastPage("末页");
        instance.setPreviousPage("上一页");
        instance.setNextPage("下一页");
        instance.setPageIndex("page");
        instance.setBeforeNum(4);
        instance.setAfterNum(5);
        instance.setSupplement(false);
        instance.setUrl("http://zhangshixi.iteye.com");

        instance.doStartTag();
        instance.doEndTag();
    }
}

最终写入到Jsp页面的内容如下：

<div class="divClass">
    <label><a href="http://zhangshixi.iteye.com?page=1">首页</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=6">上一页</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=3">3</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=4">4</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=5">5</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=6">6</a></label>
    <span>7</span>
    <label><a href="http://zhangshixi.iteye.com?page=8">8</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=9">9</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=10">10</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=11">11</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=12">12</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=8">下一页</a></label>
    <label><a href="http://zhangshixi.iteye.com?page=12">末页</a></label>
</div>

限于篇幅，这里仅略举一例，当然，你也可写通过修改测试代码，来测试更多参数组合。至于在页面的最终展示样式，您可通过在外部css中，提供一个外层div的样式divClass来自行设定。在上传的代码中我会上传一个css的样式定义，来实现像本文开始时提供的效果，仅供参考，读者可在自己实际的项目中自行实现。

5. 如何使用？
好了，通过上面的说明，我们已经详细介绍了分页标签的设计及实现，那么我们究竟如何将其使用在页面中呢？下面我讲意义说明：
首先，我们需要对自定义标签处理程序提供一个page-tag.tld配置文件，它定义了该标签的使用规则，参数规范等。如：

<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-jsptaglibrary_2_0.xsd">

    <tlib-version>1.0</tlib-version>
    <short-name>util</short-name>
    <uri>http://www.codingfarmer.com/tags</uri>
    <tag>
        <description>分页标签</description>
        <name>page</name>
        <tag-class>com.codingfarmer.util.page.PageTag</tag-class>
        <body-content>empty</body-content>
        <attribute>
            <description>首页</description>
            <name>homePage</name>
            <required>false</required>
            <rtexprvalue>true</rtexprvalue>
            <type>java.lang.String</type>
        </attribute>
        <attribute>
            <description>分页对象</description>
            <name>page</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
            <type>com.codingfarmer.util.page.Page</type>
        </attribute>
        ........
    </tag>
</taglib>

限于篇幅，上面只略举了两个属性的定义，其余原理同上。在上传的源码中会有详细的配置，请下载参考。
其次，在定义好自定义标签的配置文件后，我们还需要在web.xml中引入，如将去放到WEB-INF下，并在web.xml中配置如下：

<jsp-config>
    <taglib>
        <taglib-uri>pageTag</taglib-uri>
        <taglib-location>/WEB-INF/page-tag.tld</taglib-location>
    </taglib>
</jsp-config>

最后，在需要分页的页面中我们可以插入以下代码，并根据实际需要设置相应的属性即可，如：

// 引入page-tag.tld文件的定义
<%@ taglib uri=" http://www.codingfarmer.com/tags" prefix="util" %>

// 分页显示
<util:page url="http://zhangshixi.iteye.com" page="${page}" 
           pageIndex=”pageIndex” homePage=”首页” lastPage=”末页” 
           previousPage="Previous" nextPage="Next" className="pageNav" />

最终在页面上生成的分页效果为：

6. 相关说明：
至此，我们已经完成了一个通用的分页组件的设计与实现，这样，我们就可以将其收录到自己的工具箱中，使用时在项目中引入即可，从而大大简化了分页的处理及展示，也达到了良好的复用，简化了维护。
下面上传的压缩包中，包含了自定义分页标签处理程序，测试类，还提供了一个仅供参考的css分页样式定义。还望大家哪呢个提出更好的建议和意见，以便改进，不胜感激。

pageTag.zip (67.2 KB)
下载次数: 1295

分享到：

NIO学习系列：核心概念及基本读写 | 构建自己的通用分页组件（上）

2010-05-28 00:28
浏览 10900
评论(50)
论坛回复 / 浏览 (49 / 20491)
分类:编程语言
查看更多

30 楼 finalerboy 2010-06-07

我还想知道。

Action里面怎么拼参数，怎么取SIZE，DAO里怎么取总。。。

可否再详细一点？

29 楼 jzgl_javaeye 2010-06-02

sundoctor 写道

这玩艺，地球人都知道了。

太牛啦,地球人都知道,看来就看这贴的人不知道.

分享东西,本来就是一种精神,你知道得那么多,怎么不拿出来给人看看.BS

28 楼風一樣的男子 2010-05-30

<div class="quote_title">zhangshixi 写道</div>
<div class="quote_div">
<div class="quote_title">風一樣的男子写道</div>
<div class="quote_div">就一分页导航？分页的列表信息怎么展示的？<br>如果就一分页导航就没啥必要用 tag 了吧</div>
<p>关于如何展示分页列表,请参考我的上一篇文章: <span style="color: #0000ff;"><a title="构建自己的通用分页组件（上）" href="/topic/676906" target="_blank">构建自己的通用分页组件（上）.</a></span></p>
<p> </p>
</div>
<p>上我也看了，就是不知道LZ是怎么把 List 数据展示到页面的</p>
<p>能否直接用您的分页标签直接展示？</p>

27 楼 leepengyu 2010-05-29

想问一下LZ代码的这种字体叫什么名字？

26 楼 zhangshixi 2010-05-29

<div class="quote_title">風一樣的男子写道</div>
<div class="quote_div">就一分页导航？分页的列表信息怎么展示的？<br>如果就一分页导航就没啥必要用 tag 了吧</div>
<p>关于如何展示分页列表,请参考我的上一篇文章: <span style="color: #0000ff;"><a title="构建自己的通用分页组件（上）" href="/topic/676906" target="_blank">构建自己的通用分页组件（上）.</a></span></p>
<p> </p>

25 楼風一樣的男子 2010-05-29

就一分页导航？分页的列表信息怎么展示的？
如果就一分页导航就没啥必要用 tag 了吧

24 楼 zhangshixi 2010-05-28

wsygdwrdpy 写道

还有，楼主的page-tag.tld文件没有找到啊。。。。是不是忘记传了？

是的，我会重新编辑一下上传的文件。

23 楼 wsygdwrdpy 2010-05-28

还有，楼主的page-tag.tld文件没有找到啊。。。。是不是忘记传了？

22 楼 wsygdwrdpy 2010-05-28

按照你的代码写了一遍，结果出现如下错误。。。还望指教。。。。
严重: Servlet.service() for servlet jsp threw exception
org.apache.jasper.JasperException: /index.jsp(13,22) quote symbol expected
at org.apache.jasper.compiler.DefaultErrorHandler.jspError(DefaultErrorHandler.java:40)
at org.apache.jasper.compiler.ErrorDispatcher.dispatch(ErrorDispatcher.java:407)
at org.apache.jasper.compiler.ErrorDispatcher.jspError(ErrorDispatcher.java:88)
at org.apache.jasper.compiler.Parser.parseAttribute(Parser.java:199)
at org.apache.jasper.compiler.Parser.parseAttributes(Parser.java:144)
at org.apache.jasper.compiler.Parser.parseCustomTag(Parser.java:1339)
at org.apache.jasper.compiler.Parser.parseElements(Parser.java:1578)
at org.apache.jasper.compiler.Parser.parse(Parser.java:127)
at org.apache.jasper.compiler.ParserController.doParse(ParserController.java:212)
at org.apache.jasper.compiler.ParserController.parse(ParserController.java:101)
at org.apache.jasper.compiler.Compiler.generateJava(Compiler.java:156)
at org.apache.jasper.compiler.Compiler.compile(Compiler.java:296)
at org.apache.jasper.compiler.Compiler.compile(Compiler.java:277)
at org.apache.jasper.compiler.Compiler.compile(Compiler.java:265)
at org.apache.jasper.JspCompilationContext.compile(JspCompilationContext.java:564)
at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:302)
at org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:329)
at org.apache.jasper.servlet.JspServlet.service(JspServlet.java:265)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:803)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:269)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:188)
at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:213)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:174)
at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)
at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:117)
at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:108)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:174)
at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:874)
at org.apache.coyote.http11.Http11BaseProtocol$Http11ConnectionHandler.processConnection(Http11BaseProtocol.java:665)
at org.apache.tomcat.util.net.PoolTcpEndpoint.processSocket(PoolTcpEndpoint.java:528)
at org.apache.tomcat.util.net.LeaderFollowerWorkerThread.runIt(LeaderFollowerWorkerThread.java:81)
at org.apache.tomcat.util.threads.ThreadPool$ControlRunnable.run(ThreadPool.java:689)
at java.lang.Thread.run(Thread.java:619)

index.jsp 代码如下
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8" import="com.likangtimes.util.page.*"%>
<%@ taglib uri="http://www.codingfarmer.com/tags" prefix="util" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
<link href="./css/page.css" rel="stylesheet" type="text/css" />
</head>
<body>
<util:page url="http://zhangshixi.iteye.com" page="${page}"
           pageIndex=”pageIndex” homePage=”首页” lastPage=”末页”
           previousPage="Previous" nextPage="Next" className="pageNav" />

</body>
</html>

21 楼 zhangshixi 2010-05-28

<div class="quote_title">yourfei 写道</div>
<div class="quote_div">写的的确不错，有个小白问题，请问假如有查询条件怎么办？</div>
<p>在url参数中进行设定即可。如：</p>
<pre name="code" class="java"><util:page url="http://zhangshixi.iteye.com?name=${name}&age=${age}"
           page="${page}"
           pageIndex="pageIndex"
           homePage="首页"
           lastPage="末页"
           previousPage="Previous"
           nextPage="Next"
           className="pageNav" /></pre>

<p> </p>

20 楼 yourfei 2010-05-28

写的的确不错，有个小白问题，请问假如有查询条件怎么办？

19 楼奥、特曼 2010-05-28

zhangshixi 写道

ilove2009 写道

lz的分页组件是基于get请求吧，我见过很多种，其实用处不大。我们的分页其实包含很多查询条件（当然你也可以把这些条件第一次查询时放到session中）。当查询条件包含中文的时候，可能会乱码。

session是记录用户级别的信息，将查询条件放入session中，似乎有些乱用吧？当查询条件包含中文的时候，只需对url参数进行编码即可。

LZ 你就在写个实例吧。我觉得你这个写得牛了！！！顶一！！！

18 楼 zhangshixi 2010-05-28

storm12358 写道

lz 那些查询条件保存在什么地方呢? 用get请求的话就得用js控制把条件放在后缀的里,复用也很麻烦. 求个合理解决办法

你误会了吧？PageTag中有个参数rul，你可将自己的转向链接和查询参数一起作为url传进去就行了。

17 楼 storm12358 2010-05-28

lz 那些查询条件保存在什么地方呢? 用get请求的话就得用js控制把条件放在后缀的里,复用也很麻烦. 求个合理解决办法

16 楼 zhangshixi 2010-05-28

myumen 写道

怎么没看到底层查询数据的实现是如何实现分页的呢？

底层查询数据依赖于具体持久层技术的实现，此分页为提供前后台交流的组件，分页标签作为页面展示之用。
至于持久层如何实现分页，对外界来说是透明的，可根据采用技术的不同而实现不同。

15 楼 myumen 2010-05-28

怎么没看到底层查询数据的实现是如何实现分页的呢？

14 楼 crazy.j 2010-05-28

ilove2009 写道

zhangshixi 写道

ilove2009 写道

session是记录用户级别的信息，将查询条件放入session中，似乎有些乱用吧？当查询条件包含中文的时候，只需对url参数进行编码即可。

get请求参数长度是有限制的，如果跟springmvc simpleformcontroller一起用，貌似get请求不能绑定参数。

照这么说，比如我在淘宝搜索到了一篇商品想跟朋友交流一下，我把url复制给我的朋友他看到的结果跟我的不一样？只能说get形式的分页和post形式的分页分别用在不同的地方，并不是说get处理分页用处就不大。

13 楼 ilove2009 2010-05-28

zhangshixi 写道

ilove2009 写道

session是记录用户级别的信息，将查询条件放入session中，似乎有些乱用吧？当查询条件包含中文的时候，只需对url参数进行编码即可。

get请求参数长度是有限制的，如果跟springmvc simpleformcontroller一起用，貌似get请求不能绑定参数。

12 楼 zhangshixi 2010-05-28

hatedance 写道

我局的不是lz搞得太复杂，而是servlet规范搞得lz这么复杂。
都是sun的错。

这里封装目的就是为了能够简单、灵活的使用，其实原理很简单，但是为了更通用性和展示效果的多变性，我们不得不去考虑其更加灵活的实现，当您完成这些枯燥的工作后，它能够满足我们实际的项目需求，有具有灵活性，那何乐而不为呢。

11 楼 hatedance 2010-05-28

我局的不是lz搞得太复杂，而是servlet规范搞得lz这么复杂。
都是sun的错。

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论