java自定义分页标签

最新推荐文章于 2021-02-13 19:15:16 发布

凭什么不拼

最新推荐文章于 2021-02-13 19:15:16 发布

阅读量955

点赞数

CC 4.0 BY-SA版权

分类专栏： jsp标签文章标签：标签分页 java 控件

本文链接：https://blog.youkuaiyun.com/qq_39010647/article/details/77715072

jsp标签专栏收录该内容

1 篇文章

订阅专栏

本文介绍了在Java开发中自定义分页标签的原因和原理，通过创建处理程序类、TLD文件以及使用说明，强调了自定义标签的代码复用和维护优势，帮助提高开发效率。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

为什么需要自定义标签

在开发项目过程中，我们经常有这样的体会：同一个控件我们可能多处使用，同时我们需要在基础的样式上加上自己的样式和操作的js代码；遇到这种情况，如果每个地方都copy代码的话那么，后期如果要做修改，那么维护的工作量是巨大的。基于这种情况，我们可以考虑使用自定义标签，实现代码的复用，易维护。
JSP自定义标签，实质上就是以标记的形式封装了一个俱有独立功能的Java类。标记的使用减少了直接嵌入JSP页面的Java代码，方便了页面的布局，并且有利于代码的复用，提高了开发的效率。

原理介绍

JSP服务器解析标记的过程：
当一个用户访问一个JSP页面时，这个请求被发送到JSP服务器，JSP服务器会根据这个请求去调用相应的页面，如果这个页面中有自定义的标记， JSP服务就会根据页面指令<%@ taglib>去访问TLD得到处理程序的相关信息，接着调用该处理程序的构造器方法，启动标记符处理程序,并读取标记符的属性和相应值。
TLD文件
TLD(TLD:Tag Library Descriptor标记库描述符)文件，标准的XML格式的标记定义文件，被用来存放标记符的信息。
Taglib 指令
<%@ taglib uri=”URIToTagLibrary” prefix=”tagPrefix” %>
<% @ taglib %>指令声明此JSP文件使用了自定义的标记，同时引用标记库，也指定了他们的标记的前缀。必须在使用自定义标记之前使用<% @ taglib %>指令。
属性：
uri=”URIToTagLibrary” ：Uniform Resource Identifier (URI)根据标记的前缀对自定义的标记进行唯一的命名，URI可以是一个相对或绝对的路径。
prefix=”tagPrefix”：在自定义标记之前的前缀。

举例代码

PageUtil.java代码

package com.util;

import java.util.List;

public class PageUtil<T> {
    // 以下4个属性必须指定
    private List<T> records; // 分页数据
    private int totalRecord; // 总记录数
    private int pageNo; // 当前页码,第几页
    private int pageSize; // 每页显示的记录数,每页显示多少条数据

    private int totalPage; // 总页数

    private int startIndex; // 开始索引
    private int endIndex; // 结束索引

    private int indexCount = 10;// 显示的索引数目,如:10的话， 则显示1-10， 2-11

    // public Pagination() {}

    public PageUtil(List<T> records,int totalRecord,int pageNo, int pageSize) {
        this.records = records;
        this.totalRecord = totalRecord;
        this.pageNo = pageNo;
        this.pageSize = pageSize;

        // 根据总记录数和每页显示数计算总页数(totalRecord+pageSize->totalPage)
        totalPage = this.totalRecord / this.pageSize;
        totalPage = (this.totalRecord % pageSize == 0) ? totalPage: (totalPage + 1);
        // 计算显示索引数目
        if (indexCount > totalPage) {
            indexCount = totalPage;
        }
        // 根据索引数目，当前页，总页数计算开始索引和结束索引(indexCount+pageNo+totalPage->startIndex+endIndex)
        startIndex = indexCount / 2;
        startIndex = pageNo- (indexCount % 2 == 0 ? (startIndex - 1) : startIndex);
        endIndex = pageNo + indexCount / 2;
        // 1 <= startIndex < pageNo < endIndex <= totalPage
        // startIndex = pageNo - indexCount/2
        // endIndex = pageNo + indexCount/2
        if (startIndex < 1) {
            startIndex = 1;
            if (totalPage >= indexCount) {
                endIndex = indexCount;
            } else {
                endIndex = totalPage;
            }
        }
        if (endIndex > totalPage) {
            endIndex = totalPage;
            if (endIndex > indexCount) {
                startIndex = endIndex - indexCount + 1;
            } else {
                startIndex = 1;
            }
        }
    }

