查看“JUL”的源代码

https://www.bilibili.com/video/BV1iJ411H74S/?p=4

JUL 全称 Java Util Logging，是 Java 原生的日志框架，使用时不需要另外引用第三方类库，相对其他日志框架使用方便，学习简单，能够在小型应用中灵活使用。

=== JUL 入门 ===


==== 架构介绍 ====
[[文件:JUL架构图示.png|无|缩略图|813x813像素]]

* Loggers：被称为记录器，应用程序通过获取 Logger 对象，调用其 API 来发布日志消息。Logger 通常是应用程序访问日志系统的入口程序。
* Appenders：也被称为 Handlers，每个 Logger 都会关联一组 Handlers，Logger 会将日志交给关联 Handlers 处理，由 Handlers 负责将日志做记录。Handlers 在此是一个抽象，其具体的实现决定了日志记录的位置可以是控制台、文件、网络上的其他日志服务或操作系统日志等。
* Layouts：也被称为 Formatters，它负责对日志事件中的数据进行转换和格式化。Layouts 决定了数据在一条日志记录中的最终形式。
* Level：每条日志消息都有一个关联的日志级别。该级别粗略指导了日志消息的重要性和紧迫，可以将 Level 和 Loggers，Appenders 做关联以便于我们过滤消息。
* Filters：过滤器，根据需要定制哪些信息会被记录，哪些信息会被放过。
总结一下就是：

用户使用 Logger 来进行日志记录，Logger 持有若干个 Handler，日志的输出操作是由 Handler 完成的。

Handler 在输出日志前，会经过 Filter 的过滤，判断哪些日志级别过滤放行、哪些拦截，

Handler 会将日志内容输出到指定位置（日志文件、控制台等）。

Handler 在输出日志时会使用 Layout，对输出内容进行排版。




==== 入门案例 ====
<syntaxhighlight lang="java">
package io.github.jihch.log;

import org.junit.Test;

import java.util.logging.Level;
import java.util.logging.Logger;

public class JULTest {

    @Test
    public void testQuick() {

        //1、创建日志记录器对象
        Logger logger = Logger.getLogger("io.github.jihch.log.JULTest");

        //2、日志记录输出
        logger.info("hello jul");

        logger.log(Level.INFO, "info msg");

        String name = "jack";

        Integer age = 18;

        logger.log(Level.INFO, "用户信息：{0}，{1}", new Object[]{name, age});

    }

}

</syntaxhighlight><syntaxhighlight lang="console">
二月 21, 2023 8:33:03 下午 io.github.jihch.JULTest testQuick
信息: hello jul
二月 21, 2023 8:33:03 下午 io.github.jihch.JULTest testQuick
信息: info msg
二月 21, 2023 8:33:03 下午 io.github.jihch.JULTest testQuick
信息: 用户信息：jack，18
</syntaxhighlight>



https://www.bilibili.com/video/BV1iJ411H74S?p=5
==== 日志级别 ====
{| class="wikitable"
|Integer.MAX_VALUE
|OFF
|关闭日志
|-
|1000
|SEVERE
|十分严重
|-
|900
|WARNING
|警告
|-
|800
|INFO
|信息
|-
|700
|CONFIG
|配置信息
|-
|500
|FINE
|跟踪信息
|-
|400
|FINER
|跟踪信息
|-
|300
|FINEST
|跟踪信息
|-
|Integer.MIN_VALUE
|ALL
|记录所有日志
|}
可以为每个 logger 对象设置一个日志级别，每个级别都对应一个 int 值，大于等于这个值的日志就会被记录，小于这个值的日志就不会被记录
比如在一个类中，JULTest 中设置 logger 对象的日志级别是 OFF：<syntaxhighlight lang="java">
    public void testQuick() {

        //1、创建日志记录器对象
        Logger logger = Logger.getLogger("io.github.jihch.JULTest");

        logger.setLevel(Level.OFF);

        //2、日志记录输出
        logger.info("hello jul");

        // 通用方法进行日志记录
        logger.log(Level.INFO, "info msg");


        // 通过占位符 方式输出变量值
        String name = "jack";
        Integer age = 18;
        logger.log(Level.INFO, "用户信息：{0}，{1}", new Object[]{name, age});

    }
