系统架构设计

系统架构设计说明书 系统架构设计说明书 设计
版本号： 版本号：V0.1
2010 年 7 月

1. 目的
本说明书的编写目的是描述系统的架构设计方案， 包括系统的软件总体架构 设计及使用的框架说明，以及基于该架构的开发流程，并作为指导开发人员、测 试人员进行系统开发及测试的依据。
2. 系统架构设计
整个软件架构方案采用分层、分布式的部署结构，明确地分离了表现层和业 务逻辑，能够保证应用服务逻辑的一致性和稳定性、结构的开放性、功能的可扩 展性和可维护性、开发的可并行性，同时采用一些开源的框架，兼顾了经济性。 框架是一种特殊的软件，它为软件开发带来了高度的重用性，是无数软件开发人 员的多年项目开发经验的总结。 在一个优秀的框架上开发应用， 而不是从零开始， 可以大量缩短项目的开发周期、降低开发风险、增强应用系统的稳定性。

用户层
STB 客户端 视频 视频 CMS BOSS EPG
WEB 浏览器（IE） 游戏 第 三 方 平 台
P4P 视频传 输服务
表示层
JSP
Struts
Ext
DTO
DTO
CDN 视 频 分发服务
WEB 应用 服务器
业务层 BLO
Spring
DTO NMS 网 络 监控服务
DTO
数据访问层 DAO Hibernate JDBC JDBC
数据库
ORACLE
操作系统
LINUX
系统总体架构图 系统总体架构如上图所示，按功能可以分为 P4P 视频传输服务、CDN 视频 分发服务、 NMS 网络监控服务、 内容管理系统 （CMS） 业务运行支持系统 、 （BOSS） 、 电子节目单发布系统（EPG） ；系统根据功能特点与业务需求采用 C/S 和 B/S 两 种架构模式， 其中， P4P 视频传输服务采用 XBT 开源项目， XBT 项目基于纯 C++ 代码实现，可以运行于 Linux 和 Windows 平台，支持 UPNP 和 NAT 穿透；CDN 视频分发基于 FTP 协议实现视频文件的分发传输；NMS 网络监控服务采用 OpenNMS 开源项目，OpenNMS 是基于开源协议开发的企业级网络管理系统， 支持 Linux 和 Windows 平台。支持 SNMP 网络管理协议确保管理的扩展性，可 以监控各个终端及服务器的故障及资源使用状况，并以图形化的方式展现出来；

内容管理系统 （CMS） 业务运行支持系统 、 （BOSS） 与电子节目单发布系统 （EPG） 采用基于 WEB 的 B/S 结构，技术架构采用 J2EE 标准的多层架构，基于并且集 成 Ext、Struts、Spring、Hibernate 开源框架，以后称为 WEB 子系统。
3. WEB子系统架构设计
用户层 Web 浏览器 （IE、 FireFox）
Web 服务器
Apache Server
JBOSS Server 表 示 层
Struts+Ext JSP ActionForm Action
DTO 业 务 层
DTO
BLO
Spring
DTO 数据访问层 DAO DAO
DTO
Hibernate iBatis
JDBC 数据库 Oracle
JDBC
操作系统
RedHat Linux

从架构图中可以看出系统分为四层：

用户层：浏览器 表示层：借助 Struts 及 Ext 实现 业务层：借助 Spring 进行业务组件的组装关联。 数据持久层：借助 Hibernate 实现
为什么采用这样的四层架构？
通过成熟的开源产品实现各层， 同自己编写代码实现， 相比之下能缩短开发周期， 且架构所用到的开源产品均有很广泛的用户群，经受过实践的考验，质量和性能 更有保障。

