简介
- 本篇是关于
Log4j
日志框架的介绍。 - 阅读本文请至少了解
JUL
日志框架,因为大部分的知识点是类似的。
Log4j日志框架
Log4j
全称是Log for Java
,它是Apache
的一个开源项目,通过使用Log4j
,我们可以控制日志信息输出的位置是控制台、文件还是GUI
组件,输出位置甚至可以是套接口服务器、NT
的事件记录器、UNIX Syslog
守护进程等;- 使用
Log4j
也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。
入门案例
- 所使用的项目使用
Maven
构建,需要引入Log4j
依赖:
<dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version></dependency>
Log4j
默认情况下是需要提供配置文件的,如果resource
目录下不存在log4j.properties
配置文件,则控制台中会输出相应的警告信息。- 考虑以下代码:
@Testpublic void test() { // 1.在没有log4j.properties的情况下,获取日志记录器对象Logger Logger logger = Logger.getLogger(Log4jTest.class); // 2.尝试输出日志记录 logger.info("Hey, log4j.");}
- 此时控制台输出为:
- 接触过
JUL
的都知道,当普通的Logger
没有进行额外的配置时,其默认会继承并使用RootLogger
的配置。 - 同样地,
Log4j
中也存在RootLogger
,但由于默认情况下RootLogger
不具有任何的Appender
(即Handler
)。 - 如果代码仅为了测试某项功能,并不想编写复杂的
log4j.properties
,可以使用Log4j
提供的默认配置,在获取Logger
前使用以下代码加载默认配置:BasicConfigurator.configure();
- 查看
configure()
方法的源码:
/** Add a {@link ConsoleAppender} that uses {@link PatternLayout} using the {@link PatternLayout#TTCC_CONVERSION_PATTERN} and prints to <code>System.out</code> to the root category. */staticpublicvoid configure() { Logger root = Logger.getRootLogger(); root.addAppender(new ConsoleAppender( new PatternLayout(PatternLayout.TTCC_CONVERSION_PATTERN)));}
- 古早时期的源码格式有点不太现代,但意义明确:为
RootLogger
对象添加一个Appender
,其中Appender
的类型为控制器输出的ConsoleAppender
,输出的格式使用PatternLayout.TTCC_CONVERSION_PATTERN
。 - 以下为
PatternLayout.TTCC_CONVERSION_PATTERN
源码:
/** A conversion pattern equivalent to the TTCCCLayout. Current value is <b>%r [%t] %p %c %x - %m%n</b>. */public final static String TTCC_CONVERSION_PATTERN = "%r [%t] %p %c %x - %m%n";
- 关于
PatternLayout
的相关格式化规则,后续会列举出来。 - 于是,使用以下代码加载默认配置并输出日志:
@Testpublic void testQuick() { // 1.初始化配置信息,使用默认的配置,如果不加载默认配置同时不具有log4j.properties配置文件,程序将发出警告 BasicConfigurator.configure(); // 2.获取日志记录器对象Logger Logger logger = Logger.getLogger(Log4jTest.class); // 3.日志记录输出 logger.info("Hey, log4j.");}
- 此时控制台输出为:
日志级别
Log4j
中的日志级别与JUL
的不同,一共提供了6
中日志级别:FATAL
:严重错误,一般会造成系统崩溃并终止运行;ERROR
:错误信息,不会影响系统运行;WARN
:警告信息,可能会发生问题;INFO
:运行信息,数据连接、网络连接、I/O
操作等等;DEBUG
:调试信息,一般在开发中使用,记录程序变量参数传递信息等等。默认级别;TRACE
:追踪信息,记录程序所有的流程信息。
- 参考以下示例代码:
@Testpublic void testQuick() { // 1.初始化配置信息,使用默认的配置,如果不加载默认配置同时不具有log4j.properties配置文件,程序将发出警告 BasicConfigurator.configure(); // 2.获取日志记录器对象Logger Logger logger = Logger.getLogger(Log4jTest.class); // 3.日志级别测试 logger.fatal("[FATAL] 严重错误,一般会造成系统崩溃并终止运行。"); logger.error("[ERROR] 错误信息,不会影响系统运行。"); logger.warn("[WARN] 警告信息,可能会发生问题。"); logger.info("[INFO] 运行信息,数据连接、网络连接、I/O操作等等。"); logger.debug("[DEBUG] 调试信息,一般在开发中使用,记录程序变量参数传递信息等等。默认级别。"); logger.trace("[TRACE] 追踪信息,记录程序所有的流程信息。");}
- 运行输出,得到:
- 输出的日志仍然由默认的日志级别所决定,其中默认级别为
DEBUG
。 - 为了测试默认日志级别,可以使用以下代码测试
RootLogger
:- 使用
getRootLogger()
获取RootLogger
对象; - 使用
RootLogger
中的相关方法获取日志对象的日志等级及其关联的Appender
详情。
- 使用
@Testpublic void testDetails() { // 1.初始化配置信息,使用默认的配置,如果不加载默认配置,将无法正常运行 BasicConfigurator.configure(); // 2.获取日志记录器对象RootLogger final Logger rootLogger = Logger.getRootLogger(); // 3.输出配置详情 System.out.println("Logger level: " + rootLogger.getLevel()); final Enumeration allAppenders = rootLogger.getAllAppenders(); while (allAppenders != null && allAppenders.hasMoreElements()) { final Appender appender = (Appender) allAppenders.nextElement(); System.out.println("Appender is: " +appender.getClass().getSimpleName()); }}
- 运行输出:
- 注意,对于
Log4j
中的Appender
来说,它们不具有日志等级,只有Logger
对象具有日志等级。
Log4j相关组件
Log4J
主要由Loggers
(日志记录器)、Appenders
(输出端)和Layout
(日志格式化器)组成:Loggers
:控制日志的输出级别与日志是否输出;Appenders
:指定日志的输出方式(输出到控制台、文件等);Layout
:控制日志信息的输出格式。
a. Logger
- 日志记录器,负责收集处理日志记录,
Logger
的实例命名通常是类的全限定类名。 Logger
的名字大小写敏感,其命名有继承机制。- 例如:
name
为org.apache.commons
的logger
会继承name
为org.apache
的logger
。
- 例如:
- 自
log4j 1.2
版以来,Logger
类已经取代了Category
类。对于熟悉早期版本的log4j
的人来说,Logger
类可以被视为Category
类的别名。
b. Appenders
Appender
用来指定日志输出到哪个地方,可以同时指定日志的输出目的地。Log4j
常用的输出目的地有以下几种:
输出端类型 | 作用 |
---|---|
ConsoleAppender | 将日志输出到控制台 |
FileAppender | 将日志输出到文件中 |
DailyRollingFileAppender | 将日志输出到一个日志文件,周期为天,即每天输出 |
RollingFileAppender | 将日志信息输出到一个日志文件,并且指定文件的大小,当超过指定大小,会自动将文件重命名,同时产生一个新的文件 |
JDBCAppender | 将日志信息保存到数据库中 |
c. Layouts
- 布局器
Layouts
用于控制日志输出内容的格式,我们可以使用各种自定义格式输出日志。 Log4j
常用的Layouts
有以下几种:
格式化器类型 | 作用 |
---|---|
HTMLLayout | 格式化日志输出为HTML表格形式 |
SimpleLayout | 简单的日志输出格式,打印的日志格式为info-message |
PatternLayout | 最强大的格式化方式,可以根据自定义格式输出日志,如果没有指定转换格式,则使用默认的转换格式 |
PatternLayout
中的格式化规则:
* log4j采用类似C语言的printf函数的打印格式格式化日志信息,具体的占位符及其含义如下: %m 输出代码中指定的日志信息 %p 输出优先级,及DEBUG、INFO等 %n 换行符(Windows平台的换行符为"\n",Unix平台为"\n") %r 输出自应用启动到输出该 log 信息耗费的毫秒数 %c 输出打印语句所属的类的全名 %t 输出产生该日志的线程全名 %d 输出服务器当前时间,默认为ISO8601,也可以指定格式,如:%d{yyyy年MM月dd日 HH:mm:ss} %l 输出日志时间发生的位置,包括类名、线程、及在代码中的行数。如:Test.main(Test.java:10) %F 输出日志消息产生时所在的文件名称 %L 输出代码中的行号 %% 输出一个"%"字符* 可以在%与字符之间加上修饰符来控制最小宽度、最大宽度和文本的对其方式。如: %5c 输出category名称,最小宽度是5,category<5,默认的情况下右对齐 %-5c 输出category名称,最小宽度是5,category<5,"-"号指定左对齐,会有空格 %.5c 输出category名称,最大宽度是5,category>5,就会将左边多出的字符截掉,<5不会有空格 %20.30c category名称<20补空格,并且右对齐,>30字符,就从左边交远销出的字符截掉
自定义配置
使用
Log4j
不需要显式地加载配置文件,对于Maven
项目来说,程序会自动扫描resources
目录下的log4j.properties
配置文件。自定义配置如下:
- 日志输出等级为
INFO
,此时RootLogger
拥有三个Appender
:ConsoleAppender
:配置中的命名为Console
;DailyRollingFileAppender
:配置中的命名为UserDefinedName
;JDBCAppender
:配置中的命名为logDB
。
RootLogger
的默认输出级别配置在log4j.rootLogger
的首位,随后紧跟的是关联的Appender
的名称,表示其默认支持输出的方式有哪些。
- 日志输出等级为
# 指定日志的输出级别与输出端log4j.rootLogger=INFO, Console, UserDefinedName, logDB# 控制台输出配置log4j.appender.Console=org.apache.log4j.ConsoleAppenderlog4j.appender.Console.layout=org.apache.log4j.PatternLayoutlog4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n# 文件输出配置log4j.appender.UserDefinedName=org.apache.log4j.DailyRollingFileAppender# 指定日志的输出路径log4j.appender.UserDefinedName.File=log4j.log# 是否以追加日志的形式添加log4j.appender.UserDefinedName.Append=true# 使用自定义日志格式化器log4j.appender.UserDefinedName.layout=org.apache.log4j.PatternLayout# 指定日志的输出格式log4j.appender.UserDefinedName.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] %m%n# 指定日志的文件编码log4j.appender.UserDefinedName.encoding=UTF-8# MySQL输出配置log4j.appender.logDB=org.apache.log4j.jdbc.JDBCAppenderlog4j.appender.logDB.layout=org.apache.log4j.PatternLayoutlog4j.appender.logDB.Driver=com.mysql.cj.jdbc.Driverlog4j.appender.logDB.URL=jdbc:mysql://localhost:3306/test?serverTimezone=GMT%2B8&useAffectedRows=truelog4j.appender.logDB.User=rootlog4j.appender.logDB.Password=rootlog4j.appender.logDB.Sql=INSERT INTO log(project_name, create_date, level, category, file_name, thread_name, line, all_category, message) \ values('log4j', '%d{yyyy-MM-dd HH:mm:ss}', '%p', '%c', '%F', '%t', '%L', '%l', '%m')
- 配置中包含了
sql
输出日志的方式,log
表的创建代码为:
CREATE TABLE `log` ( `log_id` INT ( 11 ) NOT NULL AUTO_INCREMENT, `project_name` VARCHAR ( 255 ) DEFAULT NULL COMMENT '项目名称', `create_date` VARCHAR ( 255 ) DEFAULT NULL COMMENT '创建时间', `level` VARCHAR ( 255 ) DEFAULT NULL COMMENT '优先级', `category` VARCHAR ( 255 ) DEFAULT NULL COMMENT '所在类的全名', `file_name` VARCHAR ( 255 ) DEFAULT NULL COMMENT '输出日志消息产生时所在的文件名称 ', `thread_name` VARCHAR ( 255 ) DEFAULT NULL COMMENT '日志事件的线程名', `line` VARCHAR ( 255 ) DEFAULT NULL COMMENT '行号', `all_category` VARCHAR ( 255 ) DEFAULT NULL COMMENT '日志事件的发生位置', `message` VARCHAR ( 4000 ) DEFAULT NULL COMMENT '输出代码中指定的消息', PRIMARY KEY ( `log_id` ) );
- 让特定名称的
logger
使用特定的配置:- 一个
log4j.properties
中可以配置多个且可重复的Appender
,但Appender
的命名不可重复; - 通过
log4j.logger.{loggerName}
的方式,让指定名为loggerName
的logger
使用该配置; - 由于该
logger
仍然是隶属于rootLogger
,因此输出是累加的形式:- 例:如果
RootLogger
使用了ConsoleAppender
,同时Logger
也使用了ConsoleAppender
,此时控制台将输出两次日志记录,一次为Logger
继承自RootLogger
的输出,另一次则为Logger
自身的输出。
- 例:如果
- 但日志等级
level
则取决于子日志Logger
与RootLogger
,以等级高的一方为准。- 例:此时
RootLogger
和Logger
同时使用了ConsoleAppender
,但输出等级分别为INFO
和WARN
,此时控制台输出的日志等级仅有高于等于WARN
的记录,即使此时RootLogger
的等级为INFO
。
- 例:此时
- 一个
- 有如下
log4j.properties
配置文件:- 其中
RootLogger
和名为cn.hanna
的Logger
使用同一个ConsoleAppender
,但日志等级不一致。
- 其中
# 指定日志的输出级别与输出端log4j.rootLogger=INFO, Console# 控制台输出配置log4j.appender.Console=org.apache.log4j.ConsoleAppenderlog4j.appender.Console.layout=org.apache.log4j.PatternLayoutlog4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n# 让名为"cn.hanna"的logger使用名为Another的Appender# 此时仍会使用rootLogger中的控制台输出,而Level则以两者间较高的为准log4j.logger.cn.hanna=WARN, Console
- 测试代码如下:
@Testpublic void testAnother() { // 1.获取日志记录器对象Logger Logger logger = Logger.getLogger("cn.hanna"); // 2.日志级别测试 logger.fatal("[FATAL] 严重错误,一般会造成系统崩溃并终止运行。"); logger.error("[ERROR] 错误信息,不会影响系统运行。"); logger.warn("[WARN] 警告信息,可能会发生问题。"); logger.info("[INFO] 运行信息,数据连接、网络连接、I/O操作等等。"); logger.debug("[DEBUG] 调试信息,一般在开发中使用,记录程序变量参数传递信息等等。默认级别。"); logger.trace("[TRACE] 追踪信息,记录程序所有的流程信息。");}
- 运行输出:
- 输出印证了之前所陈述的观点,不再赘述。
- 此时,如果一定需要使用
ConsoleAppender
,但不希望控制台输出两次记录,有两种方式:- 摒弃
RootLogger
的输出,即断开指定Logger
与RootLogger
的继承关系; - 摒弃
Logger
的输出,即指定名称的Logger
直接使用RootLogger
关联的Appender
,不再额外指定。
- 摒弃
- 如果选择断开指定
Logger
与RootLogger
的继承关系,需修改配置文件如下:
# 指定日志的输出级别与输出端log4j.rootLogger=INFO, Console# 控制台输出配置log4j.appender.Console=org.apache.log4j.ConsoleAppenderlog4j.appender.Console.layout=org.apache.log4j.PatternLayoutlog4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n# 名为"cn.hanna"的Logger不再继承使用RootLogger中的Appenderlog4j.additivity.cn.hanna=falselog4j.logger.cn.hanna=WARN, Console
- 如果选择直接使用
RootLogger
关联的Appender
,需修改配置文件如下:
# 指定日志的输出级别与输出端log4j.rootLogger=INFO, Console# 控制台输出配置log4j.appender.Console=org.apache.log4j.ConsoleAppenderlog4j.appender.Console.layout=org.apache.log4j.PatternLayoutlog4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n# 对于名称"cn.hanna"的Logger来说,将直接使用RootLogger中关联的Appender,但日志等级由自身决定log4j.logger.cn.hanna=WARN
- 两种方式的测试类运行结果均为:
- 实际应用中,应该灵活选择适合与代码的方式,去编写配置文件。
完整的配置文件示例
- 同样,在此给出一个完整的
log4j
配置文件示例:
log4j.rootLogger=INFO, Consolelog4j.appender.Console=org.apache.log4j.ConsoleAppenderlog4j.appender.Console.layout=org.apache.log4j.PatternLayoutlog4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%nlog4j.appender.UserDefinedName=org.apache.log4j.DailyRollingFileAppenderlog4j.appender.UserDefinedName.File=log4j.loglog4j.appender.UserDefinedName.Append=truelog4j.appender.UserDefinedName.layout=org.apache.log4j.PatternLayoutlog4j.appender.UserDefinedName.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] %m%nlog4j.appender.UserDefinedName.encoding=UTF-8log4j.appender.logDB=org.apache.log4j.jdbc.JDBCAppenderlog4j.appender.logDB.layout=org.apache.log4j.PatternLayoutlog4j.appender.logDB.Driver=com.mysql.cj.jdbc.Driverlog4j.appender.logDB.URL=jdbc:mysql://localhost:3306/test?serverTimezone=GMT%2B8&useAffectedRows=truelog4j.appender.logDB.User=rootlog4j.appender.logDB.Password=rootlog4j.appender.logDB.Sql=INSERT INTO log(project_name, create_date, level, category, file_name, thread_name, line, all_category, message) \ values('log4j', '%d{yyyy-MM-dd HH:mm:ss}', '%p', '%c', '%F', '%t', '%L', '%l', '%m')log4j.appender.Another=org.apache.log4j.DailyRollingFileAppenderlog4j.appender.Another.File=hanna.loglog4j.appender.Another.Append=truelog4j.appender.Another.layout=org.apache.log4j.PatternLayoutlog4j.appender.Another.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] %m%nlog4j.appender.Another.encoding=UTF-8log4j.logger.cn.xyz=WARN, Anotherlog4j.additivity.cn.xyz=false
- 说明:其中
log4j.appeder.APPENDER_NAME
中的APPENDER_NAME
为相应Appender
的名称,可以自行定义。
总结
Log4j
日志框架近似于JUL
日志框架,但功能性上要优于JUL
。
原文转载:http://www.shaoqun.com/a/504553.html
tiki:https://www.ikjzd.com/w/2053
r标:https://www.ikjzd.com/w/1070
日志框架Log4j的使用介绍。简介本篇是关于Log4j日志框架的介绍。阅读本文请至少了解JUL日志框架,因为大部分的知识点是类似的。Log4j日志框架Log4j全称是LogforJava,它是Apache的一个开源项目,通过使用Log4j,我们可以控制日志信息输出的位置是控制台、文件还是GUI组件,输出位置甚至可以是套接口服务器、NT的事件记录器、UNIXSyslog守护进程等;使用Log4j也可
easy buy:easy buy
贝贝母婴网:贝贝母婴网
为什么卖房也要做亚马逊?这其中的暴利你了解吗?:为什么卖房也要做亚马逊?这其中的暴利你了解吗?
广东新丰云髻山红叶适合什么时候去?新丰云髻山红叶最佳时间?:广东新丰云髻山红叶适合什么时候去?新丰云髻山红叶最佳时间?
关务必看:11月海关经贸新规超全汇总!:关务必看:11月海关经贸新规超全汇总!
No comments:
Post a Comment