文章目录

• 一、JUL简介
• 二、JUL组件介绍
• 三、代码实例
• • 1、入门案例
  • 2、日志级别
  • • （1）默认日志级别源码分析
  • 3、自定义日志级别
  • 4、将日志输出到文件中
  • 5、Logger的父子关系
  • • （1）父子关系源码分析
  • 6、使用配置文件
  • • （1）默认配置文件位置
    • （2）默认配置文件（去掉注释）
    • （3）配置文件解析
    • （4）自定义读取配置文件
    • （5）自定义日志配置文件
• 四、总结

一、JUL简介

JUL全称 Java Util Logging，核心类在java.util.logging包下，它是java原生的日志框架，使用时不需要另外引用第三方的类库，相对其他的框架使用方便，学习简单，主要是使用在小型应用中。

二、JUL组件介绍

Logger：被称为记录器，应用程序通过获取Logger对象，调用其API来发布日志信息。Logger通常被认为是访问日志系统的入口程序。

Handler：处理器，每个Logger都会关联一个或者是一组Handler，Logger会将日志交给关联的Handler去做处理，由Handler负责将日志做记录。Handler具体实现了日志的输出位置，比如可以输出到控制台或者是文件中等等。

Filter：过滤器，根据需要定制哪些信息会被记录，哪些信息会被略过。

Formatter：格式化组件，它负责对日志中的数据和信息进行转换和格式化，所以它决定了我们输出日志最终的形式。

Level：日志的输出级别，每条日志消息都有一个关联的级别。我们根据输出级别的设置，用来展现最终所呈现的日志信息。根据不同的需求，去设置不同的级别。

三、代码实例

本文使用的类，都是java.util.logging包下的类。

1、入门案例

// 入门案例
public static void test01() {// Logger创建方式，参数为当前类全路径字符串com.demo.logger.jul.JULTestLogger logger = Logger.getLogger(JULTest.class.getCanonicalName());/*第一种方式：直接调用日志级别相关的方法，方法中传递日志输出信息假设现在我们要输出info级别的日志信息*/logger.info("输出info信息");/*输出内容：三月 20, 2023 9:09:38 下午 com.demo.logger.jul.JULTest test01信息: 输出info信息*//*第二种方式：调用通用的log方法，然后在里面通过level类型来定义日志的级别参数，以及搭配日志输出信息的参数*/logger.log(Level.WARNING, "输出warning信息");/*输出内容：三月 20, 2023 9:14:09 下午 com.demo.logger.jul.JULTest test01警告: 输出warning信息*/// 动态输出数据，生产日志，使用占位符的方式进行操作String name = "zhangsan";int age = 23;// logger.log(Level.INFO, "姓名：" + name + "年龄：" + age);logger.log(Level.INFO, "姓名：{0}年龄：{1}", new Object[]{name, age});/*{0}和 {1}分别代表第一个占位符和第二个占位符，同时传递一个数组，代表参数的集合输出内容：三月 20, 2023 9:18:16 下午 com.demo.logger.jul.JULTest test01信息: 姓名：zhangsan年龄：23*/
}

2、日志级别

