Mybatis 全局配置文件详解

Posted 2020-09-11

　　　　　　　　这节来说说全局配置文件的东西，非常简单。看一遍就懂了。

　　　　　　　　　　　　　　　　　　　　　　　　　　--WH

一、全部配置内容

　　　　　　SqlMapConfig.xml的配置内容和顺序如下，顺序不能乱。现在来对这些属性的意思一一进行讲解。　

　　　　　　　

　　　

二、properties

　　　　　作用：引用java属性文件中的配置信息，比如，加载连接数据库的各种属性的配置文件。　

　　　　　　　

　　　　　　　　

　　　　　　　　

　　　　　　　　　db.properties

　　　　　　　　　　

 1     <!-- 
 2             properties:引用java属性文件中的配置信息
 3         比如加载连接数据库的帐号密码等信息的properties配置文件。
 4         使用${}可以引用已经加载的java配置文件中的信息
 5         使用时注意一个问题，mybatis按照下面的顺序加载属性
 6             1、properties标签体内的属性
 7             2、properties引用的属性会被读取，本例中也就是db.properties中的属性(key-value)，
 8                 如果发现db.properties中有和第一步加载的属性的key相同的属性，那么将其覆盖
 9             3、parameterType：接收的值最后被读取，parameterType="int" int相当于key，而实际上接收到的值
10                 为value，如果parameterType的属性名与前面两步中的属性名相同，那么将其覆盖。
11         总结：加载的越快，就很有可能被覆盖，所以在properties中的key值都使用db.xxx，目的就是防止重名被覆盖
12      -->
13     <properties resource="db.properties">
14         <!-- 这里就是properties标签体内的属性
15                 比如： <property name="" value=""/>
16          -->
17     </properties>
18 //使用db.properties中的配置信息
19         <dataSource type="POOLED">
20             <!-- 引用db.properties中的信息，通过${} -->
21             <property name="driver" value="${db.driver}"/>
22             <property name="url" value="${db.url}"/>
23             <property name="username" value="${db.username}"/>
24             <property name="password" value="${db.password}"/>
25         </dataSource>

View Code

 

三、settings

　　　　　　　　<!-- setting 全局参数，比如懒加载、是否启动缓存机制-->

　　　　　　　　这个在后面讲解懒加载时会讲解到。比如设置懒加载的全局参数

　　　　　　　　

1     <!-- setting 全局参数，比如懒加载、是否启动缓存机制-->
2     <settings>
3         <!-- 打开延迟加载的开关，默认为true -->
4         <setting name="lazyLoadingEnabled" value="true"/>
5         <!-- 积极的懒加载，默认是true，设置为false时，懒加载生效 -->
6         <setting name="aggressiveLazyLoading" value="false"/>
7     </settings>
8     

View Code

 

四、typeAliases

　　　　　　　　别名，为了在映射文件中更方便的编写输入参数类型和输出结果类型，比如直接编写int，就是在这里设置。(使用推荐的)

　　　　　　　　

 1     <!-- typeAliases:别名，为了在映射文件中更方便的编写输入参数类型和输出结果类型，比如直接编写int，
 2             而不需要在编写全限定名 java.lang.Integer了。 有很多默认的别名，比如int，String，八大基本类型都是
 3             我们也可以自定义别名,
 4         com.wuhao.mybatis.domain.User   使用别名  user 代替        
 5      -->
 6      <typeAliases>
 7          <!-- 单个定义别名 -->
 8           <typeAlias type="com.wuhao.mybatis.domain.User" alias="user"/> 
 9          <!-- 批量定义别名(推荐)
10              指定批量定义别名的类包，在此包下的所有类都将可以使用别名，别名就为类名(首字母大小写都可以)
11           -->
12          <!-- <package name="com.wuhao.mybatis.domain"/> -->
13      </typeAliases>

View Code

　　　　　　　　mybatis中有很多默认的别名，也就是帮我们写好了的，比如八大基本类型，

　　　　　　　　　　　　

五、typeHandlers

　　　　　　　　类型转换器，将数据库的类型转换成java的类型，mybatis会帮我们做这个事情，我们不需要自己设置，在mybatis的jar包中，有一个

　　　　　　　　　　　　　　　　　　　　　　