层与层之间松散耦合，增加代码重用率。 各层分工明确，这样也利于团队的明确分工。
系统的总体架构从结构上分为用户层、表示层、业务层、数据访问层以及在层间传递数 据的数据传输对象。下面针对各层加以描述。 1)．用户层 用户层作为客户端程序，用来与用户交互，并把来自系统的信息显示给用户。 系统的用户层采用的是 IE 浏览器作为交互方式。 2） ．表示层 表示层主要控制页面外观，产生页面逻辑以及对用户输入的数据进行合法性验证。 系统中主要包括基于 EXT 框架的 JavaScript 脚本及基于 Struts 框架的 JSP、Action、 ActionForm。其中 JavaScript 脚本可以增强用户体验，JSP 负责视图的功能，由 HTML、 Java 程序片断和 JSP 标签构成；ActionForm Bean 用于在视图组件和控制器组件之间传 递 HTML 表单数据，通常每个 HTML 表单对应一个 ActionForm Bean，HTML 表单中的 字段和 ActionForm Bean 中的属性一一对应。ActionForm 的 validate()方法用于对用户输 入的数据进行合法性验证；Action 负责单个事件的流程控制。 3） ．业务层 业务层处理应用的核心业务逻辑。业务逻辑对象 BLO(Business Logic Object) 把业务 规则、约束、活动和数据结合在一起，Spring 负责对这些业务对象的管理。 ．数据访问层 4） 数据访问对象(Data Access Object) 把底层的数据访问操作和上层的商务逻辑分开。

5） ．数据传输对象（Data Transfer Object） 数据传输对象通常作为各业务实体的 JAVABEAN 对象， 负责层与层之间数据的传输。 目录结构及包设计 J2EE 规范定义了 Web 应用程序的类和文件存放的目录结构。该层次结构由三个层 次构成。第一层是上下文，它是一个目录或者是多个目录，用来查找与客户请求关联的 Web 应用程序。在上下文中存在一个/WEB-INF 目录，该目录标记着另一个层次，它包 含一个子目录，帮助组织类文件和压缩的包文件。/WEB-INF 还包含一个映射所有文档 并定义整个应用程序特性的文档。最后一层直接位于上下文中，包含所有客户端可见的 文件，包括用户界面文件、图形和音频文件。 表 1-1 目录名 /root /css /img /js /cms /web-inf 系统目录结构表 说明 应用上下文根目录 Css 样式表文件目录 图片文件目录 JavaScript 文件目录 jsp 文件目录
/conf 配置文件目录 /lib 压缩的 java 类文件，组件的 JAR 文件 /classes 本系统的 java 类文件 /tld Tag 库文件 web.xml 部署描述符文件 classes 目录下的系统的 java 文件的包结构说明见表 1-2。 表 1-2 CMS 系统包结构说明表 作用说明 基础架构 基础架构的表示层 基础架构的表示层的 Action 类 基础架构的表示层的 Form 类 基础架构的业务层 基础架构的业务层的实现类 基础架构的数据访问层 基础架构的数据访问层的数据对象类 基础架构的共同类包 CMS 子系统 CMS 子系统的表示层 CMS 子系统的表示层的 Action 类 CMS 子系统的表示层的 Form 类 包名 com.gecai.base com.gecai.base.web com.gecai.base.web.action com.gecai.base.web.form com.gecai.base. service com.gecai.base. service.impl com.gecai.base.hibernate com.gecai.base.hibernate.pojo https://www.360docs.net/doc/f710032101.html,mon com.gecai.cms com.gecai.cms.web com.gecai.cms.web.action com.gecai.cms.web.form

com.gecai.cms. service com.gecai.cms. service.impl com.gecai.cms.hibernate com.gecai.cms.hibernate.pojo
CMS 子系统的业务层 CMS 子系统的业务层的实现类 CMS 子系统的数据访问层 CMS 子系统的数据访问层的数据对象类
4. WEB子系统架构总体功能设计
4.1 Struts框架 Struts 是一个实现了 MVC 模式的框架，对 Model、View 和 Controller 都提供了对应 的实现组件。可分为 1.x 和 2.x 两大版本，如下图所示：
Struts 配置文件
Brower
Controller
Model Action
View JSP
1．控制器（Controller） 控制器的作用是从客户端接受请求，并且选择执行相应的业务逻辑，然后把响应结 果送回到客户端。在 Struts1 中 Controller 功能由图中 ActionServlet 和 ActionMapping 对 象构成：核心是一个 Servlet 类型的对象 ActionServlet，它用来接受客户端的请求。 ActionServlet 包括一组基于配置的 ActionMapping 对象，每个 ActionMapping 对象实现 了一个请求到一个具体的 Action 处理器对象之间的映射； Struts2 中 Controller 为基于 在 事务拦截的拦截器，针对每次客户端请求 Action 进行拦截分发。 2．模型（Model） MVC 系统中的 Model 部分从概念上可以分为两类--系统的内部状态，和改变系统 状态的动作。Struts1 为 Model 部分提供了 Action 和 ActionForm 对象：所有的 Action 处 Action 处理器对象封装了具体的 理器对象都是开发者从 Struts 的 Action 类派生的子类。

