软件工程 网上商城项目 详细设计说明书.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 4 程序程序 2 标识符 设计说明 标识符 设计说明 4 2 详细设计说明书详细设计说明书 1 引言引言 1 1 编写目的编写目的 该阶段开发以正式进入软件的实际开发阶段 本阶段完成系统的详细设计并明确系统 的数据结构与软件结构 在软件设计阶段主要是把一个软件需求转化为软件表示的过程 这种表示只是描绘出 软件的总的概貌 本详细设计说明书的目的就是进一步细化软件设计阶段得出的软件总体 概貌 把它加工成在程序细节上非常接近于源程序的软件表示 软件开发小组的每一位参与开发成员应该阅读本说明 以清楚产品在技术方面的要求 和实现策略 本手册将进行技术评审和技术的可行性检查 1 2 背景背景 说明 A 软件系统的名称 BS 网上商城系统 B 任务提出者 BS 电子商务公司 开发者 LEI SKY 软件开发小组 C 本系统将是一个独立的系统 目前所产生的输出都是独立的 本系统将使用 MySql 作为数据库的存储系统 1 3 定义定义 A B S Brower Server B IIS 5 0 Internet Information Server C HTML Hypertext Markup Language 超文本标记语言 D CSS Cascading Style Sheets 层叠样式表单 E JSP Java Server Pages 1 4 参考资料参考资料 相关的文件包括 A 内部文件 BS 网上商城电子商务系统案例研究项目 3 B BS 网上商城电子商务系统案例研究项目合同 20110710 01 C BS 网上商城电子商务系统案例研究项目可行性分析 参考资料 A 国家标准 软件需求说明书 GB856T 88 B 网站开发项目教程 陈密方 中国铁道出版社 软件测试 朱少名 电子工业出版社 合同 A BS 网上商城电子商务系统案例研究项目合同 20110710 01 2 程序系统的结构程序系统的结构 前台功能模 块 商品展示商品购物用户管理 新品上架 特价商品 销售排行 购物车 收银台 会员注册 会员登录 会员资料 商品查询商城公告订单查询 图 1 BS 网上商城前台功能结构图 后台功能模 块 用户管理产品管理统计分析类别管理订单管理退出系统 产品添加 产品修改 产品删除 类别添加 类别修改 类别删除 会员查看 会员修改 会员删除 订单查看 订单修改 网站访问列表 会员购买比例列表 4 图 2 BS 网上商城后台功能结构图 3 产品管理程序设计说明产品管理程序设计说明 3 1 程序描述程序描述 产品管理程序功能的描述 商品的种类信息 详细信息全部通过终端保存在数据库服务器 管理员可以对这 些信息进行增加 修改和删除操作 软件应该提供对管理员的增加 修改和删除的操 作 3 2 功能功能 系统名称BS 网上商城 模块名称产品模块模块编号T001 作者XXX日期2011 7 16 模块简述此模块用于对产品进行增加 修改 删除 搜索等 调用模块 添加 查看 修改 删除 搜索模块 被调用模块无 项目一个指定产品的信息或添加一个新产品 输入 格式所有信息严格按照数据库中表的字段的数据类型填入 处理 当输入产品的信息通过系统调用查看 修改 添加 删除 搜查时 对应的信息被数据库 保存 当提交的信息不成功是 提示相应的处理并返回 输出新产品被输入或者旧的产品信息被新的产品信息所代替并保存在数据库 局部数据元 素 约束条件无 注释涉及的表 产品信息表 Product 表 1 产品信息管理程序模块 IPO 表 3 3 性能性能 在输入产品信息时严格执行数据库表所要求的精度 在执行数据 商品 订单 会员 管理 5 员 增加的时候 不允许出现因为程序的原因导致增加操作失败 也不允许发生重复增加的数 据 在执行数据删除操作的时候 不允许因为程序的原因发生多删除数据 删除失败的情况 数 据的修改也要求保持对应的准确性 管理员输入的精度要求主要取决于数据库的相关数据类型要求 在数据库为系统管理员 提 供的多种视图中将有各类数据库对象的相关数据类型及精度要求 管理员工作过程中可 以利用工具或查询有关数据库对象的精度信息已决定输入的参数 如果管理员输入的参数 与 要求不符将得到提示并重新进行操作 用户输入精度的要求取决于相应功能所需参数的精度要求 用户浏览的页面内如果需 要用户输入相关的信息或参数将给出详细的数据类型说明 并且如果用户在非恶意的情况 下 输入了错误的数据类型参数 系统将自动提示用户再次输入正确的参数 3 4 输人项输人项 名称标识数据类 型 有效范 围 输入方 式 输入媒 体 输入数 据来源 安全保 密条件 数量频度 新产品varchar255手动输 入 键盘 鼠标 商城新 产品 无待定待定 指定以 产品修 改 varchar255手动输 入 键盘 鼠标 数据库 中也有 产品 无待定待定 指定以 产品删 除 数据库 中已有 产品 无待定待定 产品搜 索 varchar255手动输 入 键盘 鼠标 数据库 中已有 产品 无待定待定 表 2 输入项信息表 3 5 输出项输出项 6 名称标识数据类 型 有效范 围 输出方 式 输出媒 体 对应图 形符号 说明 安全保 密条件 数量频度 新产品 被添加 varchar255自动输 出 无待定待定 对应产 品被修 改 varchar255自动输 出 无待定待定 对应产 品被删 除 自动输 出 无待定待定 对应产 品被搜 索 varchar255自动输 出 无待定待定 表 3 输出项信息表 3 6 算法算法 产品添加算法 function check Var selectedCategory document formAdd categoryId options document formAdd categoryId selectedIndex var selectedValue selectedCategory value if 二级分类不等于 2 alert 请选择第二级分类 document formAdd categoryId focus return false else selectedCategory value 将二级分类的 pid 设为 0 return true 多个产品一块删除算法 String idArray request getParameterValues id if idArray null idArray length 0 out println ID 号输入错误 return public void delete String idArray String conditionStr where id in 7 for int i 0 i idArray length i conditionStr idArray i conditionStr conditionStr conditionStr replaceAll conditionStr conditionStr substring 0 conditionStr length 1 System out println conditionStr dao delete conditionStr 3 7 流程逻辑流程逻辑 产品列表 是否添加 新产品 是否修改 产品信息 否 是否删除 产品 否 是否上传 否 结束 否 产品添加 界面 是 产品修改 界面 是 产品删除 界面 是 产品上传 界面 是 图 7 产品模块流程图 8 3 8 接口接口 图 8 产品模块界面 与本程序关联的 Product 表 图 9 Product 表信息图 3 9 存储分配存储分配 本模块由及其自动分配内存 3 10 注释设计注释设计 1 模块首部的注释 用户验证程序 2 对调用函数的注释 调用加密函数 MD5 9 3 11 限制条件限制条件 当系统第一次使用时 具有统一的用户 ID 和密码 超级用户和 123456 在三次验证 错误后 系统自动关闭 3 12 测试计划测试计划 对本单元进行单元测试 进行黑盒测试 检验能否实现功能 输入正确的条件 预期结果 输出信息 输入错 误的条件 预期结果 无法输出信息 提示输入正确条件 进行白盒测试 检验各程序路径是否能执行到 3 13 尚未解决的问题尚未解决的问题 需求中的问题在本设计中已经全部实现 但是 基于一般的考虑 并且在开发工程中 可能会出现功能不完善或者是功能模块缺少的等工程或者后期版本中增加的功能包括 1 公告通知模块 2 统计分析模块 3 广告模块 广告模块是整个网上商城系统中的盈利板块之一 4 完善个人信息空间 增设空间留言 空间网页游戏 空间交友 产品分享 购 买 心得等板块 这样可以增加用户的在线时间 收录更多的好 友 更加方便的了解产品的信息 4 用户管理程序设计说明用户管理程序设计说明 4 1 程序描述程序描述 用户管理程序功能描述 会员的信息全部通过终端保存在数据库服务器 管理员可以对这些信息进行增加 修改和删除操作 软件应该提供对会员的增加 修改和删除的操作 会员本身可以对自 身信息进行增加 查看 修改等功能 4 2 功能功能 10 系统名称BS 网上商城 模块名称用户管理模块模块编号T002 作者XXX日期2011 7 16 模块简述此模块用于对用户信息进行查看 修改 删除等 调用模块 会员查看 修改 删除 搜 索模块 被调用模块无 项目会员的新信息或指定会员的信息 输入 格式所有信息严格按照数据库中表的字段的数据类型填入 处理 当输入会员的信息通过系统调用查看 修改 添加 删除时 对应的信息被数据库保存 当提交的信息不成功是 提示相应的处理并返回 输出新会员被输入或者旧的会员信息被新的会员信息所代替并保存在数据库或会员信息被删除 局部数据元 素 约束条件管理员通过后台登陆成功进入用户管理模块 注释涉及的表 会员信息表 User 表 4 用户管理程序模块 IPO 表 4 3 性能性能 在输入会员信息时严格执行数据库表所要求的精度 在执行数据 商品 订单 会员 管理 员 增加的时候 不允许出现因为程序的原因导致增加操作失败 也不允许发生重复增加的数 据 在执行数据删除操作的时候 不允许因为程序的原因发生多删除数据 删除失败的情况 数 据的修改也要求保持对应的准确性 管理员输入的精度要求主要取决于数据库的相关数据类型要求 在数据库为系统管理员 提 供的多种视图中将有各类数据库对象的相关数据类型及精度要求 管理员工作过程中可 以利用工具或查询有关数据库对象的精度信息已决定输入的参数 如果管理员输入的参数 与 要求不符将得到提示并重新进行操作 用户输入精度的要求取决于相应功能所需参数的精度要求 用户浏览的页面内如果需 要用户输入相关的信息或参数将给出详细的数据类型说明 并且如果用户在非恶意的情况 下 输入了错误的数据类型参数 系统将自动提示用户再次输入正确的参数 4 4 输人项输人项 11 名称标识数据类 型 有效范 围 输入方 式 输入媒 体 输入数 据来源 安全保 密条件 数量频度 会员查 看 varchar255手动输 入 键盘 鼠标 数据库 中的已 有会员 会员信 息被严 格保密 待定待定 指定一 会员修 改 varchar255手动输 入 键盘 鼠标 数据库 中已有 会员 会员信 息被严 格保密 待定待定 指定一 会员删 除 数据库 中已有 会员 会员信 息被严 格保密 待定待定 表 5 用户管理程序模块输入信息表 4 5 输出项输出项 名称标识数据类 型 有效范 围 输出方 式 输出媒 体 对应图 形符号 说明 安全保 密条件 数量频度 会员信 息被输 出 varchar255自动输 出 会员信 息被严 格保密 待定待定 对应会 员信息 被修改 varchar255自动输 出 会员信 息被严 格保密 待定待定 对应会 员信息 被删除 自动输 出 会员信 息被严 格保密 待定待定 表 6 用户管理程序模块输出信息表 4 6 算法算法 会员列表信息算法 final int PAGE SIZE 2 每页显示多少条记录 final int PAGES PER TIME 10 每次显示多少个页码链接 int pageNo 1 String strPageNo request getParameter pageNo if strPageNo null catch NumberFormatException e pageNo 1 12 if pageNo 0 pageNo 1 List users new ArrayList int totalRecords User getUsers users pageNo PAGE SIZE int totalPages totalRecords PAGE SIZE 1 PAGE SIZE if pageNo totalPages pageNo totalPages int start pageNo 1 PAGES PER TIME PAGES PER TIME 1 for int i start i totalPages break if pageNo i a href UserList jsp pageNo 采用如上所示的分页算法 13 4 7 流程逻辑流程逻辑 会员列表 是否添加 新会员 是否修改 会员信息 否 是否删除 会员 否 结束 会员添加 界面 是 会员修改 界面 是 会员删除 界面 是 否 图 10 会员管理模块流程图 4 8 接口接口 图 11 会员管理模块界面 14 与本程序关联的 User 表 图 12 User 表的信息图 4 9 存储分配存储分配 本模块由及其自动分配内存 4 10 注释设计注释设计 1 模块首部的注释 用户验证程序 2 对调用函数的注释 调用加密函数 MD5 4 11 限制条件限制条件 当系统第一次使用时 具有统一的用户 ID 和密码 超级用户和 123456 在三次验证 错误后 系统自动关闭 4 12 测试计划测试计划 对本单元进行单元测试 进行黑盒测试 检验能否实现功能 输入正确的条件 预期结果 输出信息 输入错 误的条件 预期结果 无法输出信息 提示输入正确条件 进行白盒测试 检验各程序路径是否能执行到 4 13 尚未解决的问题尚未解决的问题 需求中的问题在本设计中已经全部实现 但是 基于一般的考虑 并且在开发工程中 15 可能会出现功能不完善或者是功能模块缺少的等工程或者后期版本中增加的功能包括 1 公告通知模块 2 统计分析模块 3 广告模块 广告模块是整个网上商城系统中的盈利板块之一 4 完善个人信息空间 增设空间留言 空间网页游戏 空间交友 产品分享 购 买 心得等板块 这样可以增加用户的在线时间 收录更多的好 友 更加方便的了解产品的信息 5 订单管理程序设计说明订单管理程序设计说明 5 1 程序描述程序描述 订单管理程序功能的描述 订单的信息全部通过终端保存在数据库服务器 管理员可以对这些信息进行增 加 修改和删除操作 软件应该提供对订单的增加和删除的操作 会员可以通过登 录查看自己的订单信息及过去的交易记录 5 2 功能功能 系统名称BS 网上商城 模块名称订单模块模块编号T003 作者XXX日期2011 7 16 模块简述此模块用于对订单进行查看 修改 删除等 调用模块 订单的查看 修改 删除模 块 被调用模块无 项目产品的订单列表信息 输入 格式所有信息严格按照数据库中表的字段的数据类型填入 处理 当订单的信息通过系统调用查看 修改 删除时 对应的信息被数据库保存 当提交的信息不成功是 提示相应的处理并返回 输出原订单信息被新的信息代替 并保存在数据库 局部数据元 素 约束条件无 16 注释涉及的表 订单信息表 SalesOrder 表 7 订单程序模块的 IPO 表 5 3 性能性能 在执行数据 商品 订单 会员 管理员 增加的时候 不允许出现因为程序的原因导致增加 操作失败 也不允许发生重复增加的数据 在执行数据删除操作的时候 不允许因为程序的原 因发生多删除数据 删除失败的情况 数据的修改也要求保持对应的准确性 管理员输入的精度要求主要取决于数据库的相关数据类型要求 在数据库为系统管理员 提 供的多种视图中将有各类数据库对象的相关数据类型及精度要求 管理员工作过程中可 以利用工具或查询有关数据库对象的精度信息已决定输入的参数 如果管理员输入的参数 与 要求不符将得到提示并重新进行操作 用户输入精度的要求取决于相应功能所需参数的精度要求 用户浏览的页面内如果需 要用户输入相关的信息或参数将给出详细的数据类型说明 并且如果用户在非恶意的情况 下 输入了错误的数据类型参数 系统将自动提示用户再次输入正确的参数 5 4 输人项输人项 名称标识数据类 型 有效范 围 输入方 式 输入媒 体 输入数 据来源 安全保 密条件 数量频度 订单查 看 varchar255手动输 入 键盘 鼠标 数据库 中的已 有订单 订单会 员信息 被严格 保密 待定待定 指定一 订单修 改 varchar255手动输 入 键盘 鼠标 数据库 中已有 订单 订单会 员信息 被严格 保密 待定待定 指定一 订单删 除 数据库 中已有 订单 订单会 员信息 被严格 保密 待定待定 表 8 订单程序模块的输入项信息表 5 5 输出项输出项 名称标识数据类 型 有效范 围 输出方 式 输出媒 体 对应图 形符号 安全保 密条件 数量频度 17 说明 订单信 息被输 出 varchar255自动输 出 订单会 员信息 被严格 保密 待定待定 对应订 单信息 被修改 varchar255自动输 出 订单会 员信息 被严格 保密 待定待定 对应订 单信息 被删除 自动输 出 订单会 员信息 被严格 保密 待定待定 表 9 订单程序模块的输出向信息表 5 6 算法算法 订单列表所用到的算法 分页算法 String strPageNo request getParameter pageno int pageNo 1 if strPageNo null pageNo Integer parseInt strPageNo if pageNo get all the users List orders new ArrayList int totalRecords OrderMgr getInstance getOrders orders pageNo PAGE SIZE int totalPages totalRecords PAGE SIZE 1 PAGE SIZE if pageNo totalPages pageNo totalPages 按id进行展现算法 SalesOrder so OrderMgr getInstance loadById uid 18 public SalesOrder loadById int id Connection conn DB getConn Statement stmt DB getStatement conn ResultSet rs null SalesOrder so null try String sql select salesorder id salesorder userid salesorder odate salesorder addr salesorder status user id uid user username user password user addr uaddr user phone user rdate from salesorder join user on salesorder userid user id where salesorder id id rs DB getResultSet stmt sql if rs next User u new User u setId rs getInt uid u setAddr rs getString uaddr u setUsername rs getString username u setPassword rs getString password u setPhone rs getString phone u setRdate rs getTimestamp rdate so new SalesOrder so setId rs getInt id so setAddr rs getString addr so setODate rs getTimestamp odate so setStatus rs getInt status so setUser u catch SQLException e e printStackTrace finally DB close rs DB close stmt DB close conn return so 19 5 7 流程逻辑流程逻辑 订单列表 是否查看 订单明细 是否修改 订单状态 否 结束 否 订单明细界 面 是 订单修改界 面 是 图 13 订单管理程序模块流程图 5 8 接口接口 图 14 产品模块界面 与本程序关联的 salesorder 表 20 图 15 salesorder 表的信息图 5 9 存储分配存储分配 本模块由及其自动分配内存 5 10 注释设计注释设计 1 模块首部的注释 用户验证程序 2 对调用函数的注释 调用加密函数 MD5 5 11 限制条件限制条件 当系统第一次使用时 具有统一的用户 ID 和密码 超级用户和 123456 在三次验证 错误后 系统自动关闭 5 12 测试计划测试计划 对本单元进行单元测试 进行黑盒测试 检验能否实现功能 输入正确的条件 预期结果 输出信息 输入错 误的条件 预期结果 无法输出信息 提示输入正确条件 进行白盒测试 检验各程序路径是否能执行到 5 13 尚未解决的问题尚未解决的问题 需求中的问题在本设计中已经全部实现 但是 基于一般的考虑 并且在开发工程中 可能会出现功能不完善或者是功能模块缺少的等工程或者后期版本中增加的功能包括 1 公告通知模块 21 2 统计分析模块 3 广告模块 广告模块是整个网上商城系统中的盈利板块之一 4 完善个人信息空间 增设空间留言 空间网页游戏 空间交友 产品分享 购 买 心得等板块 这样可以增加用户的在线时间 收录更多的好 友 更加方便的了解产品的信息 6 类别管理程序设计说明类别管理程序设计说明 6 1 程序描述程序描述 类别管理程序功能的描述 商品的种类信息 详细信息全部通过终端保存在数据库服务器 管理员可以对这 些信息进行增加 修改和删除操作 软件详细展示商品的类别信息 并且商品的添加必 须在二级子类别及以下添加 6 2 功能功能 系统名称BS 网上商城 模块名称类别管理模块模块编号T001 作者XXX日期2011 7 16 模块简述此模块用于对类别进行查看 增加 修改 删除等 调用模块 添加 查看 修改 删除模 块 被调用模块无 项目一个指定类别的信息或输入一个新的类别 输入 格式所有信息严格按照数据库中表的字段的数据类型填入 处理 当输入产品的类别信息通过系统调用查看 修改 添加 删除时 对应的信息被数据库保 存 当提交的信息不成功是 提示相应的处理并返回 输出新产品类别被输入或者旧的产品类别信息被新的产品类别信息所代替并保存在数据库 局部数据元 素 约束条件无 注释涉及的表 类别表 Category 表 10 类别管理程序模块的 IPO 表 6 3 性能性能 在输入产品信息时严格执行数据库表所要求的精度 在执行数据 商品 订单 会员 管理 22 员 增加的时候 不允许出现因为程序的原因导致增加操作失败 也不允许发生重复增加的数 据 在执行数据删除操作的时候 不允许因为程序的原因发生多删除数据 删除失败的情况 数 据的修改也要求保持对应的准确性 管理员输入的精度要求主要取决于数据库的相关数据类型要求 在数据库为系统管理员 提 供的多种视图中将有各类数据库对象的相关数据类型及精度要求 管理员工作过程中可 以利用工具或查询有关数据库对象的精度信息已决定输入的参数 如果管理员输入的参数 与 要求不符将得到提示并重新进行操作 用户输入精度的要求取决于相应功能所需参数的精度要求 用户浏览的页面内如果需 要用户输入相关的信息或参数将给出详细的数据类型说明 并且如果用户在非恶意的情况 下 输入了错误的数据类型参数 系统将自动提示用户再次输入正确的参数 6 4 输人项输人项 名称标识数据类 型 有效范 围 输入方 式 输入媒 体 输入数 据来源 安全保 密条件 数量频度 新产品 类别 varchar255手动输 入 键盘 鼠标 商品新 类别 无待定待定 指定以 产品修 改 varchar255手动输 入 键盘 鼠标 数据