spring4使用时发生的错误

年初两个版本刚刚发布，还处于“血淋淋”的边缘，花了两天时间把所做的基于sh的一个框架进行升级，其过程有些纠结，写在这里做一备忘。

为什么要升级？升级的理由一个是hibernate4支持multi-tenant多租户模式，对于提供saas应用的项目来说，有这个与没这个有很大不同，尽管我已经在一个项目中实现了多租户模式，跟hibernate要做的第二种模式类似；另一个理由就是spring支持servlet3.0，并且对提供cache api，速度当然是主要考虑点。

没想到遇到很多问题，按网络流行语说是有点“蛋疼”。

幸亏框架是用maven进行管理，升级版本过程比较顺利，主要改写pom中的依赖：
hibernate pom dependency:

Xml代码  

1. <dependency>  
2.         <groupId>org.hibernate</groupId>  
3.         <artifactId>hibernate-entitymanager</artifactId>  
4.         <version>4.1.1.Final</version>  
5. </dependency>  

spring pom dependency:

Xml代码  

1.               <properties>  
2.      <spring.version>3.1.1.RELEASE</spring.version>  
3.        </properties>  
4.               ....  
5.               <dependency>  
6.     <groupId>org.springframework</groupId>  
7.     <artifactId>spring-core</artifactId>  
8.     <version>${spring.version}</version>  
9. </dependency>  
10.   
11. <dependency>  
12.     <groupId>org.springframework</groupId>  
13.     <artifactId>spring-expression</artifactId>  
14.     <version>${spring.version}</version>  
15. </dependency>  
16.   
17. <dependency>  
18.     <groupId>org.springframework</groupId>  
19.     <artifactId>spring-beans</artifactId>  
20.     <version>${spring.version}</version>  
21. </dependency>  
22.   
23. <dependency>  
24.     <groupId>org.springframework</groupId>  
25.     <artifactId>spring-context</artifactId>  
26.     <version>${spring.version}</version>  
27. </dependency>  
28.   
29. <dependency>  
30.     <groupId>org.springframework</groupId>  
31.     <artifactId>spring-context-support</artifactId>  
32.     <version>${spring.version}</version>  
33. </dependency>  
34.   
35. <dependency>  
36.     <groupId>org.springframework</groupId>  
37.     <artifactId>spring-orm</artifactId>  
38.     <version>${spring.version}</version>  
39. </dependency>  
40.   
41. <dependency>  
42.     <groupId>org.springframework</groupId>  
43.     <artifactId>spring-oxm</artifactId>  
44.     <version>${spring.version}</version>  
45. </dependency>  
46.   
47. <dependency>  
48.     <groupId>org.springframework</groupId>  
49.     <artifactId>spring-aop</artifactId>  
50.     <version>${spring.version}</version>  
51. </dependency>  
52.   
53. <dependency>  
54.     <groupId>org.springframework</groupId>  
55.     <artifactId>spring-jdbc</artifactId>  
56.     <version>${spring.version}</version>  
57. </dependency>  
58.   
59. <dependency>  
60.     <groupId>org.springframework</groupId>  
61.     <artifactId>spring-webmvc</artifactId>  
62.     <version>${spring.version}</version>  
63. </dependency>  
64.   
65. <dependency>  
66.     <groupId>org.springframework</groupId>  
67.     <artifactId>spring-web</artifactId>  
68.     <version>${spring.version}</version>  
69. </dependency>  
70.   
71. <dependency>  
72.     <groupId>org.springframework</groupId>  
73.     <artifactId>spring-test</artifactId>  
74.     <version>${spring.version}</version>  
75. </dependency>  

注意maven2的repository还没有最新版本，需要配置：

Xml代码  

1. <repository>  
2.       <id>springsource-repo</id>  
3.       <name>springsource repository</name>  
4.       <url>http://repo.springsource.org/release</url>  
5. </repository>  
6.   
7. <repository>  
8.         <id>repository.jboss.org-public</id>  
9.         <name>JBoss repository</name>  
10.         <url>https://repository.jboss.org/nexus/content/groups/public</url>  
11.  </repository>  

