详细设计-基于S2SH架构的设备维修管理系统中客户管理子系统的设计与实现

基于S2SH架构的设备维修管理系统中客户管理模块的设计详细设计总页数 正文 附录 生效日期 2013.12.30编制 批准南昌航空大学 详细设计报告 版本：0.1.12修 改 履 历修改编号 日期 修改人 版本号 修改内容1 0.1.0 初始做成南昌航空大学 详细设计报告 版本：0.1.13目 录1 引言 .41.1 编制目的 .41.2 参考资料 .41.3 系统开发环境 .41.4 词汇表 .42 系统开发环境 .43 系统设计思路 .54 系统公用代码设计 .54.1 分页组件类： .54.2 过滤组件类：CHARACTER FILTER, LOGINFILTER.64.3 HIBERNATESESSIONFACTORY 类 .74.4 404.JSP， 500.JSP .74.5 CSS: CSS.84.6 页面图片文件夹：IMAGES .85 功能模块设计 .95.1 维修管理模块设计 .96 数据库设计 .156.1 功能说明 .156.2 数据表设计 .16南昌航空大学 详细设计报告 版本：0.1.141 引言1.1 编制目的本报告详细完成对设备维修管理系统的整体设计，达到指导开发的目的，同时实现和测试人员及用户的沟通。本报告面向详细设计人员、开发人员、测试人员及最终用户而编写，是了解系统的导航。1.2 参考资料1.3 系统开发环境操作系统： Windows XP集成开发工具：MyEclipse 10.0编译环境：J2SDK 1.6Web 服务器：Tomcat 6.01.4 词汇表词汇名称 词汇含义 备注客户表 客户服务中心即前台所要面对的服务对象的个人数据信息。客户分为新客户和老客户，老客户在报修时不用重新输入个人信息，而新客户在报修设备之前需要登记自己的个人信息。客户表的主要内容：客户编号、身份证号、客户性质、单位名称、座机、移动电话、客户地址、邮编、联系人、email 等。报修记录单 它是设备维修分配的依据，它通过客户服务中心提供的维修信息而记录。南昌航空大学 详细设计报告 版本：0.1.15报修记录单的主要内容有：报修记录编号、报修时间、预估维修费用、预估完成时间、报修状态报修设备单 根据客户的设备维修要求所需要用到的设备零件而生成的单据。报修设备单的主要内容有：报修设备单编号、产品类型、机器品牌、机器型号、系列号、缺少零件、机器故障现象、故障类型、机器外观检查、开机口令重要资料、HDD、内存、外置 PC 卡、AC 适配器、电池、外接光驱、其他等。维修记录单 是设备维修完成之后对所有维修信息的详细单据。维修记录单的主要内容有：维修记录单编号、维修人员、分配时间、检测记录、维修记录、维修检测时间、工作量、人工费、材料费、报修承诺、注意事项、维修状态、维修延迟程度。备件流水明细 因为维修设备所需要用到的零件而生成的表，它记录着此次维修所用的备件型号及其数量。备件流水明细表的主要内容是：备件流水明细表编号、备件名称、备件型号、备件数量等。备件表 备件表是记录设备所需要备用零件信息的单据。由它可以查知设备的可用与否和控制备件的储备量。备件表的主要内容有：备件表编号、备件名称、型号、单价、数量、警戒数量、库存状态。结算费用 由维修记录单查找出的总维修费用表单。结算费用单的主要内容有：结算费用单编号、结算费用。客户确认单 维修结束后客户确认维修信息的一个单据。结算信息表的主要内容有：结算信息表单编号、维修单号、单位名称、合计金额、机器故障现象、报修承诺、部件名、部件型号、部件数量、部件单价、联系人、南昌航空大学 详细设计报告 版本：0.1.16修理费、材料费、注意事项。2 系统开发环境操作系统： Windows XP集成开发工具：MyEclipse 8.0M编译环境：J2SDK 1.6Web 服务器：Tomcat 6.03 系统设计思路本系统采用 B/S 模式的模块化设计，并且采用最先进的 S2SH 架构以系统公用代码为基本功能支持，将整个系统划分为客户管理模块、报修管理模块、维修管理模块、结算管理模块、备件管理模块以及运营监督管理模块。4 系统公用代码设计4.1 分页组件类：4.1.1 功能描述Page 类用于封装页面常用的信息，用于页面间对象的传递，PagerHelp 类用于产生Page 类的实例。4.1.2 类、方法描述 Page 类返回值 方法名 功能 参数说明南昌航空大学 详细设计报告 版本：0.1.17int getStartRow() 获得页面 起始页int getCurrentPage() 获得总页数int getPageSize() 获得当前页int getTotalPages() 获得每页显示的行数void setStartRow() 获得总行数void setTotalPages() 设置总页数void setCurrentPage() 设置当前页void setPageSize() 设置每页显示的行数void setTotalRows() 设置总行数 PagerHelp返回值 方法名 功能 参数说明Page getPager() 获得 Page 对象 HttpServletRequestrequest,请求对象 int totalRow，总行4.2 过滤组件类：CharacterFilter, LoginFilter4.2.1 功能描述用于字符编码的过滤，用户是否登陆验证类，方法描述CharacterFilter返回值 方法名 功能 参数说明void doFilter() 过滤字符串 HttpServletRequest request, 请求对象南昌航空大学 详细设计报告 版本：0.1.18HttpServletResponseresponse, 回应对象FilterChain chainLoginFilter返回值 方法名 功能 参数说明void doFilter() 判断用户是否登陆 HttpServletRequest request, 请求对象HttpServletResponseresponse, 回应对象FilterChain chain4.3 HibernateSessionFactory 类4.3.1 功能描述获取 Session 对象实例4.3.2 类、方法描述Page返回值 方法名 功能 参数说明Session getSession () 获得 Session 对象实例南昌航空大学 详细设计报告 版本： 404.jsp， 500.jsp4.4.1 功能说明该页面显示经 Struts 捕获的异常信息，并提供返回超链接。4.4.2 设计说明 界面设计图 4-2 404 异常处理图 4-3 500 异常处理 逻辑设计该页面使用标签显示 Struts 捕获的异常信息。并使用 JavaScript 代码作为返回发生异常的请求。4.5 CSS: css4.5.1 功能说明为本系统各页面提供 CSS 支持，使得样式统一化。南昌航空大学 详细设计报告 版本：0.1.1104.5.2 设计说明分别为 HTML 基本元素（body 、table、select 、a 等） 、去掉图片和表单边框、按钮、普通信息、分页页码、后台任务链接等设计统一的样式。4.6 页面图片文件夹：imag es4.6.1 功能说明该文件夹中包含了本系统页面需要使用的图片文件。5 功能模块设计5.1 客户管理模块设计5.1.1 功能说明分站的主要工作是直接面向客户，为客户提供服务。功能包括： 查询客户信息，添加客户信息，删除客户信息，修改客户信息。查询客户信息：客服输入查询条件：查询条件为客户基本信息如姓名，公司号，小区号等。系统显示满足条件的客户信息。添加客户信息：若客服未查到客户信息，则为客户注册用户并添加客户详细信息。删除客户信息：若客户超过一定时限没有报修过任务设备修理服务，客服则可以删除客户信息。修改客户信息：若客户的基本信息发生变化时，客服需修改客户基本信息。南昌航空大学 详细设计报告 版本：0.1.1115.1.2 子模块设计客户信息查询模块.1模块功能通过用户唯一的基本信息可以查看该用户的详细信息。.2 界面设计暂无.3 类、方法设计ClientAction 类该类的功能：对于用户表的所有操作均提供相应的方法。返回值 方法名 功能 参数说明String search() 根据用户信息，查询是否存在该用户。ClientDAO 与 ClientDAOImpl 的映射类对象String Add 添加信息提供功能 对数据表进行操作和映射String Update 修改信息提供功能服务 对数据表进行操作和映射String Show显示信息对 ClientDAO 与 ClientDAOImpl的映射类对象ClientDAO 类与 ClientDAOImpl 类该类的功能：查询用户基本信息，并查看是否存在该用户。返回值 方法名 功能 参数说明boolean search() 根据用户信息，查询是否存在该用户。支撑 ClientAction 类相关操作boolean Add 添加信息提供功能 支撑 ClientAction 类相关操作boolean Update 修改信息提供功能服务 支撑 ClientAction 类相关操作南昌航空大学 详细设计报告 版本：0.1.112boolean Show 显示信息 支撑 ClientAction 类相关操作ClientService 与 ClientServicImpl 类这两个类主要功能是用于支撑于 hibernate 架构中对数据库进行的连接和操作。从而支撑了相应的 DAO 和 Action 的对于数据使用的操作。返回值 方法名 功能 参数说明boolean Add 添加信息提供功能 支撑 ClientAction 类相关操作boolean Update 修改信息提供功能服务 支撑 ClientAction 类相关操作boolean Show 显示信息 支撑 ClientAction 类相关操作Client 类该类就是一个创建用户信息实体，储存用户信息。返回值 方法名 功能 参数说明void setters 用户的各类信息 无int/String/Dategetters 用户的各类信息 无.4时序图暂无。查询功能时序图 客户信息注册模块.1 模块说明当不存在该用户时，客服将为其注册一个新用户。.2 界面设计暂无.3 类，方法设计Client 类该类是一个创建用户信息实体，允许客服添加客服信息的类返回值 方法名 功能 参数说明南昌航空大学 详细设计报告 版本：0.1.113void setters 用户的各类信息 无int/String/Dategetters 用户的各类信息 无ClientAction该类的功能：提供客服为客户注册的功能。返回值 方法名 功能 参数说明string Insert() 读取相应的需要修改的客户信息记录，进行数据修改。ClientDAO 与 ClientDAOImpl 的映射类ClientDAO 类与 ClientDAOImpl 类该类的功能：查询用户信息。返回值 方法名 功能 参数说明boolean Delete() 删除客户信息功能 支撑 ClientAction 类相关操作boolean Add 添加客户信息功能 支撑 ClientAction 类相关操作boolean Update 修改客户信息功能 支撑 ClientAction 类相关操作boolean Show 显示信息 支撑 ClientAction 类相关操作ClientService 与 ClientServicImpl 类这连个类主要功能是用于支撑于 hibernate 架构中对数据库进行的连接和操作。从而支撑了相应的 DAO 和 Action 的对于数据使用的操作。返回值 方法名 功能 参数说明boolean Add 添加信息提供功能 支撑 ClientAction 类相关操作boolean Update 修改信息提供功能服务 支撑 ClientAction 类相关操作boolean Show 显示信息 支撑 ClientAction 类相关操作.4 时序图暂无。客户信息注册功能时序图 客户信息维护模块.1 功能说明对客户信息表插入数据。 南昌航空大学 详细设计报告 版本：0.1.1.2 界面设计暂无.3 类、方法设计ClientAction 类的类同上。下面介绍备件流水信息明细 Tpart 类。该类是用来创建一个维修记录的附属类，用以提供查询维修过程中备件的使用和计费。返回值 方法名 功能 参数说明void setters 已使用备件的各类信息 无int/String/Dategetters 已使用备件的各类信息 无TpartAction 类该类负责反馈单各种操作的功能提供返回值 方法名 功能 参数说明string Show() 显示所有的已使用的备件基本信息TpartDAO 与 TpartDAOImpl 的映射string Insert() 对相应的维修记录单的备件使用情况进行添加。无string Query() 查找关键字的已使用备件信息。无TpartDAO 类与 TpartDAOImpl 类该类的功能：查询反馈单信息，并修改反馈单状态。返回值 方法名 功能 参数说明boolean Delete() 删除已使用备件信息信息 支撑 TpartAction 类相关操作boolean Add() 添加使用备件信息功能 支撑 TpartAction 类相关操作boolean Update() 修改备件信息提供功能服务 支撑 TpartAction 类相关操作boolean Show()显示信息支撑 ReceipTpartActiontAction 类相关操作TpartService 与 TpartServiceImpl 类这连个类主要功能是用于支撑于 hibernate 架构中对数据库进行的连接和操作。从而支南昌航空大学 详细设计报告 版本：0.1.115撑了相应的 DAO 和 Action 的对于数据使用的操作。返回值 方法名 功能 参数说明boolean Add() 添加信息提供功能 支撑 TpartAction 类相关操作boolean Update() 修改信息提供功能服务 支撑 TpartAction 类相关操作boolean Show()