JUL（Java util Logging）日志初步整合

柔光的暖阳◎ 2023-07-04 11:27 15阅读 0赞

一、JUL（Java util Logging）初步学习

JUL是Java原生的日志框架，很多项目在没有配置日志(slf4j或者log4j)时会默认使用jul作为最后的日志实现

[Java Logging Technology–java日志简介][Java Logging Technology_java]

### Logger的大致处理流程 ###

![20170408193334945][]

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

2.Appenders:也被称为Handlers，每个Logger都会关联一组Handlers，Logger会将日志交换关联Handlers处理，**由Handlers负责将日志做记录**，Handlers在此是一个抽象，其**具体的实现决定了日志记录的位置可以是控制台、文件、网络上的其他日志服务或者操作系统日志等**。

3.Layouts:也被称为Formatters，它负责**对日志事件中的数据进行转化和格式化**，Layouts决定了数据在一条日志记录中的最终形式。

4.level:每条日志的消息都有一个关联的**日志级别**。该级别粗略指导了日志消息的重要性和紧迫，我可以将level和loggers,Appenders做关联以便于我们过滤消息。

5.Filters:**过滤器**，根据需要定制那些信息会被记录，哪些信息会被放过

### 创建Logger对象 ###

// 为指定子系统查找或创建一个 logger。
    static Logger getLogger(String name) 
    // 为指定子系统查找或创建一个 logger。
    static Logger getLogger(String name, String resourceBundleName)

注意：name是Logger的名称，当名称相同时候，同一个名称的Logger只创建一个。

//  1.   快速入门
        @Test
        public void testQuick() throws Exception{
    //        1.获取日志记录器对象
            Logger logger = Logger.getLogger("LoggerDemo.JULTest");
    //        2.日志记录输出
            logger.info("hello jul");
    
    //        通用方法进行日志记录
            logger.log(Level.INFO,"info msg");
    
    //        通过占用符 方式输出变量值
            String name = "com.jul";
            Integer age = 13;
    
            logger.log(Level.INFO,"用户信息：{0},{1}",new Object[]{name,age});
        }

**Logger的级别**  
        在进行信息的记录时，依信息程序的不同，会设定不同等级的信息输出。Java log比log4j的级别详细，全部定义在java.util.logging.Level里面。Java的一个日志级别对应一个整数值，Level有9个内置的级别，分别是：

<table style="width:500px;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;"> 类型 </td> 
 <td style="vertical-align:top;"> 对应的整数 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> OFF </td> 
 <td style="vertical-align:top;"> 最大整数（&nbsp;Integer.&nbsp;MAX_VALUE） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> SEVERE </td> 
 <td style="vertical-align:top;"> 1000（最高值） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> WARNING </td> 
 <td style="vertical-align:top;"> 900 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> INFO </td> 
 <td style="vertical-align:top;"> 800 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> CONFIG </td> 
 <td style="vertical-align:top;"> 700 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> FINE </td> 
 <td style="vertical-align:top;"> 500 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> FINER </td> 
 <td style="vertical-align:top;"> 400 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> FINEST </td> 
 <td style="vertical-align:top;"> 300（最低值） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> ALL </td> 
 <td style="vertical-align:top;"> 最小整数（Integer.&nbsp;MIN_VALUE） </td> 
 </tr> 
 </tbody> 
</table>

此外，级别OFF是用来关闭日志记录，级别ALL是启用所有消息的日志记录。

logger默认的级别是INFO，比INFO更低的日志将不显示。

//  2.  日志级别
        @Test
        public void testLogLevel() throws Exception{
    //        1.获取日志记录器对象
            Logger logger = Logger.getLogger("LoggerDemo.JULTest");
    //        2.日志记录输出
            logger.severe("severe");
            logger.warning("warning");
            logger.info("info");//jul默认的日志级别info
            logger.config("config");
            logger.fine("fine");
            logger.finer("finer");
            logger.finest("finest");
    
        }

//  3.  自定义日志级别
        @Test
        public void testLogConfig() throws Exception{
    //        1.获取日志记录器对象
            Logger logger = Logger.getLogger("LoggerDemo.JULTest");
    //        关闭系统默认配置
            logger.setUseParentHandlers(false);
    
    //        自定义配置日志级别
    //        创建ConsolHandler
            ConsoleHandler consoleHandler = new ConsoleHandler();
    
    //        创建简答格式转换对象
            SimpleFormatter simpleFormatter = new SimpleFormatter();
    
    //        进行关联
            consoleHandler.setFormatter(simpleFormatter);
            logger.addHandler(consoleHandler);
    
    //        配置日志具体级别Level.ALL表示显示所有的信息，所有这一次的执行结果可显示所有等级的信息。如果要关闭所有的信息，可以设定为Level.OFF。
            logger.setLevel(Level.ALL);
            consoleHandler.setLevel(Level.ALL);
    
    //        场景FileHandler文件输出
            FileHandler fileHandler = new FileHandler("/logs/jul.log");
    
    //        进行关联
            fileHandler.setFormatter(simpleFormatter);
            logger.addHandler(fileHandler);
    
    //        2.日志记录输出
            logger.severe("severe");
            logger.warning("warning");
            logger.info("info");//jul默认的日志级别info
            logger.config("config");
            logger.fine("fine");
            logger.finer("finer");
            logger.finest("finest");
    
        }