由于spring3.1.1基于servlet3.0，因此需要将原先2.5的接口进行版本指定：

Xml代码  

1. <dependency>  
2.         <groupId>javax.servlet</groupId>  
3.         <artifactId>javax.servlet-api</artifactId>  
4.         <version>3.0.1</version>  
5.         <scope>provided</scope>  
6. </dependency>  

spring3.1.1为了支持hibernate4，相关部分做了很大改动，除了一步步排错，别无他法，而且这些错误会因项目不同而异，即case by case根据项目实情来改。这里将常见的几个错误以及解决办法罗列如下：

错误1：java.lang.NoClassDefFoundError: org/hibernate/cache/CacheProvider
原因：spring的sessionfactory和transactionmanager与支持hibernate3时不同。
解决：

Xml代码  

1. <bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">  
2.     <property name="dataSource" ref="dataSource"/>  
3.     ...  
4. </bean>  
5.   
6.   
7. <bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager">  
8.     <property name="sessionFactory" ref="sessionFactory"/>  
9. </bean>  

错误2：java.lang.NoSuchMethodError: org.hibernate.SessionFactory.openSession()Lorg/hibernate/classic/Session
原因：hibernate4之后，spring31把HibernateDaoSupport去除，包括数据访问都不需要hibernatetemplate，这意味着dao需要改写，直接使用hibernate的session和query接口。
解决：为了改写dao，足足花了一天时间，然后一个个接口进行单元测试，这是蛋疼的一个主要原因。

错误3：nested exception is org.hibernate.HibernateException: No Session found for current thread
原因：发现一些bean无法获得当前session，需要把之前一些方法的事务从NOT_SUPPORT提升到required,readonly=true
见https://jira.springsource.org/browse/SPR-9020
http://www.iteye.com/topic/1120924
解决：

Xml代码  

1. <tx:advice id="baseServiceAdvice" transaction-manager="transactionManager">  
2.         <tx:attributes>  
3.             <tx:method name="get*" read-only="true" propagation="REQUIRED"/><!--之前是NOT_SUPPORT-->  
4.             <tx:method name="find*" read-only="true" propagation="REQUIRED"/><!--之前是NOT_SUPPORT-->  
5.             <tx:method name="save*" propagation="REQUIRED"/>  
6.             <tx:method name="update*" propagation="REQUIRED"/>  
7.             <tx:method name="remove*" propagation="REQUIRED"/>  
8.             <tx:method name="add*" propagation="REQUIRED"/>  
9.             <!--默认其他方法都是REQUIRED-->  
10.             <tx:method name="*"/>  
11.         </tx:attributes>  
12.     </tx:advice>  

错误4:与错误3报错类似，java.lang.NoSuchMethodError: org.hibernate.SessionFactory.openSession()Lorg/hibe
rnate/classic/Session;
        at org.springframework.orm.hibernate3.SessionFactoryUtils.doGetSession(S
essionFactoryUtils.java:324) [spring-orm-3.1.1.RELEASE.jar:3.1.1.RELEASE]
        at org.springframework.orm.hibernate3.SessionFactoryUtils.getSession(Ses
sionFactoryUtils.java:202) [spring-orm-3.1.1.RELEASE.jar:3.1.1.RELEASE]
        at org.springframework.orm.hibernate3.support.OpenSessionInViewFilter

原因：因为opensessioninview filter的问题，如果你的配置还是hibernate3，需要改为hibernate4

Xml代码  

1. <filter>  
2.   <filter-name>openSessionInViewFilter</filter-name>  
3.   <filter-class>org.springframework.orm.hibernate4.support.OpenSessionInViewFilter</filter-class>  
4. </filter>  

以上这些错误仅仅是将原有代码部署发现的，当然，随着继续深入，可能会有更多问题暴露出来，包括代码需要调整，新feature要使用，任重而道远。