领航航空售票系统架构设计说明书

领航航空订票系统架构设计说明书Version : 1.1.32012-02-291.版本Time：2012-2-29 14:30:21Version：1.1.3(大更新第一个版本/小更新第一版/测试版)注：奇数版为测试版，偶数版为发布版Author：TeacherTian、Cuifeng、Zhangbin、Shao俊铖2.概述领航票务系统架构领航票务系统架构描述对应包控制层设计com.linghang.service模型设计com.linghang.entitya)控制层设计控制层中包含有如下几个业务处理类Service名称对应类有关用户的Service erSerivce处理订单的Service com.linghang.service.ItemSerivce有关管理员的Service com.linghang.service.ManagerService b)模型设计模型设计如下：模型名称对应类用户类er管理员com.linghang.entity.Manager订单com.linghang.entity.Item用户地址com.linghang.entity.Address票种com.linghang.entity.Ticket3.开发环境介绍开发环境WindowsXP 部署环境Linux开发工具eclipse3.6/notepad WEB服务器Tomcat7 版本控制CVS4.ER图a) 管理员ER 图b) 用户ER图c) 订单ER 图管理员ID密码真实姓名联系电话用户名（邮箱）d)票务ER图e)航空港ER图f)用户地址ER图5.业务组件(com.linghang.service包)a)erService登录/邮箱注册方法◆用户注册事件流事件流异常从request中获取用户注册的信息email密码重复密码身份证真实姓名联系电话如果有任意一个属性为空则返回false如果有任意一个属性的格式不正确则返回false如果email在数据库中不存在则继续否则返回false将从request中获取的数据封装为一个User对象初始化封装好的User对象的score(0)和等级(0)如果用户添加成功则返回true，否则返回false方法原型：boolean createUser(User user);方法概要功能描述：从页面的request中获取用户信息并注册用户方法参数：从request中获取信息后封装成一个User返回值：如果成功则返回true，否则返回false◆查询用户事件流事件流异常根据用户名从数据库中查询用户如果用户名为空则返回空如果返回的结果集为空则返回空如果返回的结果集不为空则将数据封装为一个User对象并返回方法原型：User loadUser(String username);方法概要说明：从数据库中根据用户名查询用户的全部信息方法参数：用户名返回值：用户的全部信息以及用户的◆修改用户事件流事件流异常根据参数对数据库中的用户进行修改如果用户为空则返回false 如果修改成功则返回true，否则返回false方法原型：boolean modifyUser(User user);方法概要说明：通过用户参数来修改数据库中的用户信息方法参数：用户返回值：如果修改成功则返回true，否则返回false◆删除用户事件流事件流异常根据参数对数据库中的用户进行删除如果删除成功则返回true，否则返回false方法原型：boolean removeUser(User user);方法概要说明：通过用户参数来修改数据库中的用户信息方法参数：需要删除的用户返回值：如果成功删除则返回true否则返回false◆登录时间流事件流异常从request中获得用户的用户账号、用户密码用户名、密码、验证码为空、用户名不存在用户输入用户名，用Ajax验证用户输入的账户是否存在如果用户名不存在，在用户名输用户输入验证码，用Ajax验证用户输入的验证码是否正确如果验证码错误，在输入框用jquery验证用户输入的用户名、密码、验证码是否为空如果用户输入的信息为空、在输入框后方法原型：User login（String userName,String password）；方法概要功能描述：如果用户的userName和password不正确，返回loginErrorMassage。

用户密码正确，登录成功，根据用户的用户名获得一个用户对象。

方法参数：从request获得用户的用户名和用户密码。