    /**
     * 获取分页数据
     * 
     * @return
     */
    public List<T> getRecords() {
        return records;
    }

    /**
     * 获取总记录数
     * 
     * @return
     */
    public int getTotalRecord() {
        return totalRecord;
    }

    /**
     * 当前页数(第几页)
     * 
     * @return
     */
    public int getPageNo() {
        return pageNo;
    }

    /**
     * 每页显示数据记录数
     * 
     * @return
     */
    public int getPageSize() {
        return pageSize;
    }

    /**
     * 总页数
     * 
     * @return
     */
    public int getTotalPage() {
        return totalPage;
    }

    /**
     * 起始索引
     * 
     * @return
     */
    public int getStartIndex() {
        return startIndex;
    }

    /**
     * 结束索引
     * 
     * @return
     */
    public int getEndIndex() {
        return endIndex;
    }

    /****************************************************************/
    /************************ get/set方法 ******************************/
    /****************************************************************/

    public int getIndexCount() {
        return indexCount;
    }

    public void setIndexCount(int indexCount) {
        this.indexCount = indexCount;
    }

    @Override
    public String toString() {
        return "PageUtil [records=" + records + ", totalRecord=" + totalRecord
                + ", pageNo=" + pageNo + ", pageSize=" + pageSize
                + ", totalPage=" + totalPage + ", startIndex=" + startIndex
                + ", endIndex=" + endIndex + ", indexCount=" + indexCount + "]";
    }

}

PageTag.java

package com.util;

import java.io.IOException;

import javax.servlet.jsp.JspContext;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.SimpleTagSupport;

public class PageTag extends SimpleTagSupport {

    /**
     * 分页数据(required)
     */
    private PageUtil pagination;
    /**
     * 请求路径
     */
    private String href;

    /**
     * 分页div
     */
    private String divId;
    /**
     * 分页样式
     */
    private String divClass;

    @Override
    public void doTag() throws JspException, IOException {
        // 缓冲字符串对象
        StringBuffer strBuf = new StringBuffer();
        strBuf.append("<script type=\"text/javascript\">\n");
        strBuf.append("function paga_toPage(pageNo) {");
        strBuf.append("window.location.href=\"").append(href);
        if (href.indexOf("?") == -1) {
            strBuf.append("?");
        } else {
            strBuf.append("&");
        }
        strBuf.append("pageNo=\"").append("+pageNo;").append("}");
        strBuf.append(" </script> ");
        strBuf.append(" <div id=\"").append(divId).append("\" class=\"")
                .append(divClass).append("\"> ");
        // 上一页
        if (pagination.getPageNo() == 1) {
            strBuf.append(" <a>&#9668;</a>");
        } else {
            strBuf.append(" <a onclick=\"paga_toPage(")
                    .append(pagination.getPageNo() - 1)
                    .append(")\"> &#9668; </a> ");
        }
        // 容器
        strBuf.append(" <span>");

        if (pagination.getStartIndex() != 1) {
            // 显示第一页索引
            strBuf.append(" <a").append(" onclick=\"paga_toPage(").append(1)
                    .append(");\">").append(1).append("</a> ");
        }

        // 显示省略号
        if (pagination.getStartIndex() > 2) {

            strBuf.append(" <i>...</i> ");
        }
        // 分页条主体
        for (int i = pagination.getStartIndex(); i <= pagination.getEndIndex(); i++) {
            if (pagination.getPageNo() == i) {
                strBuf.append(" <a class=\"current\">").append(i)
                        .append("</a> ");
            } else {
                strBuf.append(" <a onclick=\"paga_toPage(").append(i)
                        .append(");\">").append(i).append("</a> ");
            }
        }
        // 显示省略号
        if (pagination.getEndIndex() < pagination.getTotalPage() - 1) {
            strBuf.append(" <i>...</i> ");
        }
        if (pagination.getEndIndex() != pagination.getTotalPage()) {
            // 显示最后一页索引
            strBuf.append(" <a").append(" onclick=\"paga_toPage(")
                    .append(pagination.getTotalPage()).append(");\">")
                    .append(pagination.getTotalPage()).append("</a>");
        }

        // 容器结尾
        strBuf.append(" </span> ");

        // 下一页
        if (pagination.getPageNo() == pagination.getTotalPage()) {
            strBuf.append(" <a>&#9658;</a> ");
            // strBuf.append("<a">末页</a> ");
        } else {
            strBuf.append(" <a onclick=\"paga_toPage(")
                    .append(pagination.getPageNo() + 1)
                    .append(")\"> &#9658; </a> ");
            // strBuf.append(" <a onclick=\"paga_toPage(").append(pagination.getTotalPage()).append(")\">末页</a> ");
        }

        strBuf.append(" </div> ");

        JspContext ctx = getJspContext();
         // 获取页面输出流，并输出字符串
        JspWriter out = ctx.getOut();
        out.print(strBuf.toString());

    }

