Java SSH框架术规范.doc

航安项目 (三期) 框架技术规范 日期 版本 简述 作者 2011年3月1日 V1.0 指定本系统的技术规范 2011年9月25日 V2.0 指定本系统的技术规范  1、规范配置说明 1 2、系统三层架构规范配置说明 1 2.1 Dao 2 2.2 Entity 4 2.3 Service 4 3、Spring规范配置说明 5 3.1 IOC配置说明 5 3.2 集成Hibernate配置说明 5 3.3 AOP配置说明 6 4、Hibernate规范配置说明 7 4.1 Hiebernate的基本配置 7 4.2 对象标识符号 8 4.3 Hibernate映射类型 9 4.4 Hibernate的HQL语言 10 5、Struts规范配置说明 13 5.1 struts2-convention插件概述 13 5.2 struts2-convention具体配置及规范说明 14 5.3 Struts.xml配置文件 15 5.4 Web目录规范说明 16 6、JPA规范配置说明 17 6.1 Entity Identity 实体标识 17 6.2 Accessor of Persistent Fields and Properties 持久化值域和属性的访问器 18 6.3 Persistence Context 持久化上下文 18 6.4 Entity Instances Life Cycle 实例对象生命周期 19 6.5 Entity Relationships 实体关系 19 6.6 Inheritance 继承 20 6.7 Optimistic Locking and Concurrency 乐观锁及并发控制 20 6.8 本系统JPA例子 21 6.9 JPA注解详细说明 22 1、规范配置说明 在JavaEE企业级开发中，以SSH框架为核心的应用非常广泛，航安项目实现全注解式的开发。用到SSH框架的版本为：Struts2.1.6+Spring2.5.6+Hibernate3.6.4+JPA，用到的工作流流程管理框架为JBPM：JBPM4.4，…… 框架（sinoframe）的服务器上SVN的地址是：11/SVN/kuangjia。 航安系统（sms）的服务器上SVN的地址是：11/svn/sms。 2、系统三层架构规范配置说明 这章为大家说明系统的层次结构，并实现除WEB层的部分功能代码，详细代码请在源码中查看。 系统一共分为：dao、entity、service、web四层。另外在这些层次下，还以业务功能再进行分包，这样做是为了方便在以后的功能扩展中，能更好的管理和维护代码。如果将所有类都直接集中在这4个包下面，随着类的增加，会越来越难以维护，而且查找起来也很费劲。 2.1 Dao 先建立BaseHibernateDao，它是通过继承Spring提供的DaoSupport来实现持久层的基类，并且封装了一些基本操作方法。 这是BaseHibernateDao的部分代码。大家在写Dao时，可以直接继承BasehibernateDao。 持久层的Dao类是根据实体类定义，一般是一个实体类就会有一个对应的Dao类。当然这要跟业务需求来设计，不是绝对的。 这些定义的方法是供service层调用，在业务层，将不会看到一行与持久层有关的代码，降低藕合性是这样做的目的。@Repository注解的作用就是标注这个UserDao是一个持久层组件。component-scan它就是用来将标有@Repository，@Service这样的注解类扫描到Spring的容器里，并且同时对标有@Resource注解的Bean启用了自动注入功能。使用注解的方法，可以告别繁琐的配置文件定义。 2.2 Entity 关于实体的定义就是使用JPA注解。详见JPA规范说明。 2.3 Service @Service表示这是业务层组件。在业务层需要对调用的Dao类的Set方法加上@Resource注解，这里将业务层的方法名与持久层的方法名定义大家可以按自己的想法来做。 3、Spring规范配置说明 3.1 IOC配置说明 根据base-package指定的路径，扫描其下所有包含注解的Bean，并自动注入。比如@Repository，@Service这些都是注解，前者表示持久层，后者表示业务层。有了它，将不用再去写那繁琐的bean id= class= /。本系统的主旨就是全注解，就是为了告诉大家不用写配置文件（当然不是绝对不写）来怎样进行开发工作。 3.2 集成Hibernate配置