Java日志框架 -- JCL日志门面（JCL概念介绍JCL示例）

Posted 2022-06-13 CodeJiao

1. JCL

全称为Jakarta Commons Logging，是Apache提供的一个通用日志API。是日志门面的一种实现方式，另外一种日志门面的实现方式是Slf4j。

它是为 "所有的Java日志实现"提供一个统一的接口，它自身也提供一个日志的实现，但是功能非常弱（SimpleLog）。所以一般不会单独使用它。他允许开发人员使用不同的具体日志实现工具: Log4j、Jdk自带的日志（JUL)。

JCL 有两个基本的抽象类：

• Log（基本记录器）
• LogFactory（负责创建Log实例，通过LogFactory动态加载Log实现类）。

---

1.1 JCL示例代码

首先创建一个普通的Maven工程：

然后导入相关的依赖：

    <dependencies>
        <!--        单元测试依赖-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
        <!--        JCL-->
        <dependency>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
            <version>1.2</version>
        </dependency>
    </dependencies>

示例代码：

JCLTest.java

package com.tian.logs;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.junit.Test;

public class JCLTest 

    @Test
    public void testQuick() throws Exception 
        // 获取 log日志记录器对象
        Log log = LogFactory.getLog(JCLTest.class);
        // 日志记录输出
        log.info("hello jcl");
    

运行结果（默认使用 JUL 实现）：

现在引入 Log4j 的依赖：

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

再次运行刚刚的代码：

现在我们创建Log4j的配置文件：

log4j.properties

# 指定 RootLogger 顶级父元素默认配置信息
# 指定日志级别=trace，使用的 appenderw 为=console
log4j.rootLogger=trace,console
# 指定控制台日志输出的 appender
log4j.appender.console=org.apache.log4j.ConsoleAppender
# 指定消息格式 layout
log4j.appender.console.layout=org.apache.log4j.PatternLayout
# 指定消息格式的内容
log4j.appender.console.layout.conversionPattern=[%-10p]%r  %l %dyyyy-MM-dd HH:mm:ss.SSS %m%n

再次运行上面的测试代码：

---

1.2 使用日志门面的好处

1. 面向接口开发，不再依赖具体的实现类。减少代码的耦合
2. 项目通过导入不同的日志实现类，可以灵活的切换日志框架
3. 统一API，方便开发者学习和使用
4. 统一配置便于项目日志的管理

---

---