MyBatis学习（中）

4 配置解析

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

4.1 核心配置文件

• mybatis-config.xml

configuration（配置）
	properties（属性）
	settings（设置）
    typeAliases（类型别名）
    typeHandlers（类型处理器）
    objectFactory（对象工厂）
    plugins（插件）
    environments（环境配置）
		environment（环境变量）
			transactionManager（事务管理器）
			dataSource（数据源）
	databaseIdProvider（数据库厂商标识）
	mappers（映射器）
<!-- 注意元素节点的顺序！顺序不对会报错 -->

在XML中标签有顺序：

4.2 环境配置（environments）

MyBatis 可以配置成适应多种环境，不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

在 MyBatis 中有两种类型的事务管理器（也就是 type=“[JDBC【默认】|MANAGED]”）

有三种内建的数据源类型（也就是 type=“[UNPOOLED|POOLED【默认】|JNDI]”）

<environment id="test">
    <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>

4.3 属性（properties）

我们可以通过properties属性来实现引用配置文件

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。【db.properties】

• 编写数据库配置文件db.properties

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

• 在核心配置文件中引用

<!--    引入外部配置文件-->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="123456"/>
    </properties>

• 可以引入外部文件
• 可以在其中增加一些配置属性
• 如果两个文件有同一个字段，优先外部配置文件！

4.4 类型别名（typeAliases）

• 类型别名可为 Java 类型设置一个缩写名字。

• 它仅用于 XML 配置，意在降低冗余的全限定类名书写。

1. typeAlias

<!--    可以给实体类起别名-->
    <typeAliases>
        <typeAlias type="com.kuppy.pojo.User" alias="User"/>
    </typeAliases>

2. package 扫描实体类的包，它的默认别名就是这个类名的首字母小写

<!--    可以给实体类起别名-->
    <typeAliases>
        <package name="com.kuppy.pojo.User"/>
    </typeAliases>

​ package还可以添加注解

@Alias("hello")
public class User {
    private int id;
    private String name;
    private String pwd;
}

4.5 设置（settings）

logImpl	指定 MyBatis 所用日志的具体实现，未指定时将自动查找。
cacheEnabled	全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态

4.6 其他配置

• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
  • mybatis-generator-core
  • mabatis-plus
  • 通用mapper

4.7 映射器(mappers)

MapperRegistry: 注册绑定我们的Mapper文件，以告诉 MyBatis 到哪里去找到SQL语句。

方式一[推荐]：

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/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>

4.8 生命周期和作用域

理解我们之前讨论过的不同作用域和生命周期类别是至关重要的，因为错误的使用会导致非常严重的并发问题。

我们可以先画一个流程图，分析一下Mybatis的执行过程！

作用域（Scope）

SqlSessionFactoryBuilder

• 一旦创建了 SqlSessionFactory，就不再需要它了。
• 局部变量

SqlSessionFactory

• 说白了就是数据库连接池。一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。
• 因此 SqlSessionFactory 的最佳作用域是应用作用域。
• 最简单的就是使用单例模式或者静态单例模式。

SqlSession

• 可以当作连接到连接池的一个请求，每个线程都应该有它自己的 SqlSession 实例。
• SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
• 用完之后需要关闭

这里的每一个Mapper代表一个具体业务！

5 解决属性名和字段名不一致的问题

5.1 问题

数据库中的字段

新建一个项目，拷贝之前的，测试实体类字段不一样的情况 (pwd 和 password)

public class User {
    private int id;
    private String name;
    private String password;
}

执行后： password = ‘null’

select * from mybatis.user where id = #{id}
//类型处理器
select id,name,pwd from mybatis.user where id = #{id}

解决方法：

• 起别名 pwd as password

<select id="getUserById" parameterType="int" resultType="com.kuppy.pojo.User">
    select id,name,pwd as password from mybatis.user where id = #{id}
</select>

5.2 resultMap

结果集映射

id name pwd
id name password

<!--结果集映射-->
<resultMap id="UserMap" type="User">
<!--column数据库的字段，property实体类中的属性-->
    <result column="id" property="id"></result>
    <result column="name" property="name"></result>
    <result column="pwd" property="password"></result>
</resultMap>
<select id="getUserById" parameterType="int" resultMap="UserMap">
    select * from mybatis.user where id = #{id}
</select>

• resultMap元素是 MyBatis 中最重要最强大的元素。

• 它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来，并在一些情形下允许你进行一些 JDBC 不支持的操作。实际上，在为一些比如连接的复杂语句编写映射代码的时候，一份 resultMap 能够代替实现同等功能的数千行代码。

• ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

• ResultMap 的优秀之处——你完全可以不用显式地配置它们

• 如果这个世界总是这么简单就好了。

6 日志

6.1 日志工厂

如果一个数据库操作出现异常需要排错，日志就算最好的助手！

曾经：sout, debug

现在：日志工厂

logImpl	指定 MyBatis 所用日志的具体实现，未指定时将自动查找。	SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING

• LOG4J 【掌握】
• STDOUT_LOGGING 【掌握】

1. 在mybatis-config.xml核心配置文件中设置

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

2. 测试

Opening JDBC Connection
Created connection 1943325854.
Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@73d4cc9e]
==>  Preparing: select * from mybatis.user where id = ?
==> Parameters: 1(Integer)
<==    Columns: id, name, pwd
<==        Row: 1, 小黑, 66666
<==      Total: 1
User{id=1, name='小黑', password='66666'}
Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@73d4cc9e]
Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@73d4cc9e]
Returned connection 1943325854 to pool.

6.2 Log4j

什么是Log4j?

• Log4j是Apache的一个开源项目

• 通过使用Log4j，我们可以控制日志信息输送的目的地：控制台，文本，GUI组件…

• 我们也可以控制每一条日志的输出格式；

• 通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

1. 导入jar包

<dependencies>
    <!-- https://mvnrepository.com/artifact/log4j/log4j -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
</dependencies>

2. 创建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/shun.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.sql.PreparedStatement=DEBUG

3. 配置mybatis-config.xml

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

4. 测试

[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Opening JDBC Connection
[org.apache.ibatis.datasource.pooled.PooledDataSource]-Created connection 1007309018.
[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@3c0a50da]
[com.kuppy.dao.UserMapper.getUserById]-==>  Preparing: select * from mybatis.user where id = ?
[com.kuppy.dao.UserMapper.getUserById]-==> Parameters: 1(Integer)
[com.kuppy.dao.UserMapper.getUserById]-<==      Total: 1
User{id=1, name='小黑', password='66666'}
[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@3c0a50da]
[org.apache.ibatis.transaction.jdbc.JdbcTransaction]-Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@3c0a50da]
[org.apache.ibatis.datasource.pooled.PooledDataSource]-Returned connection 1007309018 to pool.

log4j的使用

1. 导入import org.apache.log4j.Logger;
2. 日志对象，参数为当前类的class

Logger logger = Logger.getLogger(UserMapperTest.class);

3. 日志级别

logger.info("info:进入了testLog4j");
logger.debug("debug:进入了testLog4j");
logger.error("error:进入了testLog4j");