Mybatis--配置文件解析（属性、类型别名、设置、环境配置、映射器） &作用域和生命周期

1.配置文件解析

1.1、核心配置文件

mybatis-config.xml 这个名字不是固定的，但官方建议使用这个名字
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

    <?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><!-- 配置 -->
        <properties /><!-- 属性 -->
        <settings /><!-- 设置 -->
        <typeAliases /><!-- 类型命名 -->
        <typeHandlers /><!-- 类型处理器 -->
        <objectFactory /><!-- 对象工厂 -->
        <plugins /><!-- 插件 -->
        <environments><!-- 配置环境 -->
            <environment><!-- 环境变量 -->
                <transactionManager /><!-- 事务管理器 -->
                <dataSource /><!-- 数据源 -->
            </environment>
        </environments>
        <databaseIdProvider /><!-- 数据库厂商标识 -->
        <mappers /><!-- 映射器 -->
    </configuration>

properties、settings、typeAliases、typeHandler、plugin、environments、mappers 是常用的内容。

【注意】MyBatis 配置项的顺序不能颠倒。如果颠倒了它们的顺序，那么在 MyBatis 启动阶段就会发生异常，导致程序无法运行。

1.2、属性（properties）

这些属性可以在外部进行配置，并可以进行动态替换。

方式一：

在resource文件夹下创建db.properties文件

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis
username=root
password=root

引入外部配置文件

<properties resource="db.properties"/>

方式二：

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis

<properties resource="db.properties">
	<!--动态添加属性-->
  	<property name="username" value="root"/>
  	<property name="password" value="root"/>
</properties>

1.3、类型别名（typeAliases）

类型别名是为Java类型设置一个短的名字
存在的意义仅在于减少类完全限定名的冗余

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

也可以指定一个包名，MyBatis会在包名下面搜索需要的Java Bean,比如：

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

<typeAliases>
   <package name="cn.cgz.pojo"/>
</typeAliases>

两种方式如何使用：

如果实体类比较少，建议用第一种方式
如果实体类十分多，建议使用第二种方式

区别：第一种可以自定义别名；第二种不行，如果非要改，需要在实体类上增加注解