// 日志级别
public static void test02() {/*日志的级别，总共七级Level.SEVERE：（最高级）错误Level.WARNING：警告Level.INFO：（默认级别）消息Level.CONFIG：配置级别Level.FINE：详细信息（少）Level.FINER：详细信息（中）Level.FINEST：（最低级）详细信息（多）两个特殊的级别：Level.OFF；可用来关闭日志记录Level.ALL：启用所有日志记录对于日志的级别，我们重点关注的是new对象时第二个参数，是一个数值：public static final Level OFF = new Level("OFF",Integer.MAX_VALUE, defaultBundle);public static final Level SEVERE = new Level("SEVERE",1000, defaultBundle);public static final Level WARNING = new Level("WARNING", 900, defaultBundle);public static final Level INFO = new Level("INFO", 800, defaultBundle);public static final Level CONFIG = new Level("CONFIG", 700, defaultBundle);public static final Level FINE = new Level("FINE", 500, defaultBundle);public static final Level FINER = new Level("FINER", 400, defaultBundle);public static final Level FINEST = new Level("FINEST", 300, defaultBundle);public static final Level ALL = new Level("ALL", Integer.MIN_VALUE, defaultBundle);这个数值的意义在于：如果我们设置的日志级别是800，那么最终展现的日志信息，比如是数值大于800的所有日志信息。*/Logger logger = Logger.getLogger(JULTest.class.getCanonicalName());logger.severe("severe信息");logger.warning("warning信息");logger.info("info信息");logger.config("config信息");logger.fine("fine信息");logger.finer("finer信息");logger.finest("finest信息");/*输出内容：我们看到，默认是输出info及比info信息级别高的信息三月 20, 2023 9:47:27 下午 com.demo.logger.jul.JULTest test02严重: severe信息三月 20, 2023 9:47:27 下午 com.demo.logger.jul.JULTest test02警告: warning信息三月 20, 2023 9:47:27 下午 com.demo.logger.jul.JULTest test02信息: info信息*/
}

（1）默认日志级别源码分析

我们进入Logger的getLogger方法：

// java.util.logging.Logger#getLogger(java.lang.String)
@CallerSensitive
public static Logger getLogger(String name) {// This method is intentionally not a wrapper around a call// to getLogger(name, resourceBundleName). If it were then// this sequence:////     getLogger("Foo", "resourceBundleForFoo");//     getLogger("Foo");//// would throw an IllegalArgumentException in the second call// because the wrapper would result in an attempt to replace// the existing "resourceBundleForFoo" with null.return demandLogger(name, null, Reflection.getCallerClass());
}// java.util.logging.Logger#demandLogger
private static Logger demandLogger(String name, String resourceBundleName, Class caller) {LogManager manager = LogManager.getLogManager(); // 获取LogManagerSecurityManager sm = System.getSecurityManager();if (sm != null && !SystemLoggerHelper.disableCallerCheck) {if (caller.getClassLoader() == null) {return manager.demandSystemLogger(name, resourceBundleName);}}return manager.demandLogger(name, resourceBundleName, caller);// ends up calling new Logger(name, resourceBundleName, caller)// iff the logger doesn't exist already
}

在初始化LogManager时，初始化了默认的日志级别为Level.INFO：

// java.util.logging.LogManager#ensureLogManagerInitialized
final void ensureLogManagerInitialized() {final LogManager owner = this;if (initializationDone || owner != manager) {// we don't want to do this twice, and we don't want to do// this on private manager instances.return;}// Maybe another thread has called ensureLogManagerInitialized()// before us and is still executing it. If so we will block until// the log manager has finished initialized, then acquire the monitor,// notice that initializationDone is now true and return.// Otherwise - we have come here first! We will acquire the monitor,// see that initializationDone is still false, and perform the// initialization.//synchronized(this) {// If initializedCalled is true it means that we're already in// the process of initializing the LogManager in this thread.// There has been a recursive call to ensureLogManagerInitialized().final boolean isRecursiveInitialization = (initializedCalled == true);assert initializedCalled || !initializationDone: "Initialization can't be done if initialized has not been called!";if (isRecursiveInitialization || initializationDone) {// If isRecursiveInitialization is true it means that we're// already in the process of initializing the LogManager in// this thread. There has been a recursive call to// ensureLogManagerInitialized(). We should not proceed as// it would lead to infinite recursion.//// If initializationDone is true then it means the manager// has finished initializing; just return: we're done.return;}// Calling addLogger below will in turn call requiresDefaultLogger()// which will call ensureLogManagerInitialized().// We use initializedCalled to break the recursion.initializedCalled = true;try {AccessController.doPrivileged(new PrivilegedAction