springboot+ibatis 多数据源配置

最新推荐文章于 2024-08-21 11:28:18 发布

贰玖玖0zero

最新推荐文章于 2024-08-21 11:28:18 发布

阅读量8.8k

点赞数 5

分类专栏：工作笔记文章标签： java spring boot ibatis 多数据源

本文链接：https://blog.csdn.net/crqnyf/article/details/80691640

版权

工作笔记专栏收录该内容

4 篇文章 0 订阅

订阅专栏

废话少说吧，直接进入主题，首先新建一个maven项目，pom.xml引入基本的jar包

这个是boot基本版本包，因为我用的打包方式是war所以去除掉了boot内置的tomcat，但是为了方便测试又引入了内置tomcat，只要添加<scope>provided</scope>在打包时就不会影响了。

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.5.6.RELEASE</version>
    <relativePath /> 
</parent>

 <dependency>
        <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-web</artifactId>
    <!--   打包的时候以war包形式，这里要把springboot集成的tomcat去除 -->
              <exclusions>
                   <exclusion>
                        <groupId>org.springframework.boot</groupId>
                        <artifactId>spring-boot-starter-tomcat</artifactId>
                   </exclusion>
                   <exclusion>
                    <groupId>ch.qos.logback</groupId>
                   <artifactId>logback-classic</artifactId>
                </exclusion>
              </exclusions>
    </dependency>

 <!--因配置外部TOMCAT 而配置 测试使用的tomcat-->
	<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>
 <dependency>
		  <groupId>org.apache.tomcat</groupId>
		  <artifactId>tomcat-servlet-api</artifactId>
		  <version>8.0.39</version>
		  <scope>provided</scope>
    </dependency>

  <!-- 热部署 -->
	<dependency>
	    <groupId>org.springframework.boot</groupId>
	    <artifactId>spring-boot-devtools</artifactId>
	    <optional>true</optional>
	    <scope>true</scope>
	</dependency>

下面是引入ibatis的jar包

<dependency>  
		    <groupId>org.apache.ibatis</groupId>  
		    <artifactId>ibatis-sqlmap</artifactId>  
		    <version>2.3.0</version>  
		</dependency>

引入成功之后，我们首先了解一下ibatis的工作原理，ibatis的工程配置文件有两种，本宝以前都是用springmvc配置的，没用过boot，但是原理都是类似的，首先是总配置文件sqmapConfig.xml，第二个是具体的sql映射文件。

首先这个文件要建立在项目工程的那个位置，我想大部分新手都是想知道的，直接上图。就放在src/main/resources根目录下。

可以看到图中有两个sqlmap-**.xml文件，其中代表两个不同数据库的ibatis的sqlmapConfig配置文件。

这个文件里面的内容给大家介绍一下，代码中的properties标签内application-dev.properties是boot提供的application.properties配置文件再进行的引用，可分为test测试环境，prod生产环境以及dev线上环境，根据自己情况切换。其中配置文件中的${spring.datasource.driver-class-name}引用的就是application-dev.properties中的spring.datasource.driver-class-name，其他属性值类推。下图是ibatis连接数据库1的sqlmapConfig配置文件。也就是上图中的sqlmap-web.xml。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMapConfig
        PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"
        "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">
<sqlMapConfig>
	<properties resource="application-dev.properties" />
	<settings lazyLoadingEnabled="true" cacheModelsEnabled="true"
		enhancementEnabled="false" useStatementNamespaces="true" />
	
	<!-- 连接数据源 -->
	<transactionManager type="JDBC">
	<dataSource  type ="SIMPLE" >
		<property  name ="JDBC.Driver"  value ="${spring.datasource.driver-class-name}" />  
		<property  name ="JDBC.ConnectionURL"  value ="${spring.datasource.url}" />
		<property  name ="JDBC.Username"  value ="${spring.datasource.username}" />
		<property  name ="JDBC.Password"  value ="${spring.datasource.password}" /> 
		<property  name ="Pool.MaximumActiveConnections"  value ="10"   />    
		<property  name ="Pool.MaximumIdleConnections"  value ="5" />  <!-- 连接池允许挂起的最大连接 -->  
		<property  name ="Pool.MaximumCheckoutTime"  value ="120000" /> <!-- 连接被某个任务所允许占用的最大时间 -->  
		<property  name ="TimeToWait"  value ="500" /> <!-- 线程允许等待的最大时间 -->  
	</dataSource>
	</transactionManager>
	<sqlMap resource="com/*/web/order/dao/*.xml" /><!-- 自己的映射文件路径 -->
	
</sqlMapConfig>

这是application.properties和application-dev.properties的具体配置

#spring.profiles.active=test
spring.profiles.active=dev
server.port=8081
server.session.timeout=1800
server.tomcat.uri-encoding=UTF-8
server.context-path=/order_sht
spring.http.encoding.charset=UTF-8
spring.http.encoding.force=true
spring.http.encoding.enabled=true

