springSide

1.概述

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

* SpringSide 3 的进步(京山游侠)

2.主要库栈

* JDK：JDK 5.0/6.0、 UTF-8.
* IOC container：Spring 2.5.
* ORM：Hibernate 3.3.
* Web ：Struts 2.1、JSP 2.0、JQuery 1.3/Dojo Base 1.3.
* Web Service：基于Apache CXF 2.2的JAX-WS/JAXB 2.0规范.
* Security: Spring Security 2.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 API使用时，才会在DAO类中增加新的函数，而不会为每个普通HQL封装新的函数。
3.3 service - 业务逻辑层

Service层有两类对象，

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

一类是业务服务类(Service)，按业务划分，每个Server类负责一个业务脚本, 可能会访问到多种领域对象。

用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，视乎项目中的JS使用是否繁重。
3.5 ws - WebService接口

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

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

用户-角色-授权三层控制，使用Spring Security的Filter 拦截URL，使用Spirng Security的taglib 拦截页面内容。
3.7 测试

dao层测试OR mapping与特别SQL，特别数据库操作，使用集成测试测试实际数据库，基于Spring的集成测试Context，使用DBUnit准备数据。

manager/service类测试业务逻辑， 可使用连接实际数据库也以使用MockObject屏蔽dao层。

功能测试使用selenium测试主要用户故事的主流程及Javascript的效果.
4.常见问题
4.1 什么时候使用基于接口编程 ？

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

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