03_mybatis配置文件详解

墨蓝 2024-04-19 10:12 51阅读 0赞

#  #

# 1. SqlMapConfig.xml #

**mybatis全局配置文件SqlMapConfig.xml,配置内容如下：**

\*properties(属性)

*setting(全局配置参数)*

*typeAliases(类型别名)*

*typeHandlers(类型处理器)*

*plugins(插件)*

*enviroments(环境集合对象)*

*enviroment(环境子属性对象)*

*transactionManager(事务管理)*

*datasource(数据源)*

*mappers(映射器)*

## 1.1 properties属性 ##

可将数据库连接参数单独配置在db.properties中，只需要在SqlMapConfig.xml中加载db.properties的属性值。

在SqlMapConfig.xml中就不需要对数据库连接参数硬编码。

**db.properties:**

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

在SqlMapConfig.xml中加载属性文件：

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
    <configuration>
        
        <properties resource="com/mybatis/config/db.properties"></properties>
        <settings>
            <setting name="logImpl" value="LOG4J"/>
        </settings>
        .....
        .....

**properties特性：注意： MyBatis 将按照下面的顺序来加载属性：**

*在 properties元素体内定义的属性首先被读取。*

*然后会读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。*

*最后读取parameterType传递的属性，它会覆盖已读取的同名属性。*

建议：不要在properties元素体内添加任何属性值，只将属性值定义在properties文件中。在properties文件中定义属性名要有一定的特殊性，如：XXXXX.XXXXX.XXXX

## 1.2 settings全局配置参数 ##

mybatis框架在运行时可以调整一些运行参数。

比如：开启二级缓存、开启延迟加载、全局参数将会影响mybatis

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdHBlbg_size_16_color_FFFFFF_t_70]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdHBlbg_size_16_color_FFFFFF_t_70 1]![在这里插入图片描述][20190917094414483.png]

## 1.3 typeAliases（别名） ##

在mapper.xml中，定义很多的statement，statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。

如果在指定类型时输入类型全路径，不方便进行开发，可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名定义，方便开发。

**1）Mybatis默认支持的别名：**

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

**2）自定义别名**

**单个别名定义：**

<typeAliases>
            
           <typeAlias type="com.mybatis.po.User" alias="user"></typeAlias>
        </typeAliases>

**批量别名定义**：批量别名定义mybatis:自动扫描包中的po类，别名就是类名（首字母大写小写都可以）

<typeAliases>
            
            <package name="com.mybatis.po"></package>
    
        </typeAliases>

**引用别名**：

<select id="findUserByName" parameterType="java.lang.String" resultType="user">
             SELECT * FROM USER WHERE USERNAME LIKE '%${value}%'
        </select>

## 1.4 typeHandlers（类型处理器） ##

*mybatis中通过typeHandlers完成jdbc类型和java类型的转换。通常情况下，mybatis提供的类型处理器满足日常需要，不需要自定义.*

mybatis支持类型处理器：