　　　　　　　　其中就会将类型转换器，转换哪些java类型都会列举出来，我们去看看，用来借鉴借鉴，等用到了可以到里面查查，

　　　　　　　　　　　　　　

 

六、objectFactory

　　　　　　　　对象工厂不用管，因为到时候肯定和spring整合，都会由sprig来管理，到与spring整合的时候就会讲解到对象工厂的了。

 

七、mappers

　　　　　　　　加载映射文件，也就是我们配置的映射文件，在这里需要显示声明加载。有四种方式加载，使用推荐的那种，其他的了解

　　　　　　　　　　　　　　

　　　　　　　　使用第四种方式加载

　　　　　　　　　　　　　　

 1     <!-- 
 2         mappers:加载映射文件
 3         四种方式来加载
 4         1、<mapper resource="config/sqlmap/user.xml"/> 
 5             使用相对路径，相对于项目底下。,比如config下的sqlmap下的user.xml
 6          2、<mapper url=’’/>
 7              使用绝对路径，比如d盘下的xx，不会用这种
 8          3、<mapper class=’’/>
 9              使用mapper接口的全县定名。就不用管路径问题了，让mybatis通过全限定名自己去找映射文件
10              前提：mapper接口的名称必须与映射文件的名称相同，并且放到一个目录下，
11                  比如：UserMapper.java(接口)   UserMapper.xml(映射文件)
12          4、<package name=’’/>（推荐)
13              注册指定包下的所有映射文件
14                  <package name="com.wuhao.mapper"/>
15                  配置了com.wuhao.mapper下的所有映射文件，
16                  注意：此种方法要求mapper接口和mapper映射文件要名称相同，且放到同一个目录下
17      -->
18 <mappers>
19     <!-- <mapper resource="sqlmap/User.xml"/> -->
20     <!-- 批量加载映射文件 -->
21     <package name="com.wuhao.mapper"/>
22     <package name="com.wuhao.shuru"/>
23     <package name="com.wuhao.resultMap"/>
24     <package name="com.wuhao.onetoone"/>
25 </mappers>

View Code

 

