【一场迟到的约会】我与log4j那点事

作者: 咖啡er | 来源:发表于2015-11-29 00:14 被阅读516次

【一场迟到的约会】我与log4j那点事
迟了太久，就不必到了
迟到那点儿事
约会那点儿事
杂记柒
等
与春·无我茶会
赴一场春天的约会－济南至厦门往返4000公里自驾游
手办模型修复
赴一场迟到的约会

好吧，我承认我是一个标题党。还有，本来我以为这张图会很帅，但是并没有我想象中的那种帅气...，看来我的艺术气息完全被社会给磨灭了。

好了，废话少说，其实这一篇本质上就是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