@Alias("user")
public class User {

1.4、设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

日志工厂


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

如果一个数据库操作，出现了异常，我们需要拍错。日志就是最好的助手！

曾经：sout、debug

现在：日志工厂！

SLF4J
LOG4J 【掌握】
LOG4J2
JDK_LOGGING
COMMONS_LOGGING
STDOUT_LOGGING【掌握】
NO_LOGGING

在Mybatis中具体使用哪个------ 日志实现，在设置中设定！

STDOUT_LOGGING标准日志输出

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

在这里插入图片描述

log4j

什么是log4j?

Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件；
我们也可以控制每一条日志的输出格式；
通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。
通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

先导入log4j的包

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

在类路径下建立log4j.properties

# priority  :debug<info<warn<error
#you cannot specify every priority with different file for log4j
log4j.rootLogger=debug,stdout,info,debug,warn,error

#console
log4j.appender.stdout=org.apache.log4j.ConsoleAppender 
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout 
log4j.appender.stdout.layout.ConversionPattern= [%d{
    
    yyyy-MM-dd HH:mm:ss a}]:%p %l%m%n
#info log
log4j.logger.info=info
log4j.appender.info=org.apache.log4j.DailyRollingFileAppender 
log4j.appender.info.DatePattern='_'yyyy-MM-dd'.log'
log4j.appender.info.File=./src/com/hp/log/info.log
log4j.appender.info.Append=true
log4j.appender.info.Threshold=INFO
log4j.appender.info.layout=org.apache.log4j.PatternLayout 
log4j.appender.info.layout.ConversionPattern=%d{
    
    yyyy-MM-dd HH:mm:ss a} [Thread: %t][ Class:%c >> Method: %l ]%n%p:%m%n
#debug log
log4j.logger.debug=debug
log4j.appender.debug=org.apache.log4j.DailyRollingFileAppender 
log4j.appender.debug.DatePattern='_'yyyy-MM-dd'.log'
log4j.appender.debug.File=./src/com/hp/log/debug.log
log4j.appender.debug.Append=true
log4j.appender.debug.Threshold=DEBUG
log4j.appender.debug.layout=org.apache.log4j.PatternLayout 
log4j.appender.debug.layout.ConversionPattern=%d{
    
    yyyy-MM-dd HH:mm:ss a} [Thread: %t][ Class:%c >> Method: %l ]%n%p:%m%n
#warn log
log4j.logger.warn=warn
log4j.appender.warn=org.apache.log4j.DailyRollingFileAppender 
log4j.appender.warn.DatePattern='_'yyyy-MM-dd'.log'
log4j.appender.warn.File=./src/com/hp/log/warn.log
log4j.appender.warn.Append=true
log4j.appender.warn.Threshold=WARN
log4j.appender.warn.layout=org.apache.log4j.PatternLayout 
log4j.appender.warn.layout.ConversionPattern=%d{
    
    yyyy-MM-dd HH:mm:ss a} [Thread: %t][ Class:%c >> Method: %l ]%n%p:%m%n
#error
log4j.logger.error=error
log4j.appender.error = org.apache.log4j.DailyRollingFileAppender
log4j.appender.error.DatePattern='_'yyyy-MM-dd'.log'
log4j.appender.error.File = ./src/com/hp/log/error.log 
log4j.appender.error.Append = true
log4j.appender.error.Threshold = ERROR
log4j.appender.error.layout = org.apache.log4j.PatternLayout
log4j.appender.error.layout.ConversionPattern = %d{
    
    yyyy-MM-dd HH:mm:ss a} [Thread: %t][ Class:%c >> Method: %l ]%n%p:%m%n

配置log4j为日志的工厂实现

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

log4j的简单使用

在要使用log4j的类中，导入包import org.apache.log4j.Logger;
日志对象，参数为当前类的class

static Logger logger = Logger.getLogger(UserDaoTest.class);

日志级别

@Test
public void TestLog4j(){
    
    
     logger.info("info:进入了testLog4j");
     logger.debug("debug:进入了testLog4j");
     logger.error("error:进入了testLog4j");
}

1.5、环境配置（environments）

Mybatis可以配置成适应多种环境

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

连接两个数据库，就需要创建两个 SqlSessionFactory 实例。

每个数据库对应一个 SqlSessionFactory 实例

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment);
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, properties);

如果忽略了环境参数，那么将会加载默认环境 .

<environments default="development">
  <environment id="development">
    <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>
</environments>

默认使用的环境 ID（比如：default=“development”）。
每个 environment 元素定义的环境 ID（比如：id=“development”）。
事务管理器的配置（比如：type=“JDBC”）。
数据源的配置（比如：type=“POOLED”）。

默认环境和环境 ID 顾名思义。环境可以随意命名，但务必保证默认的环境 ID 要匹配其中一个环境 ID。

1.6、其他配置

typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
databaseIdProvider（）

1.7、映射器（mappers）

MapperRegistry：注册绑定我们的Mapper文件

方式一：使用相对于类路S径的资源引用

<mappers>
    <mapper resource="cn/cgz/dao/UserMapper.xml"/>
</mappers>

方式二：使用映射器接口实现类的完全限定类名

<mappers>
    <mapper class="cn.cgz.dao.UserDao"/>
</mappers>

方式三：将包内的映射器接口实现全部注册为映射器

<mappers>
    <package name="cn.cgz.dao"/>
</mappers>

方式二和方式三有相同的注意点：

接口和它的Mapper配置文件必须同名！
接口和它的Mapper配置文件必须在同一个包下！

练习时间：

将数据库配置文件外部引入
实体类别名
保证UserMapper接口和UserMapper.xml改为一致！并且放在同一个包

2.作用域（Scope）和生命周期

不同作用域和生命周期类别是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder

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

SqlSessionFactory

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

SqlSession

连接到一个连接池的请求！
SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
用完之后赶紧关闭，否则资源被占用！

Mapper

Mapper 是一个接口，它由 SqlSession 所创建，所以它的最大生命周期至多和 SqlSession 保持一致
SqlSession 的关闭，它的数据库连接资源也会消失，所以它的生命周期应该小于等于 SqlSession 的生命周期
Mapper 代表的是一个请求中的业务处理，所以它应该在一个请求中，一旦处理完了相关的业务，就应该废弃它。

在这里插入图片描述