【一场迟到的约会】我与log4j那点事
好吧,我承认我是一个标题党。还有,本来我以为这张图会很帅,但是并没有我想象中的那种帅气...,看来我的艺术气息完全被社会给磨灭了。
好了,废话少说,其实这一篇本质上就是log4j的学习记录。
前言
如果你还不知道log4j
的话,建议你马上关掉当前网页先去了解一下log4j;
如果你了解了log4j的话,建议你马上关掉当前网页,去做一些其他的有意义的事情,我不觉得重复一个自己会的东西是一件有价值的事情;
如果你知道log4j,但是却不知道怎么使用,或者不太熟悉,你可以看一下我的笔记。
OK,以上全是废话,我是一个逗比!
简介
log4j是干什么的
log4j是Apache的一个开源项目,主要功能是打印日志信息,以各种形式在各种地方花式打印日志。
使用log4j的准备工作
使用log4j就必须要引入其jar包。
附上官网地址http://logging.apache.org/log4j/2.x/download.html
如果你用maven
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
当然,这里的maven依赖不是最新的版本。如果想用最新版本,在网上随随便便就能找到,具体就不说了。
使用
代码
按照用过程来说,我们首先写好配置文件然后在进行代码的编写。但是由于代码的编写比较简单单一,并且在这里我们把不同的配置方式结果都是用相同的代码进行比较,所以这里就暂且本末倒置,先把代码部分放上来。
import org.apache.log4j.Logger;
public class Log4jDemo {
private static Logger logger = Logger.getLogger(Log4jDemo.class);
public static void main(String[] args) {
logger.debug("@debug");
logger.info("@info");
logger.error("@error");
logger.warn("@warn");
}
}
配置
log4j可以使用xml文件配置,也可以使用properties文件进行配置。
在日常使用中,我们基本上都使用properties文件进行配置。这里就以properties文件进行配置举例说明。在此之前我们需要新建一个log4j.properties配置文件并将其放在项目根目录下。
在log4j的配置中,有以下三大必要要素。
- 日志级别
- 日志输出位置
- 日志输出样式
接下来我们看具体配置:
日志级别
log4j中日志级别一共有5级,加上全开与全关两个状态,一共有7个状态:
状态 | 级别 |
---|---|
all | Integer.MIN_VALUE |
debug | 10000 |
info | 20000 |
warn | 30000 |
error | 40000 |
fatal | 50000 |
off | Integer.MAX_VALUE |
从上到下级别的值是增加的,但是权重是逐渐降低的。权重的排名如下:
all>debug>info>warn>error>fatal>off
我们选择打印某个级别的日志的时候,权重不大于这个级别的日志都会被打印出来。例如:我们选择info级别的日志,则info、warn、error、fatal都会被打印出来,但是debug不会被打印出来。
日志的各种级别以及优先级已经分析清楚了,那么具体是怎么配置的呢?
log4j.rootLogger = [leven],[appendername]
举例:
log4j.rootLogger = debug,myAppender
在上边的例子中,我们配置日志的级别为debug级,还定义了一个名为myAppender的appender
输出类型
在log4j里一共提供了5种输出类型,分别是:
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
举例:
log4j.appender.myAppender = org.apache.log4j.ConsoleAppender
在上边的例子中,我们定义为控制台输出,其中myAppender
为上边定义日志级别的时候我们定义的那个appender
输出格式
在log4j里一共提供了4种输出格式,分别是:
org.apache.log4j.HTMLLayout(HTML表格形式)
org.apache.log4j.SimpleLayout(日志级别信息、输出字符串)
org.apache.log4j.TTCCLayout(日志级别、产生日志的线程、输出字符串)
org.apache.log4j.PatternLayout(自己指定输出格式)
举例:
log4j.appender.appender1.layout = org.apache.log4j.SimpleLayout
在上边的例子中,我们定义了一个SimpleLayout(包含日志信息的级别和信息字符串)类型的输出格式。
自定义格式:
%m 输出代码中指定的消息
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出所属的类目,通常就是所在类的全名
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符,Windows平台为“/r/n”,Unix平台为“/n”
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss , SSS},输出类似:2002年10月18日 22 : 10 : 28 , 921
%l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java: 10 )
实战举例
log4j.rootLogger = debug,stdout,appender1,appender2
# 输出到控制台
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout = org.apache.log4j.TTCCLayout
#输出到日志文件
log4j.appender.appender1 = org.apache.log4j.DailyRollingFileAppender
#输出日志文件位置
log4j.appender.appender1.File = logs/log.log
#以追加的方式添加
log4j.appender.appender1.Append = true
#输出权重不大于DEBUG的日志
log4j.appender.appender1.Threshold = DEBUG
log4j.appender.appender1.layout = org.apache.log4j.TTCCLayout
#保存异常信息到单独文件
log4j.appender.appender2 = org.apache.log4j.DailyRollingFileAppender
#输出日志文件位置
log4j.appender.appender2.File = logs/error.log
#以追加的方式添加
log4j.appender.appender2.Append = true
#只输出权重不大于ERROR日志
log4j.appender.appender2.Threshold = ERROR
log4j.appender.appender2.layout = org.apache.log4j.PatternLayout
log4j.appender.appender2.layout.ConversionPattern = %d %p %l - %m %n
输出日志结果:
log.log
[main] DEBUG com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @debug
[main] INFO com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @info
[main] WARN com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @warn
[main] ERROR com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @error
[main] FATAL com.zhangyingwei.log4jdemo.debug_console.Log4jDemo - @fatal
error.log
2015-11-28 23:17:00,371 ERROR com.zhangyingwei.log4jdemo.debug_console.Log4jDemo.main(Log4jDemo.java:12) - @error
2015-11-28 23:17:00,375 FATAL com.zhangyingwei.log4jdemo.debug_console.Log4jDemo.main(Log4jDemo.java:13) - @fatal
OK,到这里就先告一段落了,具体其他高级功能待学习后再来记录。
END