接上文內容，本節介紹基於Mybatis的查詢和分頁功能，並展示一個自定義的分頁標籤，可重複使用以簡化JSP頁面的開發。

在上一節中，我們已經使用Maven搭建好了專案的基礎結構，包括一個父專案petstore-parent和資料庫持久層模組petstore-persist及Web站點petstore-web，現在來為petstore-web新增一些功能。對於初學者來說，可能第一個遇到的較複雜問題就是分頁查詢，那麼就先從解決它開始。

看一下完成的效果：

上面是四個可選的查詢條件，使用者可以根據需要組合查詢條件。

中間是符合條件的資料展示表格，對查詢結果可以執行修改和刪除操作，但是暫未實現。

最下面是一個分頁導航欄，以自定義標籤(Tag)技術實現，可複用到多個jsp頁面。

下面來介紹關鍵步驟和程式碼。首先是petstore-persist模組，目錄結構如下：

Product.java是一個普通的Java Bean，這裡略過。ProductMapper.java中定義了兩個方法：

package com.example.petstore.persist.model;

import java.util.List;
import org.apache.ibatis.annotations.Param;

public interface ProductMapper {
	
	/**
	 * 查詢符合條件的記錄總數
	 * @param id
	 * @param name
	 * @param fromPrice
	 * @param toPrice
	 * @return
	 */
	int matches(@Param(value="id") int id, @Param(value="name") String name, @Param(value="fromPrice") float fromPrice, @Param(value="toPrice") float toPrice);
	
	/**
	 * 按查詢條件及分頁條件分段查詢記錄
	 * @param id
	 * @param name
	 * @param fromPrice
	 * @param toPrice
	 * @param fetchIndex
	 * @param fetchCount
	 * @return
	 */
	List<Product> findProducts(@Param(value="id") int id, @Param(value="name") String name, @Param(value="fromPrice") float fromPrice, @Param(value="toPrice") float toPrice, @Param(value="fetchIndex") int fetchIndex, @Param(value="fetchCount") int fetchCount);
}
 

使用時，首先呼叫matches方法獲得符合條件的記錄總數，然後根據每頁顯示的記錄數和當前頁數計算讀取資料的Limit偏移量和記錄數，再呼叫findProducts方法讀取資料。兩個方法的引數都使用了@Param註解，例如@Param(value="id") int id，在對映檔案中，可通過#{id}的格式來使用這個引數。

