pager-taglib 体验

pager-taglib 体验

      可能是自已习惯了用自已的分页组件。一直不知道有这样一个现成的分页标签。直到那天,白衣跟我提起了一下,我Search了一下,发现了Pager-taglib这个东东。支持多种风格的分页显示。
       先简单介绍一下Pager-taglib。实际上,她是一个Jsp标签库,为在JSP上显示分页信息而设计的一套标签,通过这些标签的不同的组合,会形成多种不一样的分页页面,风格各异,她自带的DEMO就有七种左右的分页风格,包括Google的分页风格。而需要订制自已的风格的分页页面也非常简单。
      接触的当天、匆匆看了下Demo和文档,发现这个很早(2002年最新版一直到现在)就已经有的东西,似 乎比较擅长显示端分页。如,把所有的数据传到页面,通过参数设定页面大小等,可能得到很完美的分页效果。
      第二天回家,做了些小动作,把一个页码参数塞进URL里面,让程序在页面之下分了页再把结果传出来,简单地实现了服务器的分页的功能。
      Pager-taglib的文档很详尽,我如果有说也只有翻译的份,要是真的翻译也就免了,文档还是挺容易看懂的。于是我开始作了另外一个小Demo,用了原先Demo里面的一个分页风格(Simple),稍作修改。希望能帮助自已理清脉络和对朋友们有用:P
一、模拟业务类:

package  net.jf.ajax.business;

import  java.util.ArrayList;
import  java.util.List;

