当当网详细设计文档V31

通用电子商务平台项目GWAP详细设计说明书Version 3.1General WEB application platform（GWAP 3.1）Design elucidation in detail文档编号：GWAP-03-02NO. GWAP-03-02达内 IT 培训集团通用的电子商务平台 GWAP V3.0 详细设计说明书通用的电子商务平台 GWAP V3.0 详细设计说明书版本标题内容作者时间1.0.0创建创建马东锋08/18/20091.0.1修订1、 详细设计文档中 4.3，技术体系 “数据库”变 更 为“MySQL”。2、 增加异常实现逻辑 6.3.2（向管 理 员 发email）。3、 6.3.1 UML 图Factory 成员隐去。马东锋08/24/2009目录1编写目的.52参考文档.53名称解释.54系统架构.64.1 功能结构.64.2 系统架构.84.2.1 交易系统架构.94.2.2 管理系统架构.94.3 技术体系.105访问控制设计.105.1 访问控制流程图.105.2 访问控制流程说明.116域模型设计.116.1 视图层设计.116.2 控制层设计.126.2.1 类图.126.2.2 类描述.126.2.3 控制文件描述.156.3 业务层设计.256.3.1 类图.256.3.2 类描述.276.4 持久层设计.346.4.1 类图.346.4.2 类描述.366.4.3 映射文件描述.486.5 监听器设计.546.5.1 类图.546.5.2 类描述.546.6 过滤器设计.566.6.1 类图.566.6.2 类描述.567数据库设计.587.1 E-R 图 .587.2 数据实体描述.587.3 实体关系描述.607.4 实体数据初始化.608程序结构设计.619系统环境设计.629.1 开发环境设计.629.2 发布环境设计.639.3 编译和发布工具.639.3.1 ANT 介绍.63通用的电子商务平台 GWAP V3.0 详细设计说明书9.3.2 ANT 在 GWAP 中的使用 .6310用例实现.6810.1 交易系统.6810.1.1 显示首页面.6810.1.2 分类检索.6910.1.3 显示商品明细.7010.1.4 订单列表.7110.1.5 删除订单.7210.1.6 添加商品到购物车.7310.1.7 在购物车中删除一个订单列表 .7410.1.8 在购物车中恢复删除的订单列表 .7510.1.9 修改订单列表中商品数量 .7610.1.10 购物车结算.7710.1.11 订单确认 .7810.1.12 清空购物车.7910.1.13 用户登入.8010.1.14 用户登出.8110.1.15 用户注册.8210.1.16 编辑个人基本信息.8510.1.17 修改 Email .8510.1.18 修改密码.8610.2 管理系统.8710.2.1 商品列表.8710.2.2 添加商品.8810.2.3 修改商品.8910.2.4 删除商品.9010.2.5 管理员登入.9110.2.6 管理员登出.9210.2.7 用户列表.9310.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 应用系统，包括交易系统和管理系统两个独立的子系统，主要包括：商品展示、购物车管理、我的订单、用户管理、商品管理五个功能模块。交易系统功能描述商品展示：实现商品预览、商品明细、分类检索功能。购物车：实现添加商品、删除列表、恢复列表、数量修改、清空购物车、结算功能。我的订单：实现订单确认、订单列表、删除订单、查询明细功能。用户管理：实现登入/登出、用户注册、信息修改功能。管理系统管理描述用户管理：对于系统管理员提供用户删除、用户查询功能。商品管理：实现商品列表、商品发布、商品删除、商品修改功能。4.2 系统架构交易系统和管理系统在系统架构方面完全一致，采用 4 层结构，主要包括：表现层、控制层、业务层、持久层。表现层：主要负责用户交互和结果显示，交易系统和管理系统有不同的 URL 入口界面，详细设计参考“GWAP DEMO”。控制层：主要负责系统的访问控制、数据加载和注销，是系统的核心控制单元。控制层通过系统描述来组织工作。业务层：实现了交易系统和管理系统的主要业务逻辑，是系统主要的运算单元。持久层：实现了静态数据和数据库数据的持久化管理，为业务层提供数据服务，是系统进行数据操作的统一界面。通用的电子商务平台 GWAP V3.0 详细设计说明书4.2.1 交易系统架构4.2.2 管理系统架构通用的电子商务平台 GWAP V3.0 详细设计说明书4.3 技术体系下图描述了本系统将要使用到的具体的技术和工具。HTMLAJAXHibernateMySQLXMLCSSJavaScriptStrutsDBCP/JDBCPROPERTIES5访问控制设计5.1 访问控制流程图通用的电子商务平台 GWAP V3.0 详细设计说明书LOG4JJAVA MAIL5.2 访问控制流程说明结合上图，针对每一个消息请求，按照消息请求/回复顺序，作如下说明。编号12345678910111213消息名称HttpServletRequestActionFormExectuleActionForm.getXxx()BusinessFactory.getBusinessBusiness MethodImportDAOFactory.getDAODao MethodReturn execution resultReturn execution resultActionForward.findForwardHttpServletResponse消息说明浏览器发来的 HttpServletRequest 请求通过 ActionForm 获取 Struts 加载的页面表单数据根据 struts-config.xml 配置调用指定的 Action 指定的方法处理请求通过 ActionForm 获取页面表单数据获得 Business 对象调用业务逻辑使用 Pojo 进行数据操作获得 Dao 对象调用 Dao 方法，执行数据库操作返回 Dao 执行结果，给 Business返回 Business 执行结果，给 ActionAction 返回执行结果给新的画面（Struts-Config.xml 配置）MappingDispatchAction 返回处理结果给浏览器6域模型设计6.1 视图层设计视图层设计参考“GWAP3.1 需求分析说明书.doc”实现效果参考“GWAP(VER1.0)-20090811.zip”通用的电子商务平台 GWAP V3.0 详细设计说明书6.2 控制层设计6.2.1 类图ProductMappingDispatchAction(from .tarena.gwap.web.action)index()showDetail()searchProduct()addProduct()listAllProduct()deleteProductById()toModifyProduct()modifyProduct()MappingDispatchAction(from .tarena.gwap.web.action)ShopCartMappingDispatchAction(from .tarena.gwap.web.action)showShopCart()add2Cart()viewShopCart()removeById()undoById()account()clearShopCart()modifyNumber()checkOut()6.2.2 类描述OrderMappingDispatchAction 订单管理核心控制类UserMappingDispatchAction(from .tarena.gwap.web.action)toLogin()toRegister()checkMail()register()login()manager()listAllUser()isValid()modify()changeEmail()changePwd()delete()query()logout()usernameValidate()OrderMappingDispatchAction(from .tarena.gwap.web.action)deleteOrder()listUserOrders()orderDetail()方法名deleteOrder功能描述删除用户订单.参数和返回值参数异常定义ExceptionActionMapping,ActionForm,HttpServletRequest,HttpServletResponse返回值ActionForwardlistUserOrdersorderDetail显示用户订单列表显示订单明细同上同上ExceptionException通用的电子商务平台 GWAP V3.0 详细设计说明书ProductMappingDispatchAction 商品管理核心控制类方法名addProduct功能描述添加发布商品（管理参数和返回值参数异常定义ExceptionActionMapping,员）ActionForm,HttpServletRequest,HttpServletResponse返回值ActionForwardindex显示我的 GWAP 首页同上Exception面showDetailsearchProductlistAllProductdeleteProductByIdtoModifyProduct显示商品明细按照类别检索商品得到所有的商品删除和下架商品打起修改商品信息页同上同上同上同上同上ExceptionExceptionExceptionExceptionException面modifyProduct修改商品信息同上ExceptionShopCartMappingDispatchAction 购物车管理核心控制类方法名account功能描述统计商品，进入订单确参数和返回值参数异常定义ExceptionActionMapping,认页面ActionForm,HttpServletRequest,HttpServletResponse返回值ActionForward通用的电子商务平台 GWAP V3.0 详细设计说明书showShopCartadd2CartviewShopCartremoveById打起购物车添加商品到购物车暂时没有使用根据商品 ID，从购物同上同上同上同上ExceptionExceptionExceptionException车中移出商品undoById恢复移出商品到购物同上Exception车clearShopCartmodifyNumbercheckOut清空购物车修改商品数量订单检查和入库同上同上同上ExceptionExceptionExceptionUserMappingDispatchAction 用户管理核心控制类方法名changeEmail功能描述修改 Mail 信息.参数和返回值参数异常定义ExceptionActionMapping,ActionForm,HttpServletRequest,HttpServletResponse返回值ActionForwardtoLogintoRegistercheckMailregisterloginmanager调转到登陆画面打起用户注册页面邮箱验证用户注册用户登陆管理员用户登陆同上同上同上同上同上同上ExceptionExceptionExceptionExceptionExceptionException通用的电子商务平台 GWAP V3.0 详细设计说明书listAllUser查找所有用户得到同上Exception用户列表isValid用户信息有效性验同上Exception证modifychangePwddeletequerylogoutusernameValidate编辑个人信息修改个人密码删除用户查询用户.用户退出AJAX 检查用户名是同上同上同上同上同上参数ExceptionExceptionExceptionExceptionExceptionExceptionActionMapping,否存在（用户注册时）ActionForm,HttpServletRequest,HttpServletResponse返回值Void6.2.3 控制文件描述web.xmlweb-app xmlns=xmlns:xsi=http:/www.w3.org/2001/XMLSchema-instance version=2.4xsi:schemaLocation=.tarena.gwap.web.listener.ProductContextListener通用的电子商务平台 GWAP V3.0 详细设计说明书.tarena.gwap.web.listener.CartSessionListenerencodingFilter.tarena.gwap.web.filter.EncodingFilterencodingUTF-8encodingFilter*.doencodingFilter*.jsploginFilter.tarena.gwap.web.filter.LoginFilterloginFilter/product/list.dologinFilter/product/productAdd.do通用的电子商务平台 GWAP V3.0 详细设计说明书loginFilter/product/productModify.dologinFilter/product/productModified.dologinFilter/product/deleteProduct.dologinFilter/user/modify.dologinFilter/user/changeemail.dologinFilter/user/changepwd.do/filter-