spring升级到3.1.1 hibernate升级到4备忘

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

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

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

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

<dependency>
      	<groupId>org.hibernate</groupId>
      	<artifactId>hibernate-entitymanager</artifactId>
      	<version>4.1.1.Final</version>
</dependency>

spring pom dependency:

                <properties>
		     <spring.version>3.1.1.RELEASE</spring.version>
	        </properties>
                ....
                <dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-core</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-expression</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-beans</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context-support</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-orm</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-oxm</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-aop</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-jdbc</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-web</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-test</artifactId>
			<version>${spring.version}</version>
		</dependency>

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

<repository>
      <id>springsource-repo</id>
      <name>springsource repository</name>
      <url>http://repo.springsource.org/release</url>
</repository>

<repository>
      	<id>repository.jboss.org-public</id>
      	<name>JBoss repository</name>
      	<url>https://repository.jboss.org/nexus/content/groups/public</url>
 </repository>

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

<dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.0.1</version>
        <scope>provided</scope>
</dependency>

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

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

    <bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        ...
    </bean>


    <bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager">
        <property name="sessionFactory" ref="sessionFactory"/>
    </bean>

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

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

<tx:advice id="baseServiceAdvice" transaction-manager="transactionManager">
        <tx:attributes>
            <tx:method name="get*" read-only="true" propagation="REQUIRED"/><!--之前是NOT_SUPPORT-->
            <tx:method name="find*" read-only="true" propagation="REQUIRED"/><!--之前是NOT_SUPPORT-->
            <tx:method name="save*" propagation="REQUIRED"/>
            <tx:method name="update*" propagation="REQUIRED"/>
            <tx:method name="remove*" propagation="REQUIRED"/>
            <tx:method name="add*" propagation="REQUIRED"/>
            <!--默认其他方法都是REQUIRED-->
            <tx:method name="*"/>
        </tx:attributes>
    </tx:advice>

[b][color=red]错误4:与错误3报错类似，java.lang.NoSuchMethodError:[/color][/b] 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

        <filter>
          <filter-name>openSessionInViewFilter</filter-name>
          <filter-class>org.springframework.orm.hibernate4.support.OpenSessionInViewFilter</filter-class>
        </filter>

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