java分页详细设计说明书.doc

1 1 引言引言 2 1 1 编写目的 2 1 2 背景 2 1 3 定义 2 1 4 参考资料 2 2 程序系统的结构程序系统的结构 2 3 程序程序 1 标识符 设计说明 标识符 设计说明 2 3 1 程序描述 3 3 2 功能 3 3 3 性能 3 3 4 输人项 3 3 5 输出项 3 3 6 算法 3 3 7 流程逻辑 3 3 8 接口 3 3 9 存储分配 4 3 10 注释设计 4 3 11 限制条件 4 3 12 测试计划 4 3 13 尚未解决的问题 4 2 详细设计说明书详细设计说明书 1 引言引言 1 1 编写目的编写目的 简化软件 程序开发 为程序员软件开发节省大量时间 1 2 背景背景 说明 a 系统名称 软件程序 分页类 b 任务提出者 刘官升 c 开发者 巩远义 d 用户 适合所有程序开发人员 1 3 定义定义 类 处理分页的程序类 Page 类 连接数据库查询数据类 EntityHibernate 类 外文词组 result 数据集合 start 本页数据在数据集中的起始位置 pageSize 每页数据的记录数 totalCount 总数据集合的记录数 pageNo 页码 currentPageNo 当前页码 lastPageNo 尾页页码 定义方法 hql查询分页 返回list param pageNo 页码 param pageSize 每页数据大小 param totalCount 总数据数 param hql 3 return public List listHql int pageNo int pageSize int totalCount String hql 分页查询函数hql不带参数 param hql param pageSize 每页显示数据大小 param totalCount 总条数 param pageNo 页号 return new Page list startIndex totalCount pageSize public Page pageHql String hql int pageSize int totalCount int pageNo hql分页查询 param hql param pageNo 当前页数 param pageSize 每页显示数据条数 return new page public Page pageHql int pageNo int pageSize String hql 分页查询函数 使用hql 返回Page param hql 使用 named query parameter as from Foo foo where foo bar bar Map param new HashMap param put bar xxx param pageNo 页号 从0开始 param pageSize 页大小 param param a java util Map return new Page list startIndex totalCount pageSize public Page pagedHqlQuery String hql int pageNo int pageSize int totalCount Map param 分页查询函数 使用sql param pageNo 页号 param pageSize 页大小 param totalCount 总条数 param sql 4 return new Page list startIndex totalCount pageSize public Page pagedSqlQuery int pageNo int pageSize int totalCount String sql 分页查询函数 使用hql param hql 使用 named query parameter as from Foo foo where foo bar bar param pageNo 页号 从0开始 param pageSize 页大小 param param a java util Map return new Page list startIndex totalCount pageSize public Page pagedHqlQuery int pageNo int pageSize String hql Map param 获取hql查询的总条数 param hql 查询hql语句 return throws Exception public Integer getHqlCount String hql 获取sql查询的总条数 param sql 查询sql语句 return throws Exception public Integer getSqlCount String sql 1 4 参考资料参考资料 a b c JQuery 1 4 API CHM 2 程序系统的结构程序系统的结构 EntityHibernate class 引用包 5 import java util List import java util Map import org hibernate Query import org hibernate transform Transformers import org springframework orm hibernate3 support HibernateDaoSupport Page class 引用包 import java io Serializable import java util ArrayList import java util List import mons lang builder ToStringBuilder 3 程序程序 1 标识符 设计说明 标识符 设计说明 从本章开始 逐个地给出各个层次中的每个程序的设计考虑 以下给出的提纲是针对 一般情况的 对于一个具体的模块 尤其是层次比较低的模块或子程序 其很多条目的内 容往往与它所隶属的上一层 模块的对应条目的内容相同 在这种情况下 只要简单地说明 这一点即可 3 1 程序描述程序描述 在 hibernate 框架基础之上开发的一套可重用的分页组件 3 2 功能功能 Hibernate 框架mon util EntityHibernate mon util Page Jsp 页面 输出结果 Jsp 页面 搜索 后台处理 6 3 3 性能性能 适用于以 hibernate 为底层框架的任何地方 3 4 输人项输人项 传入的参数 int pageNo int pageSize int totalCount 需要查询的 hql 或者 sql 语句 3 5 输出项输出项 输出对象 Page 包含数据集 3 6 算法算法 Page 类处理 构造函数 默认 param result 本页包含的数据 param start 本页在数据集中的起始位置 param totalCount 数据库记录数 param pageSize 页容量 public Page List results int start int totalCount int pageSize if results null this result new ArrayList else if results size pageSize this result results else this result new ArrayList for int i start i start pageSize this totalCount totalCount 7 当前页 public int getCurrentPageNo return start pageSize 1 获取最大页 总页数 public int getLastPageNo return totalCount pageSize 1 pageSize 当前页记录 public List getResult return result 取数据库中包含的总记录数 public int getTotalCount return totalCount 判断是否有下一页 public boolean hasNextPage return getCurrentPageNo 1 获取指定页在数据集中的起始位置 每页条数使用默认值 从0开始 8 public static int getStartOfPage int pageNo return getStartOfPage pageNo DEFAULT PAGE SIZE 获取指定页在数据集中的起始位置 从0开始 param pageNo param pageSize return public static int getStartOfPage int pageNo int pageSize return Math max pageNo 1 pageSize 0 Hibernate 设置查询数据 int startIndex Page getStartOfPage pageNo pageSize query setFirstResult startIndex query setMaxResults pageSize 3 7 流程逻辑流程逻辑 Jsp 页面 条件 Struts2 action 接口定义的方法 底层处理 调用分页类 9 3 8 接口接口 用图的形式说明本程序所隶属的上一层模块及隶属于本程序的下一层模块 子程序 说明参数赋值和调用方式 说明与本程序相直接关联的数据结构 数据库 数据文卷 Service 层调用 EntityHibernate entityHibernate 需要传递的参数 int pageNo int pageSize int totalCount String hql 或者 String sql 如 pub