Mini示例架构

1.概述

技术框架选型以工业化大规模软件开发为原则---主流的选型、适宜团队分工的架构，同时照顾轻量级快速开发的需求，Java版的约定大于配置的风格。

SpringSide 3 的进步(京山游侠)

2.主要库栈

JDK：JDK 6.0、 UTF-8.
IOC container：Spring 3.
ORM：Hibernate 3.3.
Web ：Struts 2.1、JSP 2.0、JQuery 1.4/Dojo Base 1.4.
Web Service：基于Apache CXF 2.2的JAX-WS/JAXB 2.0规范, 基于Jersey的JAX-RS规范.
Security: Spring Security 3.0.

3.层次说明

3.1 entity - 领域模型层

使用Sql First的开发模式，先设计数据库，参考DBA的性能意见而不要太片面追求OO化的表结构。

然后纯手工编写entity与极少量的JPA annotation(约定大于配置), 也可以用hibernate-tools从数据库逆向生成后再作修改。

3.2 access - 资源访问层

资源访问层包括对数据库、JMS、外部的WebService等的访问。

每个领域对象对应一个DAO类，继承于通用的HibernateDao<T>，所有以该对象为查询主体的HQL语句统一定义于DAO内并提供查询函数.

在性能紧要而Hibernate又无法满足要求时，可混合使用JDBCTemplate。

3.3 service - 业务逻辑层

Service层有两类对象，

一类是领域对象管理类(Entity Manager)，按领域对象划分，每个Manager类负责管理多个紧密关联的Entity的增删改查及其业务逻辑。

一类是业务服务类(Service)，按业务脚本划分，可能会访问到多种领域对象与Manager类。

用Spring的Transcation annotation定义事务。对于Hibernate Lazy load的关联对象，在性能要求不高时可使用OpenSessionInView Filter，否则在Service层完成对象的初始化操作。

3.4 web - Web MVC层

MVC框架使用Struts 2.1 这一老牌传统MVC框架 + Convention Plugin 实现零配置文件，每个Action实现一组页面操作。

View模板用JSP2.0 , 尽量使用纯html+JSP2.0 EL展示页面。

Javascript与Ajax使用JQuery或Dojo Base。

尽量采用CSS框架规范CSS的布局。

3.5 ws - WebService接口

使用Java first的开发模式，通过JSR181 annotation标注Web Service接口，用JAXB-2.0 annotation标注Java-XML Mapping。

用DTO类实现Entity与外系统的解耦，用WSResult包裹返回结果与返回码，不使用Exception返回错误。

对于Restful服务，同样采用JAX-RS annotation标注。

3.6 security - 安全控制

使用Spring Security的Filter 拦截URL，使用Spirng Security的taglib 拦截页面内容。

采用用户-角色-资源三层控制，角色-资源关系定义于XML的简化模式。

3.7 测试

单元测试尽量采用MockObject的方式屏幕所有依赖对象/数据的访问，对于dao层与特别查询与特别数据库操作，采用集成测试连接实际数据库，基于Spring的集成测试Context。

功能测试使用selenium测试主要用户故事的主流程及Javascript的效果，使用Jetty嵌入式Web服务器与H2嵌入式数据库，使用DBUnit预备数据，使得整个测试可以快速运行，对测试环境没有太多的依赖。

4.常见问题

4.1 什么时候使用基于接口编程？

基于接口编程、Fascade层等等抽象封装都是有开发和维护的代价的，是否使用归根结底还是看在团队人员的分工情况，在大家不得不依赖这几项技术来解决相互的接口、契约问题时，自然就用了。

4.2 Package是先分层还是先分模块

org.springside.模块A.web 还是 org.springside.web.模块A？同上，还是看团队人员的分工情况。如果是每人从头到尾负责一个独立模块的可以先分模块。反之，按层进行分工并鼓励层内重用的，可以考虑先分层。