Struts216+Spring256+Hibernate331全注解实例详解转自大象.docx

1、Struts216+Spring256+Hibernate331全注解实例详解转自大象2010-12-07Struts2.1.6+Spring2.5.6+Hibernate3.3.1全注解实例详解（一）(转载大象)文章分类:Java编程 在JavaEE企业级开发中，以SSH2框架为核心的应用非常广，大象根据项目实践经验，通过一个实例，详细的为大家讲解如何实现全注解式的开发。开发环境JDK 1.6.0_18Eclipse3.2.1MyEclipse5.1.0Tomcat6.0.10MySQL5.0.27Navicat Lite for MySQL 8.1.20每个人的开发环境可能会有差异，但有一

2、点我需要说明的是，JDK的版本不得低于1.5，因为用到了很多1.5版才支持的新特性。Tomcat和MySQL请不要低于我所用的版本，因为我没在其它的版本上进行测试。Navicat则是MySQL数据库的图形化操作工具。我在这里假定各位目前已经设置好了开发环境，下面就开始详细的说明。由于要阐述的内容比较多，大象决定将它们划分成个几章节来讲，这一章就主要来说说jar包的选择。第一部分：选择必须的jar包新建一个web项目，然后将必要的jar包COPY到lib里面。根据本文实例demo，大象给出下图中的最少jar包配置。我对这些jar包进行一下说明，方便大家理解。解压Struts2.1.6的lib文件

3、夹，从中选出上面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

4、-2.1.6.jar也必不可少。大象在这里偷个懒，直接将spring的完整jar包加了进来，如果各位想精简类库的话，就选取它的分类jar包吧。比如本例使用struts2作为MVC框架，所以spring的webmvc就不可能用到了。有想改的朋友请自己动手改下。另外有点我想说下，如果采取完整spring的jar包，还需要Spring2.5.6libconcurrent文件夹中的backport-util-concurrent.jar，如果不加这个，spring会报错。但是采取spring分类jar包的形式，这个可以不用加，至于具体使用什么需要依赖这个包，大象还没去测试过，这个有待验证。还有libs

5、lf4j下的日志包，目前很多都开始采用基于slf4j接口的日志器，它的好处就是日志器是根据slf4j的接口来进行实现，可以在不改变代码的情况下更换日志器。最后Spring的源代码中使用的是commons-logging记录日志，因此这个包不能少，不过因为struts2也用到了，所以这里就省了。Hibernate从3.3版开始，对jar包结构做了一次大的调整，我们只需要加入librequired文件夹下面的6个jar包。请注意这6个jar包都是使用Hibernate所必须的。另外再加上hibernate核心包。这里我将slf4j-api-1.5.2.jar换成了1.5.0，这是因为slf4j是一

6、个通用日志接口，不提供任何实现，我在demo里面使用的是log4j，而hibernate包里面没有log4j的slf4j实现。而且如果版本不一致，会有异常，因此我就采用Spring2.5.6libslf4j里面提供的配套版本。另外我将commons-collections-3.1.jar换成了Struts2.1.6里面的3.2版。例子中使用Hibernate JPA来完成实体对象映射，所以上面这些包都必不可少。使用注解的方式，可以不用写繁琐的配置文件，降低了出错机率。而且现在很多人都喜欢这种方式。大家可以去sourceforge下载。下载地址：本例使用DBCP连接池来管理数据源。MySQL数据

7、库的连接驱动。这个包的作用是创建动态代理对象。比如在使用AOP方式管理spring事务时，如果我们的目标对象没有实现接口，而又要使用AOP来处理事务，这时就需要用到这个jar包。可以在Spring2.5.6libcglib里面找到。JSTL标签库，很经典的东东，如果需要可以将它们加入lib中。大象在这里建议大家做开发的时候，不要过多的依赖MyEclipse提供的那些功能，多用手动的方式来做。那样方便是方便了，但不利于学习。比如加入上面这些开发所用的类库，这样可以更清楚的了解每个jar包的作用，增加知识的积累，方便以后调试。Ok，关于这部分的内容到这里就说完了，那么，我们下次继续。2010-12

