mybatis-config.xml-配置文件详解

说明

mybatis 的核心配置文件(mybatis-config.xml)，比如配置jdbc 连接信息，注册mapper等等,我们需要对这个配置文件有详细的了解。

文档地址:

官方文档： https://mybatis.org/mybatis-3/zh/configuration.html

配置文件属性解析

properties 属性

通过该属性，可以指定一个外部的jdbc.properties 文件，引入我们的jdbc 连接信息。

应用实例

1. 创建NLC_MyBatis\mybatis_quickstart\src\main\resources\jdbc.properties

jdbc.user=root
jdbc.password=123456
jdbc.url=jdbc:mysql://127.0.0.1:3306/mybatis?userSSL=true&userUnicode=true&char
acterEncoding=UTF-8
jdbc.driver=com.mysql.jdbc.Driver

2. 修改mybatis-confing.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>
   
       <!--引入外部的jdbc.properties-->
       <properties resource="jdbc.properties"/>
       
    <environments default="development">
           <environment id="development">
               <!--配置事务管理器-->
               <transactionManager type="JDBC"/>
               <!--配置数据源
                   1. 我们使用外部的properties文件来设置相关的值
                   2. 这个属性文件，需要统一放在 resources目录/类加载路径
               -->
               <dataSource type="POOLED">
                   <!--配置驱动-->
                   <property name="driver" value="${jdbc.driver}"/>
                   <!--从外部文件动态使用-->
                   <!--配置连接mysql-url
                   解读:
                   1. jdbc:mysql 协议
                   2. 127.0.0.1:3306 : 指定连接mysql的ip+port
                   3. mybatis: 连接的DB
                   4. useSSL=true 表示使用安全连接
                   5. &amp; 表示 & 防止解析错误
                   6. useUnicode=true : 使用unicode 作用是防止编码错误
                   7. characterEncoding=UTF-8 指定使用utf-8, 防止中文乱码
                   -->
                   <property name="url" value="${jdbc.url}"/>
                   <property name="username" value="${jdbc.user}"/>
                   <property name="password" value="${jdbc.pwd}"/>
               </dataSource>
           </environment>
       </environments>
   

   3. 修改父项目的pom.xml(如果已经配置了*.properties 就不用再配置) 并完成测试

settings 全局参数定义

1. 感兴趣的可以看手册
2. settings 列表，通常使用默认

应用实例

 <!--配置MyBatis自带的日志输出-查看原生的sql-->
    <settings>
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>

typeAliases 别名处理器

1. 别名是为Java 类型命名一个短名字。它只和XML 配置有关，用来减少类名重复的部分

2. 如果指定了别名,我们的MappperXxxx.xml 文件就可以做相应的简化处理

3. 注意指定别名后，还是可以使用全名的

举例说明

1. 修改NLC_MyBatis\mybatis_quickstart\src\main\resources\mybatis-config.xml

 <!--配置别名-->
    <typeAliases>
        <!-- 为某个mapper 指定一个别名, 下面可以在XxxxxMapper.xml 做相应简化处理-->
        <!--<typeAlias type="com.nlc.entity.Monster" alias="Monster"/>-->

        <!--
            如果一个包下有很多的类，我们可以直接引入包，这样
            该包下面的所有类名，可以直接使用
        -->
        <package name="com.nlc.entity"/>
    </typeAliases>

2. 修改MonsterMapper.xml 并完成测试

<!--没有在mybatis-config.xml 指定typealiases 时，需要给Monster 指定全类名
<insert id="addMonster" parameterType="com.nlc.entity.Monster"-->
<!-- useGeneratedKeys="true" keyProperty="id"-->

<insert id="addMonster" parameterType="Monster" useGeneratedKeys="true" keyProperty="id">
 <!--useGenerated Keys是一个在数据库操作中常用的选项或属性。它用于指示数据库返回生成的主键值，
	 keyProperty 用来定义和操作对象的主键。
-->
    INSERT INTO monster (age,birthday,email,gender,name,salary)
    VALUES(#{age},#{birthday},#{email},#{gender},#{name},#{salary})
</insert>

typeHandlers 类型处理器

1. 用于java 类型和jdbc 类型映射
2. Mybatis 的映射基本已经满足，不太需要重新定义
3. 这个我们使用默认即可，也就是mybatis 会自动的将java 和jdbc 类型进行转换.
4. java 类型和jdbc 类型映射关系一览[ 手册]
   https://mybatis.org/mybatis-3/zh/configuration.html#typeHandlers

environments 环境

1、MyBatis 可以配置多种环境，比如开发、测试和生成环境需要有不同的配置

2、每种环境使用一个 environment 标签进行配置并指定唯一标识符

3、可以通过 environment 标签中的 default 属性指定一个环境的标识符来快速的切换环境

environment 属性

environments：指定具体环境，mybatis 可以配置多种环境，default 指定使用某种环境，可以达到快速切换环境。

environment：配置一个具体的环境信息，id属性代表当前环境的唯一标识，

必须有下面两个标签：

​ transactionManager：事务管理器

​ dataSource：数据源

应用实例

<environments default="development">
        <environment id="development">
            <!--配置事务管理器-->
            <transactionManager type="JDBC"/>
            <!--配置数据源
           解读
            1. 我们使用外部的properties文件来设置相关的值
            2. 这个属性文件，需要统一的放在 resources目录/类加载路径
            -->
            <dataSource type="POOLED">
                <!--配置驱动-->
                <property name="driver" value="${jdbc.driver}"/>
                <!--配置连接mysql-url
                解读:
                1. jdbc:mysql 协议
                2. 127.0.0.1:3306 : 指定连接mysql的ip+port
                3. mybatis: 连接的DB
                4. useSSL=true 表示使用安全连接
                5. &amp; 表示 & 防止解析错误
                6. useUnicode=true : 使用unicode 作用是防止编码错误
                7. characterEncoding=UTF-8 指定使用utf-8, 防止中文乱码
                8.温馨提示：不要背，直接使用即可
                -->
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.user}"/>
                <property name="password" value="${jdbc.pwd}"/>
            </dataSource>
        </environment>
</environments>

mappers配置

1. resource 注册Mapper 文件: XXXMapper.xml 文件(常用)

<mapper resource="com/nlc/mapper/MonsterMapper.xml"/>
        <!--解读
           1. 如果是通过注解的方式，可不再使用 MonsterMapper.xml
           2. 但是需要在mybatis-config.xml注册/引入含注解的类
           3. 如果没有引入，不能使用
        -->

2. class:接口注解实现(使用过)

 <!--解读
           1. 如果是通过注解的方式，可不再使用 MonsterMapper.xml
           2. 但是需要在mybatis-config.xml注册/引入含注解的类
           3. 如果没有引入，不能使用
        -->
      <mapper class="com.nlc.mapper.MonsterAnnotation"/>

3. url:外部路径,使用很少，不推荐,

   <mapper url="file:///D:\yy\kk\yy\MOnsterMapper.xml" />
   

4. package 方式注册： 并测试

<!--
1. 当一个包下有很多的Mapper.xml 文件和基于注解实现的接口时，
为了方便，我们可以以包方式进行注册
2. 将下面的所有xml 文件和注解接口都进行注册
-->
<package name="com.nlc.mapper"/>