分页查询接口常见设计思路

我们在web开发中，在页面展示时经常会遇到分页技术，常见的分页实现的思路有：

1. 客户端分页：直接将全部或多页结果数据一次性返回给客户端，客户端通过展现组件进行数据分页的控制。
2. 数据库分页：进行数据查询时，数据库返回一页数据给客户端。
3. 服务器分页：从数据库返回全部或者多条数据，在服务器端进行缓存，但是每次只返回一页数据给客户端。

上述思路的优缺点：

1. 客户端分页
   
   • 优点：减少了客户端和服务器交互的次数，客户端进行数据缓存，提高了系统交互性。
   • 缺点：增加了第一次交互的负荷
2. 数据库分页
   
   • 优点：每次从数据库返回较少数据，当次交互的负荷较轻。
   • 缺点：每次切页时都访问数据库，增加了数据库访问并发性。

3. 服务器分页（介于1、2之间）

   • 优点：在1、2之间达到了平衡，既减少了数据库并发又使服务器和客户端交互的当次负荷较小
   • 缺点：需要考虑数据缓存、数据同步等问题，增加了系统复杂性。

   根据不同的需求选择合适的分页思路会有事半功倍的效果。

   简单的分页查询接口如下：

   
   参数说明：
   queryXxxs的两个入参：XxxQueryParam为查询参数对象，PageParam为分页的设置信息，一般包括页码pageNo，每页记录数pageSize和最大查询页数maxPageNum。Page为当前页数据的封装类，其中包括页码pageNo，结果集总页数totalPageNum（客户端分页导航栏需要取到pageNo和totalPageNum）和当前页的业务数据集合pageItems。当需要查询的页码超过结果集最大页数或者超过允许查询的最大页时，抛出OutOfPageSizeException运行期异常。