#数据库1
spring.datasource.url=jdbc:mysql://localhost:3306/数据库实例名称?useUnicode=true&characterEncoding=utf-8 #主数据库的连接
spring.datasource.username=root
spring.datasource.password=toot
spring.datasource.driver-class-name=com.mysql.jdbc.Driver



#数据库2
spring.center.url=jdbc:oracle:thin:@192.168.0.222:1521:orcl
spring.center.username=root
spring.center.password=root
spring.center.driver-class-name=oracle.jdbc.driver.OracleDrivers

数据库2 对应的sqlmap-center.xml代码如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMapConfig
        PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"
        "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">
<sqlMapConfig>
	<properties resource="application-dev.properties" />
	<settings lazyLoadingEnabled="true" cacheModelsEnabled="true"
		enhancementEnabled="false" useStatementNamespaces="true" />
	
	<transactionManager type="JDBC">
	<dataSource  type ="SIMPLE" >
		<property  name ="JDBC.Driver"  value ="${spring.center.driver-class-name}" />  
		<property  name ="JDBC.ConnectionURL"  value ="${spring.center.url}" />
		<property  name ="JDBC.Username"  value ="${spring.center.username}" />
		<property  name ="JDBC.Password"  value ="${spring.center.password}" /> 
		<property  name ="Pool.MaximumActiveConnections"  value ="10"   />    
		<property  name ="Pool.MaximumIdleConnections"  value ="5" />  <!-- 连接池允许挂起的最大连接 -->  
		<property  name ="Pool.MaximumCheckoutTime"  value ="120000" /> <!-- 连接被某个任务所允许占用的最大时间 -->  
		<property  name ="TimeToWait"  value ="500" /> <!-- 线程允许等待的最大时间 -->  
	</dataSource>
	</transactionManager>
	<sqlMap resource="com/web/order/dao/*.xml" /></sqlMapConfig><!-- 自己的映射文件路径 -->

配置好这些文件之后就能使用ibatis连接上不同数据库了，可是boot怎么获取到sqlmapclient呢？重点来了，敲黑板！

要是在springmvc里面要有一个配置文件，springboot推荐使用@Configuration注解，代码如下：使用Resources获取到xml，并解析。然后使用SqlMapClientBuilder的buildSqlMapClient方法就能得到对应的SqlMapClient。

import java.io.Reader;

import org.springframework.context.annotation.Configuration;

import com.ibatis.common.resources.Resources;
import com.ibatis.sqlmap.client.SqlMapClient;
import com.ibatis.sqlmap.client.SqlMapClientBuilder;
/**
 * ibatis多数据源配置 获取sqlmapclient
 * @author crq
 *
 */
@Configuration
public class BaseDao extends SqlMapClientBuilder{
	
	 private static final SqlMapClient sqlMap;
	 private static final SqlMapClient sqlMapCenter;
	    //在静态区块中初试化返回

	    static {

	        try {

	            //声明配置文件的名称（映射文件被定义在其中）

	            String resource = "sqlmap-web.xml";
	            String resource_center = "sqlmap-center.xml";
	            int a = 0 ;
	            //利用工具类Resources来读取到配置文件

	            Reader reader = Resources.getResourceAsReader(resource);
	            Reader reader_center = Resources.getResourceAsReader(resource_center);
	   /**      // 第3步、进行读操作
	                   char c[] = new char[1024] ;        // 所有的内容都读到此数组之中
	                     int temp = 0 ;    // 接收每一个内容
	                     int len = 0 ;        // 读取内容
	                    while((temp=reader.read())!=-1){
	                         // 如果不是-1就表示还有内容，可以继续读取
	                         c[len] = (char)temp ;
	                         len++ ;
	                    }
	                     // 第4步、关闭输出流
	                    reader.close() ;                        // 关闭输出流
	                    // 把字符数组变为字符串输出
	                    System.out.println("内容为：" + new String(c,0,len)) ;    */
	            //创建SqlMapClient接口的变量实例
	            
	            sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);
	            sqlMapCenter = SqlMapClientBuilder.buildSqlMapClient(reader_center);

	        } catch (Exception e) {

	            e.printStackTrace();

	            throw new RuntimeException(

	                    "加载sqlmap-*文件出错(load sqlmap-* file wrong). Cause: " + e);

	        }

	    }

	    public static SqlMapClient getSqlMapInstance() {

	        //提供静态方法返回静态区块中得到的SqlMapClient
	          
	       return sqlMap;
	       // return null;

	    }
	public static SqlMapClient getSqlMapCenterInstance() {
		
		//提供静态方法返回静态区块中得到的SqlMapClient
		return sqlMapCenter;
		// return null;
		
	}
}

接下来就要用这个sqlmapclient了，怎么用？老鸟们肯定知道getSqlMapInstance()这个方法不就是获取数据库1的sqlmapClient嘛！对了就是这个方法，只要在dao层继承这个baseDao，就能使用了。代码如下：


