当前位置： 首页 > news >正文

Java - 日志体系_Apache Commons Logging（JCL）日志接口库

news 2024/12/28 12:14:47

文章目录

  • Apache Commons
    • Apache Commons Proper
    • 官网 Logging （Apache Commons Logging ）
  • 1. 什么是JCL？
  • 2. JCL的主要特点
  • 3. JCL的核心组件
  • 4. JCL的实现机制
  • 5. SimpleLog 简介
  • 6. Code
    • Example 1 ： 默认日志实现 (JCL 1.3.2版本)
    • Example 2 ： JCL (1.2版本） + Log4J 【安全风险高，请勿使用】
  • 7. 使用场景与优点
  • 8. 常见问题
  • 9. 动态绑定机制源码分析
    • getFactory
    • LogFactoryImpl
  • 10. 总结

在这里插入图片描述

Apache Commons

官网：Apache Commons

在这里插入图片描述

Apache Commons Proper

Commons Proper 致力于一个主要目标： 创建和维护可重用的 Java 组件。这 Commons Proper 是一个协作和共享的地方，其中 来自整个 Apache 社区的开发人员都可以 一起讨论由 Apache 项目共享的项目，以及 Apache 用户。

共享资源开发人员将努力确保他们的 组件对其他库的依赖性最小，因此 这些组件可以轻松部署。此外，共享资源 组件将尽可能保持其接口稳定，因此 Apache 用户（包括其他 Apache 项目）可以实现 这些组件。

在这里插入图片描述

组件描述最新 Maven 版本发布版本发布日期
BCEL字节码工程库 - 分析、创建和操作 Java 类文件6.10.06.10.02024-07-23
BeanUtilsJava 反射和 introspection API 的易用封装1.9.41.9.42019-08-13
BSFBean 脚本框架 - 提供对脚本语言的接口，包括 JSR-2233.13.12010-06-24
CLI命令行参数解析器1.9.01.9.02024-08-14
Codec通用的编码/解码算法（例如音标、base64、URL）1.17.11.17.12024-07-15
Collections扩展或增强 Java 集合框架4.5.0-M34.5.0-M32024-12-18
Compress定义用于处理 tar、zip 和 bzip2 文件的 API1.27.11.27.12024-08-20
Configuration用于读取各种格式的配置/偏好文件2.11.02.11.02024-06-10
Crypto一个针对 AES-NI 优化的加密库，包装了 OpenSSL 或 JCE 算法实现1.2.01.2.02023-01-23
CSV处理逗号分隔值文件的组件1.12.01.12.02024-09-25
Daemon为 Unix 守护进程般的 Java 代码提供替代调用机制1.3.41.3.42023-05-12
DBCP数据库连接池服务2.13.02.13.02024-12-02
DbUtilsJDBC 辅助库1.8.11.8.12023-09-14
DigesterXML 到 Java 对象的映射工具3.23.22011-12-13
Email用于从 Java 发送电子邮件的库2.0.0-M12.0.0-M12024-06-27
Exec用于处理外部进程执行和环境管理的 API1.4.01.4.02024-01-05
FileUpload为您的 servlets 和 Web 应用提供文件上传功能1.51.52023-12-27
FileUpload2为您的 servlets 和 Web 应用提供文件上传功能（版本 2）2.0.0-M12.0.0-M12023-07-19
Geometry空间和坐标处理1.01.02021-08-21
Imaging一个纯 Java 图像库（之前称为 Sanselan）1.0.0-alpha51.0.0-alpha52024-04-18
IO一组 I/O 工具类2.18.02.18.02024-11-19
JCIJava 编译器接口1.11.12013-10-14
JCSJava 缓存系统3.2.13.2.12024-05-27
Jelly基于 XML 的脚本和处理引擎1.0.11.0.12017-09-25
Jexl扩展 JSTL 表达式语言的表达式语言3.4.03.4.02024-06-05
JXPath使用 XPath 语法操作 Java Beans 的工具集1.31.32008-08-14
Lang为 java.lang 类提供额外的功能3.17.03.17.02024-08-29
Logging包装了多种日志 API 实现1.3.41.3.42024-08-19
Math轻量级、自包含的数学和统计学组件4.0-beta14.0-beta12022-12-20
Net一组网络工具类和协议实现3.11.13.11.12024-06-10
Numbers数字类型（复数、四元数、分数）和工具（数组、组合数学等）1.21.22024-08-12
Pool通用对象池组件2.12.02.12.02023-09-30
RDFRDF 1.1 的通用实现，可由 JVM 上的系统实现0.5.00.5.02017-12-23
RNG随机数生成器的实现1.61.62024-07-15
SCXMLSCXML 规范的实现，旨在创建和维护 Java SCXML 引擎0.90.92008-12-01
Statistics统计学工具1.11.12024-08-20
TextApache Commons Text 是一个专注于字符串操作的算法库1.13.01.13.02024-12-13
Validator用于在 XML 文件中定义验证器和验证规则的框架1.9.01.9.02024-05-28
VFS虚拟文件系统组件，用于将文件、FTP、SMB、ZIP 等视为一个逻辑文件系统2.9.02.9.02021-07-21
Weaver提供一种简单的方式来增强（织入）已编译的字节码2.02.02018-09-07

官网 Logging （Apache Commons Logging ）

https://commons.apache.org/proper/commons-logging/

组件描述最新 Maven 版本发布版本发布日期
Logging包装了多种日志 API 实现1.3.41.3.42024-08-19

在这里插入图片描述

1. 什么是JCL？

Apache Commons Logging（简称 JCL）是一个轻量级的日志接口库，提供了日志记录的抽象层。它允许开发人员编写独立于具体日志实现的代码，而具体的日志实现（如Log4j、SLF4J或java.util.logging）可以在运行时配置。这种设计简化了日志库的集成和切换。

2. JCL的主要特点

  • 灵活性：通过抽象层，可以自由选择日志实现。
  • 自动发现机制：运行时动态发现类路径中的可用日志实现。
  • 兼容性：支持主流日志框架，如Log4j、SLF4J和java.util.logging。
  • 简单易用：只需依赖commons-logging.jar，无需复杂配置。

3. JCL的核心组件

  • Log 接口
    提供通用的日志记录方法（如debug、info、warn、error、fatal）。

    Log log = LogFactory.getLog(YourClass.class);
log.info("信息日志");
log.error("错误日志");

  • LogFactory 类
    用于创建Log接口的实例。LogFactory实现了日志系统的自动发现和绑定。

4. JCL的实现机制

JCL使用自动发现机制选择合适的日志实现：

  1. 首先检查类路径中是否存在Log4j，如果存在则使用Log4j (高版本的JCL已经移除了对log4j的支持)
  2. 如果找不到Log4j，JCL会检查java.util.logging并使用它。
  3. 如果前两个都不可用，则使用内置的SimpleLog作为默认实现。

可以通过配置文件commons-logging.properties显式指定日志实现。例如：

org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger

5. SimpleLog 简介

JCL内置的SimpleLog是一个轻量级实现，适用于没有复杂日志需求的小型项目。
它通过系统属性进行配置，例如：

  • org.apache.commons.logging.simplelog.defaultlog：设置默认日志级别。
  • org.apache.commons.logging.simplelog.showdatetime：是否显示日期时间。

6. Code

POM

  <dependency><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId><version>1.3.2</version></dependency>

Example 1 ： 默认日志实现 (JCL 1.3.2版本)

package com.artisan.jcl;import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;public class JavaCommonsLoggingTest {private static final Log log = LogFactory.getLog(JavaCommonsLoggingTest.class);public static void main(String[] args) {log.info("这是信息日志");log.warn("这是警告日志");log.error("这是错误日志");}
}

在这里插入图片描述

Example 2 ： JCL (1.2版本） + Log4J 【安全风险高，请勿使用】

log4j1从2005年11月更新到2012年3月， 最新的依赖(May 26, 2012)

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

2015年8月5日，项目管理委员会宣布Log4j 1.x已End Of Life 。建议用户使用Log4j 1升级到Apache Log4j 2

在这里插入图片描述
为了演示这种组合，我们将JCL降级到1.2版本

pom

   <!-- Jakarta Commons Logging --><dependency><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId><version>1.2</version></dependency><!-- Log4j 核心依赖 --><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version></dependency>

log4j.properties

# 设置根日志记录器的日志级别为 DEBUG，并将其输出到控制台和文件
log4j.rootLogger=DEBUG, console, file# 配置控制台输出
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n# 可选：配置日志文件滚动
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=application.log
log4j.appender.file.MaxFileSize=10MB
log4j.appender.file.MaxBackupIndex=10
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n# 可选：配置特定包的日志级别
log4j.logger.com.artisan=DEBUG

Code

package com.artisan.jcl;import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;public class JavaCommonsLoggingTest {private static final Log logger = LogFactory.getLog(JavaCommonsLoggingTest.class);public static void main(String[] args) {logger.trace("This is a trace message");logger.debug("This is a debug message");logger.info("This is an info message");logger.warn("This is a warning message");logger.error("This is an error message");logger.fatal("This is a fatal message");}
}

输出

在这里插入图片描述

7. 使用场景与优点

  • 适用于需要在多个日志框架之间切换的场景。
  • 提供了对遗留系统的支持，使其能够与现代日志框架协同工作。
  • 适合中间件开发，避免直接绑定特定的日志框架。

8. 常见问题

  • 为什么不直接使用SLF4J？
    JCL比SLF4J更早出现，仍被许多遗留系统使用。如果是全新项目，建议考虑SLF4J，它解决了JCL的一些局限性。

  • 性能是否有损耗？
    JCL的动态绑定机制在启动时可能略有开销，但运行时性能与直接使用日志实现接近。

9. 动态绑定机制源码分析

让我们以LogFactory.getLog(JavaCommonsLoggingTest.class) 为切入口 ，

  /*** 获取指定类的日志记录器实例* * @param clazz 要获取日志记录器的类* @return 指定类的日志记录器实例* @throws LogConfigurationException 如果日志配置存在错误，则抛出此异常*/
public static Log getLog(final Class<?> clazz) throws LogConfigurationException {// 调用日志工厂的实例方法获取日志记录器return getFactory().getInstance(clazz);
}
成功
失败
开始
获取 LogFactory 实例
通过 LogFactory 获取日志记录器
返回日志记录器
抛出 LogConfigurationException

getFactory

重点看下： getFactory()

主要功能是根据一系列优先级规则查找并返回一个 LogFactory 实例。

  1. 获取类加载器：首先获取当前线程的上下文类加载器。
  2. 检查缓存：如果该类加载器已经有一个对应的 LogFactory 实例，则直接返回该实例。
  3. 加载配置文件：尝试从 commons-logging.properties 文件中读取配置信息。
  4. 确定是否使用TCCL：根据配置文件中的 use_tccl 属性决定是否使用线程上下文类加载器。
  5. 查找实现类：
    • 首先尝试通过系统属性 org.apache.commons.logging.LogFactory 查找。
    • 如果未找到，尝试使用 JDK 1.3 的服务发现机制。
    • 如果仍未找到，尝试从配置文件中查找。
    • 最后，尝试使用默认的实现类 org.apache.commons.logging.impl.LogFactoryImpl。
  6. 创建并缓存实例：创建 LogFactory 实例并将其缓存。
成功
命中
未命中
开始
获取类加载器
检查缓存
返回缓存实例
加载配置文件
确定是否使用TCCL
查找实现类
系统属性查找
服务发现机制查找
配置文件查找
默认实现类
创建并缓存实例
返回实例

假设： 没有org.apache.commons.logging.LogFactory 这个系统配置项，classpath下没有包含META-INF/services/org.apache.commons.logging.LogFactory 这个文件的Jar包、没有commons-logging.properties 文件，只有commons-logging这个jar

LogFactoryImpl

我们来看下 LogFactoryImpl ，

	    /** Log4JLogger class name */private static final String LOGGING_IMPL_LOG4J_LOGGER = "org.apache.commons.logging.impl.Log4JLogger";/** Jdk14Logger class name */private static final String LOGGING_IMPL_JDK14_LOGGER = "org.apache.commons.logging.impl.Jdk14Logger";/** Jdk13LumberjackLogger class name */private static final String LOGGING_IMPL_LUMBERJACK_LOGGER ="org.apache.commons.logging.impl.Jdk13LumberjackLogger";/** SimpleLog class name */private static final String LOGGING_IMPL_SIMPLE_LOGGER = "org.apache.commons.logging.impl.SimpleLog";private static final String[] classesToDiscover = {LOGGING_IMPL_JDK14_LOGGER,LOGGING_IMPL_SIMPLE_LOGGER};

可知： 默认实现为

 LOGGING_IMPL_JDK14_LOGGER org.apache.commons.logging.impl.Jdk14Logger

log4j 不再是默认实现

在这里插入图片描述

commons-logging的动态绑定机制实现如上，但是这种机制的问题在哪儿呢，由于它使用了ClassLoader寻找和载入底层的日志库， 导致了象OSGI这样的框架无法正常工作，因为OSGI的不同的插件使用自己的ClassLoader。 OSGI的这种机制保证了插件互相独立，然而却使Apache Common-Logging无法工作 。 所以就有了Slf4j这种静态绑定的方案。

10. 总结

JCL为日志记录提供了一种统一的接口，虽然不如SLF4J现代化，但在历史遗留系统中仍有广泛的使用价值。如果需要简化日志实现的切换，JCL是一个可靠的选择。

在这里插入图片描述


http://www.mrgr.cn/news/81730.html

相关文章：

  • 【原理图专题】CIS库中有两部分组成的器件怎么查看符号库
  • 拼多多纠偏，能否实现买卖平权？
  • 数据库保留最新的n条记录，一波三折的日志清理需求实现
  • 操作002：HelloWorld
  • table 表格转成 excell 导出
  • 每日一练 | DHCP 报文交互方向
  • sqlserver 数据库误删-用mdf和ldf文件恢复
  • C# 窗体应用程序嵌套web网页（基于谷歌浏览器内核）
  • 获取页面上所有的img，并保存到本地
  • 3.微服务灰度发布落地实践(组件灰度增强)
  • CY系统环境部署说明
  • 工作流审批流程的一些概念
  • 广义线性模型（GLM）全面解析
  • Ribbon、Nacos
  • 「matplotlib」绘制图线和数据点的样式风格和颜色表大全
  • 适配器模式概述
  • Linux应用软件编程-多任务处理（线程）
  • 119.【C语言】数据结构之快速排序(调用库函数)
  • 工厂+策略模式之最佳实践（疾病报卡维护模块API设计）
  • Java编程规约
  • C++线程、并发、并行
  • 【Leetcode 热题 100】46. 全排列
  • 雷电模拟器安装LSPosed
  • 强化学习基础之贝尔曼期望方程
  • -0.4375 IEEE754表示
  • Python+Django 技术实现自动化漏洞扫描系统开发