8、-07Struts2.1.6+Spring2.5.6+Hibernate3.3.1全注解实例详解（二）(转载大象)文章分类:Java编程 在上一章中详细分析了JAR包的选择，那么这次我将对例子中的一些必须的配置文件进行下说明。虽然这些配置在网上也很容易找到，但是很多都没有讲个因为所以出来，这样根本就得不到提高。在此，大象为各位详细分析一下这些内容。实例中涉及的配置文件有这么几个applicationContext.xmljdbc.propertieslog4j.propertiesstruts.xmlweb.xml我准备在本章中只讲applicationContext.xml、jdbc.pro

9、perties和web.xml。log4j的配置大同小异而且也不在本文范围。至于struts.xml我准备留到后面与Action代码一起来讲，因为用的是struts2-convention-plugin插件来实现struts2的注解，所以这两个结合起来讲要好一些。第二部分：分析配置文件1、jdbc.properties本例采用MySQL数据库，所以我设置了一个属性文件，用来存放一些连接信息和Hibernate相关的设置。因为我们使用的是Hibernate来与数据库进行交互，把这些东西写在单独的文件里，是方便修改，如果你想换成SQL Server或是Oracle，只需要更改driver、url以

10、及dialect，而且还可以自由控制sql语句的显示的开关，非常方便。至于写在这里怎么用呢？请接着看下面的applicationContext.xml说明。2、applicationContext.xml这个文件就是spring的主配置文件了，当然，本例也只有这么一个spring的配置文件，内容不多，但做的工作还是很多的，下面我给大家详细分析一下。我把这两部分放在一起是因为这两者是相互联系的，而且也比较好说明。可以这样来理解，PropertyPlaceholderConfigurer这个类就是读取jdbc. properties文件，并将它们设置到这个类的属性中。然后再将下面数据源配置中定义的

11、这些$jdbc.driver、$jdbc.url字符串换成属性文件中相同名称的值。$这种写法，是类里面方法解析用的，网上都说这是叫占位符，我看了源代码的，其实是把它们当成字符串截取前后的特殊字符，再根据里面定义的名称找属性文件中对应的值。所以这个类只能读取properties格式的文件，你如果还有其它需要加入的属性文件，可以在list之间加入，写在value标签里面。根据base-package指定的路径，扫描其下所有包含注解的Bean，并自动注入。比如Repository，Service这些都是注解，前者表示持久层，后者表示业务层。这可是非常非常好的一个功能，是从Spring2.5开始加入的

12、一个非常棒的特性。有了它，我们将不用再去写那繁琐的。本文的主旨就是全注解，就是为了告诉大家不用写配置文件（当然不是绝对不写）来怎样进行开发工作。关于这部分的具体情况，在后面代码章节中会详细讲解。这就是在Spring中定义Hibernate相关的配置，Spring已经集成了这部分功能。通过class里面定义的类名称我们很容易就能理解，这是使用注解的方式映射实体以及创建Hiberante SessionFactory。$hibernate.dialect、$hibernate.show_sql和上面的数据源配置获取方式一样，当applicationContext.xml定义好之后，就不用再对它进行

13、修改，而是将修改对象变成了jdbc.properties文件。另外在Spring 2.5.6版中，加入了一个很有用的小功能，就是packagesToScan属性，它是根据value中定义的路径来扫描其下所有的注解实体类。大象对这个路径做了多种测试，另外又看了源代码，发现它只能匹配某一类型的路径，而不是所有路径。比如上面的value值表示，扫描entity包下面的所有包中的注解类，如果你将类直接放在entity包下，那么服务器启动和程序运行时都不会报错，但是当你的代码需要用到这个类的时候，就会出现异常，提示你找不到实体。这是事务定义，而且是使用注解方式定义事务（Transactional），pr

