HibernateSpring多数据库解决方案.doc

Hibernate+Spring多数据库解决方案我以前在项目中的探索和实践，写出来与大家分享。 大家有其他好的方式，也欢迎分享。 环境：JDK 1.4.x , Hibernate 3.1, Spring 2.0.6, JBOSS4.0, 开发模式: Service + DAO 我们项目中需要同时使用多个数据库. 但 Hibernate 不能直接支持，为此我们对比了网上网友的方案，自己做了一点探索。 1. Demo需求 我们的项目使用一个全省的公共库加十多个地市库的架构。 本文主要说明原理，将需求简化为两库模型。 主库：User管里，主要是系统管理，鉴权等数据； 订单库：Order 管理，存放订单等业务性数据。 2. 原理： 1） Hibernate 的每个配置文件对应一个数据库，因此多库需要做多个配置文件。本文以两个为例： 主库 hibernate_sys.cfg.xml， 订单库 hibernate_order.cfg.xml 每个库，Hibernate 对应一个 sessionFactory 实例，因此Hibernate下的多库处理，就是在多个 sessionFactory 之间做好路由。 2) sessionFactory 有个 sessionFactory.getClassMetadata(voClass) 方法，返回值不为空时，表示该 VO 类在该库中 (hbm.xml文件配置在了对应的hibernate.cfg.xml中)， 该方法是数据路由的核心和关键所在。 因此， User.hbm.xml 配置在 hibernate_sys.cfg.xml ， Order数据位于配置到 hibernate_order.cfg.xml 3） 多库处理时，需要使用 XA 事务管理。本例中使用 Jboss4.0 来做JTA事务管理；用JOTM，其他应用服务器原理相同。 3. 实现 1） 为做多 sessionFactory 实例的管理，设计 SessionFactoryManager 类，功能就是做数据路由， 控制路由的核心是 sessionFactoryMap 属性，它按 dbFlag=sessionFactory 的方式存储了多个库的 引用。 判断路由要使用的核心方法就是 public Session getSessionFactory(Class voClass) ，它根据传入的 voClass，返回对应sessionFactory 的 当前 session。 SessionFactoryManager 类的详细实现原理以后为大家说明。 2） Hibernate配置 主库 hibernate_sys.cfg.xml Xml代码 1. 2. 3. XAOracleDS_MAIN 4. hibernate1 5. org.hibernate.transaction.JTATransactionFactory 6. org.hibernate.transaction.JBossTransactionManagerLookup 7. UserTransaction 8. 9. org.hibernate.dialect.OracleDialect 10. 5 11. 5 12. 1 13. 14. 15. XAOracleDS_MAIN hibernate1 org.hibernate.transaction.JTATransactionFactory org.hibernate.transaction.JBossTransactionManagerLookup UserTransaction org.hibernate.dialect.OracleDialect 5 5 1 订单库 hibernate_order.cfg.xml Xml代码 1. 2. 3. XAOracleDS_ORDER 4. hibernate2 5. org.hibernate.transaction.JTATransactionFactory 6. org.hibernate.transaction.JBossTransactionManagerLookup 7. UserTransaction 8. 9. org.hibernate.dialect.OracleDialect 10. 5 11. 5 12. 1 13. 14. 15. XAOracleDS_ORDER hibernate2 org.hibernate.transaction.JTATransactionFactory org.hibernate.transaction.JBossTransactionManagerLookup UserTransaction org.hibernate.dialect.OracleDialect 5 5 1 3) Spring配置 applicationContext.xml 使用Spring提供的 org.springframework.orm.hibernate3.LocalSessionFactoryBean 类，为每个库配置一个sessionFactory bean： Xml代码 1. 2. 3. 4. 5. classpath:hibernate_sys.cfg.xml 6. 7. 8. 9. 10. 11. 12. 13. 14. classpath:hibernate_order.cfg.xml 15. 16. 17. classpath:hibernate_sys.cfg.xml classpath:hibernate_order.cfg.xml 配置 SessionFactoryManager 来管理多个 sessionFactory Xml代码 1. 2. 3. 4. 5. 6. 7. 8. 9. 4） 事务控制，使用Spring的 JtaTransactionManager 类来控制，但要为其注入JBboss启动后的 JTA事务管理器的名字 java:comp/UserTransaction； 使用Spring的自动代理功能为 业务类 *Service 进行拦截，控制事务边界。 Xml代码 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. PROPAGATION_REQUIRED 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. *Service 22. 23. 24. 25. 26. trasactionMethodPointcutAdvisor 27. 28. 29. 30. 31. PROPAGATION_REQUIRED *Service trasactionMethodPointcutAdvisor 5） 配置 XA 数据源，在 jboss 4 的 server/default/deploy 目录下添加 oracle-xa-ds.xml 文件，在其中配置数据源， Xml代码 1. 2. XAOracleDS_MAIN 3. 4. false 5. false 6. oracle.jdbc.xa.client.OracleXADataSource 7. jdbc:oracle:thin:192.168.0.25:1521:DB_SYS 8. admin 9. admin 10. 11. org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionChecker 12. 13. org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter 14. 15. 16. 17. Oracle9i 18. 19. XAOracleDS_MAIN false false oracle.jdbc.xa.client.OracleXADataSource jdbc:oracle:thin:192.168.0.25:1521:DB_SYS admin admin org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionChecker org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter Oracle9i 这里是 XAOracleDS_MAIN 的配置，XAOracleDS_ORDER 的配置修改下 IP，user，password就可以了。 6） 关键代码 最关键的一步，就是以往 dao.setSessionFactory( sessionFactory ) 注入，要改为由 SessionFactoryManager 来注入，否则dao无法关联到正确的库，也无法操作数据。 我们项目中采用动态 Service，DAO 创建，也就是零配置，是在 DAOFactory 中进行的注入，在 DAOFactory.createDAO(daoClass)方法中，源代码贴出来，帮助理解： Java代码 1. publicclassDAOFactory 2. /* 3. *创建DAO类 4. *paramdaoClass 5. *return 6. *throwsException 7. */ 8. publicstaticBaseDAOcreateDAO(ClassdaoClass)throwsException 9. SessionFactoryManagersessionFactoryManager=(SessionFactoryManager)BeanFactory.getBean(SessionFactoryManager.class); 10. BaseDAOdao=null; 11. try 12. dao=(BaseDAO)BeanFactory.createBean(daoClass); 13. catch(Exceptione) 14. throwe; 15. 16. SessionFactorysf=sessionFactoryManager.getSessionFactory(dao.getVoClass(); 17. dao.setSessionFactory(sf);/注入sessionFactory 18. returndao; 19. 20. public class DAOFactory /* * 创建DAO类 * param daoClass * return * throws Exception */ public static BaseDAO createDAO(Class daoClass) throws Exception SessionFactoryManager sessionFactoryManager = (SessionFactoryManager) BeanFactory.getBean(SessionFactoryManager.class); BaseDAO dao = null; try dao = (BaseDAO) BeanFactory.createBean(daoClass); catc