返回值：返回一个User对象b)com.linghang.service.ItemService的方法◆通过机次查询票种事件流事件流异常通过页面获取用户提交的查询数据：日期(使用Jquery插件)机次(手动输入)验证码如果机次为空则返回false 通过日期与机次来进行机次的查找查询出来的内容需要有机次、到时、历时、商务舱数量/票价、头等舱数量/票价、经济舱数量/票价将查询出来的内容封装为Ticket对象并返回如果没有对应的数据则返回false方法原型：List<Ticket> loadTicketByName(Long date, String ticketName);方法概要功能描述：机次查询的方法，通过日期和机次来查询Ticket方法参数：date:Long类型，表示查询的日期ticketName:String类型，表示需要查询的机票的机次方法返回值：成功则返回机票信息，否则返回null◆通过航空港查询票种事件流事件流异常通过页面获取用户提交的数据：日期(使用Jquery控件) 发站以及到站发站和到站同时为空则返回false通过发站或者到站来进行计票的查询查询出来的内容需要有机次、到时、历时、商务舱数量/票价、头等舱数量/票价、经济舱数量/票价将查询出来的内容封装为Ticket对象并返回如果没有对应的数据则返回false方法原型：List<Ticket> loadTicketByStation(Long date, String from, String to);方法概要功能描述：通过起始站和终到站来进行计票的查询方法参数：date：Long类型，表示查询的日期from：起始站的名称to：终到站的名称方法返回值：成功则返回机票信息，否则返回null◆通过时间以及出发地/目的地查询票种事件流事件流异常通过表单获取如下数据:出发地、目的地、出发日期、出发时间(非必选，表示一个时间范围)、出发班次(非必选) 出发地、目的地、出发日期或者有格式问题则返回fal通过数据库查询获取如下信息:机次、发站、到站、历时、头等舱(数量/价格)、商务舱(数量/价格)、经济舱(数量/价格)将上述的票务信息封装成对象列表并返回给页面将信息以列表方式展示在页面上并添加"预定"按钮方法原型：List<Ticket> loadTickets(String from, Sting to, Long time, String flightNum); 方法概要功能描述：通过出发地，目的地，出发时间以及出发班次来获取票务信息方法参数：from：String类型，表示出发地to：String类型，表示目的地time：Long类型，表示出发时间flghtNum：String类型，表示出发班次方法返回值：如果成功则返回符合条件的票，否则返回null◆预定订单事件流事件流异常用户单击"预定"按钮通过数据库以及List<Item>获取如下信息:班机信息(出发时间/机次/出发地/目的地/历时/)，票务信息(头等舱/商务舱/经济舱数量及价格)，乘客信息(实名制乘客名)将这些信息显示在页面上以便用户提交订单方法原型：void preCreateItem();方法概要功能描述：用户点击”预定”按钮后，将票务信息详细显示在页面上以便用户进行提交◆核实订单事件流事件流异常用户选择如下信息:有效身份信息(仓位/姓名/身份证件类型/证件号码/手机号/)填写及验证页面上的验证码用户提交订单后获取订单信息:车次信息、乘客信息将车次信息以及乘客信息封装在Item对象中将该对象的信息回显到页面上方法原型：Item createItem();方法概要功能描述：生成订单信息并由用户来进行确认方法返回：返回给页面一个Item对象，如果失败则返回null◆提交订单事件流事件流异常获得班机信息以及乘客信息将班级信息与乘客信息封装在Item对象中将Item对象持久化到数据库中如果数据库发生异常则返回返回正确方法原型：bool submitItem();方法概要功能描述：在客户确认item信息后将班级信息和乘客信息持久化到数据库中方法返回值：如果成功则返回true否则返回falsec)com.linhang.service.ManagerService管理◆创建票种事件流事件流异常生成新的票种方法原型：void createTicket();方法概要功能描述：由管理员添加一种新的票种◆修改票种事件流事件流异常修改票种方法原型：boolean modifyTicket(Ticket t);方法概要功能描述：由管理员修改票种◆删除票务事件流事件流异常删除票种方法原型：boolean removeTicket(Ticket t);方法概要功能描述：删除指定的票种◆修改票务事件流事件流异常修改订单方法原型：boolean modyfiItem(Item item);方法概要功能描述：有管理员修改指定的订单，通过修改订单来达到退票等功能6.实体组件(Entity implements Serializable)◆Ticket(票)概述:为了能够实现将来的服务器集群,该类应当实现serializable属性:ID（Long）：票的ID，与业务无关name（String）：票的名字，车次kind（String）：票的种类（firstSeat、businessSeat、touristSeat）stations（ArrayList<Station>）：票停的站，从Station中查询出来的数据放在该List 中去price（Double）：票价number（Integer）：该票的数量describe（String）：票的描述discount（double）：票的折扣行为:构造器：一个无参数构造器、一个无ID的全参数构造器、一个全参数构造器gettersettertoString◆Station站属性：id（Long）：与业务无关的IDname（String）：该站的名字可以使用城市名称time（Long）：到达该站的时间order（Integer）：站的顺序tid（Long）：外键，该Station属于哪张票行为：构造器gettersettertostring◆Manager(管理员)概述:为了能够实现将来的服务器集群,该类应当实现serializable属性包括:行为包括:◆User(用户)概述:为了能够实现将来的服务器集群,该类应当实现serializable属性：id（Long）：与业务不相关的IDcid（String）：身份证IDusername（String）：用户名（Email）password（String）：密码（使用MD5进行加密）name（String）：真实姓名phone（String）：联系电话score（Long）：用户购买机票的积分level（Long）：用户等级（需要等级表）行为：构造器gettersetter◆Address概述: 为了能够实现将来的服务器集群,该类应当实现serializable.此类作为User 的一个外键,表示一个用户的地址，用户的地址可以有多个属性：id（Long）：与业务不相关的idcontent（String）：用户的地址uid（Long）：用户的外键行为：构造器setterItem(作为User的一个外键)概述: 为了能够实现将来的服务器集群,该类应当实现serializable.此类作为User 的一个外键,表示一个用户的订单属性：id（Long）：与业务不相关的idnumber（String）：订单的编号generateDate（Long）：订单生成时间tid（Long）：该item的机票类型buildFree（Double）：机场建设费insurance（Double）：保险费oilTax（Double）：燃油税uid：该item所属的用户，是一个外键aid：该item使用用户的哪一个地址方法：7.工具类(Util)a)MD5Util提供加密算法方法原型：String encode(String password);方法概要功能描述：对参数password进行加密并返回密文方法参数：password：String类型，代表需要加密的明文返回值：加密后的密文b)DBUtil提供数据库的连接方法原型：Connection getConn();方法概要功能描述：通过配置文件获取数据库连接返回值：返回数据库连接方法原型：boolean close(ResultSet rs, Statement stmt, Connection conn);方法概要功能描述：依次关闭结果集、Statement以及数据库连接方法参数：rs:ResultSet的对象类型，代表数据库结果集stmt:Statement对象或者PreparedStatement对象类型conn:Connection对象类型，代表需要关闭的Connectionc)ConfigUtil方法原型：String getConfig(String key);方法概要功能描述：根据key的值返回配置文件中对应的Value方法参数：key:String类型，表示需要从配置文件中获得的配置信息的Key返回值：配置信息8.一些专有名词解释票种:Ticket管理员:Manager用户:User(分为会员或者非会员)邮寄地址:Address订单:Item9.扩展系统中可能发生的扩展，要求系统能够满足以下扩展a) 安全性:权限(某些页面普通用户不可见,VIP用户可见,或者管理员可见)b)网上银行支付c)WebService在网络上获得票务信息d)并发性(集群)e)积分制度f)手机版g)英文版/中文版h)热门机票推荐i)主要城市票价排行j)酒店预定k)团购l)托运。