public   class  PageManager  {
    
private   static  List names;
    
{
        names 
=   new  ArrayList();
        names.add(
" black " );
        names.add(
" black " );
        names.add(
" black " );
        names.add(
" black " );
        names.add(
" blue " );
        names.add(
" blue " );
        names.add(
" blue " );
        names.add(
" blue " );
        names.add(
" blue " );
        names.add(
" red " );
        names.add(
" yellow " );
        names.add(
" blue " );
        names.add(
" green " );
        names.add(
" blue " );
        names.add(
" black " );
        names.add(
" green " );
        names.add(
" black " );
    }

    
/** */ /**
     * 查询函数
     * 
@param  pageNum 页码
     * 
@param  pageSize 页大小
     * 
@param  condition 查询条件
     * 
*/

    
public  List query( int  pageNum, int  pageSize,String condition) {
        List tmpNames 
=  getNames(condition);
        List ret 
=   new  ArrayList();
        
int  start  =  (pageNum  -   1 *  pageSize;
        
int  end  =  start  +  pageSize  -   1 ;
        
if (start  >=  tmpNames.size())
            
return  ret;
        
for ( int  i  =   0 ; i  <  tmpNames.size(); i  ++ ) {
            
if (i  >=  start  &&  i  <=  end)
                ret.add(tmpNames.get(i));
        }

        
return  ret;
    }

    
/** */ /**
     * 按条件查询所有名字
     * 
*/

    
private  List getNames(String condition)  {
        
if ( null   ==  condition)  return  names;
        List ret 
=   new  ArrayList();
        
        
for ( int  i  =   0 ; i  <  names.size(); i  ++ ) {
            
if (condition.equals(names.get(i)))
                ret.add(names.get(i));
        }

        
return  ret;
    }

    
/** */ /**
     * 获得条件指定的名字的数量
     * 
*/

    
public   int  getSize(String condition) {
            
return  getNames(condition).size();
    }

}

二、JSP代码:
本页面提供了列表、查找功能。目的在于演示在Pager-taglib里面如何传递参数(如Form的Post后URL是找不到参数的,但是要保持原来的查询条件必须把这些参数在分页的时候加到URL上去)。

<% @ page language = " java "   import = " java.util.* "  pageEncoding = " UTF-8 " %>
<% @ taglib uri = " http://jsptags.com/tags/navigation/pager "  prefix = " pg "   %>
<%
request.setCharacterEncoding(
" UTF-8 " );
%>
< jsp:useBean id  =   " pm "  scope = " page "   class = " net.jf.ajax.business.PageManager " />
<! DOCTYPE HTML PUBLIC  " -//W3C//DTD HTML 4.01 Transitional//EN " >
< html >
  
< head >
  
</ head >
  
  
< body >
    
< form name = " cc "  action = " pager.jsp "  method = " post " >
        
< input type = " text "  name = " name "  value = " <%=request.getParameter( " name " )%> " />< input type = " submit "  value = " search " />
    
</ form >
    
< pg:pager
    items
= " <%= pm.getSize(request.getParameter( " name " )) %> "
    index
= " center "
    maxPageItems
= " 5 "
    maxIndexPages
= " 5 "
    isOffset
= " <%= false %> "
    export
= " pageOffset,currentPageNumber=pageNumber "
    scope
= " request " >
    
<%
    
int  pageNum  =   1 ;
    
if (request.getParameter( " pageNo " !=   null )
        pageNum 
=  Integer.valueOf(request.getParameter( " pageNo " ));
    
int  pageSize  =   5 ;
      List result 
=  pm.query(pageNum,pageSize,request.getParameter( " name " ));
  
%>
    
< table >
        
< tr >
            
< td > result </ td >
        
</ tr >
        
<% for ( int  i  =   0 ; i  <  result.size(); i  ++ ) { %>
        
< tr >
            
< td >
                
<%= result.get(i) %>
            
</ td >
        
</ tr >
        
<% }
%>
    
</ table >
    
    
< pg:param name = " name " />
    
< pg:index >
        
< jsp:include page = " /pagination/jsptags.jsp "  flush = " true " />
    
</ pg:index >
    
</ pg:pager >
  
</ body >
</ html >


从页面里可以看到,这里使用了三个标签

1、<pg:pager>,在这个标签库里就充当着一个领袖的作用,一切子标签都在它里面工作。就以上出现的参数进行解释一下:
items:数据的纪录数
index:说起来比较麻烦,反正是一次大跳跃之后,当前页面在各个页数的什么位置,默认为Center,不动也罢了。
maxPageItems:显示最多的纪录数/页
maxIndexPages:显示最多的分页数/次,如设为5的话,则会出现这样的情况 1 2 3 4 5 .或 3 4 5 6 7 这样的形式,其实她自带的DEMO都喜欢把页数展现出来排成一排。
isOffset:与pg:item配套使用,页pg:item基本上被我淘汰出局。
export:这个属性比较重要,文档也对此作好相对长篇幅的说明。这个属性是让标签给你暴露什么变量,当然这些变量是有选择的,如在Pager标签里,可以暴露出来的变量有pageOffset及pageNumber,即页码偏移量及页码。通过这两个变量名,可以在Jsp或Java里面从Request里获得。Export属性接受的值还有表达式,如currentPage=pageNumber表示,把pageNumber的值暴露出来,并赋给一个叫CurrentPage的变量,这个变量将被保存到Request中,在Jsp或Java中可以得到。
scope:咳。还需要讲么?

2、<pg:param>这个标签很有用,用来设置将要加入到URL的变量。使用Name属性指定即可。

3、<pg:index>这个标签说明分页显示开始了。跳进我们Include的页面。再看看详细的情况。

三、分页显示页面

<% @ page session = " false "  contentType = " text/html;charset=utf-8 " %>
<% @ taglib uri = " http://jsptags.com/tags/navigation/pager "  prefix = " pg "   %>
< pg:first >
  
< a href = " <%= pageUrl %>&pageNo=<%= pageNumber %> " >< nobr > [ # <%=  pageNumber  %>  首页 ] </ nobr ></ a >
</ pg:first >
< pg:skip pages = " <%= -5 %> " >
  
< a href = " <%= pageUrl %>&pageNo=<%= pageNumber %> " >< nobr > [ # <%=  pageNumber  %>  后退 ] </ nobr ></ a >
</ pg:skip >
< pg:prev >
  
< a href = " <%= pageUrl %>&pageNo=<%= pageNumber %> " >< nobr > [ # <%=  pageNumber  %>  前一页 ] </ nobr ></ a >
</ pg:prev >
< pg:pages >
   
< a href = " <%= pageUrl %>&pageNo=<%= pageNumber %> " ><%=  pageNumber  %></ a >  
</ pg:pages >
< pg:next >
  
< a href = " <%= pageUrl %>&pageNo=<%= pageNumber %> " >< nobr > [ 下一页 # <%=  pageNumber  %>  ] </ nobr ></ a >
</ pg:next >
< pg:skip pages = " <%= 5 %> " >
  
< a href = " <%= pageUrl %>&pageNo=<%= pageNumber %> " >< nobr > [ 跳进 # <%=  pageNumber  %>  ] </ nobr ></ a >
</ pg:skip >
< pg:last >
  
< a href = " <%= pageUrl %>&pageNo=<%= pageNumber %> " >< nobr > [ 尾页 # <%=  pageNumber  %>  ] </ nobr ></ a >
</ pg:last >


没错,你看到的这些标签都是导航标签。很容易明白,用法基本上一致,从标签的名字上就能看出是什么作用。告诉你我动了手脚的地方就是我在每一个PageUrl后面都加了&pageNo=<%= pageNumber %>。让我们的URL带上页码的参数,这样程序可以拿到页码去查找所需要的数据。

结果很理想。在SpringSide领了个分页标签的任务,原来还想着自已实现一套标签的。还好被白衣喝住了。。卡卡。摸清楚了整套标签的使用方法后,很容易就可以把一些重复的东西再稍作封装,变成有“特色”的东西。幸亏没有重复发明轮子(脸红啊,还发明呢~~~)。

       天色已早。这几天再继续研究和“拿来”。有经验再一起交流。。


参考资料:
http://jsptags.com/tags/navigation/pager/index.jsp Pager-taglibs官网
http://www.springside.org.cn/ SpringSide 春天的旁边(需要我们的参与)

你可能感兴趣的:(pager-taglib 体验)