14、oxy-target-class=true表示采用动态代理类来管理事务，如果是false表示采用接口代理来管理事务（默认值为false）。什么意思呢？就是说对于需要加入事务处理的类，如果是实现接口，那么将采用Spring的默认事务管理（Spring默认方式为接口），如果不采用接口，而直接使用类，那么就需要cglib类库的支持，它通过动态的创建目标类（就是你需要加入事务的类）的子类，然后对这子类中的方法（当然是从目标类中继承来的）进行事务管理。这其实就是AOP切面，而且从中可以看出来，需要加入事务的方法不能为private、static、final 的方法。这样说也不是很严格，说它不能加入事务，

15、是说它不能主动的启动一个事务，如果某个private方法是被某个public方法调用的，而public方法是可以被动态代理加入事务的，所以这个private方法也一样被加入了事务，只是它处在public方法的事务之中。但是static和final这两类方法因为不能被子类覆盖，所以无法加入事务。如果这两类型的方法不被其它的事务方法所调用，那么它们就会以无事务的方式运行，因此很容易造成隐患，这一点请大家特别注意。上面这个就是使用配置式来定义事务，两种方式的区别主要是，注解式只用写那么一句话，然后在业务类或方法中加入Transactional这个注解标记，就完成事务声明，不过对于每个业务类都需要在类

16、或方法中加入这些标记。而配置式声明，就是不用加这些标记，只要你的方法名称命名比较统一，就可以像上面这样定义事务规范，然后在aop标签中定义切入点与执行通知就行了。我感觉如果业务逻辑不是太复杂的情况，配置式会比较简单，而且修改起来也方便，这两种方式我都写出来了，至于用哪一种，由你们自己决定。3、web.xml现在使用的Servlet容器还是2.4版，因此web.xml里面还是需要写配置文件的，到了3.0版就可以采取注解的方式来实现了。Spring ApplicationContext配置文件的路径,可使用通配符，applicationContext*.xml表示所有以applicationCon

17、text开头的xml文件。多个路径用,号分隔。比如可以这样写：不过推荐采用通配符的写法，能够简单点，为什么还要弄那么复杂呢？context-param是在容器启动后最先被执行的，并且被放入到容器上下文中。在这里引入spring的配置文件，是供Spring的ContextLoaderListener监听器使用。而这个监听器中会有一个ContextLoade类用来获取这个配置文件中的信息。从而进行Spring容器的初始化工作。因为是采用注解的方式来进行开发，所以spring的配置文件其实只有一个，上面那个星号可以去掉。这个监听器就是为了读取Spring的配置文件，这在上面已经讲到了。这是Sprin

18、g提供的一个用来防止内存泄漏的监听器。在我们使用struts2框架，或其它的某些类库时，因为它们自身的设计，会用到Introspector（内省）机制来获取Bean对象的信息。但不幸的是，这些框架或类库在分析完一个类之后却没有将它从内存中清除掉，内存中还保留有大量的静态资源，而这些东西又无法进行垃圾回收，因此产生了很严重的内存泄漏问题。直接表现为服务器的内存使用会随着时间而不断上升，最后的结果当然就是服务器当掉。所以在这里加入此监听器，能够帮助我们更好的处理内存资源回收的问题。这是Spring的编码过滤器，我们可以直接拿来用，相信这段配置应该很好理解，不过请大家注意forceEncoding这

19、个参数，把它设置为true表示不管请求中的编码是什么格式，都将强制采用encoding中设置的编码方式。另外对于响应也将按照encoding指定的编码进行设置。另外不建议将编码设置成gb2312或是gbk格式，请采用基于Unicode的UTF-8编码。这个过滤器是个好东西，有了它，我们在使用Hibernate延迟加载的时候，就不会再为因Session被关闭，导致延迟加载数据异常而头痛了。网上有很多人说这个不好，其实在使用中，效果还是不错的。首先我要说这个过滤器的名字很雷，不知道写这类的家伙是不是个变态，或者喜欢恶搞。主要原因就是，这个过滤器的功能是推迟清理值栈中的值，以便在web层中进行访问，

