0.概述
本文主要介绍以下内容(所用版本log4j 1.x):
0、Hello World 示例
配合着动手学习,效率会高很多,这先来个最简单的示例,好有个感性的认识先。
1、项目中所用日志介绍
在我使用log4j的项目中,需要将debug、info、warn、error日志分别输出到指定文件,且给用户看的info日志只含info级别的日志,这里贴出log4j配置文件及测试程序,列示测试结果。
2、log4j理论介绍
这部分介绍log4j的类层次结构、log4j的配置等信息
3、如何自定义日志等级级并将自定义日志输出到指定文件中
实际使用中可能需要将用户登录、邮件发送等特定的日志输出到指定的文件中,这里举例说明。
4、log4j其他功能简介
log4j功能强大,这里就它有但尚未使用到的功能做一个介绍,好心里有个概念。
1、log4j的Hello World示例
0、到Apache下载jar包
[点我] ,这里的版本是log4j 1.2.17。
1、建java项目,并将导入下面两个jar包
2、编写代码
import org.apache.log4j.Logger;
<span style="font-family: Arial, Helvetica, sans-serif;">public class HelloWorld {</span>
<span style="white-space:pre"> </span>private static Logger logger = Logger.getLogger(HelloWorld.class.getName());
public static void main(String[] args) {
<span style="white-space:pre"> </span>logger.trace("trace ...");
<span style="white-space:pre"> </span> logger.debug("Debug ...");
<span style="white-space:pre"> </span> logger.info("Info ...");
<span style="white-space:pre"> </span> logger.warn("Warn ...");
<span style="white-space:pre"> </span> logger.error("Error ...");
<span style="white-space:pre"> </span> logger.fatal("Fatal ...");
}
}
3、新建文件夹config用于存放配置文件,写配置文件log4j.xml。
有以下两点建议新建config文件夹存放配置文件:
a、一般项目中用到的配置文件比较多,有专门的文件夹存放会比较方便。
b、项目打成jar包时,一般不会把配置文件也打进jar包。
配置文件log4j内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/' >
<appender name="myConsole" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="[%d{yyyy-MM-dd HH:mm:ss,SSS\} %-5p] [%t] %c{2\} - %m%n" />
</layout>
</appender>
<root>
<priority value ="error"/>
<appender-ref ref="myConsole"/>
</root>
</log4j:configuration>
这时若报log4j.dtd的错误,则需要将log4j.dtd文件拷贝到xml配置文件目录中,log4j.dtd文件在log4j的jar包的org\apache\log4j\xml文件夹可以找到。
运行程序输出为:
[2014-09-27 18:16:28,215 ERROR] [main] test.HelloWorld - Error ...
[2014-09-27 18:16:28,215 FATAL] [main] test.HelloWorld - Fatal ...
1、使用项目中所用到的log4j配置文件说明
写本文时项目对log4j写日志的要求是:
a、提供用户及开发人员看的两大类日志。
b、提供给用户看的日志只有info级别的信息并输出到指定文件中
c、提供给开发人员用的有debug、warn、error,三个级别的日志分别输出到指定文件中。
1.1 先看配置文件
log4j.properties配置文件,配置简单,但不支持复杂过滤器filter,log4j.xml虽然配置文件看似复杂,但支持复杂过滤器和Log4j的新特性。推荐使用log4j.xml,本文也只讲解log4j.xml的配置。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/' >
<appender name="myConsole" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="[%d{yyyy-MM-dd HH:mm:ss,SSS\} %-5p] [%t] %c{2\} - %m%n" />
</layout>
</appender>
<span style="white-space:pre"> </span><appender name="user" class="org.apache.log4j.DailyRollingFileAppender">
<span style="white-space:pre"> </span><param name="File" value="files/logs/result.log" />
<span style="white-space:pre"> </span><param name="Append" value="true"/>
<span style="white-space:pre"> </span><layout class="org.apache.log4j.PatternLayout">
<span style="white-space:pre"> </span> <span style="white-space:pre"> </span><param name="ConversionPattern" value="%d{yyy-MM-dd HH:mm:ss} [%-5p] %c {%F:%L} - %m%n" />
<span style="white-space:pre"> </span></layout>
<span style="white-space:pre"> </span><filter class="com.test.test.UserLogFilter">
<span style="white-space:pre"> </span> <span style="white-space:pre"> </span><param name="LevelMin" value="20060" />
<span style="white-space:pre"> </span> <span style="white-space:pre"> </span><param name="LevelMax" value="20060" />
<span style="white-space:pre"> </span> <span style="white-space:pre"> </span><param name="acceptOnMatch" value="true" />
<span style="white-space:pre"> </span></filter>
<span style="white-space:pre"> </span></appender>
<appender name="info" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="files/logs/info.log" />
<!-- 设置是否在重新启动服务时,在原有日志的基础添加新日志 -->
<param name="Append" value="true" />
<span style="white-space:pre"> </span><param name="DatePattern" value="'.'yyyy-MM-dd'.log'" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss\}] - %m%n" />
</layout>
<!--过滤器设置输出的级别-->
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<span style="white-space:pre"> </span> <param name="levelMin" value="INFO" />
<span style="white-space:pre"> </span> <param name="levelMax" value="INFO" />
<span style="white-space:pre"> </span> <param name="AcceptOnMatch" value="true" />
<span style="white-space:pre"> </span></filter>
</appender>
<appender name="debug" class="org.apache.log4j.DailyRollingFileAppender">
<span style="