处理逻辑，调用业务逻辑模块，并且把响应提交到合适的 View 组件以产生响应。Struts 提供的 ActionForm 组件对象，它可以通过定义属性描述客户端表单数据。开发者可以 从它派生子类对象，利用它并结合 Struts 提供的自定义标记库，可以实现对客户端的表 单数据的良好封装和支持，Action 处理器对象可以直接对它进行读写，而不再需要和 request、 response 对象进行数据交互。 通过 ActionForm 组件对象实现了对 View 和 Model 之间交互的支持； Struts2 的 Action 为 ActionSupport 基类的子类， 由于对于每一个 Action 请求生成一个实例对象，不存在线程安全问题。 3．视图（View） Struts 应用中的 View 部分是通过 JSP 技术实现的。Struts 提供了自定义的标记库可 以使用，通过这些自定义标记可以非常好地和系统的 Model 部分交互，通过使用这些自 定义标记创建的 JSP 表单，可以实现和 Model 部分中的 ActionForm 的映射，完成对用 户数据的封装，同时这些自定义标记还提供了像模板定制等多种显示功能。 4.2 Spring框架 Spring 是一个轻量级的实现了控制反转(IoC)和面向切面(AOP)的容器框架， 其组件包括： 1． Core 包 Core 包是框架的最基础部分， 它提供依赖注入 （Dependency Injection）
特性来管理 Bean 容器功能。 2．Context 包 口。 3． DAO 包 DAO 包提供了 JDBC 的抽象层， 它可消除冗长的 JDBC 编码和解析数 Context 包提供了框架的资源访问方式，如 JNDI、资源装载等的接
据库厂商的特有代码。该包也提供了实现编程性和声明性事务管理的方法。 4．ORM 包 ORM 包为流行的关系－对象映射 APIs 提供了集成层，包括 JDO，
Hibernate 和 iBatis。 5．AOP 包 AOP 包提供与 AOP 联盟兼容的面向方面编程实现，允许用户定义，
如方法拦截器和切点，来从逻辑上把应该被分离的功能实现代码解耦。 6．Web 包 的结合。 Spring 提供了一致的事务管理抽象。这个抽象是 Spring 最重要的抽象之一， 它有 如下的优点： Web 包提供了基本的面向 Web 的特性。如 MVC 以及与其他 Web 框架

为不同的事务 API 提供一致的编程模型，如 JTA、JDBC、Hibernate、iBatis 数据 库层 和 JDO。

提供比大多数事务 API 更简单的，易于使用的编程式事务管理 API。 整合 Spring 数据访问抽象。 支持 Spring 声明式事务管理。 Spring 使应用开发者能够使用在任何环境下使用一致的编程模型，只写一次代码，
就可以实现不同环境下的事务管理。Spring 同时提供声明式和编程式事务管理。其中声 明式事务管理仅通过一些配置就使得事务管理从业务逻辑分离出来， 极大地减轻了开发 人员的负担。 4.3 Hibernate框架 Hibernate 是一个实现了以 ORM 模式实现了持久层的框架，由于数据库的读写是一 个很耗费时间和资源的操作，当大量用户同时直接访问数据库的时候，效率将非常低， 如果将数据持久化就不需要每次从数据库读取数据，直接在内存中对数据进行操作，这 样就节约了数据库资源，而且加快了系统的反映速度。 Hibernate 提供的接口可以分为以下几类： （1） 提供访问数据库的操作的接口，包括 session、Transaction、Query 接口； （2） 用于配置 Hibernate 的接口，Configuration； （3） 间接接口， 使应用程序接受 Hibernate 内部发生的事件， 并作出相关的回应， 包括：Interceptor、Lifecycle、Validatable； （4） 用于扩展 Hibernate 功能的接口，如 UserType、CompositeUserType、 IdentifierGenerator 接口。 Hibernate 内部还封装了 JDBC、JTA（Java Transaction API）和 JNDI（Java Naming And Directory Interface）。其中，JDBC 提供底层的数据访问操作，只要用户提供了 相应的 JDBC 驱动程序，Hibernate 可以访问任何一个数据库系统。JTA 和 JNDI 使 Hibernate 能够和 J2EE 应用服务器集成。 4.4 ExtJS框架 ExtJS 是一个 JavaScript 框架，包括丰富的 JS 函数库，用于在客户端创建丰富多 彩的 Web 应用程序界面，增强用户体验及界面友好性。ExtJS 由一系列的类库组成，包 括如下几个部分：

