MyBatis快速入门第四讲——SqlMapConfig.xml配置文件详解

矫情吗；* 2023-06-13 11:13 10阅读 0赞

本讲将着重讲解MyBatis的SqlMapConfig.xml配置文件。

# SqlMapConfig.xml文件中配置的内容 #

SqlMapConfig.xml文件中配置的内容和顺序如下图所示。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70]  
上图标红的内容是本讲要重点讲解的东西。

## properties（属性） ##

在SqlMapConfig.xml配置文件中，我们可把数据库连接信息配置到properties标签当中，类似如下：  
![在这里插入图片描述][20191116175339110.png]  
接下来就可以把以上配置信息添加到SqlMapConfig.xml配置文件中了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 1]  
SqlMapConfig.xml文件像上面这样配置，虽然没问题，但是你不觉得这样很不爽吗？我们一般都是将数据库连接信息配置到一个属性文件中，然后再来引用其中的配置信息。按照这种指导思想，我们就要在classpath下创建一个属性文件了，例如jdbc.properties，既然该文件要在classpath下，所以可以在config源码目录下创建它。SqlMapConfig.xml文件引用该属性文件中的配置信息如下：

jdbc.driver=com.mysql.jdbc.Driver
    jdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8
    jdbc.username=root
    jdbc.password=liayun

如此一来，SqlMapConfig.xml配置文件的内容就要修改成下面这个样子了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 2]  
注意：MyBatis将按照下面的顺序来加载属性：

1.  在properties元素体内定义的属性首先被读取；
2.  然后会读取properties元素中resource或url加载的属性，它会覆盖已读取的同名属性。

说得通俗一点就是：先加载property元素内部的属性，然后再加载jdbc.properties文件外部的属性，如果有同名属性则会覆盖。如若读者不信，则可以将properties元素内部jdbc.username属性的值故意写错，即故意将数据库连接的用户名给整错，就像上图所示的那样。结果发现仍然好使，这足以说明问题了。

## typeAliases（类型别名） ##

### MyBatis支持别名 ###

MyBatis支持的别名如下列表所示：

<table> 
 <thead> 
  <tr> 
   <th align="center">别名</th> 
   <th align="center">映射的类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">_byte</td> 
   <td align="center">byte</td> 
  </tr> 
  <tr> 
   <td align="center">_long</td> 
   <td align="center">long</td> 
  </tr> 
  <tr> 
   <td align="center">_short</td> 
   <td align="center">short</td> 
  </tr> 
  <tr> 
   <td align="center">_int</td> 
   <td align="center">int</td> 
  </tr> 
  <tr> 
   <td align="center">_integer</td> 
   <td align="center">int</td> 
  </tr> 
  <tr> 
   <td align="center">_double</td> 
   <td align="center">double</td> 
  </tr> 
  <tr> 
   <td align="center">_float</td> 
   <td align="center">float</td> 
  </tr> 
  <tr> 
   <td align="center">_boolean</td> 
   <td align="center">boolean</td> 
  </tr> 
  <tr> 
   <td align="center">string</td> 
   <td align="center">String</td> 
  </tr> 
  <tr> 
   <td align="center">byte</td> 
   <td align="center">Byte</td> 
  </tr> 
  <tr> 
   <td align="center">long</td> 
   <td align="center">Long</td> 
  </tr> 
  <tr> 
   <td align="center">short</td> 
   <td align="center">Short</td> 
  </tr> 
  <tr> 
   <td align="center">int</td> 
   <td align="center">Integer</td> 
  </tr> 
  <tr> 
   <td align="center">integer</td> 
   <td align="center">Integer</td> 
  </tr> 
  <tr> 
   <td align="center">double</td> 
   <td align="center">Double</td> 
  </tr> 
  <tr> 
   <td align="center">float</td> 
   <td align="center">Float</td> 
  </tr> 
  <tr> 
   <td align="center">boolean</td> 
   <td align="center">Boolean</td> 
  </tr> 
  <tr> 
   <td align="center">date</td> 
   <td align="center">Date</td> 
  </tr> 
  <tr> 
   <td align="center">decimal</td> 
   <td align="center">BigDecimal</td> 
  </tr> 
  <tr> 
   <td align="center">bigdecimal</td> 
   <td align="center">BigDecimal</td> 
  </tr> 
  <tr> 
   <td align="center">map</td> 
   <td align="center">Map</td> 
  </tr> 
 </tbody> 
</table>

### 自定义别名 ###

如果我们在SqlMapConfig.xml配置文件添加了如下配置信息：  
![在这里插入图片描述][20191116183029418.png]  
那么就为User类定义了一个别名（别名就叫user）。这时，我们就可以在UserMapper.xml映射文件中使用这个别名了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 3]  
温馨提示：resultType属性的值就是User类的别名，且别名是不区分大小写的。  
聪明的小伙伴们肯定发现如果像这样为每一个pojo定义一个别名，那不是傻逼吗！万一一个项目里面有很多pojo类呢？所以我们可以批量定义别名，就像下面这样。  
![在这里插入图片描述][20191116183046747.png]

## SqlMapConfig.xml文件加载Mapper.xml文件 ##

Mapper（映射器）的配置有如下三种方式：

1.  第一种方式：使用`<mapper resource="..." />`标签来加载相对于类路径的映射文件。正如下图所示的那样。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 4]
2.  第二种方式：使用`<mapper class="..." />`标签配置映射文件的class扫描器，也就是说加载Mapper接口类路径下的映射文件。正如下图所示的那样。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 5]  
    注意：这种方式要求Mapper接口名称和Mapper映射文件名称相同，且放在同一个目录中。
3.  第三种方式：使用`<package name="..." />`标签配置映射文件包扫描，注册指定包下的所有Mapper接口，也就是说能加载指定包下的所有映射文件了。正如下图所示的那样。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 6]  
    注意：这种方式也要求Mapper接口名称和Mapper映射文件名称相同，且放在同一个目录中。

虽然Mapper（映射器）配置有以上三种方式，但是在实际开发中就用第三种方法，其他方式仅做了解就行！

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191116175330358.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA==,size_16,color_FFFFFF,t_70
[20191116175339110.png]: https://img-blog.csdnimg.cn/20191116175339110.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20191116175345862.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20191116175354172.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA==,size_16,color_FFFFFF,t_70
[20191116183029418.png]: https://img-blog.csdnimg.cn/20191116183029418.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20191116183039359.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA==,size_16,color_FFFFFF,t_70
[20191116183046747.png]: https://img-blog.csdnimg.cn/20191116183046747.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20191116183058728.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20191116183108291.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20191116183115396.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9saWF5dW4uYmxvZy5jc2RuLm5ldA==,size_16,color_FFFFFF,t_70