</syntaxhighlight>
运行程序发现控制台没有日志记录输出





==== 测试默认日志级别 ====
<syntaxhighlight lang="java">
    // 日志级别
    @Test
    public void testLogLevel() {
        //1、获取日志记录器对象
        Logger logger = Logger.getLogger("io.github.jihch.JULTest");

        //2、日志记录输出
        logger.severe("severe");
        logger.warning("warning");
        logger.info("info");
        logger.config("config");
        logger.fine("fine");
        logger.finer("finer");
        logger.finest("finest");

    }
</syntaxhighlight><syntaxhighlight lang="console">
二月 21, 2023 8:40:42 下午 io.github.jihch.JULTest testLogLevel
严重: severe
二月 21, 2023 8:40:42 下午 io.github.jihch.JULTest testLogLevel
警告: warning
二月 21, 2023 8:40:42 下午 io.github.jihch.JULTest testLogLevel
信息: info
</syntaxhighlight>

说明 JUL 默认的日志级别是 info




https://www.bilibili.com/video/BV1iJ411H74S?p=6

==== 硬编码配置 ====

===== 尝试1 =====
<syntaxhighlight lang="java">
    // 日志级别
    @Test
    public void testLogConfig() {
        //1、获取日志记录器对象
        Logger logger = Logger.getLogger("io.github.jihch.JULTest");

        // 关闭系统默认配置
        logger.setUseParentHandlers(false);

        // 创建 ConsolHandler
        ConsoleHandler consoleHandler = new ConsoleHandler();

        // 创建简单格式
        SimpleFormatter simpleFormatter = new SimpleFormatter();

        // 进行关联
        consoleHandler.setFormatter(simpleFormatter);
        logger.addHandler(consoleHandler);

        // 配置日志具体级别
        logger.setLevel(Level.ALL);
        consoleHandler.setLevel(Level.ALL);

        //2、日志记录输出
        logger.severe("severe");
        logger.warning("warning");
        logger.info("info");
        logger.config("config");
        logger.fine("fine");
        logger.finer("finer");
        logger.finest("finest");

    }
</syntaxhighlight><syntaxhighlight lang="console">
二月 21, 2023 8:55:14 下午 io.github.jihch.JULTest testLogConfig
严重: severe
二月 21, 2023 8:55:14 下午 io.github.jihch.JULTest testLogConfig
警告: warning
二月 21, 2023 8:55:14 下午 io.github.jihch.JULTest testLogConfig
信息: info
二月 21, 2023 8:55:14 下午 io.github.jihch.JULTest testLogConfig
配置: config
二月 21, 2023 8:55:14 下午 io.github.jihch.JULTest testLogConfig
详细: fine
二月 21, 2023 8:55:14 下午 io.github.jihch.JULTest testLogConfig
较详细: finer
二月 21, 2023 8:55:14 下午 io.github.jihch.JULTest testLogConfig
非常详细: finest
</syntaxhighlight>





===== 尝试2 =====
<syntaxhighlight lang="java">
    // 日志级别
    @Test
    public void testLogConfig() throws IOException {
        //1、获取日志记录器对象
        Logger logger = Logger.getLogger("io.github.jihch.JULTest");

        // 关闭系统默认配置
        logger.setUseParentHandlers(false);

        // 创建 ConsolHandler 控制台输出
        ConsoleHandler consoleHandler = new ConsoleHandler();

        // 创建简单格式
        SimpleFormatter simpleFormatter = new SimpleFormatter();

        // 进行关联
        consoleHandler.setFormatter(simpleFormatter);
        logger.addHandler(consoleHandler);

        // 配置日志具体级别
        logger.setLevel(Level.ALL);
        consoleHandler.setLevel(Level.ALL);

        // 场景 FileHandler 文件输出
        FileHandler fileHandler = new FileHandler("E:\\record\\2023\\2\\21\\jul.log");

        // 进行关联
        fileHandler.setFormatter(simpleFormatter);
        logger.addHandler(fileHandler);


        //2、日志记录输出
        logger.severe("severe");
        logger.warning("warning");
        logger.info("info");
        logger.config("config");
        logger.fine("fine");
        logger.finer("finer");
        logger.finest("finest");

    }