底层 API（core）：底层 API 中提供了对 DOM 操作、查询的封装、事件处理等基础 功能，其他控件也是建立在这些底层 API 的基础上的。 控件（widgets）：控件是指可以直接在页面创建的可视化组件，如面板、选项板、 表格、树、窗口、菜单、工具栏、按钮等，在系统中可以直接通过应用这些控件来增强 界面的友好及交互性。 实用工具（utils）：Ext 提供了很多实用的工具，通过它们可以实现数据内容格式 化、JSON 数据解析、AJAX 调用、Cookie 管理、CSS 管理等功能。 同时，Ext 也是一个 Ajax 框架，提供了一套通过 AJAX 方式与服务器异步交互的机 制，即不通过页面刷新就可以访问服务器的程序进行数据读取与保存。ExtJS 与服务器 端的数据交互可以通过 XML 或 JSON 对象格式。 由于 JSON 对象格式比 XML 格式更易于解 析和理解，本系统前端与服务器端进行数据交互的方式采用 JSON 对象。 4.5 缓存机制 缓存是介于应用程序和物理数据源之间的数据内存，其作用是为了降低应用 程序对物理数据源访问的频次，从而提高了应用的运行性能。缓存内的数据是对 物理数据源中的数据的复制，应用程序在运行时从缓存读写数据，在特定的时刻 或事件会同步缓存和物理数据源的数据。 Hibernate 提供了两级缓存架构，第一级缓存是 Session 缓存；该级缓存缺省被 Hibernate 启用，并且是基于事务级别的缓存。第二级缓存是 SessionFactory 缓存，该级 缓存对 Hibernate 来说是可选的且可通过缓存插件来进行配置，并且是基于应用级别的 缓存，也就是说它被该应用范围内的所有事务所共享。由于 Hibernate 的二级缓存策 略，是针对于 ID 查询的缓存策略，对于条件查询则毫无作用。为此，Hibernate 提供了针对条件查询的 Query 缓存，该缓存可以把某个或多个 Query 查询放入到 二级缓存中。 当然，二级缓存的使用也需要一些前提条件，并且带来了一些限制。首先要 求 Hibernate 程序对数据库有独占的写访问权，其他的进程更新了数据库，Hibernate 是 不可能知道的。所有操作数据库必需直接通过 hibernate，如果调用存储过程，或者使用 jdbc 更新数据库，Hibernate 也是不知道的，hibernate 的大批量更新和删除是不更新二级 缓存的，这样就限制了大批量更新和删除的数据的使用。 针对该系统前期系统用户量不大、并发要求不高的情况，只采用一级缓存。