<table> 
 <thead> 
  <tr> 
   <th>类型处理器</th> 
   <th><strong>Java</strong>类型</th> 
   <th><strong>JDBC</strong>类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>BooleanTypeHandler</td> 
   <td>Boolean，boolean</td> 
   <td>任何兼容的布尔值</td> 
  </tr> 
  <tr> 
   <td>ByteTypeHandler</td> 
   <td>Byte，byte</td> 
   <td>任何兼容的数字或字节类型</td> 
  </tr> 
  <tr> 
   <td>ShortTypeHandler</td> 
   <td>Short，short</td> 
   <td>任何兼容的数字或短整型</td> 
  </tr> 
  <tr> 
   <td>IntegerTypeHandler</td> 
   <td>Integer，int</td> 
   <td>任何兼容的数字和整型</td> 
  </tr> 
  <tr> 
   <td>LongTypeHandler</td> 
   <td>Long，long</td> 
   <td>任何兼容的数字或长整型</td> 
  </tr> 
  <tr> 
   <td>FloatTypeHandler</td> 
   <td>Float，float</td> 
   <td>任何兼容的数字或单精度浮点型</td> 
  </tr> 
  <tr> 
   <td>DoubleTypeHandler</td> 
   <td>Double，double</td> 
   <td>任何兼容的数字或双精度浮点型</td> 
  </tr> 
  <tr> 
   <td>BigDecimalTypeHandler</td> 
   <td>BigDecimal</td> 
   <td>任何兼容的数字或十进制小数类型</td> 
  </tr> 
  <tr> 
   <td>StringTypeHandler</td> 
   <td>String</td> 
   <td>CHAR和VARCHAR类型</td> 
  </tr> 
  <tr> 
   <td>ClobTypeHandler</td> 
   <td>String</td> 
   <td>CLOB和LONGVARCHAR类型</td> 
  </tr> 
  <tr> 
   <td>NStringTypeHandler</td> 
   <td>String</td> 
   <td>NVARCHAR和NCHAR类型</td> 
  </tr> 
  <tr> 
   <td>NClobTypeHandler</td> 
   <td>String</td> 
   <td>NCLOB类型</td> 
  </tr> 
  <tr> 
   <td>ByteArrayTypeHandler</td> 
   <td>byte[]</td> 
   <td>任何兼容的字节流类型</td> 
  </tr> 
  <tr> 
   <td>BlobTypeHandler</td> 
   <td>byte[]</td> 
   <td>BLOB和LONGVARBINARY类型</td> 
  </tr> 
  <tr> 
   <td>DateTypeHandler</td> 
   <td>Date（java.util）</td> 
   <td>TIMESTAMP类型</td> 
  </tr> 
  <tr> 
   <td>DateOnlyTypeHandler</td> 
   <td>Date（java.util）</td> 
   <td>DATE类型</td> 
  </tr> 
  <tr> 
   <td>TimeOnlyTypeHandler</td> 
   <td>Date（java.util）</td> 
   <td>TIME类型</td> 
  </tr> 
  <tr> 
   <td>SqlTimestampTypeHandler</td> 
   <td>Timestamp（java.sql）</td> 
   <td>TIMESTAMP类型</td> 
  </tr> 
  <tr> 
   <td>SqlDateTypeHandler</td> 
   <td>Date（java.sql）</td> 
   <td>DATE类型</td> 
  </tr> 
  <tr> 
   <td>SqlTimeTypeHandler</td> 
   <td>Time（java.sql）</td> 
   <td>TIME类型</td> 
  </tr> 
  <tr> 
   <td>ObjectTypeHandler</td> 
   <td>任意</td> 
   <td>其他或未指定类型</td> 
  </tr> 
  <tr> 
   <td>EnumTypeHandler</td> 
   <td>Enumeration类型</td> 
   <td>VARCHAR-任何兼容的字符串类型，作为代码存储（而不是索引）。</td> 
  </tr> 
 </tbody> 
</table>

## 1.5 mappers（映射配置） ##

**通过resource加载单个映射文件**

<mappers>
            <mapper resource="com/mybatis/config/mapper/UserMapper.xml"></mapper>
        </mappers>

**通过mapper接口加载单 个mapper**

通过mapper接口加载映射文件，遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在同一个目录中，按照这个规范：将mapper.java和mapper.xml放在一个目录中，且同名。

![在这里插入图片描述][20190917094159926.png]

<mappers>
            <mapper class="com.mybatis.mapper.UserMapper"></mapper>
        </mappers>

**批量加载mapper(推荐使用)**

指定mapper接口的包名，mybatis自动扫描包下所有mapper接口进行加载；

遵循规范:使用mapper代理开发、mapper.java和mapper.xml在同一个包中、mapper接口类名和mapper.xml映射文件名称保持一致

<mappers>
            
            <package name="com.mybatis.mapper"/>
        </mappers>

…补充中

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdHBlbg_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20190917094356527.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdHBlbg==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdHBlbg_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20190917094404500.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdHBlbg==,size_16,color_FFFFFF,t_70
[20190917094414483.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/c38e34bcd579412b8af54a07fec26c97.png
[20190917094159926.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/a82f406affd74fb0b16c0d6e973541d3.png