（四）Mybatis 日志（详解）

前言

前面我们介绍了 Mybatis 的一些基本代码编写，配置，增删改查，设置等内容，下面将对日志进行简单介绍。

日志

MyBatis 是一个流行的 Java 持久层框架，它提供了一种简单的方式来访问关系型数据库。MyBatis 具有自己的日志系统，可以用来记录执行 SQL 语句、参数和结果等信息，方便开发者进行调试和优化。

在我们使用 MyBatis 编程过程中，如果一个数据库操作，出现了异常，我们需要排错，日志就是最好的工具。

MyBatis 的日志分为四个等级：TRACE、DEBUG、INFO 和 ERROR，可以通过配置文件来设置日志级别。

日志工厂

Mybatis 的 setting 中给出了很多日志设置，比如 logImpl ：指定 MyBatis 所用日志的具体实现，未指定时将自动查找。

SLF4J
LOG4J			
LOG4J2			 // 【LOG4J plus版】
JDK_LOGGING 	 // 【Java自带的日志输出】
COMMONS_LOGGING	 
STDOUT_LOGGING	 // 【控制台输出】
NO_LOGGING		 // 【没有日志输出】

这里只简单了解下 LOG4J和 STDOUT_LOGGING；

STDOUT_LOGGING

• 控制台输出日志，xml文件配置，如下第9—12行：

DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    
    <properties resource="db.properties"/>

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

    <typeAliases>
        <typeAlias alias="User" type="com.hb.pojo.User"/>
    typeAliases>
    
    <environments default="development">
        <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>
    environments>

    <mappers>
        <mapper class="com.hb.dao.UserMapper"/>
    mappers>
configuration>

• 重新运行getUserByIdTest()，看输出结果如下：

LOG4J

什么是LOG4J

Log4j 是 Apache 的一个开源项目，通过使用 Log4j ，我们可以控制日志信息输送的目的地是控制台、文件、GUI 组件，甚至是套接口服务器、NT的事件记录器、UNIX、Syslog守护进程等；我们也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。 ——摘自百度百科：LOG4J

LOG4J 的使用

• 导入 log4j-1.2.8.jar (可以选择 log4j 的更高版本)到 lib 下。如果使用 maven 项目，也可以选择在 pom.xml 中导入依赖。（Maven repository官网）

<dependency>
    <groupId>log4jgroupId>
    <artifactId>log4jartifactId>
    <version>1.2.17version>
dependency>

• 在 CLASSPATH 下建立 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/kuang.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

• 配置 log4j 为日志的实现：

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

• 运行测试类，查看控制台输出：

测试使用：

1、在要使用 LOG4J 的类中，导入包 import org.apache.log4j.Logger;

2、生成一个静态的日志对象，参数为当前类的 class；

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

3、编写测试类，如下：

public class UserMapperTest {
    static Logger logger = Logger.getLogger(UserMapperTest.class);
    @Test
    public void log4jTest(){
        logger.info("info：进入了log4jTest");
        logger.debug("debug：进入了log4jTest");
        logger.error("error：进入了log4jTest");
    }
}

4、由于在 properties 配置文件下，log4j.appender.file.File=./log/hb.log，配置了当前文件目录下生成 log 文件。打开 log 文件，如下：

也可以在，我么们之前的测试类中加入所要输出的 log 日志信息，类似如下：

这就是 MyBatis 的日志功能，MyBatis 的日志功能非常强大，可以帮助开发者快速定位问题并进行优化。在实际开发中，可以根据需要进行配置和调整。