Spring 支持大多数流行的 ORM 框架, 包括 Hibernate JDO, TopLink, Ibatis 和 JPA。
Spring 对这些 ORM 框架的支持是一致的, 因此可以把和 Hibernate 整合技术应用到其他 ORM 框架上。
对于 Hibernate 而言, 必须从原生的 Hibernate API 中构建 SessionFactory。 此外, 应用程序也无法利用 Spring 提供的数据存储机制(例如: Spring 的事务管理机制)。Spring 提供了对应的工厂 Bean, 可以用单实例的形式在 IOC 容器中创建 SessionFactory 实例。
二、整合步骤
整体整合思路:用spring来加入C3P0数据源,hibernate.cfg.xml文件中的所有跟数据源相关的配置去掉,直接用spring的dataSource。hibernate.cfg.xml文件中只包含关于Hibernate数据库的一些配置信息。之后配置Spring的针对Hibernate事务管理器和其他等。
1、配置Hibernate的XML文件:applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- 配置 hibernate 的基本属性 --> <!-- 1. 数据源配置到Spring IOC 容器中, 所以在此处不再需要配置数据源 --> <!-- 2. 关联的 .hbm.xml 也在Spring IOC 容器配置 SessionFactory 实例时在进行配置 --> <!-- 3. 配置 hibernate 的基本属性: 方言, SQL 显示及格式化, 生成数据表的策略以及二级缓存等. --> <property name="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property> <property name="hibernate.show_sql">true</property> <property name="hibernate.format_sql">true</property> <property name="hibernate.hbm2ddl.auto">update</property> <!-- 配置 hibernate 二级缓存相关的属性. --> </session-factory> </hibernate-configuration>
2、配置数据源相关:db.properties
#----------------------------------------------------- # 数据库配置 #----------------------------------------------------- #服务器地址 host=127.0.0.1 jdbc.driverClassName=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://${host}:3306/hibernate_test jdbc.username=root jdbc.password=root #----------------------------------------------------- # 适用于c3p0的配置 #----------------------------------------------------- #----------------------------------------------------- # c3p0反空闲设置,防止8小时失效问题28800 #----------------------------------------------------- #idleConnectionTestPeriod要小于MySQL的wait_timeout jdbc.c3p0.testConnectionOnCheckout=false jdbc.c3p0.testConnectionOnCheckin=true jdbc.c3p0.idleConnectionTestPeriod=3600 #----------------------------------------------------- # c3p0连接池配置 #----------------------------------------------------- #initialPoolSize, minPoolSize, maxPoolSize define the number of Connections that will be pooled. #Please ensure that minPoolSize <= maxPoolSize. #Unreasonable values of initialPoolSize will be ignored, and minPoolSize will be used instead. jdbc.c3p0.initialPoolSize=10 jdbc.c3p0.minPoolSize=10 jdbc.c3p0.maxPoolSize=100 #maxIdleTime defines how many seconds a Connection should be permitted to go unused before being culled from the pool. jdbc.c3p0.maxIdleTime=3600
3、编写持久化类
这里采用上一篇博客(Spring中的事务管理)中的相关代码和实现功能,完成一个购买图书的事务操作。这里不做具体展现,可参看上一篇博客。
4、生成相应的Hibernate持久化映射文件
Account.hbm.xml
<?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> <hibernate-mapping> <class name="com.kang.Account" table="SH_ACCOUNT"> <id name="id" type="java.lang.Integer"> <column name="ID" /> <generator class="native" /> </id> <property name="username" type="java.lang.String"> <column name="USERNAME" /> </property> <property name="balance" type="int"> <column name="BALANCE" /> </property> </class> </hibernate-mapping>
Book.hbm.xml
<?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> <hibernate-mapping> <class name="com.kang.Book" table="SH_BOOK"> <id name="id" type="java.lang.Integer"> <column name="ID" /> <generator class="native" /> </id> <property name="bookName" type="java.lang.String"> <column name="BOOK_NAME" /> </property> <property name="isbn" type="java.lang.String"> <column name="ISBN" /> </property> <property name="price" type="int"> <column name="PRICE" /> </property> <property name="stock" type="int"> <column name="STOCK" /> </property> </class> </hibernate-mapping>
5、在Spring配置文件中引入数据源
applicationContext.xml
<!-- 配置数据源 --> <!-- 导入资源文件 --> <context:property-placeholder location="classpath:db.properties"/> <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"> <property name="user" value="${jdbc.user}"></property> <property name="password" value="${jdbc.password}"></property> <property name="driverClass" value="${jdbc.driverClass}"></property> <property name="jdbcUrl" value="${jdbc.jdbcUrl}"></property> <property name="testConnectionOnCheckout" value="${jdbc.c3p0.testConnectionOnCheckout}"></property> <property name="testConnectionOnCheckin" value="${jdbc.c3p0.testConnectionOnCheckin}"></property> <property name="idleConnectionTestPeriod" value="${jdbc.c3p0.idleConnectionTestPeriod}"></property> <property name="initialPoolSize" value="${jdbc.c3p0.initialPoolSize}"></property> <property name="maxPoolSize" value="${jdbc.c3p0.maxPoolSize}"></property> <property name="minPoolSize" value="${jdbc.c3p0.minPoolSize}"></property> <property name="maxIdleTime" value="${jdbc.c3p0.maxIdleTime}"></property> </bean>
6、在Spring配置文件中配置SessionFactory
在Spring中可以利用 LocalSessionFactoryBean 工厂 Bean, 来声明一个使用 XML 映射文件的 SessionFactory 实例。同时需要为该工厂 Bean 指定 configLocation 属性来加载 Hibernate 配置文件。
如果在 Spring IOC 容器中配置数据源,可以将该数据源注入到 LocalSessionFactoryBean 的 dataSource 属性中。该属性指定的数据源会覆盖掉 Hibernate 配置文件里的数据库配置。
applicationContext.xml
<!-- 配置 Hibernate 的 SessionFactory 实例: 通过 Spring 提供的 LocalSessionFactoryBean 进行配置 --> <bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean"> <!-- 配置数据源属性 --> <property name="dataSource" ref="dataSource"></property> <!-- 配置 hibernate 配置文件的位置及名称 --> <property name="configLocation" value="classpath:hibernate.cfg.xml"></property> <!-- 使用 hibernateProperties 属相来配置 Hibernate 原生的属性,用此可以省略Hibernate的配置文件 --> <!-- <property name="hibernateProperties"> <props> <prop key="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</prop> <prop key="hibernate.show_sql">true</prop> <prop key="hibernate.format_sql">true</prop> <prop key="hibernate.hbm2ddl.auto">update</prop> </props> </property> --> <!-- 配置 hibernate 映射文件的位置及名称, 可以使用通配符 --> <property name="mappingLocations" value="classpath:com/kang/*.hbm.xml"></property> </bean>
7、Spring的事务管理配置
同JDBC一样,Spring提供了关于Hibernate的事务管理器,同时提供了模版类,DAO类的支持。具体情况如下图:
applicationContext.xml
<!-- 配置 Spring 的声明式事务 --> <!-- 1. 配置事务管理器 --> <bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager"> <property name="sessionFactory" ref="sessionFactory"></property> </bean> <!-- 2. 配置事务属性, 需要事务管理器 --> <tx:advice id="txAdvice" transaction-manager="transactionManager"> <tx:attributes> <tx:method name="get*" read-only="true"/> <tx:method name="purchase" propagation="REQUIRES_NEW"/> <tx:method name="*"/> </tx:attributes> </tx:advice> <!-- 3. 配置事务切点, 并把切点和事务属性关联起来 --> <aop:config> <aop:pointcut expression="execution(* com.kang.*.*(..))" id="txPointcut"/> <aop:advisor advice-ref="txAdvice" pointcut-ref="txPointcut"/> </aop:config>
至此,Spring整合Hibernate的配置文件基本配置完毕,此时的applicationContext.xml内容如下:
applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx" xmlns:aop="http://www.springframework.org/schema/aop" xsi:schemaLocation="http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd"> <!-- 配置自动扫描的包 --> <context:component-scan base-package="com.kang"></context:component-scan> <!-- 配置数据源 --> <!-- 导入资源文件 --> <context:property-placeholder location="classpath:db.properties"/> <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"> <property name="user" value="${jdbc.user}"></property> <property name="password" value="${jdbc.password}"></property> <property name="driverClass" value="${jdbc.driverClass}"></property> <property name="jdbcUrl" value="${jdbc.jdbcUrl}"></property> <property name="testConnectionOnCheckout" value="${jdbc.c3p0.testConnectionOnCheckout}"></property> <property name="testConnectionOnCheckin" value="${jdbc.c3p0.testConnectionOnCheckin}"></property> <property name="idleConnectionTestPeriod" value="${jdbc.c3p0.idleConnectionTestPeriod}"></property> <property name="initialPoolSize" value="${jdbc.c3p0.initialPoolSize}"></property> <property name="maxPoolSize" value="${jdbc.c3p0.maxPoolSize}"></property> <property name="minPoolSize" value="${jdbc.c3p0.minPoolSize}"></property> <property name="maxIdleTime" value="${jdbc.c3p0.maxIdleTime}"></property> </bean> <!-- 配置 Hibernate 的 SessionFactory 实例: 通过 Spring 提供的 LocalSessionFactoryBean 进行配置 --> <bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean"> <!-- 配置数据源属性 --> <property name="dataSource" ref="dataSource"></property> <!-- 配置 hibernate 配置文件的位置及名称 --> <property name="configLocation" value="classpath:hibernate.cfg.xml"></property> <!-- 使用 hibernateProperties 属相来配置 Hibernate 原生的属性 --> <!-- <property name="hibernateProperties"> <props> <prop key="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</prop> <prop key="hibernate.show_sql">true</prop> <prop key="hibernate.format_sql">true</prop> <prop key="hibernate.hbm2ddl.auto">update</prop> </props> </property> --> <!-- 配置 hibernate 映射文件的位置及名称, 可以使用通配符 --> <property name="mappingLocations" value="classpath:com/kang/*.hbm.xml"></property> </bean> <!-- 配置 Spring 的声明式事务 --> <!-- 1. 配置事务管理器 --> <bean id="transactionManager" class="org.springframework.orm.hibernate4.HibernateTransactionManager"> <property name="sessionFactory" ref="sessionFactory"></property> </bean> <!-- 2. 配置事务属性, 需要事务管理器 --> <tx:advice id="txAdvice" transaction-manager="transactionManager"> <tx:attributes> <tx:method name="get*" read-only="true"/> <tx:method name="purchase" propagation="REQUIRES_NEW"/> <tx:method name="*"/> </tx:attributes> </tx:advice> <!-- 3. 配置事务切点, 并把切点和事务属性关联起来 --> <aop:config> <aop:pointcut expression="execution(* com.kang.*.*(..))" id="txPointcut"/> <aop:advisor advice-ref="txAdvice" pointcut-ref="txPointcut"/> </aop:config> </beans>
三、如何Spring中调用Hibernate
首先来看一下结合Hibernate后的Spring事务管理流程
1. 在方法开始之前
(1)获取 sessionFactory,这里通过配置XML文件使用Spring的依赖注入实现。
(2)获取当前线程的Session实例,通过sessionFactory.getCurrentSession()的静态方法来实现。
(3)开启事务,由事务管理器实现。
2. 若方法正常结束, 即没有出现异常, 则
(1)提交事务,由事务管理器负责。
(2)使和当前线程绑定的 Session 解除绑定。
(3)关闭 Session。
3. 若方法出现异常, 则:
(1)回滚事务。
(2)使和当前线程绑定的 Session 解除绑定。
(3)关闭 Session。
相应的代码实现:
持久化操作类:
import org.hibernate.Query; import org.hibernate.Session; import org.hibernate.SessionFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Repository; import com.kang.BookShopDao; import com.kang.BookStockException; import com.kang.UserAccountException; @Repository public class BookShopDaoImpl implements BookShopDao { @Autowired private SessionFactory sessionFactory; //获取和当前线程绑定的 Session. private Session getSession(){ return sessionFactory.getCurrentSession(); } @Override public int findBookPriceByIsbn(String isbn) { String hql = "SELECT b.price FROM Book b WHERE b.isbn = ?"; Query query = getSession().createQuery(hql).setString(0, isbn); return (Integer)query.uniqueResult(); } @Override public void updateBookStock(String isbn) { //验证书的库存是否充足. String hql2 = "SELECT b.stock FROM Book b WHERE b.isbn = ?"; int stock = (int) getSession().createQuery(hql2).setString(0, isbn).uniqueResult(); if(stock == 0){ throw new BookStockException("库存不足!"); } String hql = "UPDATE Book b SET b.stock = b.stock - 1 WHERE b.isbn = ?"; getSession().createQuery(hql).setString(0, isbn).executeUpdate(); } @Override public void updateUserAccount(String username, int price) { //验证余额是否足够 String hql2 = "SELECT a.balance FROM Account a WHERE a.username = ?"; int balance = (int) getSession().createQuery(hql2).setString(0, username).uniqueResult(); if(balance < price){ throw new UserAccountException("余额不足!"); } String hql = "UPDATE Account a SET a.balance = a.balance - ? WHERE a.username = ?"; getSession().createQuery(hql).setInteger(0, price).setString(1, username).executeUpdate(); } }
测试类:
public class SpringHibernateTest { private ApplicationContext ctx = null; private BookShopService bookShopService = null; private Cashier cashier = null; { ctx = new ClassPathXmlApplicationContext("applicationContext.xml"); bookShopService = ctx.getBean(BookShopService.class); cashier = ctx.getBean(Cashier.class); } @Test public void testCashier(){ cashier.checkout("aa", Arrays.asList("1001","1002")); } @Test public void testBookShopService(){ bookShopService.purchase("aa", "1001"); } }