JUL

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

  

  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,将输出内容进行排版。
入门案例:

  1.创建工程,引入依赖

<dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

  2.测试

public class JULTest {

    @Test
    public void test01() {
        // 1.获取日志记录器对象
        Logger logger = Logger.getLogger("pers.fgy.JULTest");
        // 2.日志记录输出
        logger.info("hello jul");

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

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

日志的级别:

  jul中定义的日志级别

    java.util.logging.Level中定义了日志的级别:
      SEVERE(最高值)
      WARNING  警告信息
      INFO (默认级别)
      CONFIG  配置信息
      FINE  debug级别信息,信息颗粒度最小
      FINER  debug级别信息
      FINEST(最低值)debug级别信息,信息颗粒度最大
    还有两个特殊的级别:
      OFF,可用来关闭日志记录。
      ALL,启用所有消息的日志记录。

@Test
public void testLogLevel() {
    // 1.获取日志对象
    Logger logger = Logger.getLogger("pers.fgy.JULTest");
    // 2.日志记录输出
    logger.severe("severe");
    logger.warning("warning");
    logger.info("info");
    logger.config("config");
    logger.fine("fine");
    logger.finer("finer");
    logger.finest("finest");
}

    虽然测试了 7 个日志级别,但是默认是info级别,所以只会输出info以上级别的信息。

自定义日志级别配置:

@Test
public void testLogConfig() throws IOException {
    // 1.创建日志记录器对象
    Logger logger = Logger.getLogger("pers.fgy.JULTest");

    // 一、自定义日志级别
    // a.关闭系统默认配置
    logger.setUseParentHandlers(false);
    // b.创建handler对象
    ConsoleHandler consoleHandler = new ConsoleHandler();
    // c.创建formatter对象(简单格式转换对象)
    SimpleFormatter simpleFormatter = new SimpleFormatter();
    // d.进行关联
    consoleHandler.setFormatter(simpleFormatter);
    logger.addHandler(consoleHandler);
    // e.设置日志级别
    logger.setLevel(Level.ALL);
    consoleHandler.setLevel(Level.ALL);

    // 二、输出到日志文件
    FileHandler fileHandler = new FileHandler("d:/logs/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");
}

Logger之间的父子关系:

  JUL中Logger之间存在父子关系,这种父子关系通过树状结构存储,JUL在初始化时会创建一个顶层RootLogger作为所有Logger父Logger,存储上作为树状结构的根节点。并且父子关系通过路径来关联。

@Test
public void testLogParent() {
    Logger logger1 = Logger.getLogger("pers");
    Logger logger2 = Logger.getLogger("pers.fgy");

    System.out.println(logger2.getParent() == logger1); // true
    System.out.println(logger1.getParent()); // java.util.logging.LogManager$RootLogger@887af79
}

日志的配置文件:默认配置文件路径$JAVAHOMEjreliblogging.properties

  自定义 logging.properties 文件

## RootLogger使用的处理器(获取时设置)
handlers=java.util.logging.ConsoleHandler,java.util.logging.FileHandler
# RootLogger日志等级
.level=ALL

## 自定义Logger
pers.fgy.handlers=java.util.logging.ConsoleHandler
# 自定义Logger日志等级
pers.fgy.level=CONFIG
# 忽略父日志设置
pers.fgy.useParentHandlers=false

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

## 文件处理器
# 输出日志级别
java.util.logging.FileHandler.level=INFO
# 输出日志格式
java.util.logging.FileHandler.formatter=java.util.logging.XMLFormatter
# 输出日志文件路径
java.util.logging.FileHandler.pattern=d:/logs/java%u.log
# 输出日志文件限制大小(50000字节)
java.util.logging.FileHandler.limit=50000
# 输出日志文件限制个数
java.util.logging.FileHandler.count=10
# 输出日志文件 是否是追加
java.util.logging.FileHandler.append=true

## 指定日志消息格式
java.util.logging.SimpleFormatter.format=%4$s
@Test
public void testProperties() throws IOException {
    // 读取自定义配置文件
    InputStream in = JULTest.class.getClassLoader().getResourceAsStream("logging.properties");
    // 获取日志管理器对象
    LogManager logManager = LogManager.getLogManager();
    // 通过日志管理器加载配置文件
    logManager.readConfiguration(in);

    Logger logger = Logger.getLogger("pers");
    logger.severe("severe");
    logger.warning("warning");
    logger.info("info");
    logger.config("config");
    logger.fine("fine");
    logger.finer("finer");
    logger.finest("finest");
    // 严重警告信息配置详细较详细非常详细

    Logger logger2 = Logger.getLogger("pers.fgy");
    logger2.severe("severe");
    logger2.warning("warning");
    logger2.info("info");
    logger2.config("config");
    logger2.fine("fine");
    logger2.finer("finer");
    logger2.finest("finest");
    // 严重警告信息配置
}

日志原理解析:

  1. 初始化LogManager
    1. LogManager加载logging.properties配置
    2. 添加Logger到LogManager
  2. 从单例LogManager获取Logger
  3. 设置级别Level,并指定日志记录LogRecord
  4. Filter提供了日志级别之外更细粒度的控制
  5. Handler是用来处理日志输出位置
  6. Formatter是用来格式化LogRecord的

  

原文地址:https://www.cnblogs.com/roadlandscape/p/12738123.html