4.6 数据批量处理 数据批量处理是指在一个事务中处理大量数据，一般说来，应该尽可能避免在应用 程序中进行批量操作，而应该在数据库中直接进行批量操作，但同时带来了数据库的可 移植性差，所以针对小批量的数据更新（100 条以内），可以在应用层进行批量操作， 操作方式主要有：（1）通过 Session 来进行批量操作。（2）通过 StatelessSession 来进 行批量操作。（3）通过 HQL 来进行批量操作。（4）直接通过 JDBC API 来进行批量 操作。 为了开发方便，我们选用 Session 来进行批量操作，Session 的 save()以及 update() 方法都会把处理的对象存放在自己的缓存中。如果通过一个 Session 对象来处理大量持 久化对象，应该及时从缓存中清空已经处理完毕并且不会再访问的对象。具体的做法是 在处理完一个对象或小批量对象后，立刻调用 flush()方法清理缓存，然后再调用 clear() 方法清空缓存。并且需进行如下设置：（1）需要在 Hibernate 的配置文件中设置 JDBC 单 次 批 量 处 理 的 数 目 ， 合 理 的 取 值 通 常 为 10 到 50 之 间 ， 本 系 统 采 用 hibernate.jdbc.batch_size=20，并应保证每次向数据库发送的批量 SQL 语句数目与这个 batch_size 属性一致。（2）如果对象采用"identity"标识符生成器，则 Hibernate 无法 在 JDBC 层进行批量插入操作。（3）批量操作时关闭二级缓存。 4.7 加锁机制 加锁对于数据库来说是保障并发和数据一致性的重要手段， Hibernate 作为对数据库 实现持久化的一个框架，同样也有自己的加锁机制，Hibernate 的加锁机制有悲观锁和乐 观锁两种机制。悲观锁(Pessimistic Locking)假定任何时刻存取数据时，都可能有另一个 事务也正在存取同一笔数据，为了保持数据被操作的一致性，于是对数据采取了锁定状 态，Hibernate 的加锁依靠数据库提供的锁机制来实现；乐观锁（Optimistic Locking）认 为数据库的存取很少发生同时存取的问题，因而不对数据锁定。为了维护正确的数据， Hibernate 中通过检查版本号来判断 乐观锁是使用应用程序上的逻辑来实现版本控制的。 数据是否已经被其他人所改动，在数据库中加入一个 version 字段记录，在读取数据时 连同版本号一同读取，并在更新数据时比较版本号与数据库中的版本号，如果等于数据 库中的版本号则予以更新，并递增版本号，如果小于数据库中的版本号就抛出异常。 悲观锁从根本上保证了数据的一致性， 但因为等待解锁带来了性能及数据库表死锁 的问题；针对本系统数据库表的更新操作并发量不大的特点，适合采取悲观锁，并采取

防死锁机制。 4.8 防死锁机制 在数据库系统中，产生死锁的原因是两个或多个事务都已封锁了一些数据对象，然 后又都请求对已为其他事务封锁的数据对象加锁，从而出现死锁等待。防止死锁的发生 其实就是要破坏产生死锁的条件。 预防死锁通常有两种方法。 预防死锁通常有两种方法： 一次封锁法，一次封锁法要求每个事务必须一次将所有要使用的数据全部加锁，否则就 不能继续执行。 一次封锁法虽然可以有效地防止死锁的发生， 但由于扩大了加锁的范围， 降低了系统的并发度；顺序封锁法，顺序封锁法是预先对数据对象规定一个封锁顺序， 所有事务都按这个顺序执行封锁。 在本系统中将定义一个数据库表的访问顺序， 并要求所有的事务都按照这个顺序访 问操作数据库。 4.9 表单验证 对 Web 应用来说， 由于用户的行为是无法预测的， 在表单数据在传递给业务类之前， 必须保证数据的合法性及有效性，而表单验证是保证数据合法性及有效性的重要手段。 对于基于 SSH 框架的表单验证一般有两种方式： 基于 JavaScript 的表单验证 （前端验证） 及基于 Struts 的表单验证（后端验证） 。 前端验证： 前端验证： 可以针对基本类型（汉字、英文、整型、数字、日期、邮编）的有效性及合法性开 发出一些共同 JavaScript 函数，以备整个系统统一调用。 后端验证： 后端验证： 主要采用基于 Struts 的表单验证，通过 ActionForm 的 validate 函数进行验证。 由于前端验证不需要提交服务器，直接在客户端完成，从而减少了服务器的压力， 所以我们优先采用前端验证。 4.10 异常处理 异常处理的目的是为了让用户看到异常的详细信息，定位异常发生的原因，让开发 人员对预期的异常进行处理，进一步提高系统的健壮性。 Java 语言拥有一套自己的异常处理机制，在 Java 的异常体系结构中，异常被分为两 类：一类是基于 https://www.360docs.net/doc/f710032101.html,ng.Exception 的异常，被称为检查异常，这类异常必须在程序中 予以扑获；另一类是基于 https://www.360docs.net/doc/f710032101.html,ng.RuntimeException 的异常，被称为运行异常，这类异