//  4.  Logger对象父子关系 子级继承父级
        @Test
        public void testLogParent() throws Exception{
            Logger logger1 = Logger.getLogger("com.jultest");
            Logger logger2 = Logger.getLogger("com");
    //        关闭日志默认选项
            logger2.setUseParentHandlers(false);
    
    //        测试
            System.out.println(logger1.getParent() == logger2);
    
    //        所有日志记录器的顶级父元素LogManager$RootLogger@3b22cdd0,name: ""
            System.out.println("logger2 parent:"+logger2.getParent()+",name:"+logger2.getParent().getName());
    
    //        自定义配置日志级别
    //        创建ConsolHandler
            ConsoleHandler consoleHandler = new ConsoleHandler();
    
    //        创建简答格式转换对象
            SimpleFormatter simpleFormatter = new SimpleFormatter();
    
    //        进行关联
            consoleHandler.setFormatter(simpleFormatter);
            logger2.addHandler(consoleHandler);
    
    //        配置日志具体级别
            logger2.setLevel(Level.ALL);
            consoleHandler.setLevel(Level.ALL);
    //        2.日志记录输出
            logger1.severe("severe");
            logger1.warning("warning");
            logger1.info("info");//jul默认的日志级别info
            logger1.config("config");
            logger1.fine("fine");
            logger1.finer("finer");
            logger1.finest("finest");
    
        }

二、JUL日志原理解析：

1.初始化LogManager:LogManager加载logging.properties配置；添加Logger到LogManager

2.从单例LogManager获取Logger

3.设置级别Level,并指定日志记录LogRecord

4.Filter提供了日志级别之外更细粒度的区别

5.Handlers是用来处理日志输出位置，Java SE实现了5个Handler：

1)    java.util.logging.ConsoleHandler 以System.err输出日志。

2)    java.util.logging.FileHandler 将信息输出到文件。

3)    java.util.logging.StreamHandler以指定的OutputStream实例输出日志。

4)    java.util.logging.SocketHandler将信息通过Socket传送至远程主机。

5)    java.util.logging.MemoryHandler将信息暂存在内存中。

6.Formatter为格式化LogRecords提供支持。一般来说，每个Handler都有关联的Formatter。Formatter接受LogRecord，并将它转换为一个字符串。

默认提供了两种Formatter：

1.java.util.logging.SimpleFormatter：标准日志格式，就是我们通常在启动一些诸如 Tomcat、 JBoss之类的服务器的时候经常能在控制台下看到的那种形式。

2.java.util.logging.XMLFormatter：XML形式的日志格式，如果为Logger添加了一个newXMLFormatter()，那么就会以XML形式输出，不过更常用的是使用上面介绍的FileHandler输出到XML文件中。

FileHandler的默认格式是java.util.logging.XMLFormatter，而ConsolerHandler的默认格式是java.util.logging.SimpleFormatter，可以使用Handler实例的setFormatter()方法来设定信息的输出格式。

FileHandler的Formatter设定为SimpleFormatter，则输出的日志文件内容就是简单的文字信息，打开文件后会发现与命令行模式下看到的信息内容相同。

<--
 java默认log配置文件:
 这样在maven项目中快速使用jul日志，项目根目录新建配置文件logging.properties
 -->
 
 handles = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
 <--.level 是针对所有handler与包的根日志级别;ConsoleHandler.level是使用Console这个handler的logger级别-->
 .level = ALL
 
 java.util.logging.FileHandler.pattern = /logs/java%u.log
 java.util.logging.FileHandler.limit = 50000
 java.util.logging.FileHandler.count = 1
 java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter
 
 java.util.logging.ConsoleHandler.level = ALL
 java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter

//  5.  加载自定义配置文件测试Demo
        @Test
        public void testLogProperties() throws Exception{
    //        读取配置文件，通过类加载器
            InputStream ins = JULTest.class.getClassLoader().getResourceAsStream("logging.properties");
    
    //        创建LogManager
            LogManager logManager = LogManager.getLogManager();
    
    //        通过LogManager加载配置文件
            logManager.readConfiguration(ins);
    
    //        创建日志记录器
            Logger logger = Logger.getLogger("LoggerDemo.JULTest");
    
    //        2.日志记录输出
            logger.severe("severe");
            logger.warning("warning");
            logger.info("info");//jul默认的日志级别info
            logger.config("config");
            logger.fine("fine");
            logger.finer("finer");
            logger.finest("finest");
    
    
            //        创建日志记录器
            Logger logger2 = Logger.getLogger("test");
    
    //        2.默认日志记录输出和读取配置文件日志记录输出的比较
            logger2.severe("severe test ");
            logger2.warning("warning test ");
            logger2.info("info test ");//jul默认的日志级别info
            logger2.config("config test ");
            logger2.fine("fine test ");
            logger2.finer("finer test ");
            logger2.finest("finest test ");
        }

java.util.logging包中类的关系图如下：

![Center][]

[Java Logging Technology_java]: https://docs.oracle.com/javase/8/docs/technotes/guides/logging/index.html
[20170408193334945]: https://img-blog.csdn.net/20170408193334945
[Center]: https://img-blog.csdn.net/20150213001612627?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvbHVvd2VpZnU=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center