Mybatis配置详细解析-工具盒子

# （一）概述 {#一-概述}

Mybatis的核心配置文件是mybatis-config.xml。我还是先把Mybatis官方中文网站的地址拿出来：

mybatis官方中文网站：https://mybatis.org/mybatis-3/zh/configuration.html

上面的地址对应于Mybatis的配置属性，MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

其中environments和mappers我们已经在前面介绍了，这里对比较重要的几个配置项做介绍。

# （二）属性（properties） {#二-属性-properties}

在最开始写mybatis-config.xml的时候，我们写了下面一段代码：

<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>

这里将各种属性写死在了xml配置文件里，如果想修改就会很麻烦，这时就可以用到properties属性。在resources目录下新建一个db.properties:

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456

接着在mybatis-config.xml中添加properties节点，注意这个节点的位置必须放在首位

<properties resource="db.properties">
</properties>

接着就可以用properties中的属性去代替xml中的属性

<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>

# （三）设置（settings） {#三-设置-settings}

MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为，官网中列出了所有设置项，这里就介绍几个常用的：

设置cacheEnabled可以全局的开启或关闭配置文件的缓存。

设置是否开启驼峰命名规则

是否开启懒加载

指定所使用的日志

设置的配置方式如下：

<settings>
  <setting name="cacheEnabled" value="true"/>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="mapUnderscoreToCamelCase" value="false"/>
  <setting name="logImpl" value="LOG4J"/>
</settings>

# （四）类型别名（typeAliases） {#四-类型别名-typealiases}

类型别名可为 Java 类型设置一个缩写名字。它仅用于 XML 配置，意在降低冗余的全限定类名书写。

类型别名有两种方式，第一种是对类取别名，第二种是指定一个包名。比如拿出之前写的sql

<select id="getUserById" resultType="com.javayz.pojo.User" parameterType="int">
    select * from user where id=#{id};
</select>

这里的resultType写的是类的全限定名，我们可以在mybatis-config.xml中使用类型别名来简化。

<typeAliases>
    <typeAlias type="com.javayz.pojo.User" alias="user"/>
</typeAliases>

这样设置之后就可以在resultType中直接使用user。

第二种方式是指定一个包名，Mybatis会在指定的包名路径下搜索需要的JavaBean。修改上面的代码，使用包名来指定

<typeAliases>
    <package name="com.javayz.pojo"/>
</typeAliases>

官方文档里有这样一句话，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名，意思就是如果我们使用@Alias制定了别名，就可以使用指定的别名，如果没有指定，就是用当前实体类名的小写作为别名。

例如下面这种写法不管加不加注解，别名都是user

@Alias("user")
public class User {
    ...
}

下面是java类型内建的别名

# （五）映射器（mappers） {#五-映射器-mappers}

在前面我们已经讲了mapper的使用，每编写一个mapper.xml，都需要在mybatis-config.xml中增加一个mapper标签。

mappers有四种引入方式：

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
<!-- 使用完全限定资源定位符（URL） -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
<mapper url="file:///var/mappers/BlogMapper.xml"/>
<mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>