基于比较的分页机制的注意事项

分页机制有两种: 一种是根据偏移量(或页码)+页大小获取数据,另一种是根据上一次看过的最后一条记录+页大小获取本页记录。

后一种机制常见于weibo/twitter这种feed流页面:记住当前页最后一条feed的发表时间,然后找出比这个时间更早的feed.   这种情况下一般不需要知道feed总数。

姑且把这种机制称为“基于比较的分页”。 使用这种机制时,需要注意的地方有:

1. 用作比较的维度应该是唯一的,在做大小比较时才不会遗漏数据。如果按ID来比较,则比id=1更大的记录是(2,3,…),不会遗漏;  如果按发表时间来比较,则比100毫秒更大的记录是(101, 102…), 而同在第100毫秒发表的其他记录就会被遗漏掉。

2. 除了往下翻页,还可能要往上翻页; 系统应该同时支持。

3. “首页”应该传什么值作为比较基准? 如果id为Long型,应该传-1还是传一个Long.maxValue()? 这种地方最容易埋坑,引发程序错误和沟通困难。 最好的办法是再另传一个参数:firstPage = true, 简单明了。

4. 服务端回传记录时,应该同时回传本页记录第一条和最后一条的比较值,比如第一个feed的id和最后一个 feed的id; 客户端/浏览器 再根据这两个记录决定上一页和下一页的URL。你会说不传也可以,客户端自己从feed列表中找出这两个id; 然而用于比较分页的维度未必是feed的属性,从feed列表中是找不出来的,比如分页查询“我评论过的feed”时,要通过评论ID来做比较,评论ID显然并不是feed的属性。

5. 第4点帮助你得出一个结论:分页参数可以跟业务无关,客户端不必知道分页维度的业务意义; 同理,也不必知道下一页的记录是比某个属性更“大”,还是更“小”,客户端只需要传“下一页”,或是“上一页”,让服务端自己决定取更大或是更小的记录。

6. 有了这个结论,我们可以做一个通用的、适用于任何业务分页参数类。示范代码:

分页参数类:

public class PageByCompareParam {

	 * 服务端将跟这个值比较。日期时间类型请传毫秒数时间戳,数字类型将转成字符串后再传过来
	 */
	private String value;

	/**
	 * 页大小
	 */
	private int pageSize;

	/**
	 * true = next page, false = previous page. 默认为true
	 */
	private boolean next = true;


	/**
	 * 访问的是否是第一页,如果是的话,value将被忽略。默认为true
	 */
	private boolean firstPage = true;
  
         ...
}

结果参数类:

public class PageQueryResult {
	/**
	 * 本页结果中的第一条记录的相关值。
	 */
	private String resultFirstValue;

	/**
	 * 本页结果中的最后一条记录的相关值。
	 */
	private String resultLastValue;
}

7. 上述PageQueryResult.resultFirstValue和PageQueryResult.resultLastValue从哪里来? 为了解决这个问题,最好为你的每一条查询记录配一个sortOrder属性;当sortOrder不是记录本身的属性时,这一点尤其必要。所以,你内部使用的查询结果可以这样写:


public class PageByCompareQueryResult<D, S> {

	/**
	 * 本页结果
	 */
	private List<ResultEntry<D, S>> resultList; 

	public S getFirstSortOrder() {
		return resultList.get(0).getSortOrder();
	}

	public S getLastSortOrder() {
		return resultList.get(resultList.size() - 1).getSortOrder();
	}

	public List<D> getDataList() {
		......
	}

	/**
	 * 结果列表中的一个元素,由数据本身和用于比较用的排序号组成
	 * 
	
	 * 
	 * @param <D>
	 * @param <S>
	 */
	public static class ResultEntry<D, S> {
		private D data;
		private S sortOrder;
		......
	}
}

7. 最后附一段ibatis代码:

	public List<Post> selectPosts(long idToCompareWith, int pageSize,
			NumCompareFlag numCompareFlag) {
		Map<String, Object> params = new HashMap<String, Object>();
		params.put("id", idToCompareWith);
		params.put("rowCount", pageSize);
		params.put("numCompareFlag", numCompareFlag.name());
		return getSqlMapClientTemplate().queryForList("selectPosts",
				params);
	}

	public static enum NumCompareFlag {

		/**
		 * 更大。 
		 */
		GREATER,
		/**
		 * 更小。 
		 */
		LESS;

	}


	<select id="selectPosts" parameterClass="map" resultMap="resultMap">	
			select  *
			from post
			where  
			<include refid="id_compare"/>								
			order by id desc
			LIMIT 0, #rowCount#	 
	</select>	


	<sql id="id_compare">
			<isEqual prepend="and"  property="numCompareFlag"  compareValue="LESS">
				id &lt; #id#
			</isEqual> 
			<isEqual prepend="and"  property="numCompareFlag"  compareValue="GREATER">
				id &gt; #id#
			</isEqual> 					
	</sql>	




Leave a Comment

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.