在Product.xml中新增兩個方法的SQL對映：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.petstore.persist.model.ProductMapper">
	<resultMap type="com.example.petstore.persist.model.Product"
		id="productMap">
		<id column="p_id" property="id" />
		<result column="p_name" property="name" />
		<result column="p_price" property="price" />
	</resultMap>
	<select id="matches" resultType="int">
		select count(*) from t_product
		<where>
			<if test="id>0">
				p_id=#{id}
			</if>
			<if test="name!=null and name!='' ">
				and locate(#{name},p_name)>0
			</if>
			<if test="fromPrice>-1">
				and p_price>=#{fromPrice}
			</if>
			<if test="toPrice>-1">
				and p_price<=#{toPrice}
			</if>
		</where>
	</select>
	<select id="findProducts" resultMap="productMap">
		select * from t_product
		<where>
			<if test="id>0">
				p_id=#{id}
			</if>
			<if test="name!=null and name!='' ">
				and locate(#{name},p_name)>0
			</if>
			<if test="fromPrice>-1">
				and p_price>=#{fromPrice}
			</if>
			<if test="toPrice>-1">
				and p_price<=#{toPrice}
			</if>
		</where>
		limit #{fetchIndex},#{fetchCount}
	</select>
</mapper>
 

可以看到上面兩個方法中，就是通過<where><if>等元素來組裝查詢SQL。Mybatis的優點之一就是直接使用SQL語法，有SQL基礎的情況下非常容易上手。

下面進入petstore-web模組，先來看整體結構：

其中com.example.petstore.web.tag.PagingTag.java是分頁標籤類，關鍵程式碼：

	private int pageIndex = 1;  //當前頁數
	private int pageSize = 20;  //預設每頁行數
	private int pageCount = 0;  //記錄總頁數
	private int itemCount = 0;  //記錄總條數
	private int numCount = 10;  //分頁欄數字導航連結個數
	
	@Override
	public void doTag() throws JspException, IOException {
		JspWriter out = this.getJspContext().getOut();
		
		out.write("<script type=\"text/javascript\">function navigatorPage(pageIndex) {document.getElementById('pageIndex').value = pageIndex;document.forms[0].submit();}</script>");
		
		out.write("每頁顯示");
		out.write("<select id='pageSize' name='pageSize' onchange='navigatorPage(" + pageIndex + ")'>");
		out.write("<option value='5'" + (pageSize == 5 ? " selected='true'" : "") + ">5</option>");
		out.write("<option value='10'" + (pageSize == 10 ? " selected='true'" : "") + ">10</option>");
		out.write("<option value='20'" + (pageSize == 20 ? " selected='true'" : "") + ">20</option>");
		out.write("<option value='50'" + (pageSize == 50 ? " selected='true'" : "") + ">50</option>");
		out.write("<option value='100'" + (pageSize == 100 ? " selected='true'" : "") + ">100</option>");
		out.write("<option value='500'" + (pageSize == 500 ? " selected='true'" : "") + ">500</option>");
		out.write("</select>");
		out.write("條    ");
		
		out.write(pageIndex + "/" + pageCount + "頁    ");
		out.write("共" + itemCount + "條記錄    ");
		
		out.write("<input type='button' value='第一頁' onclick='javascript:navigatorPage(1);'" + (pageIndex > 1 ? "" : " disabled='true'") + " />  ");
		out.write("<input type='button' value='上一頁' onclick='javascript:navigatorPage(" + (pageIndex - 1) + ");'" + (pageIndex > 1 ? "" : " disabled='true'") + " />  ");
		
		//數字導航欄
		int iStartIndex = 1;
		int iEndIndex = pageCount;
		if(pageCount <= numCount) {
		} else if ((pageIndex + (numCount + 1) / 2) > pageCount) {
			iStartIndex = pageCount - (numCount - 1);
			iEndIndex = pageCount;
        } else if (pageIndex <= (numCount + 1) / 2) {
        	iEndIndex = numCount;
        } else {
            if (numCount % 2 == 0) {
            	iStartIndex = pageIndex - numCount / 2;
            	iEndIndex = pageIndex + (numCount - 1) / 2;
            } else {
            	iStartIndex = pageIndex - numCount / 2;
            	iEndIndex = pageIndex + numCount / 2;
            }
        }
		for(int i = iStartIndex; i <= iEndIndex; i++) {
			if(i == pageIndex) {
				out.write("<strong>" + i + "</strong>  ");
			} else {
				out.write("<a href='javascript:navigatorPage(" + i + ");'>" + i + "</a>  ");
			}
		}
		
		out.write("<input type='button' value='下一頁' onclick='javascript:navigatorPage(" + (pageIndex + 1) + ");'" + (pageIndex < pageCount ? "" : " disabled='true'") + " />  ");
		out.write("<input type='button' value='最後頁' onclick='javascript:navigatorPage(" + pageCount + ");'" + (pageIndex < pageCount ? "" : " disabled='true'") + " />");
		out.write("<input type='hidden' id='pageIndex' name='pageIndex' value='" + pageIndex + "'/>");
	}

接下來還需要一個標籤配置檔案來宣告這個標籤的使用方法。

在WEB-INF下建立目錄tld，然後新增pagingTag.tld，內容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib
  PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
  "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
	<tlib-version>2.0</tlib-version>
	<jsp-version>1.2</jsp-version>
	<short-name>Paging</short-name>
	<uri>http://blog.csdn.net/autfish/tag/</uri>
	<display-name>Paging Tag</display-name>
	<description>Paging Tag library</description>

	<tag>
		<name>pagingTag</name>
		<tag-class>com.example.petstore.web.tag.PagingTag</tag-class>
		<body-content>empty</body-content>
		<description>create navigation for paging</description>
		<attribute>
			<name>pageIndex</name>
			<rtexprvalue>true</rtexprvalue>
		</attribute>
		<attribute>
			<name>pageSize</name>
			<rtexprvalue>true</rtexprvalue>
		</attribute>
		<attribute>
			<name>pageCount</name>
			<rtexprvalue>true</rtexprvalue>
		</attribute>
		<attribute>
			<name>itemCount</name>
			<rtexprvalue>true</rtexprvalue>
		</attribute>
	</tag>
</taglib>

注意其中的uri元素，這裡並不需要配置真實存在的url，但該uri在你的classpath中應保持唯一，不能被其他元件宣告使用。

在web.xml中啟用這個標籤：

	<jsp-config>
		<taglib>
			<taglib-uri>http://blog.csdn.net/autfish/tag/</taglib-uri>
			<taglib-location>/WEB-INF/tld/pagingTag.tld</taglib-location>
		</taglib>
	</jsp-config>

在jsp中使用：

<%@ taglib prefix="my" uri="http://blog.csdn.net/autfish/tag/" %>

<my:pagingTag pageIndex="${contentModel.pageIndex}" pageSize="${contentModel.pageSize}" pageCount="${contentModel.pageCount}" itemCount="${contentModel.itemCount}" />

對於四個屬性的賦值，contentModel是一個PagingList.java類的例項，用於輔助分頁，由分頁屬性和資料表構成，在Controller中填充資料並傳遞到檢視JSP。屬性如下：

	private int pageIndex = 1;
	private int pageSize = 20;
	private int pageCount = 0;
	private int itemCount = 0;
	
	private List<T> items;

Controller程式碼：

@Controller
@RequestMapping("/product")
public class ProductController {

	@Autowired
	private ProductService productService;

	@RequestMapping(value="/list")
	public String listProduct(Model model, @ModelAttribute("searchModel") SearchModel formModel, 
			@RequestParam(value=PagingList.PAGE_INDEX_NAME, defaultValue="1") int pageIndex,
			@RequestParam(value=PagingList.PAGE_SIZE_NAME, defaultValue="10") int pageSize) {

		int id = 0;
		String name = "";
		float fromPrice = -1;
		float toPrice = -1;
		if(formModel != null) {
			id = NumberUtils.toInt(formModel.getId(), 0);
			name = formModel.getName();
			fromPrice = NumberUtils.toFloat(formModel.getFromPrice(), -1);
			toPrice = NumberUtils.toFloat(formModel.getToPrice(), -1);
		}
		model.addAttribute("searchModel", formModel);
		PagingList<Product> contentModel = this.productService.findProducts(id, name, fromPrice, toPrice, pageIndex, pageSize);
		model.addAttribute("contentModel", contentModel);

		return "product/list";
	}
}

Controller中注入了一個ProductService的例項，用於管理持久層的呼叫，主要程式碼如下：

@Service
public class ProductServiceStdImpl implements ProductService {

	@Autowired
	private ProductMapper productMapper;

	@Override
	public PagingList<Product> findProducts(int id, String name,
			float fromPrice, float toPrice, int pageIndex, int pageSize) {
		int total = this.productMapper.matches(id, name, fromPrice, toPrice);
		int pageCount = total % pageSize == 0 ? total / pageSize : total / pageSize + 1;
		if(pageIndex > pageCount)
			pageIndex = pageCount;
		int fetchIndex = (pageIndex - 1) * pageSize;
		int fetchCount = fetchIndex + pageSize > total ? (total - fetchIndex) : pageSize;
		List<Product> list = this.productMapper.findProducts(id, name, fromPrice, toPrice, fetchIndex, fetchCount);
		PagingList<Product> paging = new PagingList<Product>();
		paging.setItemCount(total);
		paging.setPageCount(pageCount);
		paging.setPageIndex(pageIndex);
		paging.setPageSize(pageSize);
		paging.setItems(list);
		return paging;
	}

}

限於篇幅，不能把所有的原始碼一一貼上，有興趣可以下載原始碼。

在WEB容器如tomcat中執行petstore-web模組，使用http://localhost:8080/petstore-web/product/list訪問，順利的話就看到了一開始的畫面。如果出錯，比對原始碼檢查差異即可。

總結

分頁查詢功能使用頻繁，且開發比較複雜，按需定製一套可複用的分頁元件對提高開發效率有很大的幫助。下一節我們繼續完善Web模組，增加增刪改查以及許可權控制功能。