</syntaxhighlight>console：<syntaxhighlight lang="console">
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
严重: severe
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
警告: warning
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
信息: info
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
配置: config
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
详细: fine
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
较详细: finer
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
非常详细: finest
</syntaxhighlight>"E:\record\2023\2\21\jul.log"<syntaxhighlight lang="console">
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
严重: severe
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
警告: warning
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
信息: info
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
配置: config
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
详细: fine
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
较详细: finer
二月 21, 2023 9:06:53 下午 io.github.jihch.JULTest testLogConfig
非常详细: finest

</syntaxhighlight>





https://www.bilibili.com/video/BV1iJ411H74S?p=7

==== Logger 对象父子关系 ====
<syntaxhighlight lang="java">
    // Logger 对象父子关系
    @Test
    public void testLogParent() {
        Logger logger1 = Logger.getLogger("io.github.jihch");
        Logger logger2 = Logger.getLogger("io.github");

        // 测试
        System.out.println(logger1.getParent() == logger2);

        // 所有日志记录器的顶级父元素 LogManager$RootLogger，name ""
        System.out.printf("logger2.getParent():%s, logger2.getParent().getName():%s\n", logger2.getParent(),
                logger2.getParent().getName());

        // 关闭默认配置
        logger2.setUseParentHandlers(false);

        // 创建 ConsolHandler 控制台输出
        ConsoleHandler consoleHandler = new ConsoleHandler();

        // 创建简单格式
        SimpleFormatter simpleFormatter = new SimpleFormatter();

        // 进行关联
        consoleHandler.setFormatter(simpleFormatter);
        logger2.addHandler(consoleHandler);

        // 配置日志具体级别
        logger2.setLevel(Level.ALL);
        consoleHandler.setLevel(Level.ALL);

        logger1.severe("severe");
        logger1.warning("warning");
        logger1.info("info");
        logger1.config("config");
        logger1.fine("fine");
        logger1.finer("finer");
        logger1.finest("finest");
    }
</syntaxhighlight>子包默认继承父包；

不写默认继承 RootLogger

RootLogger 有默认的 Handler 和 Formatter





=== JUL 配置文件入门 ===
https://www.bilibili.com/video/BV1iJ411H74S?p=8

默认配置文件调用

Logger.getLogger(String name) -> 

Logger.demandLogger(String name, String resourceBundleName, Class<?> caller) ->

LogManager.getLogManager() ->

manager.ensureLogManagerInitialized() ->

owner.readPrimordialConfiguration()->

readConfiguration()->

f = new File(f, "logging.properties")

I:\Java\jdk1.8.0_101\jre\lib\logging.properties





==== 加载自定义配置文件 ====
logging.properties<syntaxhighlight lang="properties">
handlers= java.util.logging.ConsoleHandler


.level= ALL



# default file output is in user's home directory.
java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

# Limit the message that are printed on the console to INFO and above.
java.util.logging.ConsoleHandler.level = ALL
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
</syntaxhighlight>JULTest.java<syntaxhighlight lang="java">
    //加载自定义配置文件
    @Test
    public void test01() throws IOException {
        // 读取配置文件，通过类加载器
        InputStream resourceAsStream = JULTest.class.getClassLoader().getResourceAsStream("logging.properties");
        // 创建 LogManager
        LogManager logManager = LogManager.getLogManager();
        // 通过 LogManager 加载配置文件
        logManager.readConfiguration(resourceAsStream);

        // 创建日志记录器
        Logger logger = Logger.getLogger("io.github.jihch");

        logger.severe("severe");
        logger.warning("warning");
        logger.info("info");
        logger.config("config");
        logger.fine("fine");
        logger.finer("finer");
        logger.finest("finest");
    }
