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

---

前言

随着对MyBatis 配置文件理解的加深，越来越体会到这个文件的作用了。也终于区分开config.xml和XXmapper.xml的区别了

• config.xml是用来配置mybatis，他是总配置，配置Mapper只是他的功能之一。在配置Mapper方面，目前我用到的<mapper>是用来设置mapper.xml的路径的，<typeAliases>是用来简写XXType的
• XXmapper是用来实现XXMapper接口的，用来写sql语句的。
  终于开始系统的学习xml的配置属性了，不再觉得每个<属性标签>都很陌生了。本文仅列出一些常用的属性。
  参考文档：xml配置文档

一、属性<properties>

myBatis.xml配置文件

• 这儿的配置属性，指的是在resource文件夹下面的myBatis.xml中的<properties>
• property 的value，可以从外部文件读取。
• 使用value="${username}"这样的形式，读取properties中的username的值

<property name="user" value="laohan">
1

properties文件

• 配置在resource文件夹下面
• 文件后缀为.properties，不能是property
• username=hsp的形式连接。等号前后不加“引号”；也不要加空格，避免引用带了空格，导致出错；也不要用“;”分号结尾
• 为了能使用properties，需要在mybatis.xml文件中添加properties的位置。保存在默认resources路径下。

<properties resource="jdbc.properties"/>
1

• 更改为从外部引用后，出现的第一个错误就是，添加的中文信息出现乱码了。
  • 猜测是“&amp;”换了位置后不能正常解析，统一改为&后，能正常录入中文了。

pom.xml文件

• 配置在工程目录下面
• 代码运行后，文件都是从target目录下读取的，为了生成target目录下的properties，需要在pom.xml中配置:

<build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.xml</include>
                    <include>**/*.properties</include>
                </includes>
            </resource>
        </resources>
</build>
1
2
3
4
5
6
7
8
9
10
11

二、设置<settings>

• logImpl，配置MyBatis自带的日志输出-查看原生的sql

    <settings>
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>
1
2
3

三、类型别名<typeAliases>

• 类型别名可设置为 Java 类型设置一个SimpleName。

<typeAlias type=“com.stein.entity.Monster” alias=“Monster”/>

• 也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean。
  • 这样在同一个包下，如果有多个别名需要配置，就会简化很多

<package name=“domain.blog”/>

四、类型处理器<typeHandlers>

• MyBatis 在设置预处理语句（PreparedStatement）中的参数或从结果集中取出一个值时， 都会用类型处理器将获取到的值以合适的方式转换成 Java 类型。
• 年-月-日 时:分:秒 ，在java端可以设置Date格式，在DB端可以设置成TimeStamp(推荐)或者datetime。

五、环境配置<environments>

• 配置jdbc

六、映射器<mappers>

既然 MyBatis 的行为已经由上述元素配置完了，我们现在就要来定义 SQL 映射语句了。 但首先，我们需要告诉 MyBatis 到哪里去找到这些语句。MyBatis通过以下4种方式查找实现了接口的XXMapper.xml文件。如果没有写，或者写错了路径、文件名，都会报错Type interface *** is not known to the MapperRegistry。

• 使用映射器接口实现类的完全限定类名。可以用来配置用@注解实现的映射器。

<mapper class=“com.stein.mapper.MonsterAnnotation”/>。

• 使用相对于类路径的资源引用

<mapper resource=“com/stein/mapper/monsterMapper.xml”/>

• 将包内的映射器接口全部注册为映射器。直接写包名，在包内搜索。

<package name=“com.stein.mapper”/>

• 使用完全限定资源定位符（URL）（不常用）

---

注意事项

貌似对config.xml的配置顺序有要求，需要按照文档的顺序排列，否则会报红，而且运行会出错。