JWAP系统详细设计说明书.doc

JWAP系统说明书详细设计编写人Seven star编写日期2009.12.171.导言1.1目的该文档的目的是描述网上购物系统项目的详细设计，其主要内容包括：系统功能简介；系统底层数据库的ER图；网上购物系统的流程图；系统详细设计简述；各个模块的三层划分DAO层设计biz层设计过滤器的设计监听器的设计系统功能流程图；1.2范围该文档定义了系统的各个模块和模块接口，以及页面跳转的过程 但未确定单元的具体实现，这部分内容将在程序实现中确定。1.3缩写说明JSP：Java Server Page（Java服务器页面）的缩写，一个脚本化的语言。1.4术语定义JavaBean：JavaBean 是一种JAVA语言写成的可重用组件。Database：数据库，按照数据结构来组织、存储和管理数据的仓库。2.1系统设计概述根据网上购物系统的概要设计，本系统按照功能分解，可以分为客户端子系统和管理端子系统。根据页面流的设计，管理端系统分为登陆管理、用户管理、产品管理、类别管理、订单管理5个模块，客户端系统分为自服务、购物车管理2个模块。它们的关系如图C-1所示，以下将对各个部分分别进行详细设计。图C-1模块设计2.2网上购物系统的流程图如下；顾客网站首页搜索商品退出浏览该商品浏览其他商品查看购物放入购物车继续购买退出下订单确认订单订单送商家银货两讫支付送货上门交易完成售后服务评论商品3.详细设计概述本系统采用JSP+JavaBean+Database的3层架构。JSP负责表现，JavaBean负责业务逻辑，Database负责持久保持数据。三层架构(3-tier application) 通常意义上的三层架构就是将整个业务应用划分为：表现层（VIEW）、业务逻辑层（BIZ）、数据访问层（DAO）。区分层次的目的即为了“高内聚，低耦合”的思想。、表现层（VIEW）：通俗讲就是展现给用户的界面，即用户在使用一个系统的时候他的所见所得。、业务逻辑层（BIZ）：针对具体问题的操作，也可以说是对数据层的操作，对数据业务逻辑处理。、数据访问层（DAO）：该层所做事务直接操作数据库，针对数据的增添、删除、修改、更新、查找等。4.登陆管理模块详细设计4.1表现层（VIEW）4.1.1管理员登陆页面输入（input）WebRoot/jsp/user/index3.jsp导向（Forword）登陆成功WebRoot/jsp/adminis/index2.jsp;登陆失败的话留在原页面输出ResultDataSessionDatasession.setAttribute(admin,admin);,将管理员存储在Session中.功能说明进行管理员登陆4.1.2用户登录页面输入（input）WebRoot/jsp/user/index3.jsp导向（Forword）登陆成功WebRoot/jsp/index/index1.jsp;登陆失败的话留在原页面输出ResultDataSessionDatasession.setAttribute(user,user);,将用户存储在Session中.功能说明进行用户登陆4.2业务逻辑层（biz）4.2.1管理员登陆页面JavaB.impl.AdminServiceImpl.java方法名称public Admin login(String adminName, String password)方法说明判断登录的用户是否是管理员输入参数用户名 adminName 类型（String）密码 password 类型（String）输出参数Admin事务管理否处理流程根据用户名和密码查询是否存在这个管理员主要算法说明引用的其他Class出错处理UserNotFoundException，PasswordNotCorrectException4.2.2用户登陆页面JavaB.impl.UserServiceImpl.java方法名称public User login(String userName, String password)方法说明判断登录的用户是否存在输入参数用户名 userName 类型（string）密码 password 类型（string）输出参数Admin事务管理否处理流程根据用户名和密码查询是否存在这个用户主要算法说明引用的其他Class出错处理UserNotFoundException，PasswordNotCorrectException4.3数据访问层（DAO）4.3.1管理员登陆页面方法public Admin query(String adminName, String password)输入参数用户名 adminName密码 password输出参数管理员 Admin描述根据传入的用户名和密码返回是否是管理员Admin的对象SQL脚本算法说明4.3.2用户登陆页面方法public User query(String username, String password)输入参数用户名 username密码 password输出参数用户 User描述根据传入的用户名和密码返回是否是用户User的值SQL脚本算法说明5. 购物车管理模块详细设计5.1表现层（view）5.1.1添加输入（input）可以把商品加入到购物车的多个jsp页面导向（Forword）添加后回到购物车页面WebRoot /jsp/shoop car/index4.jsp输出ResultDataSessionData功能说明进行购物车条目添加 备注：购物车条目包括商品、商品数量。商品是一个实体类，包括许多属性。购物车抽取几个属性显示。5.1.2删除输入（input）WebRoot /jsp/shoop car/index4.jsp导向（Forword）删除后回到购物车页面WebRoot /jsp/shoop car/index4.jsp输出ResultDataSessionData功能说明进行购物车条目删除5.1.3修改输入（input）WebRoot /jsp/shoop car/index4.jsp导向（Forword）修改后回到购物车页面WebRoot /jsp/shoop car/index4.jsp输出ResultDataSessionData功能说明进行购物车条目修改（修改商品数量）5.1.4下单输入（input）WebRoot /jsp/shoop car/index4.jsp导向（Forword）如果用户已登录，则跳转到WebRoot/jsp/shoop car/order_info.jsp否则跳转到登录界面WebRoot/jsp/user/index3.jsp输出ResultDataSessionData功能说明确认所要购买的商品然后提交购买信息5.2业务逻辑层（BIZ）5.2.1添加JavaB.impl.ShopCartServiceImpl.java方法名称public void addOrderLine(OrderLine orderline)方法说明进行购物车条目添加输入参数购物车条目 orderline(OrderLine类型)输出参数无事务管理否处理流程将购物车条条目添加到购物车中主要算法说明引用的其他Class出错处理5.2.2删除删除所有JavaB.impl.ShopCartServiceImpl.java方法名称public void deleteAllOrderLine()方法说明进行购物车条目删除输入参数输出参数无事务管理否处理流程将购物车所有条目从购物车中清除主要算法说明引用的其他Class出错处理删除指定的订单项JavaB.impl.ShopCartServiceImpl.java方法名称public void deleteOrderLineById(Long productId)方法说明进行购物车条目删除输入参数商品id (Long类型)输出参数无事务管理否处理流程将购物车条条目从购物车中删除主要算法说明引用的其他Class出错处理5.2.3修改修改JavaB.impl.ShopCartServiceImpl.java方法名称public void setCount(Long productId,int count)方法说明修改购物车条目中商品的数量输入参数商品数量count (int类型)商品id输出参数无事务管理否处理流程将购物车条条目中商品的数量赋新值主要算法说明引用的其他Class出错处理修改JavaBeancom.tarena.jwap.ShopCartServiceImpl.java方法名称public double setSumPrice(Long productId,int count)方法说明修改购物车条目中商品钱数的小计输入参数商品数量count (int类型)商品id输出参数Double 购买此商品数为count时的总价格事务管理否处理流程将购物车条条目中商品的钱数合计赋新值主要算法说明引用的其他Class出错处理5.2.4下单JavaBeancom.tarena.jwap.ShopCartServiceImpl.java方法名称public int buy(Order order) 方法说明下商品订单输入参数order（Order类型）输出参数订单号（int类型）事务管理否处理流程将购物车中商品添加到数据库主要算法说明引用的其他Class出错处理5.3数据访问层（DAO）5.3.1添加无5.3.2删除无5.3.3修改无5.3.4下单方法OrderDaoImpl类中的public int add(Order order) 输入参数订单类 输出参数订单号描述根据用户将订单类和订单项添加到数据库中使得用户和订单进行关联SQL脚本insert into t_order order values (null, ?, ?, ? ,?);insert into salesitem values (null, ?, ?, ?, ?);算法说明6. 订单管理模块详细设计6.1表现层（view）6.1.1订单明细输入（input）WebRoot/jsp/order/index5.jsp导向（Forword）点击“订单明细”链接进入WebRoot/ /jsp/order/pro_order.jsp页面输出ResultDataSessionData功能说明查看订单的详细信息6.1.2订单处理输入（input）WebRoot/ /jsp/order/pro_order.jsp导向（Forword）点击“付款方式”链接进入WebRoot/admin/OrderModify.jsp页面输出ResultDataSessionData功能说明修改订单的状态6.2业务逻辑层（BIZ）6.2.1订单明细JavaB.impl.OrderServiceImpl.java方法名称public Order finfOrderById(Long orderid)方法说明显示订单明细输入参数订单号(Long 类型)输出参数订单类Order事务管理否处理流程根据订单号列出订单的详细信息主要算法说明引用的其他Class出错处理6.2.2订单处理订单处理JavaB.impl.OrderServiceImpl.java方法名称public void updateStatus(Order order)方法说明修改订单的状态输入参数订单类order（Order类型）输出参数无事务管理否处理流程输入订单类修改订单的状态主要算法说明引用的其他Class出错处理订单处理JavaB.impl.OrderServiceImpl.java方法名称public void updatePayWay(Order order)方法说明修改订单的付款方式输入参数订单类order（Order类型）输出参数无事务管理否处理流程主要算法说明引用的其他Class出错处理6.3数据访问层（DAO）6.3.1订单明细方法public Order query(Long id)输入参数订单号 id输出参数订单类SalesOrder描述根据订单id查找订单类的详细信息SQL脚本算法说明6.3.2订单处理方法public void updateStatus(Order order)输入参数订单类order输出参数无描述输入类修改订单的状态SQL脚本算法说明7. 商品管理模块详细设计7.1表现层（view）7.1.1添加类别输入（input）WebRoot/jsp/adminis/pro_manage.jsp导向（Forword）点击“添加类别”链接进入WebRoot/jsp/adminis/add_cat.jsp页面输出ResultDataSessionData功能说明增加商城的产品种类7.1.2修改类别输入（input）WebRoot/jsp/adminis/pro_manage.jsp导向（Forword）点击“修改”链接进入WebRoot/ jsp/adminis/modify_cat.jsp页面输出ResultDataSessionData功能说明对选定的类别进行修改7.1.3删除类别输入（input）WebRoot/jsp/adminis/pro_manage.jsp导向（Forword）点击“删除”链接进入WebRoot/jsp/adminis/pro_manage.jsp页面输出ResultDataSessionData功能说明把选定的类别从数据库中删除7.1.4添加商品输入（input）WebRoot/ jsp/adminis/info.jsp导向（Forword）点击“添加产品”链接进入WebRoot jsp/adminis/add_pro.jsp页面输出ResultDataSessionData功能说明增加商城中的产品7.1.5修改商品信息输入（input）WebRoot/ jsp/adminis/info.jsp导向（Forword）点击“修改”链接进入WebRoot/jsp/adminis/modify_pro.jsp页面输出ResultDataSessionData功能说明修改商品信息7.1.6删除商品输入（input）WebRoot/jsp/adminis/pro_manage.jsp导向（Forword）点击“删除”链接进入WebRoot/jsp/adminis/pro_manage.jsp页面输出ResultDataSessionData功能说明删除商品从数据库中7.1.7查询商品输入（input）WebRoot/jsp/adminis/pro_manage.jsp导向（Forword）点击“查询”链接进入WebRoot/jsp/adminis/pro_manage.jsp页面输出ResultDataSessionData功能说明查询商品7.2业务逻辑层（BIZ）7.2.1添加类别JavaB.impl.ChildCategoryServiceImpl.java方法名称Public void add ChildCategory(ChildCategory childcategory)方法说明输入参数商品的最底层类别(ChildCategry 类型)输出参数事务管理否处理流程主要算法说明引用的其他Class出错处理7.2.2修改类别JavaB.impl.ChildCategoryServiceImpl.java方法名称Public void updateChildCategory(Long childcategoryid)方法说明对产品的类别进行修改输入参数商品的最底层类别id(Long 类型)输出参数务事务管理否处理流程主要算法说明7.2.3删除类别JavaB.impl.ChildCategoryServiceImpl.java方法名称Public void deleteChildCategory(Long childcategoryid)方法说明对产品的类别删除输入参数商品的最底层类别id(Long 类型)输出参数务事务管理否处理流程主要算法说明7.2.4增加商品JavaB.impl