</syntaxhighlight><syntaxhighlight lang="console">
二月 23, 2023 8:58:36 上午 io.github.jihch.JULTest test01
严重: severe
二月 23, 2023 8:58:36 上午 io.github.jihch.JULTest test01
警告: warning
二月 23, 2023 8:58:36 上午 io.github.jihch.JULTest test01
信息: info
二月 23, 2023 8:58:36 上午 io.github.jihch.JULTest test01
配置: config
二月 23, 2023 8:58:36 上午 io.github.jihch.JULTest test01
详细: fine
二月 23, 2023 8:58:36 上午 io.github.jihch.JULTest test01
较详细: finer
二月 23, 2023 8:58:36 上午 io.github.jihch.JULTest test01
非常详细: finest
</syntaxhighlight>




==== 添加 Handler ====
logging.properties<syntaxhighlight lang="properties">
handlers= java.util.logging.ConsoleHandler,java.util.logging.FileHandler


.level= ALL



# default file output is in user's home directory.
java.util.logging.FileHandler.pattern = java%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

# Limit the message that are printed on the console to INFO and above.
java.util.logging.ConsoleHandler.level = ALL
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
</syntaxhighlight>这样将在项目根目录下增加日志文件的输出

关键点是在 handlers 后面追加了下面的 FileHandler





=== JUL 配置文件详解 ===
https://www.bilibili.com/video/BV1iJ411H74S?p=9

==== logging.properties ====
<syntaxhighlight lang="properties">
# RootLogger 顶级父元素指定的默认处理器为：ConsoleHandler
handlers= java.util.logging.FileHandler

# RootLogger 顶级父元素指定的默认日志级别为：ALL
.level= ALL



# 向日志文件输出的 Handler 对象
# 指定日志文件路径 java%u.log
java.util.logging.FileHandler.pattern = java%u.log
# 指定日志文件内容大小为 50000 条
java.util.logging.FileHandler.limit = 50000
# 指定日志文件数量
java.util.logging.FileHandler.count = 1
# 指定 Handler 对象日志消息格式对象
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter




# 向控制台输出的 Handler 对象
# 指定 Handler 对象的日志级别
java.util.logging.ConsoleHandler.level = ALL
# 指定 Handler 对象的日志消息格式对象
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
# 指定 Handler 对象的字符集
java.util.logging.ConsoleHandler.encoding = UTF-8

# 指定日志消息格式
java.util.logging.SimpleFormatter.format = %4$s: %5$s [%1$tc]%n
</syntaxhighlight>




==== 更换向日志文件输出的 Handler 对象对应的日志消息格式对象 ====
<syntaxhighlight lang="properties">
# 指定 Handler 对象日志消息格式对象
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter
</syntaxhighlight>java0.log<syntaxhighlight lang="console">
严重: severe [星期四 二月 23 09:30:36 CST 2023]
警告: warning [星期四 二月 23 09:30:37 CST 2023]
信息: info [星期四 二月 23 09:30:37 CST 2023]
配置: config [星期四 二月 23 09:30:37 CST 2023]
详细: fine [星期四 二月 23 09:30:37 CST 2023]
较详细: finer [星期四 二月 23 09:30:37 CST 2023]
非常详细: finest [星期四 二月 23 09:30:37 CST 2023]
</syntaxhighlight>





==== 指定以追加方式添加日志内容 ====
<syntaxhighlight lang="properties">
java.util.logging.FileHandler.append = true
</syntaxhighlight>