GWAP3.1详细设计说明书

通用电子商务平台项目GWAP详细设计说明书Version3.1GeneralWEBapplicationplatform（GWAP3.1）Designelucidationindetail文档编号：GWAP-03-02NO.[GWAP-03-02]达内IT培训集团版本标题内容作者时间1.0.0创建创建马东锋08/18/20091.0.1修订1、详细设计文档中4.3，技术体系“数据库”变更为“MySQL”。2、增加异常实现逻辑6.3.2（向管理员发email）。马东锋08/24/20093、6.3.1UML图Factory成员隐去。目录1．编写目的2．参考文档3．名称解释4．系统架构4.1功能结构4.2系统架构4.2.1交易系统架构4.2.2管理系统架构4.3技术体系5．访问控制设计5.1访问控制流程图5.2访问控制流程说明6．域模型设计6.1视图层设计6.2控制层设计6.2.1类图6.2.2类描述6.2.3控制文件描述6.3业务层设计6.3.1类图6.3.2类描述6.4持久层设计6.4.1类图6.4.2类描述6.4.3映射文件描述6.5监听器设计6.5.1类图6.5.2类描述6.6过滤器设计6.6.1类图6.6.2类描述7．数据库设计7.1E-R图7.2数据实体描述7.3实体关系描述7.4实体数据初始化8．程序结构设计9．系统环境设计9.1开发环境设计9.2发布环境设计9.3编译和发布工具9.3.1ANT介绍9.3.2ANT在GWAP中的使用10．用例实现10.1交易系统10.1.1显示首页面10.1.2分类检索10.1.3显示商品明细10.1.4订单列表10.1.5删除订单10.1.6添加商品到购物车10.1.7在购物车中删除一个订单列表10.1.8在购物车中恢复删除的订单列表10.1.9修改订单列表中商品数量10.1.10购物车结算10.1.11订单确认10.1.12清空购物车10.1.13用户登入10.1.14用户登出10.1.15用户注册10.1.16编辑个人基本信息10.1.17修改Email10.1.18修改密码10.2管理系统10.2.1商品列表10.2.2添加商品10.2.3修改商品10.2.4删除商品10.2.5管理员登入10.2.6管理员登出10.2.7用户列表10.2.8删除用户1．编写目的明确业务背景、业务范围、基本业务逻辑和业务框架，期望读者包括：项目发起人、最终用户、项目投资方、项目管理团队、项目执行团队，以及其他项目干系人。2．参考文档“GWAP1.x需求分析说明书.doc”：需求分析说明书模板。“GWAP需求变更意见.doc”：需求变更说明。“TTS会议纪要(2009-07-31).doc”：项目启动会议纪要。“系统需求分析（Ver1.0）.doc”：前一版本的需求分析。“GWAP3.1需求分析说明书.doc”：系统需求分析说明书。3．名称解释GWAP：通用WEB应用平台（GeneralWEBapplicationplatform）。B/S：Browser/Server（浏览器/服务器）。C/S：Client/Server（客户端/服务器）。B2B：BusinesstoBusiness商家对商家，电子商务的一种业务形式。B2C：BusinesstoConsumer商家对顾客，电子商务的一种业务形式。C2C：ConsumertoConsumer顾客对顾客，电子商务的一种业务形式。CSS：是CascadingStyleSheets(层叠样式表)的简称，CSS语言是一种标记语言,它不需要编译可以直接由浏览器执行。HTML：HypertextMarkupLanguage超文字标记语言。JAVASCRIPT：一种由SunMicrosystems所开发的程序脚本语言(它是一种严密的物件导向的语言,适合在网际网络上发展主从架构的应用程序)，常常简称JS。4．系统架构4.1功能结构通用WEB应用系统，包括交易系统和管理系统两个独立的子系统，主要包括：商品展示、购物车管理、我的订单、用户管理、商品管理五个功能模块。交易系统功能描述商品展示：实现商品预览、商品明细、分类检索功能。购物车：实现添加商品、删除列表、恢复列表、数量修改、清空购物车、结算功能。我的订单：实现订单确认、订单列表、删除订单、查询明细功能。用户管理：实现登入/登出、用户注册、信息修改功能。管理系统管理描述用户管理：对于系统管理员提供用户删除、用户查询功能。商品管理：实现商品列表、商品发布、商品删除、商品修改功能。4.2系统架构交易系统和管理系统在系统架构方面完全一致，采用4层结构，主要包括：表现层、控制层、业务层、持久层。表现层：主要负责用户交互和结果显示，交易系统和管理系统有不同的URL入口界面，详细设计参考“GWAPDEMO”。控制层：主要负责系统的访问控制、数据加载和注销，是系统的核心控制单元。控制层通过系统描述来组织工作。业务层：实现了交易系统和管理系统的主要业务逻辑，是系统主要的运算单元。持久层：实现了静态数据和数据库数据的持久化管理，为业务层提供数据服务，是系统进行数据操作的统一界面。4.2.1交易系统架构4.2.2管理系统架构4.3技术体系下图描述了本系统将要使用到的具体的技术和工具。5．访问控制设计5.1访问控制流程图5.2访问控制流程说明结合上图，针对每一个消息请求，按照消息请求/回复顺序，作如下说明。编号消息名称消息说明1HttpServletRequest浏览器发来的HttpServletRequest请求2ActionForm通过ActionForm获取Struts加载的页面表单数据3Exectule根据struts-config.xml配置调用指定的Action指定的方法处理请求4ActionForm.getXxx()通过ActionForm获取页面表单数据5BusinessFactory.getBusiness获得Business对象6BusinessMethod调用业务逻辑7Import使用Pojo进行数据操作8DAOFactory.getDAO获得Dao对象9DaoMethod调用Dao方法，执行数据库操作10Returnexecutionresult返回Dao执行结果，给Business11Returnexecutionresult返回Business执行结果，给Action12ActionForward.findForwardAction返回执行结果给新的画面（Struts-Config.xml配置）13HttpServletResponseMappingDispatchAction返回处理结果给浏览器6．域模型设计6.1视图层设计视图层设计参考“GWAP3.1需求分析说明书.doc”实现效果参考“GWAP(VER1.0)-20090811.zip”6.2控制层设计6.2.1类图6.2.2类描述OrderMappingDispatchAction订单管理核心控制类方法名功能描述参数和返回值异常定义deleteOrder删除用户订单.参数ActionMapping,ActionForm,HttpServletRequest,HttpServletResponse返回值ActionForwardExceptionlistUserOrders显示用户订单列表同上ExceptionorderDetail显示订单明细同上ExceptionProductMappingDispatchAction商品管理核心控制类方法名功能描述参数和返回值异常定义addProduct添加发布商品（管理员）参数ActionMapping,ActionForm,ExceptionHttpServletRequest,HttpServletResponse返回值ActionForwardindex显示我的GWAP首页面同上ExceptionshowDetail显示商品明细同上ExceptionsearchProduct按照类别检索商品同上ExceptionlistAllProduct得到所有的商品同上ExceptiondeleteProductById删除和下架商品同上ExceptiontoModifyProduct打起修改商品信息页面同上ExceptionmodifyProduct修改商品信息同上ExceptionShopCartMappingDispatchAction购物车管理核心控制类方法名功能描述参数和返回值异常定义account统计商品，进入订单确认页面参数ActionMapping,ActionForm,HttpServletRequest,HttpServletResponse返回值ActionForwardExceptionshowShopCart打起购物车同上Exceptionadd2Cart添加商品到购物车同上ExceptionviewShopCart暂时没有使用同上ExceptionremoveById根据商品ID，从购物车中移出商品同上ExceptionundoById恢复移出商品到购物车同上ExceptionclearShopCart清空购物车同上ExceptionmodifyNumber修改商品数量同上ExceptioncheckOut订单检查和入库同上ExceptionUserMappingDispatchAction用户管理核心控制类方法名功能描述参数和返回值异常定义changeEmail修改Mail信息.参数ActionMapping,ActionForm,HttpServletRequest,HttpServletResponse返回值ActionForwardExceptiontoLogin调转到登陆画面同上ExceptiontoRegister打起用户注册页面同上ExceptioncheckMail邮箱验证同上Exceptionregister用户注册同上Exceptionlogin用户登陆同上Exceptionmanager管理员用户登陆同上ExceptionlistAllUser查找所有用户得到用户列表同上ExceptionisValid用户信息有效性验证同上Exceptionmodify编辑个人信息同上ExceptionchangePwd修改个人密码同上Exceptiondelete删除用户同上Exceptionquery查询用户.同上Exceptionlogout用户退出同上ExceptionusernameValidateAJAX检查用户名是否存在（用户注册时）参数ActionMapping,ActionForm,HttpServletRequest,HttpServletResponse返回值VoidException6.2.3控制文件描述web.xml?xmlversion=1.0encoding=UTF-8?web-appxmlns=:xsi==2.4xsi:schemaLocation=://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd!--添加监听器--listenerlistener-class!--启动服务器时加载商品信息到内存--cn.com.tarena.gwap.web.listener.ProductContextListener/listener-class/listenerlistenerlistener-class!--启动服务器时加载购物车信息到内存--cn.com.tarena.gwap.web.listener.CartSessionListener/liste