Struts 2.1.6+Spring 2.5.6+Hibernate 3.3.1 全注解实例详解
在JavaEE企业级开发中，以SSH2框架为核心的应用非常广，大象根据项目实践经验，通过一个实例，详细的为大家讲解如何实现全注解式的开发。
开发环境
JDK1.6.0_18
Eclipse3.2.1
MyEclipse5.1.0
Tomcat6.0.10
MySQL5.0.27
Navicat Lite for MySQL 8.1.20
每个人的开发环境可能会有差异，但有一点我需要说明的是，JDK的版本不得低于1.5，因为用到了很多1.5版才支持的新特性。Tomcat和MySQL请不要低于我所用的版本，因为我没在其它的版本上进行测试。Navicat则是MySQL数据库的图形化操作工具。我在这里假定各位目前已经设置好了开发环境，下面就开始详细的说明。
由于要阐述的内容比较多，大象决定将它们划分成个几章节来讲，这一章就主要来说说jar包的选择。
第一部分：选择必须的jar包
新建一个web项目，然后将必要的jar包COPY到lib里面。根据本文实例demo，大象给出下图中的最少jar包配置。
附件: jar.jpg
我对这些jar包进行一下说明，方便大家理解。
附件: struts2jar.jpg
解压Struts2.1.6的lib文件夹，从中选出上面7个jar包添加到我们的工程库中。commons-logging、freemarker、ognl、struts2-core、xwork这5个还是struts2的核心包。但在Struts2.1.6这个版本中，还需要加上commons-fileupload包。如果没有，则启动就会报错，不过不需要像网上传言的那样还得加上commons-io的jar包，这些大象都亲自做过测试。在本实例中，我将对struts2也采取注解的方式，所以用到了struts2-convention-plugin-2.1.6.jar这个插件。因为要与spring整合，所以struts2-spring-plugin-2.1.6.jar也必不可少。
附件: springjar.jpg
大象在这里偷个懒，直接将spring的完整jar包加了进来，如果各位想精简类库的话，就选取它的分类jar包吧。比如本例使用struts2作为MVC框架，所以spring的webmvc就不可能用到了。有想改的朋友请自己动手改下。另外有点我想说下，如果采取完整spring的jar包，还需要Spring2.5.6\lib\concurrent文件夹中的backport-util-concurrent.jar，如果不加这个，spring会报错。但是采取spring分类jar包的形式，这个可以不用加，至于具体使用什么需要依赖这个包，大象还没去测试过，这个有待验证。还有lib\slf4j下的日志包，目前很多都开始采用基于slf4j接口的日志器，它的好处就是日志器是根据slf4j的接口来进行实现，可以在不改变代码的情况下更换日志器。最后Spring的源代码中使用的是commons-logging记录日志，因此这个包不能少，不过因为struts2也用到了，所以这里就省了。
附件: hibernatejar.jpg
Hibernate从3.3版开始，对jar包结构做了一次大的调整，我们只需要加入lib\required文件夹下面的6个jar包。请注意这6个jar包都是使用Hibernate 所必须的。另外再加上hibernate核心包。这里我将slf4j-api-1.5.2.jar换成了1.5.0，这是因为slf4j是一个通用日志接口，不提供任何实现，我在demo里面使用的是log4j，而hibernate包里面没有log4j的slf4j实现。而且如果版本不一致，会有异常，因此我就采用Spring2.5.6\lib\slf4j里面提供的配套版本。另外我将commons-collections-3.1.jar换成了Struts2.1.6里面的3.2版。
附件: annotationsjar.jpg
例子中使用Hibernate JPA来完成实体对象映射，所以上面这些包都必不可少。使用注解的方式，可以不用写繁琐的配置文件，降低了出错机率。而且现在很多人都喜欢这种方式。大家可以去sourceforge下载。
下载地址：http://sourceforge.net/projects/hibernate/files/
附件: dbcpjar.jpg
本例使用DBCP连接池来管理数据源。
附件: mysqljar.jpg
MySQL数据库的连接驱动。
附件: cglibjar.jpg
这个包的作用是创建动态代理对象。比如在使用AOP方式管理spring事务时，如果我们的目标对象没有实现接口，而又要使用AOP来处理事务，这时就需要用到这个jar包。可以在Spring2.5.6\lib\cglib里面找到。
附件: jstljar.jpg
JSTL标签库，很经典的东东，如果需要可以将它们加入lib中。
实例中涉及的配置文件有这么几个
applicationContext.xml
jdbc.properties
log4j.properties
struts.xml
web.xml
我准备在本章中只讲applicationContext.xml、jdbc.properties和web.xml。log4j的配置大同小异而且也不在本文范围。至于struts.xml我准备留到后面与Action代码一起来讲，因为用的是struts2-convention-plugin插件来实现struts2的注解，所以这两个结合起来讲要好一些。
第二部分：分析配置文件
1、jdbc.properties
本例采用MySQL数据库，所以我设置了一个属性文件，用来存放一些连接信息和Hibernate相关的设置。
附件: jdbc.jpg
因为我们使用的是Hibernate来与数据库进行交互，把这些东西写在单独的文件里，是方便修改，如果你想换成SQL Server或是Oracle，只需要更改driver、url以及dialect，而且还可以自由控制sql语句的显示的开关，非常方便。至于写在这里怎么用呢？请接着看下面的applicationContext.xml说明。
2、applicationContext.xml
这个文件就是spring的主配置文件了，当然，本例也只有这么一个spring的配置文件，内容不多，但做的工作还是很多的，下面我给大家详细分析一下。
附件: source.jpg
我把这两部分放在一起是因为这两者是相互联系的，而且也比较好说明。可以这样来理解，PropertyPlaceholderConfigurer这个类就是读取jdbc. properties文件，并将它们设置到这个类的属性中。然后再将下面数据源配置中定义的这些${jdbc.driver}、${jdbc.url}字符串换成属性文件中相同名称的值。${}这种写法，是类里面方法解析用的，网上都说这是叫占位符，我看了源代码的，其实是把它们当成字符串截取前后的特殊字符，再根据里面定义的名称找属性文件中对应的值。所以这个类只能读取properties格式的文件，你如果还有其它需要加入的属性文件，可以在list之间加入，写在value标签里面。
附件: component.jpg
根据base-package指定的路径，扫描其下所有包含注解的Bean，并自动注入。比如@Repository，@Service这些都是注解，前者表示持久层，后者表示业务层。这可是非常非常好的一个功能，是从Spring2.5开始加入的一个非常棒的特性。有了它，我们将不用再去写那繁琐的<bean id="" class="" />。本文的主旨就是全注解，就是为了告诉大家不用写配置文件（当然不是绝对不写）来怎样进行开发工作。关于这部分的具体情况，在后面代码章节中会详细讲解。
附件: hibernate.jpg
这就是在Spring中定义Hibernate相关的配置，Spring已经集成了这部分功能。通过class里面定义的类名称我们很容易就能理解，这是使用注解的方式映射实体以及创建Hiberante SessionFactory。${hibernate.dialect}、${hibernate.show_sql}和上面的数据源配置获取方式一样，当applicationContext.xml定义好之后，就不用再对它进行修改，而是将修改对象变成了jdbc.properties文件。
另外在Spring2.5.6版中，加入了一个很有用的小功能，就是packagesToScan属性，它是根据value中定义的路径来扫描其下所有的注解实体类。大象对这个路径做了多种测试，另外又看了源代码，发现它只能匹配某一类型的路径，而不是所有路径。比如上面的value值表示，扫描entity包下面的所有包中的注解类，如果你将类直接放在entity包下，那么服务器启动和程序运行时都不会报错，但是当你的代码需要用到这个类的时候，就会出现异常，提示你找不到实体。
附件: transaction.jpg
这是事务定义，而且是使用注解方式定义事务（@Transactional），proxy-target-class="true"表示采用动态代理类来管理事务，如果是false表示采用接口代理来管理事务（默认值为false）。什么意思呢？就是说对于需要加入事务处理的类，如果是实现接口，那么将采用Spring的默认事务管理（Spring默认方式为接口），如果不采用接口，而直接使用类，那么就需要cglib类库的支持，它通过动态的创建目标类（就是你需要加入事务的类）的子类，然后对这子类中的方法（当然是从目标类中继承来的）进行事务管理。这其实就是AOP切面，而且从中可以看出来，需要加入事务的方法不能为private、static、final 的方法。这样说也不是很严格，说它不能加入事务，是说它不能主动的启动一个事务，如果某个private方法是被某个public方法调用的，而public方法是可以被动态代理加入事务的，所以这个private方法也一样被加入了事务，只是它处在public方法的事务之中。但是static和final这两类方法因为不能被子类覆盖，所以无法加入事务。如果这两类型的方法不被其它的事务方法所调用，那么它们就会以无事务的方式运行，因此很容易造成隐患，这一点请大家特别注意。
附件: txadvice.jpg
上面这个就是使用配置式来定义事务，两种方式的区别主要是，注解式只用写那么一句话，然后在业务类或方法中加入@Transactional这个注解标记，就完成事务声明，不过对于每个业务类都需要在类或方法中加入这些标记。而配置式声明，就是不用加这些标记，只要你的方法名称命名比较统一，就可以像上面这样定义事务规范，然后在aop标签中定义切入点与执行通知就行了。我感觉如果业务逻辑不是太复杂的情况，配置式会比较简单，而且修改起来也方便，这两种方式我都写出来了，至于用哪一种，由你们自己决定。
开发环境
JDK1.6.0_18
Eclipse3.2.1
MyEclipse5.1.0
Tomcat6.0.10
MySQL5.0.27
Navicat Lite for MySQL 8.1.20
每个人的开发环境可能会有差异，但有一点我需要说明的是，JDK的版本不得低于1.5，因为用到了很多1.5版才支持的新特性。Tomcat和MySQL请不要低于我所用的版本，因为我没在其它的版本上进行测试。Navicat则是MySQL数据库的图形化操作工具。我在这里假定各位目前已经设置好了开发环境，下面就开始详细的说明。
由于要阐述的内容比较多，大象决定将它们划分成个几章节来讲，这一章就主要来说说jar包的选择。
第一部分：选择必须的jar包
新建一个web项目，然后将必要的jar包COPY到lib里面。根据本文实例demo，大象给出下图中的最少jar包配置。
附件: jar.jpg
我对这些jar包进行一下说明，方便大家理解。
附件: struts2jar.jpg
解压Struts2.1.6的lib文件夹，从中选出上面7个jar包添加到我们的工程库中。commons-logging、freemarker、ognl、struts2-core、xwork这5个还是struts2的核心包。但在Struts2.1.6这个版本中，还需要加上commons-fileupload包。如果没有，则启动就会报错，不过不需要像网上传言的那样还得加上commons-io的jar包，这些大象都亲自做过测试。在本实例中，我将对struts2也采取注解的方式，所以用到了struts2-convention-plugin-2.1.6.jar这个插件。因为要与spring整合，所以struts2-spring-plugin-2.1.6.jar也必不可少。
附件: springjar.jpg
大象在这里偷个懒，直接将spring的完整jar包加了进来，如果各位想精简类库的话，就选取它的分类jar包吧。比如本例使用struts2作为MVC框架，所以spring的webmvc就不可能用到了。有想改的朋友请自己动手改下。另外有点我想说下，如果采取完整spring的jar包，还需要Spring2.5.6\lib\concurrent文件夹中的backport-util-concurrent.jar，如果不加这个，spring会报错。但是采取spring分类jar包的形式，这个可以不用加，至于具体使用什么需要依赖这个包，大象还没去测试过，这个有待验证。还有lib\slf4j下的日志包，目前很多都开始采用基于slf4j接口的日志器，它的好处就是日志器是根据slf4j的接口来进行实现，可以在不改变代码的情况下更换日志器。最后Spring的源代码中使用的是commons-logging记录日志，因此这个包不能少，不过因为struts2也用到了，所以这里就省了。
附件: hibernatejar.jpg
Hibernate从3.3版开始，对jar包结构做了一次大的调整，我们只需要加入lib\required文件夹下面的6个jar包。请注意这6个jar包都是使用Hibernate 所必须的。另外再加上hibernate核心包。这里我将slf4j-api-1.5.2.jar换成了1.5.0，这是因为slf4j是一个通用日志接口，不提供任何实现，我在demo里面使用的是log4j，而hibernate包里面没有log4j的slf4j实现。而且如果版本不一致，会有异常，因此我就采用Spring2.5.6\lib\slf4j里面提供的配套版本。另外我将commons-collections-3.1.jar换成了Struts2.1.6里面的3.2版。
附件: annotationsjar.jpg
例子中使用Hibernate JPA来完成实体对象映射，所以上面这些包都必不可少。使用注解的方式，可以不用写繁琐的配置文件，降低了出错机率。而且现在很多人都喜欢这种方式。大家可以去sourceforge下载。
下载地址：http://sourceforge.net/projects/hibernate/files/
附件: dbcpjar.jpg
本例使用DBCP连接池来管理数据源。
附件: mysqljar.jpg
MySQL数据库的连接驱动。
附件: cglibjar.jpg
这个包的作用是创建动态代理对象。比如在使用AOP方式管理spring事务时，如果我们的目标对象没有实现接口，而又要使用AOP来处理事务，这时就需要用到这个jar包。可以在Spring2.5.6\lib\cglib里面找到。
附件: jstljar.jpg
JSTL标签库，很经典的东东，如果需要可以将它们加入lib中。
大象在这里建议大家做开发的时候，不要过多的依赖MyEclipse提供的那些功能，多用手动的方式来做。那样方便是方便了，但不利于学习。比如加入上面这些开发所用的类库，这样可以更清楚的了解每个jar包的作用，增加知识的积累，方便以后调试。
在上一章中详细分析了JAR包的选择，那么这次我将对例子中的一些必须的配置文件进行下说明。虽然这些配置在网上也很容易找到，但是很多都没有讲个因为所以出来，这样根本就得不到提高。在此，大象为各位详细分析一下这些内容。
实例中涉及的配置文件有这么几个
applicationContext.xml
jdbc.properties
log4j.properties
struts.xml
web.xml
我准备在本章中只讲applicationContext.xml、jdbc.properties和web.xml。log4j的配置大同小异而且也不在本文范围。至于struts.xml我准备留到后面与Action代码一起来讲，因为用的是struts2-convention-plugin插件来实现struts2的注解，所以这两个结合起来讲要好一些。
第二部分：分析配置文件
1、jdbc.properties
本例采用MySQL数据库，所以我设置了一个属性文件，用来存放一些连接信息和Hibernate相关的设置。
附件: jdbc.jpg
因为我们使用的是Hibernate来与数据库进行交互，把这些东西写在单独的文件里，是方便修改，如果你想换成SQL Server或是Oracle，只需要更改driver、url以及dialect，而且还可以自由控制sql语句的显示的开关，非常方便。至于写在这里怎么用呢？请接着看下面的applicationContext.xml说明。
2、applicationContext.xml
这个文件就是spring的主配置文件了，当然，本例也只有这么一个spring的配置文件，内容不多，但做的工作还是很多的，下面我给大家详细分析一下。
附件: source.jpg
我把这两部分放在一起是因为这两者是相互联系的，而且也比较好说明。可以这样来理解，PropertyPlaceholderConfigurer这个类就是读取jdbc. properties文件，并将它们设置到这个类的属性中。然后再将下面数据源配置中定义的这些${jdbc.driver}、${jdbc.url}字符串换成属性文件中相同名称的值。${}这种写法，是类里面方法解析用的，网上都说这是叫占位符，我看了源代码的，其实是把它们当成字符串截取前后的特殊字符，再根据里面定义的名称找属性文件中对应的值。所以这个类只能读取properties格式的文件，你如果还有其它需要加入的属性文件，可以在list之间加入，写在value标签里面。
附件: component.jpg
根据base-package指定的路径，扫描其下所有包含注解的Bean，并自动注入。比如@Repository，@Service这些都是注解，前者表示持久层，后者表示业务层。这可是非常非常好的一个功能，是从Spring2.5开始加入的一个非常棒的特性。有了它，我们将不用再去写那繁琐的<bean id="" class="" />。本文的主旨就是全注解，就是为了告诉大家不用写配置文件（当然不是绝对不写）来怎样进行开发工作。关于这部分的具体情况，在后面代码章节中会详细讲解。
附件: hibernate.jpg
这就是在Spring中定义Hibernate相关的配置，Spring已经集成了这部分功能。通过class里面定义的类名称我们很容易就能理解，这是使用注解的方式映射实体以及创建Hiberante SessionFactory。${hibernate.dialect}、${hibernate.show_sql}和上面的数据源配置获取方式一样，当applicationContext.xml定义好之后，就不用再对它进行修改，而是将修改对象变成了jdbc.properties文件。
另外在Spring2.5.6版中，加入了一个很有用的小功能，就是packagesToScan属性，它是根据value中定义的路径来扫描其下所有的注解实体类。大象对这个路径做了多种测试，另外又看了源代码，发现它只能匹配某一类型的路径，而不是所有路径。比如上面的value值表示，扫描entity包下面的所有包中的注解类，如果你将类直接放在entity包下，那么服务器启动和程序运行时都不会报错，但是当你的代码需要用到这个类的时候，就会出现异常，提示你找不到实体。
附件: transaction.jpg
这是事务定义，而且是使用注解方式定义事务（@Transactional），proxy-target-class="true"表示采用动态代理类来管理事务，如果是false表示采用接口代理来管理事务（默认值为false）。什么意思呢？就是说对于需要加入事务处理的类，如果是实现接口，那么将采用Spring的默认事务管理（Spring默认方式为接口），如果不采用接口，而直接使用类，那么就需要cglib类库的支持，它通过动态的创建目标类（就是你需要加入事务的类）的子类，然后对这子类中的方法（当然是从目标类中继承来的）进行事务管理。这其实就是AOP切面，而且从中可以看出来，需要加入事务的方法不能为private、static、final 的方法。这样说也不是很严格，说它不能加入事务，是说它不能主动的启动一个事务，如果某个private方法是被某个public方法调用的，而public方法是可以被动态代理加入事务的，所以这个private方法也一样被加入了事务，只是它处在public方法的事务之中。但是static和final这两类方法因为不能被子类覆盖，所以无法加入事务。如果这两类型的方法不被其它的事务方法所调用，那么它们就会以无事务的方式运行，因此很容易造成隐患，这一点请大家特别注意。
附件: txadvice.jpg
上面这个就是使用配置式来定义事务，两种方式的区别主要是，注解式只用写那么一句话，然后在业务类或方法中加入@Transactional这个注解标记，就完成事务声明，不过对于每个业务类都需要在类或方法中加入这些标记。而配置式声明，就是不用加这些标记，只要你的方法名称命名比较统一，就可以像上面这样定义事务规范，然后在aop标签中定义切入点与执行通知就行了。我感觉如果业务逻辑不是太复杂的情况，配置式会比较简单，而且修改起来也方便，这两种方式我都写出来了，至于用哪一种，由你们自己决定。
