Mybatis学习（三）—— Mybatis配置文件

---

前言

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。本文通过修改前文中对Mybatis-config.xml中的内容，举例描述一些常用属性。
详细内容可参考Mybatis中文文档

一、属性（properties）

可将例如数据库驱动、数据库url、用户登录信息这些属性写入外部配置文件中，在properties中调用。
例如：
创建db.properties文件，插入以下信息：

driver = com.mysql.jdbc.Driver
url = jdbc:mysql://localhost:3306/jdbcstudy?useUnicode=true&characterEncoding=utf8&useSSl=true
username = root
password = 123456

在Mybatis-config.xml文件中插入db.properties文件的路径，以及在environment下值改成${属性名}：

<properties resource="db.properties"/>
<environment id="development">
  <transactionManager type="JDBC"/>
  <dataSource type="POOLED">
  <property name="driver" value="${driver}"/>
  <property name="url" value="${url}"/>
  <property name="username" value="${username}"/>
  <property name="password" value="${password}"/>
</dataSource>
</environment>

或者也可在配置文件中写入属性。若属性同名，db.properties文件中的属性比Mybatis-config.xml文件中的优先级更高。例如：

<properties resource="db.properties">
  <property name="password" value="111"/>
</properties>
<environment id="development">
  <transactionManager type="JDBC"/>
  <dataSource type="POOLED">
  <property name="driver" value="${driver}"/>
  <property name="url" value="${url}"/>
  <property name="username" value="${username}"/>
  <property name="password" value="${password}"/>
</dataSource>
</environment>

二、设置（settings）

设置可改变 MyBatis 的运行时行为，具体可参考该链接查看各种设置名

1. 日志

目的：进行数据库操作时，若出错，用于排错。
日志种类：
本文介绍其中的两种。

1）STDOUT_LOGGING
在Mybatis-config.xml添加下列代码，可查看运行结果的示例。

<settings>
    <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>

我们以按id查询某一行结果测试日志，结果如下：
我们可以很清楚的了解执行的过程及结果。

2）Log4j

• 可以控制日志信息输送到控制台、文件、GUI组件

• 可以控制每一条日志的输出格式

• 通过定义每一条日志信息的级别，能够更加细致地控制日志的生成过程

• 可以通过一个配置文件（log4j.properties）来灵活地进行配置，而不需要修改应用的代码

实现：
① 导入包

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

② 设置log4j.properties配置文件

#将等级为DEBUG的日志信息输出到console和file这两个目的地，console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file
​
#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/rzp.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sq1.PreparedStatement=DEBUG

③ 在Mybatis-congfig.xml中配置settings实现log4j

<settings>
    <setting name="logImpl" value="LOG4J"/>
</settings>

④测试：查询一个表中所有结果。
从上图中可以看到连接、关闭数据库、操作sql语句、查询结果等过程。与STDOUT_LOGGING结果类似。

三、类型别名（typeAliases）

目的：用于xml配置时降低冗长的类名。
1）指定需要别名的包的路径。
在Mybatis-config.xml文件中设置。

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

2）指定一个包名，在包名下面搜索需要的 Java Bean。别名默认是类名的首字母小写。

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

3）利用在实体类上注解的方式

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

对类名起完别名后，使用时，可直接使用类名，减少冗余。
在Mapper.xml中：

<select id="getUserLike" resultType="user">
    select * from mybatis.user where name like "%"#{values}"%"
</select>

四、环境配置（environments）

Mybatis可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

所以，如果你想连接两个数据库，就需要创建两个 SqlSessionFactory 实例，每个数据库对应一个。
1） 选择哪一种环境为默认环境

<environments default="development">

2）事务管理器（transactionManager）有：JDBC和MANAGED

3）有三种内建的数据源类型UNPOOLED、POOLED、JNDI。

示例：

<environments default="development">

  <environment id="development1">
    <transactionManager type="JDBC">
      <property name="..." value="..."/>
    </transactionManager>
    <dataSource type="POOLED">
      <property name="driver" value="${driver}"/>
      <property name="url" value="${url}"/>
      <property name="username" value="${username}"/>
      <property name="password" value="${password}"/>
    </dataSource>
  </environment>
  
  <environment id="development1">
    <transactionManager type="MANAGED">
      <property name="..." value="..."/>
    </transactionManager>
    <dataSource type="POOLED">
      <property name="driver" value="${driver}"/>
      <property name="url" value="${url}"/>
      <property name="username" value="${username}"/>
      <property name="password" value="${password}"/>
    </dataSource>
  </environment>
</environments>

五、映射器（mappers）

目的：定义 SQL 映射语句的文件路径
1）使用相对于类路径的资源引用

<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
</mappers>

2）使用映射器接口实现类的完全限定类名

<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>

3）将包内的映射器接口实现全部注册为映射器

<mappers>
  <package name="org.mybatis.builder"/>
</mappers>

注意：2）3）方法需要映射接口和映射接口的实现类在同一个文件中且同名。