import java.sql.SQLException;
import java.util.List;
import java.util.Map;


import org.springframework.stereotype.Repository;


import com.web.comm.dao.BaseDao;


@Repository
public class OrderDao extends BaseDao{


	public List<Map> getOrderList() throws SQLException {
		return getSqlMapInstance().queryForList("order.getOrderList");
	}
	public List<Map> getOrderListFromCenter() throws SQLException {
		return getSqlMapCenterInstance().queryForList("order.getOrderListFromCenter");
	}


}

可是在开发过程中，我发现每一个方法都throws一个SQLException，这代码看起来太丑了，我记得以前都是使用sqlMapTemplate这个对象来进行操作的，我翻阅文档发现这个SqlMapTemplate是对sqlmapClient的包装，反正更高级，也不用抛异常，我就用呗，咋用啊，我先看需要引入什么jar包，源码中地址是这个org.springframework.orm.ibatis.SqlMapClientTemplate，那肯定是org.springframework.orm-3.1.2.RELEASE.jar包了，版本最好用兼容你自己代码的，只要把这个jar包放到maven就行，本地jar加入maven仓库了解一下，网上很多，我就不赘述了。加入之后发现项目开始报错，翻源码发现这个类还引用的jdbc的类，还得加jar包，jar包名字是org.springframework.jdbc-3.1.2.RELEASE.jar，加上之后就不会报错了。

import org.springframework.jdbc.CannotGetJdbcConnectionException;
import org.springframework.jdbc.JdbcUpdateAffectedIncorrectNumberOfRowsException;
import org.springframework.jdbc.datasource.DataSourceUtils;
import org.springframework.jdbc.datasource.TransactionAwareDataSourceProxy;
import org.springframework.jdbc.support.JdbcAccessor;
import org.springframework.jdbc.support.SQLExceptionTranslator;
import org.springframework.util.Assert;

我又编写了一个类，BaseDaoImp 继承 BaseDao，然后注入Bean获取两个数据源对应的SqlMapClientTemplate对象。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.orm.ibatis.SqlMapClientTemplate;
/**
 * ibatis 没有封装的sqlmapclient类，本类是获取sqlmapclient的封装对象SqlMapClientTemplate
 * @author gong
 *
 */
@Configuration
public class BaseDaoImp extends BaseDao{

	/**
	 * 获取数据源的sqlmapTemplate
	 * @return
	 */
	 @Bean
	  public SqlMapClientTemplate getSqlMapTemplate(){
		 SqlMapClientTemplate sqlMapTemplate = new SqlMapClientTemplate();
		    	//提供静态方法返回静态区块中得到的SqlMapClient
		    	sqlMapTemplate.setSqlMapClient(getSqlMapInstance());
		    	
		    	return sqlMapTemplate;
		    	// return null;
		    	
		    }
	 /**
	  * 获取中心 数据源的sqlmapTemplate
	  * @return
	  */
	 @Bean
	 public SqlMapClientTemplate getSqlMapCenterTemplate(){
		 SqlMapClientTemplate sqlMapTemplate = new SqlMapClientTemplate();
		 //提供静态方法返回静态区块中得到的SqlMapClient
		 sqlMapTemplate.setSqlMapClient(getSqlMapCenterInstance());
		 
		 return sqlMapTemplate;
		 // return null;
		 
	 }


}

只要业务层的dao.java继承BaseDaoImp ，即可使用getSqlMapTemplate()来操作数据库1了。

import java.sql.SQLException;
import java.util.List;

import org.springframework.stereotype.Repository;

import com.web.comm.model.UserBean;

@Repository
public class UserDao extends BaseDaoImp{

	public UserBean queryUserByUsername(String username) {
		return ((UserBean) getSqlMapTemplate().queryForObject(
				"user.queryUserByUserName", username));
	}
        //之前要抛异常的写法，代码看起来真难受
	/**public  UserBean queryUserById(String userId) {
		UserBean u = null;
		try {
		 	u = ((UserBean) getSqlMapInstance().queryForObject(
					"user.queryUserById", userId));
		} catch (SQLException e) {
			e.printStackTrace();
		}
		return u;
	}*/

	public List<String> queryRoleFunctionIdByRoleId(String roleId){
		return getSqlMapTemplate().queryForList(
				"user.queryRoleFunctionIdByRoleId", roleId);
	}

}

至此就算是完整的springboot+ibatis+多数据源配置了，网上全是springboot+mybatis的教程，确实boot整合了mybatis配置起来很简单，但是很多时候开发习惯了ibatis，我找半天没找到springboot整合ibatis的教程，就自己摸索配置了，并且配置了多数据源，希望能帮到有缘人吧。要是有更简单的配置方法，欢迎讨论分享，互相学习，或者有疑问私信吧。springboot+spring security+ibatis，基本搭建完毕了，文章就不介绍spring security了，网上很多教程，按照教程来就行。