常不必在程序中扑捉，而且用户对这类异常一般无法恢复，但通过业务处逻辑的判断理 可以让程序避免这类异常的出现。 针对 J2EE 应用的多层架构，数据访问层和业务层可以根据需要向上层抛出相应的 Exception，而这些 Exception 须在 Action 类中捕捉，并向页面返回一个合适的信息，具 体展现根据情况来定，针对普通页面的异常，一般显示错误页面；Ajax 发生的异常，返 回一个包含错误信息的 JSON 对象，以 Ajax 方式显示。系统首先定义一个异常基类 BaseException，然后扩展定义 BaseDAOException 作为数据访问层的异常，扩展定义 BaseBusinessException 作为业务访问层的异常， Action 层的异常不做处理， 而 通过 Struts 框架统一处理，并把表示层的异常统一转向异常页面，并提示异常信息。 系统都需要用日志文件来记录系统的运行，以便于跟踪和记录系统的运行情况。系 统发生的异常理所当然的需要记录在日志系统中，并且仅在最初产生异常的位置记录， 在以后抛出并捕获该异常的位置则不再记录。 4.11 日志处理 规范合理的日志记录能让开发人员和维护人员事半功倍， 在记录日志时还应该考虑 不同的角色对日志内容可能会有 不同的需求。比如，软件正常情况下提供给用户的日 志应该简洁明了，调试时提供给程序员的日志应该详细明确。 LOG4J 作为一个开源的日志管理组件，提供了强大的日志管理功能，可以把日志输 出到控制台、文件或其他地方，支持包括 Fatal、Error、Warn、Info、Debug 多级日志输 入。并可以通过配置来控制日志的格式、输出级别。 本系统要求在每个函数的开始、结束位置、异常的初次抛出位置均要求输出到日志 记录文件，并把用户的系统操作记录存入到数据库日志表。
5. 共同组件
5.1 分页组件 数据列表是页面的一种常见页面表现形式，而分页功能又是列表的一个不可缺少 的功能，分页组件主要为各种形式的数据列表提供一个共同的分页功能。技术上可以分 两种实现方法：一是查询出所有的符合条件的数据记录，在 JSP 页面进行分页计算。这 种方法在数据量少的情况很方便，而且不影响效果，但对于大数据量的情况，将严重影 响性能；二是首先查询出总的符合条件的数据记录数，然后每次只查询出一页的数据记 录，这种方法对于大数据量的情况性能很好。本系统将采用第二种方法。由于 Hibernate

提供了对数据库定点定量查询的方法， DAO 层的数据分页查询可以基于 Hibernate 实现， 也可以基于特定数据库的定点定量查询 SQL 实现。页面表现可以基于 Ajax 技术，实现 无刷新效果，组件调用接口要求简洁明了。 5.2 树形组件 树形结构一般用于组织机构等具有层次结构的数据，也是页面常见的表现形式，树 形组件为各种形式的层次结构数据提供一个共同的分页功能。 技术上可以分两种实现方 法：一是查询出所有的层次节点的符合条件的数据记录，在 JSP 页面进行分层显示。二 是只查询显示层次节点的数据，展开时查询该节点的子节点的数据，这种方法适合大数 据量的情况，但用户交互效果不好。考虑到层次结构数据一般数据量不大的特点，我们 采用第一种方法。针对大数据量的情况可以采用数据列表的形式来表示。页面表现可以 基于 Ajax 技术，实现无刷新效果，组件调用接口要求简洁明了。 5.3 DAO基类（BaseDAO） 由于系统架构的 DAO 层采用 Hibernate 框架， 所以 BaseDAO 基类应继承 Hibernate 的 HibernateDaoSupport 类，并实现数据对象的增删改查数据库操作，具体可以参照 Hibernate 文档。 5.3 Service基类（BaseManager） 该类作为业务层 Service 类的基类，所有业务层 Service 类必须继承该类。该类实现 接口 IBaseManager(所有接口的名称定义为 I+Service 类名)，并封装 BaseDAO 类及业务 类的共同操作方法。 5.3 Action基类(BaseAction) 针对 Struts1，BaseAction 基类继承 Struts1 的 DispatchAction 类，并实现 Action 类的 共同方法，所有表现层 Action 类继承 BaseAction；BaseForm 类继承 ActionForm 类，并 通过实现 Validate()方法来进行数据验证。 针对 Struts2，BaseAction 基类继承 Struts2 的 ActionSuport 类，封装 BaseForm 类并 实现 Action 类的共同方法，所有表现层 Action 类继承 BaseAction，并封装相应的 Form 类。Struts 提供编程式和声明式，由于编程式灵活，系统统一采用编程式验证，开发人 员需要实现 Action 的 Validate() 方法来进行数据验证。