20、另外就是为了配合SiteMesh装饰器进行工作（官方中的说明）。如果不加这个，那么Struts2的默认过滤器就会清空值栈中的值，这样就会导致异常。所以说这类的名字和功能完全不搭边，很容易让人产生误解。在2.1.6版本里面，已经用这个过滤器取代了以前的FilterDispatcher，而且在api文档中已经标注为deprecated（不赞成），并说明是从Struts 2.1.3版开始就弃用这个过滤器了，改用StrutsPrepareAndExecuteFilter，除此之外，还可以选择StrutsPrepareFilter和StrutsExecuteFilter。不过大象建议大家还是选择Stru

21、tsPrepareAndExecuteFilter吧，这也是官方推荐的。web.xml里面的几个重要的配置就这些，不过不要忘了，给这些filter加上filter-mapping映射。还有一点，请注意这些过滤器的顺序，这个顺序是很重要的，程序运行时，是根据这些filter-mapping的排列顺序依次执行过滤操作的。如果不想出现莫名其妙的错误，请控制好这些过滤器映射的顺序。我会在最后一章附上源码，大家就这样慢慢看吧。看到最后一章的时候，可能这些相关的知识就比较清楚了。到时再对照源码练习下，应该会有一些收获。恩，这部分就到此结束了，我们下次继续。2010-12-07Struts2.1.6+Spr

22、ing2.5.6+Hibernate3.3.1全注解实例详解（三）(转载大象)文章分类:Java编程 在前两章我为大家详细分析了JAR包的选择和必须的配置文件，那么这一章，我就对例子的层次结构进行说明，并实现除WEB层的功能代码。第三部分：建立框架代码工程结构大家可以看到，本例一共分为：dao、entity、service、web四层。另外在这些层次下，还以业务功能再进行分包，这样做是为了方便在以后的功能扩展中，能更好的管理和维护代码。如果将所有类都直接集中在这4个包下面，随着类的增加，会越来越难以维护，而且查找起来也很费劲。HibernateDao在本例中，我是通过继承Spring提供的Hi

23、bernateDaoSupport来实现持久层的基类。同时引入泛型参数，封装了一些基本操作方法。这是HibernateDao的部分代码，引入的这个泛型参数，其实就是实体类（User、Role）。通过传递这个实体类，在构造方法中利用反射特性将它从JVM中取出来。这里的getClass()方法是获得继承HibernateDao的类（UserDao、RoleDao）getGenericSuperclass()方法就是通过这些继承了HibernateDao的类，来得到父类（父类就是HibernateDao）的泛型。注意这个方法的返回值为Type，这是一个类型接口。请参考API。因为在继承Hiberna

24、teDao 的时候，会给它加一个泛型参数。比如，User、Role实体类。因此超类是参数化类型，所以返回的 Type 对象包含所使用的实际类型参数。这里返回的Type对象是ParameterizedType接口的实现类ParameterizedTypeImpl，所以要将返回类型转型为ParameterizedType。getActualTypeArguments()方法是ParameterizedType接口中的，它的作用就是获得实际类型参数 Type 对象的数组，因为我们这里只定义了一个泛型参数，数组里面也只有一个值，所以需要在数组下标处填0。然后最后一步转型千万别忘记了，因为这个方法返回的

