Log4j
apache推出开源免费的日志处理类库
在项目发布后,无控制台,不易观察一些输出结果
作用:不仅能把内容输出到控制台,还能把内容输出到文件,便于观察结果
使用
①导入jar包
②在src下新建log4J.properties(路径和名称都不允许改变)
Ps:此处主要说明的是properties配置文件的相关配置
具体配置
输出级别
主要使用的级别一共有七种,只建议使用四种:
error(错误)> warn(警告)> info(普通信息)> debug(调试信息)
元素及配置步骤
①根
可声明全局输出级别和输出方向
如:log4j.rootCategory=ERROR,CONSOLE,LOGFILE
全局输出级别为:ERROR
定义了两个方向:CONSOLE,LOGFILE可在之后进行详细配置
②特定输出级别
使用:log4j.logger.包名 = 输出级别
可专门设置对于某个包具体的输出级别,此时可将全局输出级别设置到较高,专门对某个包的信息做记录
③具体输出方向的配置
默认有五个方向:
配置名 | 输出方向 |
---|---|
org.apache.log4j.ConsoleAppender | 控制台 |
org.apache.log4j.FileAppender | 文件 |
org.apache.log4j.DailyRollingFileAppender | 每天产生一个日志文件 |
org.apache.log4j.RollingFileAppender | 文件大小溢出时产生新的文件 |
org.apache.log4j.WriterAppender | 将日志以流格式发送到指定的地方 |
此处需使用在根中所声明的输出方向:
如:log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender
设置CONSOLE的输出方向CONSOLE
④声明输出方向后需指定的属性
目标为控制台需指定的属性:
属性 | 作用 |
---|---|
log4j.appender.CONSOLE.Threshold | 设置该方向的输出级别 |
log4j.appender.CONSOLE.layout | 设置输出时的格式 |
Tips:对于输出时的格式一共有四种
选项 | 格式 |
---|---|
org.apache.log4j.HTMLLayout | 以HTML表格形式布局 |
org.apache.log4j.PatternLayout | 可以自定义布局模式 |
org.apache.log4j.SimpleLayout | 包含日志的级别和信息字符串 |
org.apache.log4j.TTCCLayout | 包含日志产生的时间、线程、类别等 |
Ps:若是选择格式时,选择了自定义格式‘
则需设置log4j.appender.CONSOLE.layout.ConversionPattern = 格式
格式会由特殊字符进行设置,之后会进行详解
例:
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.Threshold=DEBUG
log4j.appender.CONSOLE.layout.ConversionPattern=%C %d{yyyy-MM-dd HH:mm:ss} %m
目标为文件需指定的属性:
输出级别、输出格式同上,其他:
属性 | 作用 |
---|---|
log4j.appender.LOGFILE.File | 设置输出的目标文件 |
log4j.appender.LOGFILE.Append | 设置追加(true)、覆盖(false) |
例:
log4j.appender.LOGFILE = org.apache.log4j.FileAppender
log4j.appender.LOGFILE.File = outfile/out.log
log4j.appender.LOGFILE.Append = true
log4j.appender.LOGFILE.layout = org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
目标为每天产生日志文件:
和目标为文件时设置基本相同
例:
log4j.appender.DAILYFILE = org.apache.log4j.DailyRollingFileAppender
log4j.appender.DAILYFILE.File = outfile/daily.log
log4j.appender.DAILYFILE.Append = true
log4j.appender.DAILYFILE.Threshold = DEBUG
log4j.appender.DAILYFILE.layout = org.apache.log4j.PatternLayout
log4j.appender.DAILYFILE.layout.ConversionPattern = %C %d{yyyy-MM-dd HH:mm:ss} %m%n
目标为溢出时建立新文件:
输出级别、输出格式同上,其他:
属性 | 作用 |
---|---|
log4j.appender.ROLLFILE.MaxFileSize | 文件大小上限(带单位) |
log4j.appender.ROLLFILE.MaxBackupIndex | 文件数目上限 |
例:
log4j.appender.ROLLFILE = org.apache.log4j.RollingFileAppender
log4j.appender.ROLLFILE.File = outfile/roll.log
log4j.appender.ROLLFILE.Append = true
log4j.appender.ROLLFILE.Threshold = DEBUG
log4j.appender.ROLLFILE.MaxFileSize = 100KB
log4j.appender.ROLLFILE.MaxBackupIndex = 10
log4j.appender.ROLLFILE.layout = org.apache.log4j.PatternLayout
log4j.appender.ROLLFILE.layout.ConversionPattern = %C %d{yyyy-MM-dd HH:mm:ss} %m%n
日志信息格式设置
使用’%'进行转义:
符号 | 所代表格式 |
---|---|
%% | %字符 |
- | 信息输出时左对齐(默认右对齐) |
%p | 信息优先级(DEBUG,INFO,WARN,ERROR等) |
%d | 时间,可指定格式如:%d{yyyy-MM-dd HH:mm:ss} |
%r | 自应用启动到输出该log信息耗费的毫秒数 |
%t | 产生该日志事件的线程名 |
%x | 和当前线程相关联的NDC(嵌套诊断环境) |
%c | 日志信息所属的类的全名 |
%m | 自己指定的消息,日志具体信息 |
%F | 日志消息产生时所在的文件名称 |
%L | 代码中的行号 |
%l | 相当于:%C.%M(%F:%L),包括类目名、发生的线程,以及在代码中的行数 |
%n | 输出一个回车换行符,不同操作系统各不相同 |
Ps:此处可在%与字符间填充信息来设置最大长度(截掉)、最小长度(对齐)
格式 | 含义 |
---|---|
%am | 最小长度为a,以右对齐方式显示 |
%-am | 最小长度为a,以左对齐方式显示 |
%.am | 最大长度为a,截去左边多出的字符 |
Log4j的具体使用
①建立org.apache.log4j.Logger的对象
Logger log = Logger.getLogger(Test.class)
②通过不同的方法,输出不同的信息,与%m相对应
如:
log.error(“错误”);
log.debug(“调试信息”);
此处还有一个输出方向为DATABASE
具体配置:
属性 | 值 |
---|---|
log4j.appender.DATABASE | org.apache.log4j.jdbc.JDBCAppender |
log4j.appender.DATABASE.URL | jdbc:mysql://localhost:3306/数据库名?serverTimezone = GMT |
log4j.appender.DATABASE.driver | com.mysql.cj.jdbc.Driver |
log4j.appender.DATABASE.user | 用户名 |
log4j.appender.DATABASE.password | 密码 |
log4j.appender.DATABASE.sql | 使用插入语句:INSERT INTO 表名(列名) VALUES (格式符) |
log4j.appender.DATABASE.layout | 设置格式:org.apache.log4j.PatternLayout |
例:
log4j.rootCategory=ERROR,DATABASE
log4j.appender.DATABASE = org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL = jdbc:mysql://localhost:3306/log4j_message?serverTimezone = GMT
log4j.appender.DATABASE.driver = com.mysql.cj.jdbc.Driver
log4j.appender.DATABASE.user = root
log4j.appender.DATABASE.password = *********
log4j.appender.DATABASE.sql = INSERT INTO message(information) VALUES ("%C %d{yyyy-MM-dd HH:mm:ss} %m")
log4j.appender.DATABASE.layout = org.apache.log4j.PatternLayout
结果(此处,我全局设置为error,使用上面的输出,只记录error信息):