八，总的配置文件代码　　　　　　　　

  1 <?xml version="1.0" encoding="UTF-8" ?>
  2 <!DOCTYPE configuration
  3 PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  4 "http://mybatis.org/dtd/mybatis-3-config.dtd">
  5 <configuration>
  6     <!--
  7              属性 
  8         <properties></properties>
  9              全局参数设置
 10         <settings></settings>
 11              类型别名
 12         <typeAliases></typeAliases>
 13             类型处理器
 14         <typeHandles></typeHandles>
 15             对象工厂
 16         <objectFactory></objectFactory>
 17             插件
 18         <plugins></plugins>
 19         以上属性在后边会详细讲解到，现在我们就只需要关注一下下面的配置即可
 20             如下所配置的就是使用这点东西。
 21         environments（环境信息集合）
 22             environment（单个环境信息）
 23                 transactionManager（事物）
 24                 dataSource（数据源）
 25             environment
 26         environments    
 27         mappers(映射器)
 28     -->
 29     
 30     <!-- 
 31             properties:引用java属性文件中的配置信息
 32         比如加载连接数据库的帐号密码等信息的properties配置文件。
 33         使用${}可以引用已经加载的java配置文件中的信息
 34         使用时注意一个问题，mybatis按照下面的顺序加载属性
 35             1、properties标签体内的属性
 36             2、properties引用的属性会被读取，本例中也就是db.properties中的属性(key-value)，
 37                 如果发现db.properties中有和第一步加载的属性的key相同的属性，那么将其覆盖
 38             3、parameterType：接收的值最后被读取，parameterType="int" int相当于key，而实际上接收到的值
 39                 为value，如果parameterType的属性名与前面两步中的属性名相同，那么将其覆盖。
 40         总结：加载的越快，就很有可能被覆盖，所以在properties中的key值都使用db.xxx，目的就是防止重名被覆盖
 41      -->
 42     <properties resource="db.properties">
 43         <!-- 这里就是properties标签体内的属性
 44                 比如： <property name="" value=""/>
 45          -->
 46     </properties>
 47     
 48     <!-- setting 全局参数，比如懒加载、是否启动缓存机制-->
 49 <!--     <settings>
 50         打开延迟加载的开关，默认为true
 51         <setting name="lazyLoadingEnabled" value="true"/>
 52         积极的懒加载，默认是true，设置为false时，懒加载生效
 53         <setting name="aggressiveLazyLoading" value="false"/>
 54     </settings> -->
 55     
 56     <!-- typeAliases:别名，为了在映射文件中更方便的编写输入参数类型和输出结果类型，比如直接编写int，
 57             而不需要在编写全限定名 java.lang.Integer了。 有很多默认的别名，比如int，String，八大基本类型都是
 58             我们也可以自定义别名,
 59         com.wuhao.mybatis.domain.User   使用别名  user 代替        
 60      -->
 61      <typeAliases>
 62          <!-- 单个定义别名 -->
 63           <typeAlias type="com.wuhao.mybatis.domain.User" alias="user"/> 
 64          <!-- 批量定义别名(推荐)
 65              指定批量定义别名的类包，在此包下的所有类都将可以使用别名，别名就为类名(首字母大小写都可以)
 66           -->
 67          <!-- <package name="com.wuhao.mybatis.domain"/> -->
 68      </typeAliases>
 69             
 70     <!-- 类型转换器，将数据库的类型转换成java的类型，
 71         mybatis会帮我们做这个事情，我们不需要自己设置，
 72         <typeHandlers></typeHandlers>        
 73      -->
 74     
 75     <!-- 
 76         对象工厂不用管，因为到时候肯定和spring整合，都会由sprig来管理。
 77     <objectFactory></objectFactory> 
 78     -->
 79     
 80     <!-- 
 81         mappers:加载映射文件
 82         四种方式来加载
 83         1、<mapper resource="config/sqlmap/user.xml"/> 
 84             使用相对路径，相对于项目底下。,比如config下的sqlmap下的user.xml
 85          2、<mapper url=’’/>
 86              使用绝对路径，比如d盘下的xx，不会用这种
 87          3、<mapper class=’’/>
 88              使用mapper接口的全县定名。就不用管路径问题了，让mybatis通过全限定名自己去找映射文件
 89              前提：mapper接口的名称必须与映射文件的名称相同，并且放到一个目录下，
 90                  比如：UserMapper.java(接口)   UserMapper.xml(映射文件)
 91          4、<package name=’’/>（推荐)
 92              注册指定包下的所有映射文件
 93                  <package name="com.wuhao.mapper"/>
 94                  配置了com.wuhao.mapper下的所有映射文件，
 95                  注意：此种方法要求mapper接口和mapper映射文件要名称相同，且放到同一个目录下
 96      -->
 97     
 98     
 99 
100 <!-- 配置mybatis的环境信息 -->
101 <environments default="development">
102     <environment id="development">
103         <!-- 配置JDBC事务控制，由mybatis进行管理 -->
104         <transactionManager type="JDBC"></transactionManager>
105         <!-- 配置数据源，采用dbcp连接池 -->
106         <dataSource type="POOLED">
107             <!-- 引用db.properties中的信息，通过${} -->
108             <property name="driver" value="${db.driver}"/>
109             <property name="url" value="${db.url}"/>
110             <property name="username" value="${db.username}"/>
111             <property name="password" value="${db.password}"/>
112         </dataSource>
113     </environment>
114 </environments>
115     <!-- 加载mapper映射文件 -->    
116 <mappers>
117     <!-- <mapper resource="sqlmap/User.xml"/> -->
118     <!-- 批量加载映射文件 -->
119     <package name="com.wuhao.mapper"/>
120     <package name="com.wuhao.shuru"/>
121     <package name="com.wuhao.resultMap"/>
122     <package name="com.wuhao.onetoone"/>
123 </mappers>
124 </configuration>

View Code

 

九、总结

　　　　　　以上就把全局配置文件中的内容全部给讲解了一遍，其中

　　　　　　　　　　

　　　　　　没有具体讲解这个，因为都是死东西，在前一章节都是使用这个，所以就不在过多分析，其他的都有讲解到是什么作用，现在应该对前面一章的东西有更加深入的理解，但是需要彻底理解，还需要等待下一章讲解映射文件之后才能够更加清晰。加油。