通用的电子商务平台 GWAP V3.0 详细设计说明书 通用电子商务平台项目 GWAP 详细设计说明书 Version 3.1 General WEB application platform （GWAP 3.1） Design elucidation in detail 文档编号：GWAP-03-02 NO.[ GWAP-03-02] 达内 IT 培训集团 通用的电子商务平台 GWAP V3.0 详细设计说明书 版本 标题 内容 作者 时间 1.0.0 创建 创建 马东锋 08/18/2009 1.0.1 修订 1、 详细设计文档 中 4.3，技术体 系 “数据库” 变更为 “MySQL”。 2、 增加异常实现 逻辑 6.3.2（向 管理员发 email）。 3、 6.3.1 UML 图 Factory 成员隐 去。 马东锋 08/24/2009 通用的电子商务平台 GWAP V3.0 详细设计说明书 目 录 1．编写目的.....................................................................................................................................5 2．参考文档.....................................................................................................................................5 3．名称解释.....................................................................................................................................5 4．系统架构.....................................................................................................................................6 4.1 功能结构............................................................................................................................6 4.2 系统架构............................................................................................................................8 4.2.1 交易系统架构.........................................................................................................9 4.2.2 管理系统架构.........................................................................................................9 4.3 技术体系..........................................................................................................................10 5．访问控制设计...........................................................................................................................10 5.1 访问控制流程图..............................................................................................................10 5.2 访问控制流程说明..........................................................................................................11 6．域模型设计...............................................................................................................................11 6.1 视图层设计......................................................................................................................11 6.2 控制层设计......................................................................................................................12 6.2.1 类图.......................................................................................................................12 6.2.2 类描述...................................................................................................................12 6.2.3 控制文件描述.......................................................................................................15 6.3 业务层设计......................................................................................................................25 6.3.1 类图.......................................................................................................................25 6.3.2 类描述...................................................................................................................27 6.4 持久层设计......................................................................................................................34 6.4.1 类图.......................................................................................................................34 6.4.2 类描述...................................................................................................................36 6.4.3 映射文件描述.......................................................................................................48 6.5 监听器设计......................................................................................................................54 6.5.1 类图.......................................................................................................................54 6.5.2 类描述...................................................................................................................54 6.6 过滤器设计......................................................................................................................56 6.6.1 类图.......................................................................................................................56 6.6.2 类描述...................................................................................................................56 7．数据库设计...............................................................................................................................58 7.1 E-R 图...............................................................................................................................58 7.2 数据实体描述..................................................................................................................58 7.3 实体关系描述..................................................................................................................60 7.4 实体数据初始化..............................................................................................................60 8．程序结构设计...........................................................................................................................61 9．系统环境设计...........................................................................................................................62 9.1 开发环境设计..................................................................................................................62 9.2 发布环境设计..................................................................................................................63 9.3 编译和发布工具..............................................................................................................63 9.3.1 ANT 介绍...............................................................................................................63 通用的电子商务平台 GWAP V3.0 详细设计说明书 9.3.2 ANT 在 GWAP 中的使用 .....................................................................................63 10．用例实现.................................................................................................................................68 10.1 交易系统........................................................................................................................68 10.1.1 显示首页面.........................................................................................................68 10.1.2 分类检索.............................................................................................................69 10.1.3 显示商品明细.....................................................................................................70 10.1.4 订单列表.............................................................................................................71 10.1.5 删除订单.............................................................................................................72 10.1.6 添加商品到购物车.............................................................................................73 10.1.7 在购物车中删除一个订单列表.........................................................................74 10.1.8 在购物车中恢复删除的订单列表.....................................................................75 10.1.9 修改订单列表中商品数量.................................................................................76 10.1.10 购物车结算.......................................................................................................77 10.1.11 订单确认............................................................................................................78 10.1.12 清空购物车.......................................................................................................79 10.1.13 用户登入...........................................................................................................80 10.1.14 用户登出...........................................................................................................81 10.1.15 用户注册...........................................................................................................82 10.1.16 编辑个人基本信息...........................................................................................85 10.1.17 修改 Email ........................................................................................................85 10.1.18 修改密码...........................................................................................................86 10.2 管理系统........................................................................................................................87 10.2.1 商品列表.............................................................................................................87 10.2.2 添加商品.............................................................................................................88 10.2.3 修改商品.............................................................................................................89 10.2.4 删除商品.............................................................................................................90 10.2.5 管理员登入.........................................................................................................91 10.2.6 管理员登出.........................................................................................................92 10.2.7 用户列表.............................................................................................................93 10.2.8 删除用户.............................................................................................................94 通用的电子商务平台 GWAP V3.0 详细设计说明书 1．编写目的 明确业务背景、业务范围、基本业务逻辑和业务框架，期望读者包括：项目发起人、最 终用户、项目投资方、项目管理团队、项目执行团队，以及其他项目干系人。 2．参考文档 ¾ “GWAP1.x 需求分析说明书.doc”：需求分析说明书模板。 ¾ “GWAP 需求变更意见.doc”：需求变更说明。 ¾ “TTS 会议纪要(2009-07-31).doc”：项目启动会议纪要。 ¾ “系统需求分析（Ver 1.0）.doc”：前一版本的需求分析。 ¾ “GWAP3.1 需求分析说明书.doc”：系统需求分析说明书。 3．名称解释 ¾ GWAP：通用 WEB 应用平台（General WEB application platform）。 ¾ B/S：Browser/Server（浏览器/服务器）。 ¾ C/S：Client/Server（客户端/服务器）。 ¾ B2B：Business to Business 商家对商家，电子商务的一种业务形式。 ¾ B2C：Business to Consumer 商家对顾客，电子商务的一种业务形式。 ¾ C2C：Consumer to Consumer 顾客对顾客，电子商务的一种业务形式。 ¾ CSS：是 Cascading Style Sheets(层叠样式表)的简称，CSS 语言是一种标记语言,它不 需要编译可以直接由浏览器执行。 ¾ HTML：Hypertext Markup Language 超文字标记语言。 ¾ JAVASCRIPT：一种由 Sun Microsystems 所开发的程序脚本语言(它是一种严密的物件 导向的语言,适合在网际网络上发展主从架构的应用程序)，常常简称 JS。 通用的电子商务平台 GWAP V3.0 详细设计说明书 4．系统架构 4.1 功能结构 通用的电子商务平台 GWAP V3.0 详细设计说明书 GWAP通用WEB 应用平台 商品管理 商品发布 商品修改 商品删除 商品列表 商品展示 商品明细 商品预览 购物车 删除列表 数量修改 清空购物车 添加商品 查询明细 订单确认 订单列表 用户管理 用户列表 用户注册 信息修改 登入/登出 用户删除 我的订单 分类检索 恢复列表 结算 删除订单 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用 WEB 应用系统，包括交易系统和管理系统两个独立的子系统，主要包括：商品展示、 购物车管理、我的订单、用户管理、商品管理五个功能模块。 ¾ 交易系统功能描述 9 商品展示：实现商品预览、商品明细、分类检索功能。 9 购物车：实现添加商品、删除列表、恢复列表、数量修改、清空购物车、结算功能。 9 我的订单：实现订单确认、订单列表、删除订单、查询明细功能。 9 用户管理：实现登入/登出、用户注册、信息修改功能。 ¾ 管理系统管理描述 9 用户管理：对于系统管理员提供用户删除、用户查询功能。 9 商品管理：实现商品列表、商品发布、商品删除、商品修改功能。 4.2 系统架构 交易系统和管理系统在系统架构方面完全一致，采用 4 层结构，主要包括：表现层、控 制层、业务层、持久层。 表现层：主要负责用户交互和结果显示，交易系统和管理系统有不同的 URL 入口界面， 详细设计参考“GWAP DEMO”。 控制层：主要负责系统的访问控制、数据加载和注销，是系统的核心控制单元。控制层 通过系统描述来组织工作。 业务层：实现了交易系统和管理系统的主要业务逻辑，是系统主要的运算单元。 持久层：实现了静态数据和数据库数据的持久化管理，为业务层提供数据服务，是系统 进行数据操作的统一界面。 通用的电子商务平台 GWAP V3.0 详细设计说明书 4.2.1 交易系统架构 4.2.2 管理系统架构 通用的电子商务平台 GWAP V3.0 详细设计说明书 4.3 技术体系 下图描述了本系统将要使用到的具体的技术和工具。 CSS JavaScriptHTML MySQL XML PROPERTIES Hibernate DBCP/JDBC AJAX Struts JAVA MAIL LOG4J 5．访问控制设计 5.1 访问控制流程图 通用的电子商务平台 GWAP V3.0 详细设计说明书 5.2 访问控制流程说明 结合上图，针对每一个消息请求，按照消息请求/回复顺序，作如下说明。 编号 消息名称 消息说明 1 HttpServletRequest 浏览器发来的 HttpServletRequest 请求 2 ActionForm 通过 ActionForm 获取 Struts 加载的页面表单数据 3 Exectule 根据 struts-config.xml 配置调用指定的 Action 指定的方法 处理请求 4 ActionForm.getXxx() 通过 ActionForm 获取页面表单数据 5 BusinessFactory .getBusiness 获得 Business 对象 6 Business Method 调用业务逻辑 7 Import 使用 Pojo 进行数据操作 8 DAOFactory.getDAO 获得 Dao 对象 9 Dao Method 调用 Dao 方法，执行数据库操作 10 Return execution result 返回 Dao 执行结果，给 Business 11 Return execution result 返回 Business 执行结果，给 Action 12 ActionForward.findForward Action 返回执行结果给新的画面（Struts-Config.xml 配置） 13 HttpServletResponse MappingDispatchAction 返回处理结果给浏览器 6．域模型设计 6.1 视图层设计 ¾ 视图层设计参考“GWAP3.1 需求分析说明书.doc” ¾ 实现效果参考“GWAP(VER1.0)-20090811.zip” 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.2 控制层设计 6.2.1 类图 MappingDispatchAction (from cn.com.tarena.gwap.web.action) OrderMappingDispatchAction deleteOrder() listUserOrders() orderDetail() (from cn.com.tarena.gwap.web.action) ProductMappingDispatchAction index() showDetail() searchProduct() addProduct() listAllProduct() deleteProductById() toModifyProduct() modifyProduct() (from cn.com.tarena.gwap.web.action) ShopCartMappingDispatchAction showShopCart() add2Cart() viewShopCart() removeById() undoById() account() clearShopCart() modifyNumber() checkOut() (from cn.com.tarena.gwap.web.action) UserMappingDispatchAction toLogin() toRegister() checkMail() register() login() manager() listAllUser() isValid() modify() changeEmail() changePwd() delete() query() logout() usernameValidate() (from cn.com.tarena.gwap.web.action) 6.2.2 类描述 ¾ OrderMappingDispatchAction 订单管理核心控制类 方法名 功能描述 参数和返回值 异常定义 deleteOrder 删除用户订单. 参数 ActionMapping, ActionForm, HttpServletRequest, HttpServletResponse 返回值 ActionForward Exception listUserOrders 显示用户订单列表 同上 Exception orderDetail 显示订单明细 同上 Exception 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ ProductMappingDispatchAction 商品管理核心控制类 方法名 功能描述 参数和返回值 异常定义 addProduct 添加发布商品（管理 员） 参数 ActionMapping, ActionForm, HttpServletRequest, HttpServletResponse 返回值 ActionForward Exception index 显示我的 GWAP 首页 面 同上 Exception showDetail 显示商品明细 同上 Exception searchProduct 按照类别检索商品 同上 Exception listAllProduct 得到所有的商品 同上 Exception deleteProductById 删除和下架商品 同上 Exception toModifyProduct 打起修改商品信息页 面 同上 Exception modifyProduct 修改商品信息 同上 Exception ¾ ShopCartMappingDispatchAction 购物车管理核心控制类 方法名 功能描述 参数和返回值 异常定义 account 统计商品，进入订单确 认页面 参数 ActionMapping, ActionForm, HttpServletRequest, HttpServletResponse 返回值 ActionForward Exception 通用的电子商务平台 GWAP V3.0 详细设计说明书 showShopCart 打起购物车 同上 Exception add2Cart 添加商品到购物车 同上 Exception viewShopCart 暂时没有使用 同上 Exception removeById 根据商品 ID，从购物 车中移出商品 同上 Exception undoById 恢复移出商品到购物 车 同上 Exception clearShopCart 清空购物车 同上 Exception modifyNumber 修改商品数量 同上 Exception checkOut 订单检查和入库 同上 Exception ¾ UserMappingDispatchAction 用户管理核心控制类 方法名 功能描述 参数和返回值 异常定义 changeEmail 修改 Mail 信息. 参数 ActionMapping, ActionForm, HttpServletRequest, HttpServletResponse 返回值 ActionForward Exception toLogin 调转到登陆画面 同上 Exception toRegister 打起用户注册页面 同上 Exception checkMail 邮箱验证 同上 Exception register 用户注册 同上 Exception login 用户登陆 同上 Exception manager 管理员用户登陆 同上 Exception 通用的电子商务平台 GWAP V3.0 详细设计说明书 listAllUser 查找所有用户得到 用户列表 同上 Exception isValid 用户信息有效性验 证 同上 Exception modify 编辑个人信息 同上 Exception changePwd 修改个人密码 同上 Exception delete 删除用户 同上 Exception query 查询用户. 同上 Exception logout 用户退出 同上 Exception usernameValidate AJAX 检查用户名是 否存在（用户注册 时） 参数 ActionMapping, ActionForm, HttpServletRequest, HttpServletResponse 返回值 Voi d Exception 6.2.3 控制文件描述 ¾ web.xml cn.com.tarena.gwap.web.listener.ProductContextListener 通用的电子商务平台 GWAP V3.0 详细设计说明书 cn.com.tarena.gwap.web.listener.CartSessionListener encodingFilter cn.com.tarena.gwap.web.filter.EncodingFilter encoding UTF-8 encodingFilter *.do encodingFilter *.jsp loginFilter cn.com.tarena.gwap.web.filter.LoginFilter loginFilter /product/list.do loginFilter /product/productAdd.do 通用的电子商务平台 GWAP V3.0 详细设计说明书 loginFilter /product/productModify.do loginFilter /product/productModified.do loginFilter /product/deleteProduct.do loginFilter /user/modify.do loginFilter /user/changeemail.do loginFilter /user/changepwd.do loginFilter /user/query.do loginFilter /user/delete.do loginFilter /user/listAllUser.do loginFilter /user/add2cart.do 通用的电子商务平台 GWAP V3.0 详细设计说明书 loginFilter /shopcart/showShopCart.do loginFilter /shopcart/removeProduct.do loginFilter /shopcart/updateProductNum.do loginFilter /shopcart/removeAllProduct.do loginFilter /user/saveOrder.do loginFilter /order/list.do loginFilter /order/delete.do action org.apache.struts.action.ActionServlet config /WEB-INF/classes/struts-config.xml debug 3 detail 通用的电子商务平台 GWAP V3.0 详细设计说明书 3 0 action *.do ¾ struts-config.xml 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.3 业务层设计 6.3.1 类图 通用的电子商务平台 GWAP V3.0 详细设计说明书 CategoryBusinessImpl CategoryBusinessImpl() findTreeBYCategoryID() getChildCategoryBYFatcherID() getFatcherCategoryBYChildID() findAllChildCategoryBYFatcherID() findCategoryBYID() (from cn.com.tarena.gwap.biz.impl) OrderBusinessImpl OrderBusinessImpl() deleteOrderById() findAllOrders() getOrderById() getOrderListByUserName() deleteOrder() checkOut() (from cn.com.tarena.gwap.biz.impl) OrderStatusBusinessImpl OrderStatusBusinessImpl() findAllOrderStatus() (from cn.com.tarena.gwap.biz.impl) PayWayBusinessImpl PayWayBusinessImpl() findAllPayWay() (from cn.com.tarena.gwap.biz.impl) ProductBusinessImpl ProductBusinessImpl() getProductById() findAllProducts() deleteProductById() modifyProduct() addProduct() findAllProductByCategoryID() (from cn.com.tarena.gwap.biz.impl) ShoppingCart ShoppingCart() getOrders() setOrders() addProduct() addOrdeLine() removeProductById() removeAllProducts() isEmpty() modifyProductAmountById() getTotalPrice() getTotalPriceTemp() findProduct() setUndoID() (from cn.com.tarena.gwap.biz.impl) UserBusinessImpl UserBusinessImpl() deleteUserByName() findAllUsers() getUserByName() hasUser() updateUserInfo() userRegister() (from cn.com.tarena.gwap.biz.impl) BusinessFactory (from cn.com.tarena.gwap.biz.factory) ICategory Business (from cn....) IOrderBusi ness (from cn.c...) IOrderStatu sBusiness (from cn.co...) IPayWayBu siness (from cn.co...) IProductBus iness (from cn.co...) IShoppingCa rt (from cn.co...) IUserBusine ss (from cn.co...) 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.3.2 类描述 ¾ CategoryBusinessImpl 商品类别管理实现类 方法名 功能描述 参数和返回值 异常定义 findAllChildCategoryBYFatcherID 根据父类别 ID 得到 其下没有层次的所 有类别的集合 （LIST） 参数： Long 返回： List:the list< category> GWAPException findTreeBYCategoryID 得到从特定类别 ID 开始，封装好的类别 树（MAP）. 参数： Long 返回： Map: 所有类别的 Map GWAPException getChildCategoryBYFatcherID 根据父类别得到紧 下一级子类别集合 （MAP）. 参数： Long 返回： Map: 商品类别 Map GWAPException getFatcherCategoryBYChildID 根据当前类别 ID 得 到父类别 参数： Long 返回： Category: 商品类别 Pojo GWAPException findCategoryBYID 根据类别 ID 得到类 别信息 参数： Long 返回： Category GWAPException ¾ OrderBusinessImpl 订单管理实现类 方法名 功能描述 参数和返回值 异常定义 通用的电子商务平台 GWAP V3.0 详细设计说明书 checkOut 根据订单 Pojo，下此订 单. 参数： Orders: 订单 Pojo 返回： void GWAPException deleteOrderById 根据订单 ID 删除相应 的订单 参数： Long 返回： void GWAPException findAllOrders 取得全部的订单 参数： / 返回： List: 全部订单的 List GWAPException getOrderById 根据订单 ID 获得相应 订单 参数： Long 返回： Orders: 订单 ID 的订 单 GWAPException getOrderListByUserName 根据用户 ID 取得相应 的订单 List 参数： String 返回： List: 用户 ID 的订单 List GWAPException deleteOrder 根据订单 Pojo 删除相 应的订单 参数： Orders 返回： void GWAPException ¾ OrderStatusBusinessImpl 订单状态管理实现类 方法名 功能描述 参数和返回值 异常定义 findAllOrderStatus 取得全部的订单状态. 参数： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 / 返回： List: 全部订单状态的 List ¾ PayWayBusinessImpl 付款方式实现类 方法名 功能描述 参数和返回值 异常定义 findAllPayWay 取得全部的支付方法 式. 参数： Long 返回： List: 全部支付方法的 List GWAPException ¾ ProductBusinessImpl 商品管理实现类 方法名 功能描述 参数和返回值 异常定义 addProduct 添加商品. 参数： Product 返回： void GWAPException getProductById 根据商品 ID 取得相应 的商品 参数： Long 返回： Product: 商品 Pojo GWAPException findAllProducts 取得全部的商品 参数： / 返回： List：所有商品的 List GWAPException deleteProductById 删除商品根据指定的 商品 ID 参数： Long 返回： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 void modifyProduct 修改商品根据指定的 商品 ID 参数： Product 返回： void GWAPException findAllProductByCategoryID 根据指定的类别 ID 得 到其下所有商品 参数： Long 返回： List: 所有商品的 List GWAPException ¾ ShoppingCart 购物车管理实现类 方法名 功能描述 参数和返回值 异常定义 addOrdeLine Adds the orde line. 参数： OrderLine 返回： void GWAPException getOrders Gets the orders 参数： / 返回： Orders GWAPException setOrders Sets the orders 参数： Orders 返回： void GWAPException addProduct 向购物车中增加一个 商品 参数： Product int 返回： void GWAPException removeProductById 根据商品 ID 在购物车 参数： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 中删除一个商品 OrderLine 返回： void removeAllProducts 删除购物车中所有的 商品 参数： Long 返回： void GWAPException isEmpty Checks if is empty 参数： / 返回： bolean GWAPException modifyProductAmountById 根据商品 ID，修改购 物车中此商品的数量 参数： Long int 返回： void GWAPException getTotalPrice 获得购物车中商品金 额的合计 参数： / 返回： double: 商品价格合计 GWAPException getTotalPriceTemp / 参数： / 返回： double GWAPException findProduct 从购物车中获取订单 列表 参数： Long 返回： OrderLine: 订单列表 GWAPException setUndoID / 参数： String 返回： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 void ¾ UserBusinessImpl 用户管理实现类 方法名 功能描述 参数和返回值 异常定义 deleteUserByName 根据用户 Pojo，删除相 应用户. 参数： String 返回： boolean GWAPException findAllUsers 取得全部的用户 参数： / 返回： List: 全部用的 List GWAPException getUserByName 根据用户 ID 取得相应 的用户 参数： String 返回： User: 用户 Pojo GWAPException hasUser 根据用户 username，检 查相应用户在数据库 中是否已经存在 参数： String 返回： boolean: true 存在相 应用户, false 不存在 相应用户 GWAPException updateUserInfo 更新用户信息. 参数： User 返回： void GWAPException userRegister 根据用户 Pojo 和联系 信息 Pojo，注册一个新 用户 参数： User 返回： void GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.4 持久层设计 6.4.1 类图 通用的电子商务平台 GWAP V3.0 详细设计说明书 IOrderLineDAO (from cn.com.tarena.gwap.dao) ICategoryDAO (from cn.com.tarena.gwap.dao) IOrdersDAO (from cn.com.tarena.gwap.dao) IOrderStatusDAO (from cn.com.tarena.gwap.dao) IPayWayDAO (from cn.com.tarena.gwap.dao) IProductDAO (from cn.com.tarena.gwap.dao) IUserDAO (from cn.com.tarena.gwap.dao) OrdersDAOImpl COST : String NAME : String delete() findAllOrders() findByCost() findByExample() findById() findByName() findByProperty() lock() merge() save() saveOrUpdate() (from cn.com.tarena.gwap.dao.impl) CategoryDAOImpl DESCRIPTION : String NAME : String delete() findAllCategory() findByDescription() findByExample() findById() findByName() findByProperty() getChildCategoryBYFatcherID() getFatcherCategoryBYChildID() lock() merge() save() saveOrUpdate() (from cn.com.tarena.gwap.dao.impl) OrderLineDAOImpl AMOUNT : String delete() findAllOrderLine() findByAmount() findByExample() findById() findByProperty() lock() merge() save() saveOrUpdate() (from cn.com.tarena.gwap.dao.impl) OrderStatusDAOImpl DESCRIPTION : String NAME : String delete() findAllOrderStatus() findByDescription() findByExample() findById() findByName() findByProperty() lock() merge() save() saveOrUpdate() (from cn.com.tarena.gwap.dao.impl) PayWayDAOImpl PAYSTYLE : String delete() findAllPayWay() findByExample() findById() findByPaystyle() findByProperty() lock() merge() save() saveOrUpdate() (from cn.com.tarena.gwap.dao.impl) ProductDAOImpl AUTHOR : String BASEPRICE : String DESCRIPTION : String IMAGES : String NAME : String PAGES : String PUBLISH : String delete() findAllProducts() findByAuthor() findByBaseprice() findByDescription() findByExample() findById() findByImages() findByName() findByPages() findByProperty() findByPublish() lock() merge() save() saveOrUpdate() (from cn.com.tarena.gwap.dao.impl) UserDAOImpl PASSWORD : String delete() deleteUserById() findAllUsers() findByExample() findById() findByName() findByPassword() findByProperty() lock() merge() modifyUserPassword() save() saveOrUpdate() (from cn.com.tarena.gwap.dao.impl) DAOFactory (from cn.com.tarena.gwap.dao.factory) 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.4.2 类描述 ¾ CategoryDAOImpl 提供产品分类相关数据库操作 方法名 功能描述 参数和返回值 异常定义 delete 根据持久化 的 Pojo 删除 数据库中相 应数据. 参数： Category 返回： void GWAPException findAllCategory 取得全部的 商品分类. 参数： / 返回： List: 全 部 的 产 品 分 类 的 List GWAPException findByDescription Find by description. 参数： Object 返回： List GWAPException findByExample 根据范例 Pojo 取得数 据库中的相 应数据. 参数： Category 返回： List: Pojo 的 List GWAPException findById 根据 Pojo 的 主键取得数 据库中的相 应数据. 参数： Long 返回： Category GWAPException findByName Find by name. 参数： Object 返回： List GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 findByProperty 根据 Pojo 的 属性名和 Pojo 属性的 值在数据库 中取得相应 数据. 参数： String Object 返回： List: Pojo 的 List GWAPException getChildCategoryBYFatcherID 取得子的 Category 对 象集合，根 据当前 category.id。 参数： Long 返回： List GWAPException getFatcherCategoryBYChildID 取得父亲 Category 对 象，根据当 前 category.id。 参数： Long 返回： Category GWAPException lock 把游离的 Pojo 再次变 成持久化的 Pojo. 参数： Category 返回： void GWAPException merge 合并游离的 Pojo，使游离 的 Pojo 再次 变成持久化 的 Pojo. 参数： Category 返回： Category GWAPException save 把尚未持久 化的 Pojo 登 录至数据库. 参数： Category 返回： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 void saveOrUpdate 根据 Pojo 的 状态，进行 登录或者更 新至数据库 的操作. 参数： Category 返回： void GWAPException ¾ OrderLineDAOImpl 提供订单明细相关数据库操作 方法名 功能描述 参数和返回值 异常定义 delete 根据持久化的 Pojo 删 除数据库中相应数据. 参数： OrderLine 返回： void GWAPException findAllOrderLine 取得全部的订单明细. 参数： / 返回： List GWAPException findByAmount Find by amount. 参数： Object 返回： List GWAPException findByExample 根据范例 Pojo 取得数 据库中的相应数据. 参数： OrderLine 返回： List: Pojo 的 List GWAPException findById 根据 Pojo 的主键取得 数据库中的相应数据. 参数： Long 返回： OrderLine GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 findByProperty 根据 Pojo 的属性名和 Pojo 属性的值在数据 库中取得相应数据. 参数： String Object 返回： List GWAPException lock 把游离的 Pojo 再次变 成持久化的 Pojo. 参数： OrderLine 返回： void GWAPException merge 合并游离的 Pojo，使游 离的 Pojo 再次变成持 久化的 Pojo. 参数： OrderLine 返回： OrderLine GWAPException save 把尚未持久化的 Pojo 登录至数据库. 参数： OrderLine 返回： void GWAPException saveOrUpdate 根据 Pojo 的状态，进 行登录或者更新至数 据库的操作. 参数： OrderLine 返回： void GWAPException ¾ OrdersDAOImpl 提供订单相关数据库操作 方法名 功能描述 参数和返回值 异常定义 delete 根据持久化的 Pojo 删 除数据库中相应数据. 参数： Orders 返回： void GWAPException findAllOrders Method 参数： / GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 In IOrdersDAO. 返回： List findByCost Find by cost. 参数： Object 返回： List GWAPException findByExample 根据范例 Pojo 取得数 据库中的相应数据. 参数： Orders 返回： List GWAPException findById 根据 Pojo 的主键取得 数据库中的相应数据. 参数： Long 返回： Orders GWAPException findByName Find by name. 参数： Object 返回： List GWAPException findByProperty 根据 Pojo 的属性名和 Pojo 属性的值在数据 库中取得相应数据. 参数： String Object 返回： List GWAPException lock 把游离的 Pojo 再次变 成持久化的 Pojo. 参数： Orders 返回： void GWAPException save 把尚未持久化的 Pojo 登录至数据库. 参数： Orders 返回： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 void merge 合并游离的 Pojo，使游 离的 Pojo 再次变成持 久化的 Pojo. 参数： Orders 返回： Orders GWAPException saveOrUpdate 根据 Pojo 的状态，进 行登录或者更新至数 据库的操作. 参数： Orders 返回： void GWAPException ¾ OrderStatusDAOImpl 提供订单状态相关数据库 方法名 功能描述 参数和返回值 异常定义 delete 根据持久化的 Pojo 删 除数据库中相应数据. 参数： OrderStatus 返回： void GWAPException findAllOrderStatus Method In IOrdersDAO. 参数： / 返回： List GWAPException findByDescription Find by description. 参数： Object 返回： List GWAPException findByExample 根据范例 Pojo 取得数 据库中的相应数据. 参数： OrderStatus 返回： List GWAPException findById 根据 Pojo 的主键取得 参数： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 数据库中的相应数据. Long 返回： OrderStatus findByName Find by name. 参数： Object 返回： List GWAPException findByProperty 根据 Pojo 的属性名和 Pojo 属性的值在数据 库中取得相应数据. 参数： String Object 返回： List GWAPException lock 把游离的 Pojo 再次变 成持久化的 Pojo. 参数： OrderStatus 返回： void GWAPException save 把尚未持久化的 Pojo 登录至数据库.. 参数： OrderStatus 返回： void GWAPException merge 合并游离的 Pojo，使游 离的 Pojo 再次变成持 久化的 Pojo.. 参数： OrderStatus 返回： OrderStatus GWAPException saveOrUpdate 根据 Pojo 的状态，进 行登录或者更新至数 据库的操作. 参数： OrderStatus 返回： void GWAPException ¾ PayWayDAOImpl 提供支付方式相关数据库操作 方法名 功能描述 参数和返回值 异常定义 delete 根据持久化的 Pojo 删 参数： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 除数据库中相应数据. PayWay 返回： void findAllPayWay Method in IPayWayDAO. 参数： / 返回： List GWAPException findByExample 根据范例 Pojo 取得数 据库中的相应数据. 参数： PayWay 返回： List: Pojo 的 List GWAPException findById 根据 Pojo 的主键取得 数据库中的相应数据. 参数： Long 返回： PayWay GWAPException findByPaystyle Find by paystyle. 参数： Object 返回： List GWAPException findByProperty 根据 Pojo 的属性名和 Pojo 属性的值在数据 库中取得相应数据. 参数： String Object 返回： List GWAPException lock 把游离的 Pojo 再次变 成持久化的 Pojo. 参数： PayWay 返回： void GWAPException merge 合并游离的 Pojo，使游 离的 Pojo 再次变成持 参数： PayWay GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 久化的 Pojo 返回： PayWay save 把尚未持久化的 Pojo 登录至数据库. 参数： PayWay 返回： void GWAPException saveOrUpdate 根据 Pojo 的状态，进 行登录或者更新至数 据库的操作 同上 GWAPException ¾ ProductDAOImpl 提供商品相关数据库操作 方法名 功能描述 参数和返回值 异常定义 delete 根据持久化的 Pojo 删 除数据库中相应数据. 参数： Product 返回： void GWAPException findAllProducts Method in IProductDAO. 参数： / 返回： List GWAPException findByAuthor Find by author. 参数： Object 返回： List GWAPException findByBaseprice Find by baseprice. 同上 GWAPException findByDescription Find by description. 同上 GWAPException findByExample 根据范例 Pojo 取得数 据库中的相应数据. 参数： Product 返回： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 List findById 根据 Pojo 的主键取得 数据库中的相应数据. 参数： Long 返回： Product GWAPException findByImages Find by images. 参数： Object 返回： List GWAPException findByName Find by name. 同上 GWAPException findByPages Find by pages. 同上 GWAPException findByProperty 根据 Pojo 的属性名和 Pojo 属性的值在数据 库中取得相应数据. 参数： String Object 返回： List GWAPException findByPublish Find by publish. 参数： Object 返回： List GWAPException lock 把游离的 Pojo 再次变 成持久化的 Pojo 参数： Product 返回： void GWAPException merge 合并游离的 Pojo，使游 离的 Pojo 再次变成持 久化的 Pojo 参数： Product 返回： Product GWAPException save 把尚未持久化的 Pojo 参数： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 登录至数据库 Product 返回： void saveOrUpdate 根据 Pojo 的状态，进 行登录或者更新至数 据库的操作 同上 GWAPException ¾ UserDAOImpl 提供用户相关数据库操作 方法名 功能描述 参数和返回值 异常定义 delete 根据持久化的 Pojo 删 除数据库中相应数据. 参数： User 返回： void GWAPException deleteUserById Delete user by id 参数： String 返回： void GWAPException findAllUsers IUserDAO 参数： / 返回： List GWAPException findByExample 根据范例 Pojo 取得数 据库中的相应数据 参数： User 返回： List: Pojo 的 List GWAPException findById 根据 Pojo 的主键取得 数据库中的相应数据 参数： Long 返回： User GWAPException findByName Find by name 参数： String 返回： GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 User findByPassword Find by password 参数： Object 返回： List GWAPException findByProperty 根据 Pojo 的属性名和 Pojo 属性的值在数据 库中取得相应数据 参数： String Object 返回： List GWAPException lock 把游离的 Pojo 再次变 成持久化的 Pojo 参数： User 返回： void GWAPException merge 合并游离的 Pojo，使游 离的 Pojo 再次变成持 久化的 Pojo 参数： User 返回： User GWAPException modifyUserPassword 根据用户 Pojo，修改用 户的密码 参数： User 返回： void GWAPException save 把尚未持久化的 Pojo 登录至数据库 同上 GWAPException saveOrUpdate 根据 Pojo 的状态，进 行登录或者更新至数 据库的操作 同上 GWAPException 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.4.3 映射文件描述 ¾ Category.hbm.xml ¾ OrderLine.hbm.xml ¾ Orders.hbm.xml 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ OrderStatus.hbm.xml 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ PayWay.hbm.xml ¾ Product.hbm.xml 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ User.hbm.xml 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.5 监听器设计 6.5.1 类图 CartSessionListener log : Log sessionCreated() sessionDestroyed() (from cn.com.tarena.gwap.web.listener) HibernateListener contextInitialized() contextDestroyed() (from cn.com.tarena.gwap.web.listener) ProductContextListener log : Log contextDestroyed() contextInitialized() (from cn.com.tarena.gwap.web.listener) HttpSessionListener (from cn.com.tarena.gwap.web.lis...) 6.5.2 类描述 ¾ CartSessionListener 购物车监听器 方法名 功能描述 参数和返回值 异常定义 通用的电子商务平台 GWAP V3.0 详细设计说明书 sessionCreated 初始化购物车对象到 session 中 参数： HttpSessionEvent 返回： void / sessionDestroyed 销毁 session 中购物车 对象 同上 / ¾ ProductContextListener 商品内容监听器 方法名 功能描述 参数和返回值 异常定义 contextInitialized 初始化（系统启动），加载 IProductBusiness ， IPayWayBusiness ， IOrderStatusBusiness ， ICategoryBusiness 到内存。 参数： ServletContextEvent 返回： void / contextDestroyed 注销监听器 同上 / 通用的电子商务平台 GWAP V3.0 详细设计说明书 6.6 过滤器设计 6.6.1 类图 LoginFilter config : FilterConfig log : Log init() doFilter() destroy() (from cn.com.tarena.gwap.web.filter) EncodingFilter config : FilterConfig encoding : String log : Log init() doFilter() destroy() (from cn.com.tarena.gwap.web.filter) Filter (from cn.com.tarena.gwap.web.f...) 6.6.2 类描述 ¾ EncodingFilter 编码过滤器 方法名 功能描述 参数和返回值 异常定义 init 初始化 web.xml 配置 的过滤规则. 参数： FilterConfig 返回： void ServletException doFilter 编码过滤 参数： ServletRequest ServletResponse FilterChain IOException, ServletException 通用的电子商务平台 GWAP V3.0 详细设计说明书 返回： void destroy 注销过滤器调用 / / ¾ LoginFilter 登陆过滤器 方法名 功能描述 参数和返回值 异常定义 init 初始化过滤规则. 参数： FilterConfig 返回： void ServletException doFilter 登陆过滤功能（限制非 法用户） 参数： ServletRequest ServletResponse FilterChain 返回： void IOException, ServletException destroy 注销过滤器调用 / / 通用的电子商务平台 GWAP V3.0 详细设计说明书 7．数据库设计 7.1 E-R 图 7.2 数据实体描述 ¾ 类别表（category） 字段名称 类型 约束 描述 category_id integer pk 类别 id fathercategoryid integer not null 父类别 id name varchar(128) not null 类别名 description varchar(512) / 类别说明 ¾ 商品表（product） 字段名称 类型 约束 描述 product _id integer auto_increment/ pk 商品 id name varchar(40) not null 商品名 basePrice numeric(12,2) not null 单价 category_id integer / 类别 id author varchar(128) not nul 作者 publish varchar(256) not nul 出版社 pages int / 页数 通用的电子商务平台 GWAP V3.0 详细设计说明书 images varchar(128) / 图片 description varchar(512) / 描述 ¾ 用户表（users） 字段名称 类型 约束 描述 username varchar(20) pk 用户名 password varchar(12) not null 密码 email varchar(32) not null Email telephone varchar(16) / 固定电话 mobtelephone varchar(16) / 移动电话 province varchar(32) / 省份 city varchar(32) / 城市 address varchar(200) / 地址 state integer not null 用户状态（0-已验证、1-未验证） confirmcode varchar(20) not null 验证码 ¾ 订单状态表（orderstatus） 字段名称 类型 约束 描述 orderstatus_id integer pk 状态 id name varchar(20) not null 状态名称 description varchar(64) / 状态描述 ¾ 付款方式表（payway） 字段名称 类型 约束 描述 payway_id integer pk 付款方式 id paystyle varchar(64) not null 付款方式名称 ¾ 订单表（orders） 字段名称 类型 约束 描述 orders_id integer auto_increment / pk 订单 id username varchar(20) not null 用户名称 payway_id integer / 付款方式 id orderstatus_id integer / 订单状态 id name varchar(20) / 订单名称（用户名-日期） cost numeric(15,3) not null 订单金额 ¾ 订单项表（orderline） 通用的电子商务平台 GWAP V3.0 详细设计说明书 字段名称 类型 约束 描述 orderline_id integer auto_increment / pk 订单项 id orders_id integer not null 订单 id product_id integer not null 商品 id amount numeric(20,2) not null 商品数量 7.3 实体关系描述 alter table product add constraint product_category_id_fk foreign key(category_id) references category(category_id); alter table orders add constraint orders_username_fk foreign key(username) references users(username); alter table orders add constraint orders_payway_fk foreign key(payway_id) references payway(payway_id); alter table orders add constraint orders_orderstatus_fk foreign key(orderstatus_id) references orderstatus(orderstatus_id); alter table orderline add constraint orderline_orders_id_fk foreign key(orders_id) references orders(orders_id); alter table orderline add constraint orderline_product_id_fk foreign key(product_id) references product(product_id); 7.4 实体数据初始化 --初始化商品类别表 insert into category values(1,0,'小说','顶级分类'); insert into category values(2,0,'文学','顶级分类'); insert into category values(3,0,'商业','顶级分类'); insert into category values(4,0,'艺术','顶级分类'); insert into category values(5,1,'当代小说','当代小说'); insert into category values(6,1,'近代小说','近代小说'); --初始化商品表 INSERT INTO product VALUES(1,'杜拉拉 2 华年似水(《杜拉拉升职记》第二部：超越职场 的华年似水)','希望这本虚构的小说，能够对人们的生活有一些超越职场规则的现实意义，使 我能回报市场和读者的知遇于万一
\r\n。——李可
\r\n2005－2006 年，中国一线城市。
\r\n 对大部分人而言，挣钱的速度明显跟不上房价的涨幅。而沉寂四年的 A 股正走出漫 漫熊途，开始了从 998 向 6140 的辉煌进发。
\r\n 淡泊从容越来越成为奢侈，时代在湍 通用的电子商务平台 GWAP V3.0 详细设计说明书 急中奔流。
\r\n 作为对各种难题胸有成竹的 PROBLEM SOLVER，杜拉拉日显强大。当 女性的缺点和可爱，日益为专业的成熟及规则所取代，
\r\n 让人不禁疑惑“成熟”是褒 义还是贬义？而职场版的说文解字中，下属无性别，上级的性别则只关乎授权的程度， WHY 比 WHAT 更重要。
\r\n 每个人都有难处：姚杨年过而立竞聘经理失败，怀孕日程遥遥无 期；李坤掏心掏肺栽培小苏，反遭小苏翻脸无情；林如成被下属的发财气得发疯，
\r\n 但无从干掉业绩不错的股神杨瑞；TONY 林认为培训生制度弱智，却被迫协助好大喜功的 HR 成就功名。
\r\n 对八十后沙当当而言，爱人不是问题，问题是房子的产权。
\r\n 对七十后杜拉拉而言，失恋不是问题，问题是没有更好的恋情。
\r\n 宽带薪酬制中吃了 亏的拉拉决定跳槽，怀着恶劣的心情，在 2006 炎热的盛夏，她踏上了漫漫的求职之路⋯⋯ 作为著名的“倔驴”，她一直以为：你我会情长意久。
\r\n 中产之梦多半就是在这号人 手中实现的。 ',28.00,5,'李可','陕西师范大学出版',283,'images/product/zb_20232215_m.jpg'); --初始化用户信息表 INSERT INTO users VALUES ('admin', 'admin', 'admin@tarena.com.cn', '021-61209549', '13900000000', '上海', '上海', '北京东路 668 弄', 0, '12345678'); INSERT INTO users VALUES ('tarena', 'tarena', 'tarena@tarena.com.cn', '021-61209549', '13900000000', '上海', '上海', '北京东路 668 弄', 0, '12345678'); --初始化订单状态表 INSERT INTO orderstatus VALUES (1,'付款...','等待买家付款...'); INSERT INTO orderstatus VALUES (2,'收获...','等待买家收获确认...'); INSERT INTO orderstatus VALUES (3,'结束','订单已经关闭。'); --初始化付款方式表 INSERT INTO payway VALUES (1,'货到付款'); INSERT INTO payway VALUES (2,'邮局汇款'); INSERT INTO payway VALUES (3,'银行转帐'); 8．程序结构设计 必须使用相同的工程名、目录结构和目录名规范，具体要求如下： 项目 要求 说明 项目名称 GWAP(VER3.0)-0x 每个小组使用一个仓库，0x 代码自己项目组 的编号（每组项目名称相同） 项目目录 环境 GWAP(VER3.0)-0x — CVS |— doc |— lib |— refer |— sql |— src |— test |— web |— release CVS：连接 cvs 后自动产生的桩文件 doc：项目 java 代码 api 文件 lib：项目需要使用的第三方包 refer：主要包括 design、task、test 三个文件 夹 sql：存放“数据库创建、数据初始化”脚本 文件 src：系统 java 代码，目录结构参考“工程 代码” 通用的电子商务平台 GWAP V3.0 详细设计说明书 test：junit 测试代码，和 src 结构对应 Web：web 工程文件目录，如：jsp、js、css 等 release：临时文件加，ant 自动维护 JAVA 代 码结构 src—cn—com—tarena—gwap—biz |—common |—dao |—exception |—pojo |—web—action |—filter |—forms |—listener |—messages biz：业务层代码，包括 impl 和接口类 common：工具包，hib 的 dao 工具和 log dao：数据持久层，包括 impl 和接口类 exception：自定义异常类 pojo：数据库表映射类 action：4 个主要控制器 filter：过滤器 forms：struts 表单类 listener：监听器 messages：struts 资源文件 xxx.properties WEB 代码 结构 web—css |—images |—js |—order |—product |—shopcart |—user |—WEB-INF |—xxx.jsp css：存放 tarene.css 文件，和其它 css 文件 images：图片 js：tarena.Js 文件，和其它 JavaScripter 文件 order：订单管理相关 JSP 文件 product：商品管理相关 JSP 文件 shopcart：购物车相关 JSP 文件 user：用户管理相关 JSP 文件 WEB-INF：默认目录，编译后的文件和 xml xxx.jsp：顶级 JSP 文件 IDE 配置 Web Context-root : /gwap3 Source : src 和 test JRE : jdk1.6.0 Compiler compliance level : 6.0 Text file encoding : UTF-8 工程名-右键-Properties 9．系统环境设计 9.1 开发环境设计 ¾ 操作系统：Red Had Linux9 或 WINDOWS XP ¾ 虚拟机：jdk-6-linux-i586 或 jdk-6-win-i586 ¾ 浏览器：FireFox2.0 或 IE6 ¾ Web 服务器：Apache Tomcat 6.0 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ 数据库：MySql 5.5 ¾ 设计工具：IBM Rose 2003 ¾ IDE 工具：MyEclipse6.0（集成 Eclipse3.3） 9 数据库客户端插件：Quantum DB3.0 9 E-R 插件：clay1.4 9 代码风格插件：checkstyle4.3 9.2 发布环境设计 ¾ 操作系统：Red Had Linux9 或 WINDOWS XP ¾ 虚拟机：jdk-6-linux-i586 或 jdk-6-win-i586 ¾ 浏览器：FireFox2.0 或 IE6 ¾ Web 服务器：Apache Tomcat 6.0 ¾ 数据库：MySql 5.5 9.3 编译和发布工具 9.3.1 ANT 介绍 ¾ ANT 的概念：ANT 是著名 Java 开源组织 Apache 的一个项目，是一个基于 java 的 build 工具。它可以使你通过 ant 脚本语言，自动你的项目拷贝到某个目录，发布项目，或者生成 一些代码，执行SQL 语言。总之它可以帮助你完成项目开发中除了开发代码以外的大部分辅 助性工作。 ¾ ANT 的作用：当一个代码项目大了以后，每次重新编译，打包，测试等都会变得非常复 杂而且重复。JAVA 使用 ANT（一种流程脚本引擎），用于自动化调用程序完成项目的编译， 打包，测试等工作。每个 ANT 脚本（缺省叫 build.xml）中设置了一系列任务(target)。 9.3.2 ANT 在 GWAP 中的使用 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用的电子商务平台 GWAP V3.0 详细设计说明书 Welcome GWAP]]> Tarena All Rights Reserved.]]> 通用的电子商务平台 GWAP V3.0 详细设计说明书 通用的电子商务平台 GWAP V3.0 详细设计说明书 10．用例实现 10.1 交易系统 10.1.1 显示首页面 ¾ 功能概述 交易系统门户、首页面，交易功能入口界面。 ¾ 组件定义 /index.jsp /product/productIndex.jsp View ProductMappingDispatchAction 对应 index 方法 Action Service Dao ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml ProductMapping DispatchAction 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：index 5: 从Session中取的所有商品 6: 商品集合：List 7: 响应请求 10.1.2 分类检索 ¾ 功能概述 通过系统首页面进入，进行商品按类别分类减速。 ¾ 组件定义 /product/productIndex.jsp /product/productSearch.jsp View ProductMappingDispatchAction searchProduct 方法 Action ProductBusinessImpl 商品管理业务处理 Service CategoryBusinessImpl 商品类别管理业务处理 ProductDAOImpl 商品管理数据持久层操作 Dao CategoryBusinessImpl 商品类别数据持久层操作 ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml ProductMapping DispatchAction CategoryBus inessImpl CategoryDA OImpl 1: 页面请求 4: 处理方法：searchProduct() 5: 获取页面参数 6: 获得所有商品从session 7: 循环构造指定类别下商品的MAP(categoryid,products) 2: 获取配置 3: Action对象 8: 调用方法：findAllChildCategoryBYFatcherID() 9: 循环得到类别树：MAP 10: MAP 11: 返回所有类别：List 12: 循环构造出类别下所有商品：List 13: 类别集合，商品集合 14: 响应请求 10.1.3 显示商品明细 ¾ 功能概述 通过系统首页面、分类检索页面进入，查看商品详细信息。 ¾ 组件定义 /product/productIndex.jsp /product/productSearch.jsp View /product/productDetail.jsp ProductMappingDispatchAction showDetail 方法 Action ProductBusinessImpl 商品管理业务处理 Service ProductDAOImpl 商品管理数据持久层操作 Dao 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ 序列图 :Browser ActionServle t struts- config.xml ProductMapping DispatchAction ProductBusi nessImpl ProductDAO Impl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：showDetail 10: 响应请求 5: 根据商品ID获得商品对象 6: findById 7: Product 8: Product 9: Product 10.1.4 订单列表 ¾ 功能概述 登陆用户，通过任意页面“我的当当”进入，默认显示当前交易用户的订单列表。 ¾ 组件定义 /product/productIndex.jsp /inc/header.jsp 系统同一的也头 View /order/myorders.jsp 订单列表信息 OrderMappingDispatchAction listUserOrders 方法 Action OrderBusinessImpl 订单管理业务类 Service OrdersDAOImpl 订单管理数据持久层操作 Dao ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml OrderMapping DispatchAction OrderBusine ssImpl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：listUserOrders 6: 根据用户ID取得相应的订单List 7: 订单列表List 8: 订单列表List 9: 响应请求 5: 获取用户信息从SESSION中 10.1.5 删除订单 ¾ 功能概述 登陆用户，在“订单列表”页面删除指定的一个订单。 ¾ 组件定义 /order/myorders.jsp View OrderMappingDispatchAction deleteOrder 方法 Action OrderBusiness 订单管理业务类 Service OrdersDAOImpl 订单管理数据持久层操作 Dao ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml OrderMapping DispatchAction OrderBusine ssImpl OrdersDAOI mpl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：deleteOrder 6: 删除订单：deleteOrder 9: 删除结果 10: 订单列表List 5: 获得要删除订单ID 11: 响应请求 7: 删除订单：delete 8: 10.1.6 添加商品到购物车 ¾ 功能概述 登陆用户，从商品明细画面，添加一个商品到购物车。 ¾ 组件定义 /product/productDetail.jsp /shopcart/shoppingcart.jsp View ShopCartMappingDispatchAction add2Cart 方法（数据保存在 Session 中） Action Service Dao ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml ShopCartMappin gDispatchAction 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：add2Cart 7: 购物车 8: 响应请求 5: 从SESSION中获得购物车 6: 更新购物车中的商品列表 10.1.7 在购物车中删除一个订单列表 ¾ 功能概述 登陆用户，在购物车页面临时取消一个已经选购的商品。 ¾ 组件定义 /shopcart/shoppingcart.jsp View ShopCartMappingDispatchAction removeById 方法 Action Service Dao 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ 序列图 :Browser ActionServle t struts- config.xml ShopCartMappin gDispatchAction ProductBusi nessImpl ProductDAO Impl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：removeById 7: 更新购物车 5: 从SESSION中获得购物车 6: 将删除商品放入删除列表 8: 响应请求 10.1.8 在购物车中恢复删除的订单列表 ¾ 功能概述 登陆用户，恢复购物车临时删除的商品。 ¾ 组件定义 /shopcart/shoppingcart.jsp View ShopCartMappingDispatchAction undoById 方法 Action Service Dao ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml ShopCartMappin gDispatchAction 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：undoById 7: 更新购物车 5: 从SESSION中获得删除订单项列表 6: 将UNDO的商品ID放入UNDO LIST中 8: 响应请求 10.1.9 修改订单列表中商品数量 ¾ 功能概述 登陆用户，修改购物清单中，选购商品数量。 ¾ 组件定义 /shopcart/shoppingcart.jsp View ShopCartMappingDispatchAction modifyNumber 方法 Action ShoppingCart 购物车 Service Dao ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml ShopCartMappin gDispatchAction ShoppingCa rt 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：modifyNumber 8: 修改商品数量：modifyProductAmountById 9: 修改结果 10: 订单列表List 5: 获得商品ID 11: 响应请求 6: 获得数量 7: 从SESSION中获得购物车 10.1.10 购物车结算 ¾ 功能概述 登陆用户，商品选购完成，结算购物车中商品，进入订单确认页面。 ¾ 组件定义 /shopcart/shoppingcart.jsp /shopcart/checkout.jsp View ShopCartMappingDispatchAction Account 方法 Action ShoppingCart 购物车管理类 Service Dao 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ 序列图 :Browser ActionServle t struts- config.xml ShopCartMappin gDispatchAction ShoppingCa rt 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：account 7: 移出删除的商品：removeProductById 8: 需求结算的购物车 9: 需求结算的购物车 5: 从SESSION中获得购物车 6: 从SESSION中获得实际删除列表 10: 响应请求 10.1.11 订单确认 ¾ 功能概述 登陆用户，订单确认页面（可以修改收获信息）。 ¾ 组件定义 /shopcart/checkout.jsp /order/myorders.jsp View ShopCartMappingDispatchAction checkOut 方法 Action 通用的电子商务平台 GWAP V3.0 详细设计说明书 OrderBusinessImpl 订单管理实现类 Service ShoppingCart 购物车管理类 OrdersDAOImpl 提供订单相关数据库操作 Dao ¾ 序列图 ShoppingCa rt :Browser ActionServle t struts- config.xml ShopCartMappin gDispatchAction OrderBusine ssImpl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：checkOut 7: 订单入库：checkOut 10: 入库结果 12: 订单列表 5: 从SESSION中获得购物车 13: 响应请求 6: 更新（订单）收获信息 11: 清空购物车：removeAllProducts 8: checkOut 9: 入库结果 10.1.12 清空购物车 ¾ 功能概述 登陆用户，清空购物车中选购的所有商品。 ¾ 组件定义 /shopcart/shoppingcart.jsp /product/productIndex.jsp View Action ShopCartMappingDispatchAction clearShopCart 方法 通用的电子商务平台 GWAP V3.0 详细设计说明书 ShoppingCart 购物车管理类 Service Dao ¾ 序列图 :Browser ActionServle t struts- config.xml ShopCartMappin gDispatchAction ShoppingCa rt 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：clearShopCart 8: 返回交易页面 5: 从SESSION中获得购物车 9: 响应请求 6: removeAllProducts 7: 清除结果 10.1.13 用户登入 ¾ 功能概述 注册用户登陆。 ¾ 组件定义 /product/productIndex.jsp View /user/signin.jsp 通用的电子商务平台 GWAP V3.0 详细设计说明书 UserMappingDispatchAction Login 方法 Action UserUtil checkUser 用户登陆工具类 Service Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction UserUtil 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：login 9: 返回交易页面 5: 取得输入参数 6: 用户验证：checkUser 7: 返回用户信息 10: 响应请求 8: 保存USER对象到SESSION 10.1.14 用户登出 ¾ 功能概述 已经登入用户登出系统。 ¾ 组件定义 /product/productIndex.jsp View /inc/header.jsp 通用的电子商务平台 GWAP V3.0 详细设计说明书 UserMappingDispatchAction Logout 方法 Action Service Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：logout 7: 返回首页面（admin到登入页面） 5: 从SESSION中获取用户信息 6: 清除SESSION中USER对象 8: 响应请求 10.1.15 用户注册 ¾ 功能概述 未注册用户，注册成为系统交易用户。 ¾ 组件定义 通用的电子商务平台 GWAP V3.0 详细设计说明书 /product/productIndex.jsp /inc/header.jsp /user/register.jsp View /user/registed.jsp UserMappingDispatchAction toRegister 方法 Action UserMappingDispatchAction Register 方法 UserMappingDispatchAction usernameValidate 方法验证（用户是否存在） UserBusinessImpl 用户管理实现类 Service UserDAOImpl 用户管理的数据操作 Dao ¾ 序列图 通用的电子商务平台 GWAP V3.0 详细设计说明书 :Browser ActionServle t struts- config.xml 判断是否存 在 UserBusines sImpl UserDAOIm pl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：usernameValidate 8: 返回判断信息 9: 响应请求 5: 得到所有用户：findAllUsers 6: 7: 判断是否存在 18: 页面请求 19: 获取对象 20: Action对象 21: 处理方法：register 22: 得到注册信息，生成USER对象 23: userRegister 24: userRegister 25: 26: 27: 返回结果 28: 响应请求 10: 页面请求 17: 响应请求 11: 获取对象 12: Action对象 13: 处理方法：checkMail 14: 生成验证码 15: 发送验证码 16: 通用的电子商务平台 GWAP V3.0 详细设计说明书 10.1.16 编辑个人基本信息 ¾ 功能概述 登陆用户，修改个人基本信息。 ¾ 组件定义 /user/myarchives.jsp View UserMappingDispatchAction Modify 方法 Action UserBusinessImpl 用户管理实现类 Service UserDAOImpl 用户管理的数据操作 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction UserBusines sImpl UserDAOIm pl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：modify 9: 返回更新页面 5: 获取界面输入 10: 响应请求 6: 更新个人信息：updateUserInfo 7: 返回新的USER 8: 更新SESSION 10.1.17 修改 Email ¾ 功能概述 通用的电子商务平台 GWAP V3.0 详细设计说明书 登陆用户，修改用户 Email 信息。 ¾ 组件定义 /user/myemail.jsp View Action UserMappingDispatchAction changeEmail 方法 Service UserBusinessImpl 用户管理实现类 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction UserBusines sImpl UserDAOIm pl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：changeEmail 9: 返回更新页面 5: 获取界面输入 6: 更新个人EMAIL 7: 返回新的USER 8: 更新SESSION 10: 响应请求 10.1.18 修改密码 ¾ 功能概述 登陆用户，修改个人登陆密码。 ¾ 组件定义 通用的电子商务平台 GWAP V3.0 详细设计说明书 /user/passwordchange.jsp View Action UserMappingDispatchAction changePwd 方法 Service UserBusinessImpl 用户管理实现类 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction UserBusines sImpl UserDAOIm pl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：changePwd 9: 返回更新页面 5: 获取界面输入 6: 更新密码 7: 返回新的USER 8: 更新SESSION 10: 响应请求 10.2 管理系统 10.2.1 商品列表 ¾ 功能概述 管理员登入后，进入商品列表，删除和修改商品。 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ 组件定义 /product/productList.jsp View ProductMappingDispatchAction listAllProduct 方法 Action ProductBusinessImpl 商品管理类 Service ProductDAOImpl 商品管理的数据操作 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml ProductMapping DispatchAction ProductBusi nessImpl ProductDAO Impl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：listAllProduct 10: 响应请求 5: 取得所有商品：findAllProducts 8: List 9: 商品信息List 6: findAllProducts 7: List 10.2.2 添加商品 ¾ 功能概述 管理员登入后，添加发布商品。 ¾ 组件定义 /product/addProduct.jsp View 通用的电子商务平台 GWAP V3.0 详细设计说明书 ProductMappingDispatchAction addProduct 方法 Action ProductBusinessImpl 商品管理类 Service CategoryBusinessImpl 商品类别管理类 ProductDAOImpl 商品管理的数据操作 Dao CategoryDAOImpl 商品类别管理的数据操作 ¾ 序列图 :Browser ActionServle t struts- config.xml ProductMapping DispatchAction ProductBusi nessImpl ProductDAO Impl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：addProduct 7: 添加商品：addProduct 10: 添加结果 8: save 9: void 11: 商品列表List 12: 响应请求 5: 取得界面输入 6: 上传商品图片 10.2.3 修改商品 ¾ 功能概述 管理员登入后，修改商品信息。 ¾ 组件定义 通用的电子商务平台 GWAP V3.0 详细设计说明书 /product/productList.jsp /product/productModify.jsp View ProductMappingDispatchAction toModifyProduct 方法 Action ProductMappingDispatchAction modifyProduct 方法 ProductBusinessImpl 商品管理实现类 Service ProductDAOImpl 商品管理的 DAO 操作 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml ProductMapping DispatchAction ProductBusi nessImpl ProductDAO Impl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：modifyProduct 6: 修改商品：modifyProduct 9: 添加结果 7: saveOrUpdate 8: void 5: 取得界面输入 12: 响应请求 11: 商品列表List 10: 更新内存中商品信息 10.2.4 删除商品 ¾ 功能概述 管理员登入后，删除指定商品。 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ 组件定义 /product/productList.jsp View ProductMappingDispatchAction deleteProductById 方法 Action ProductBusinessImpl 商品管理实现类 Service ProductDAOImpl 商品管理的 DAO 操作 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml ProductMapping DispatchAction ProductBusi nessImpl ProductDAO Impl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：deleteProductById 6: 删除商品：getProductById 9: 添加结果 7: delete 8: void 5: 取得要删除的商品ID 11: 商品列表List 10: 更新内存中商品信息 12: 响应请求 10.2.5 管理员登入 ¾ 功能概述 管理用户，登入功能。 ¾ 组件定义 通用的电子商务平台 GWAP V3.0 详细设计说明书 /manager.jsp /user/userList.jsp View UserMappingDispatchAction Manager 方法 Action Service Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction UserUtil 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：manager 9: 返回管理页面 5: 取得输入参数 6: 用户验证：checkUser 7: 返回用户信息 8: 保存USER对象到SESSION 10: 响应请求 10.2.6 管理员登出 ¾ 功能概述 管理员登出。 ¾ 组件定义 通用的电子商务平台 GWAP V3.0 详细设计说明书 /manager.jsp View UserMappingDispatchAction logout 方法 Action Service Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：logout 7: 返回登入页面 5: 从SESSION中获取用户信息 6: 清除SESSION中USER对象 8: 响应请求 10.2.7 用户列表 ¾ 功能概述 管理员用户登入后，显示用户列表功能。 通用的电子商务平台 GWAP V3.0 详细设计说明书 ¾ 组件定义 /manager.jsp /user/userList.jsp View UserMappingDispatchAction listAllUser 方法 Action UserBusinessImpl 用户管理业务实现类 Service UserDAOImpl 用户管理数据操作类 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction UserBusines sImpl UserDAOIm pl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：listAllUser 9: 返回用户列表 10: 响应请求 5: findAllUsers 6: findAllUsers 7: List 8: List 10.2.8 删除用户 ¾ 功能概述 管理员用户登入后，删除列表中用户（admin 不可以删除）。 ¾ 组件定义 /user/userList.jsp View 通用的电子商务平台 GWAP V3.0 详细设计说明书 UserMappingDispatchAction Delete 方法 Action UserBusinessImpl 用户管理业务实现类 Service UserDAOImpl 用户管理数据操作类 Dao ¾ 序列图 :Browser ActionServle t struts- config.xml UserMappingDi spatchAction UserBusines sImpl UserDAOIm pl 1: 页面请求 2: 获取对象 3: Action对象 4: 处理方法：delete 11: 返回新用户列表 6: deleteUserByName 8: delete 9: boolean 10: boolean 12: 响应请求 5: 取得删除用户Name 7: 删除级联订单 -----------------------------------------------------完-----------------------------------------------------