    public PageUtil getPagination() {
        return pagination;
    }

    public void setPagination(PageUtil pagination) {
        this.pagination = pagination;
    }

    public String getHref() {
        return href;
    }

    public void setHref(String href) {
        this.href = href;
    }

    public String getDivId() {
        return divId;
    }

    public void setDivId(String divId) {
        this.divId = divId;
    }

    public String getDivClass() {
        return divClass;
    }

    public void setDivClass(String divClass) {
        this.divClass = divClass;
    }

}

PageTag.tld

<?xml version="1.0" encoding="UTF-8" ?>
<taglib 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 http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
    version="2.0">
    <description>自定义标签类</description>
    <tlib-version>1.0</tlib-version>
    <short-name>Mytaglib</short-name>
    <uri>/MyPageTag</uri>

    <tag>
        <description>分页标签</description>
        <name>Pagination</name>
        <tag-class>com.util.PageTag</tag-class>
        <body-content>empty</body-content>
        <attribute>
            <name>pagination</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
            <type>java.lang.Object</type>
        </attribute>
        <attribute>
            <name>divId</name>
            <required>false</required>
        </attribute>
        <attribute>
            <name>divClass</name>
            <required>false</required>
        </attribute>
        <attribute>
            <name>href</name>
            <required>false</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
    </tag>

</taglib>

page.css

@CHARSET "UTF-8";
#pagination {
    display: inline-block;
    vertical-align: middle;
    border-radius: 4px;
    padding: 1px 2px 4px 2px;
    border-top: 1px solid #AEAEAE;
    border-bottom: 1px solid #FFFFFF;
    background-color: #DADADA;
    background-image: -webkit-linear-gradient(top, #DBDBDB, #E2E2E2);
    background-image:    -moz-linear-gradient(top, #DBDBDB, #E2E2E2);
    background-image:     -ms-linear-gradient(top, #DBDBDB, #E2E2E2);
    background-image:      -o-linear-gradient(top, #DBDBDB, #E2E2E2);
    background-image:         linear-gradient(top, #DBDBDB, #E2E2E2);
}
#pagination a, #pagination i {
    display: inline-block;
    vertical-align: middle;
    width: 22px;
    color: #7D7D7D;
    text-align: center;
    font-size: 10px;
    padding: 3px 0 2px 0;
    -webkit-user-select:none;
       -moz-user-select:none;
        -ms-user-select:none;
         -o-user-select:none;
            user-select:none;
}

#pagination a {
    margin: 0 2px 0 2px;
    border-radius: 4px;
    border: 1px solid #E3E3E3;
    cursor: pointer;
    box-shadow: inset 0 1px 0 0 #FFF, 0 1px 2px #666;
    text-shadow: 0 1px 1px #FFF;
    background-color: #E6E6E6;
    background-image: -webkit-linear-gradient(top, #F3F3F3, #D7D7D7);
    background-image:    -moz-linear-gradient(top, #F3F3F3, #D7D7D7);
    background-image:     -ms-linear-gradient(top, #F3F3F3, #D7D7D7);
    background-image:      -o-linear-gradient(top, #F3F3F3, #D7D7D7);
    background-image:         linear-gradient(top, #F3F3F3, #D7D7D7);
}
#pagination i {
    margin: 0 3px 0 3px;
}
#pagination a.current {
    border: 1px solid #E9E9E9;
    box-shadow: 0 1px 1px #999;
    background-color: #DFDFDF;
    background-image: -webkit-linear-gradient(top, #D0D0D0, #EBEBEB);
    background-image:    -moz-linear-gradient(top, #D0D0D0, #EBEBEB);
    background-image:     -ms-linear-gradient(top, #D0D0D0, #EBEBEB);
    background-image:      -o-linear-gradient(top, #D0D0D0, #EBEBEB);
    background-image:         linear-gradient(top, #D0D0D0, #EBEBEB);
}

使用说明：

PageTag.tld放在WEB-INF目录下
引入
<%@taglib uri=”/MyPageTag” prefix=”Mytaglib”%>
page.css
调用
<Mytaglib:Pagination pagination="PageUtil" divId="divId" href="Action"/>