25、可是一个Type数组喔。如果对于这部分的说明还有点不理解的话，请到时候有了代码，设个断点跟踪一下，就会全部清楚了。关于java反射，它已经超出本文的范围。大象只对本例中用到的部分进行讲解。使用这种写法，是方便我们进行类型转换与类型检查。另外还可以简化某些方法的写法。比如：createCriteria(Criterion. criterions)这个方法。参数是Criterion类型的可变参数，它是用来设置查询条件。如果要进行对象化查询，那么最简单的写法就可以直接写成createCriteria()。另外还有重载的方法，可以根据传入class类型来创建自定义查询。dao持久层的Dao类是根据实体

26、类定义，一般是一个实体类就会有一个对应的Dao类。当然这要跟业务需求来设计，不是绝对的。另外你也可以为了简便而去掉dao层，将持久化操作与业务逻辑全部写在service层。这些定义的方法是供service层调用，在业务层，将不会看到一行与持久层有关的代码，降低藕合性是这样做的目的。Repository注解的作用就是标注这个UserDao是一个持久层组件。还记得前一章讲到的扫描器吗？component-scan 它就是用来将标有Repository，Service这样的注解类扫描到Spring的容器里，并且同时对标有Autowired注解的Bean启用了自动注入功能。这就是Spring从2.5开

27、始提供的新特性。我们使用注解的方法，就可以告别那繁琐的配置文件定义。entity关于实体的定义就是使用JPA注解，关于这部分，我以前写过一篇文章专门讲这个，如果有不清楚的朋友可以先参考一下。学习JPAHibernate Annotation使用实例本例中，我有两点要讲下。第一、管理主键的表generator_table去掉原来单独定义的那个ID主键，把g_key设为主键，整个表将只有两个字段，g_key和g_value。第二、在User实体中，我将角色ID（role_id）与角色实体（Role）做了一个多对一关联。这一点是原来文章中没有讲过的。请一定注意role_id是user表的字段。我在本

28、例中设定的是一个角色可以对应多个人员，所以这个role_id存的就是role表id的值。fetch = FetchType.LAZY指定采用延迟检索，如果当你取得了User对象，但又不想取Role中的信息，这时，User对象中的role属性是代理状态。Role对象中的值都是空的。只有当你使用role.id或role.name进行取值的时候，hibernate才会去数据库中查找对应的记录，因此在一定程度上降低了资源消耗。不过这里有点要注意，采用延迟检索的时候，需要加上前一篇讲到的OpenSessionInViewFilter过滤器。否则会遇到session关闭的异常。serviceService

29、表示这是业务层组件。在业务层需要对UserDao加上Autowired注解，大象在这里将业务层的方法名与持久层的方法名定义为一样的，是我的一种习惯，大家可以按自己的想法来做。测试既然有了这么多代码，那就来测试一下吧，看看有没有问题。好吧，为了照顾那些坚定的JUnit拥护者，再写一个JUnit测试。本例使用junit-4.4.jarBeforeClass注解的方法表示在类实例化之前，也就是在类的构造方法执行之前就会执行。而且使用这个注解的方法必须是static voidTest标明这是测试方法，方法名不用像以前那样必须按照规则进行命名，可以自由定义。上图显示大象使用JUnit方式测试也通过了（如

30、果不会通过我写它干嘛？嘿嘿）。假如我将张三改成张四，再来看看测试结果。这个截图可以很明显的说明所有东西。这一篇是给大家讲怎么用代码来实现除web层之外的全注解步骤。当然，我主要是讲思路，其实思路比代码重要得多。这一个系列的最后，我会放上所有源码供大家下载。现在这样慢慢分析，是想给大家讲道理。我们应该努力提升自己的境界与层次，而不要只把眼光放在代码上面。下一章将会着重介绍web层，以及struts2的注解插件struts2-convention。那么，我们下次继续。2010-12-07Struts2.1.6+Spring2.5.6+Hibernate3.3.1全注解实例详解（四）(转载大象)文章分类:Java编程 这一章，大象将详细分析web层代码，以及struts2的注解插件struts2-convention的用法和其它相关知识。第四部分：透析控制层上一章对dao、entity、service三层