6. WEB子系统基于架构的开发流程
6.1
编写Service类
1. 定义 Service 接口类
public interface IExampleManager { public void getCode() throws BaseBusinessException; } }
2. 实现 Service 类
public class ExampleManager extends BaseManager implements IExampleManager{ /** * 取得Code */ public void getCode() throws BaseBusinessException { try{ TbCodeId cid = new TbCodeId("1","1"); dao.getObject(TbCode.class,1); }catch(BaseDAOException ex){ log.error(ex.getMessage(), ex); throw new BaseBusinessException(ex.getMessage()); } }
注意： Service 类必须继承 BaseManager 基类 方法对 BaseDAOException 异常扑捉，并根据业务需求进行处理，并抛出 BaseBusinessException。 访问数据库操作调用基类的 DAO 属性进行操作，不需再单独定义 DAO 类。 为了减少 Spring 中注入类的数量，以加快启动时间，系统对 Service 类进行 IOC 管理，而对 Action 类不进行 IOC 管理，所以，在进行数据库的更新操作 时，须在 Service 类的一个方法中完成一个事务的所有操作，而不应该在 Action 中完成一个事务的操作。 3.在 applicationContext-Cms.xml 中配置 Service 类，纳入 Spring 容器管理

6.2 单体测试Service类
在 test 包内测试类，命名为 Service 类名+Test。
public class HelloTest {{ ApplicationContext cxt; @Before public void setUp() throws Exception { String[] xmllocations={"/WebRoot/WEB-INF/applicationContext-DataSource. xml","/WebRoot/WEB-INF/applicationContext-Hibernate.xml", "/WebRoot/WEB-INF/applicationContext-Spring.xml","/WebRoot /WEB-INF/applicationContext-Cms.xml"}; cxt = new FileSystemXmlApplicationContext(xmllocations); } @Test public void testService() { try{ IExampleManager manager = (IExampleManager)cxt.getBean("CodeManager"); manager.getDepartment(); }catch(Exception e){ e.printStackTrace(); } }
注：CodeManager 为在 ApplicationContext-Cms.xml 文件中定义的 BeanID
6.2
编写Action类
1. 编写 Action 类
public class ExampleAction extends BaseAction { public String execute() throws Exception { //IOC调用业务类 IExampleManager exaManager=(IExampleManager) getBean("CodeManager"); exaManager.getDepartment(); //设置消息 setMessage(getText(getMessage())); return SUCCESS; }

注：1.类必须继承 BaseAction 基类 2.CodeManager 为在 ApplicationContext-Cms.xml 文件中定义的 BeanID 2.配置 Action 建立一个自己专用的 XML 文件，以后每人在自己的ＸＭＬ文件中管理自己的 Action 类，并在 Struts.xml 文件中添加该配置文件：

并在 example.xml 文件中添加该 Action 的配置：
/example.jsp
注：为了避免出现大量的 Action 类，本系统开发时，Action 类采用动态方法调用，类名及方法名的 命名规则参见类定义说明书。 其中：配置格式如:
/example.jsp
页面调用格式： Action="Action 实例名!方法名.action"

6.3
单体测试Action类
@Test public void testExecute() { try{ ExampleAction ea = new ExampleAction(); //设置测试用session变量 ea.setSessionObject("name1", "value1"); //设置Request变量 MockHttpServletRequest request = new MockHttpServletRequest(); request.setParameter("name2", "value2"); ea.setRequest(request); //执行 ea.execute(); }catch(Exception ex){ ex.printStackTrace(); } -----2 ----1
注：1. 若 Action 中有需要 Session 变量，则需要往 Session 中设置该值 2. 若 Action 中有需要 Request 变量，则需要往 Request 中设置该值
6.5 编写页面
在 JSP 页面中，可以优先使用 Struts2 标签、EXTTLD 标签及 JSP 标签。原则上讲，针对页面刷 新时用的元素应该用 Struts2 标签； 针对页面局部刷新或不刷新时用的元素应该采用 EXTTLD 标签。
6.6 页面测试 在完成上述步骤后，就可以根据业务逻辑，设置页面的转移，然后进行页面联动测 试。