Mybatis 全局配置文件详解

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Mybatis 全局配置文件详解相关的知识,希望对你有一定的参考价值。

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

                          --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

 

九、总结

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

          技术分享

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

 

以上是关于Mybatis 全局配置文件详解的主要内容,如果未能解决你的问题,请参考以下文章

Mybatis 全局配置文件详解

MyBatis 全局配置文件详解

Mybatis的配置文件和映射文件详解

Mybatis的配置文件和映射文件详解

mybatis 详解------ mybatis和spring整合

MyBatis从入门到入土——使用详解