概论
在java 中实现记录日志的方式有很多种,
1. system.out.print ,system.err.print最简单的方式,直接在控制台打印消息了。
2. java.util.logging ; 在JDK 1.4 版本之后,提供了日志的API ,可以往文件中写日志了。
3. log4j -1.x, 最强大的记录日志的方式。 可以通过配置 .properties 或是 .xml 的文件, 配置日志的目的地,格式等等。
4. commons-logging, 最综合和常见的日志记录方式, 经常是和log4j 结合起来使用。
5. slf4j:类似与commons-logging,但更灵活.
6.log4j -2.x
---
在logging中,通常包含以下几个元素:
1.log- 日志对象
2.level - 日志级别
3.formatter/render/layout - 格式化日志记录
4.handler/appender - 输出位置,包括console, file, stream
java.util.logging简介
源码演示:
package com.chenjazz;
import java.io.File;
import java.util.Date;
import java.util.logging.FileHandler;
import java.util.logging.Formatter;
import java.util.logging.Level;
import java.util.logging.LogRecord;
import java.util.logging.Logger;
public class Test {
public static void main(String[] args) throws Exception {
// 1.创建log
Logger log = Logger.getLogger("logtest");
// 2.设置log级别(默认为info级别)
log.setLevel(Level.INFO);
// 3.设置Handler
FileHandler fileHandler = new FileHandler("d:" + File.separator + "log.txt");
// 4.Handler格式化(如果不格式化,默认输出为xml类型)
fileHandler.setFormatter(new Formatter() {
@Override
public String format(LogRecord record) {
StringBuilder sb=new StringBuilder("[" + new Date().toString()+this.getClass().getName() + "]");
sb.append(record.getLevel() + "\t" + record.getMessage()+"\r\n");
return sb.toString() ;
}
});
// 5.日志添加Handler
log.addHandler(fileHandler);
// 6.日志输出内容
log.fine("fine日志测试");//比info级别低的日志将不会输出
log.info("info日志测试");
log.warning("warning日志测试");
}
}
输出结果如图:
更多细节及原理请查看---http://www.oseye.net/user/kevin/blog/237
http://lavasoft.blog.51cto.com/62575/184492/
log4j ---1.x
log4j跟其它logger机制一样,存在着基本的logger所有基本概念,只是它的fomatter叫做patternLayout, 而handler则叫做appender. 另外log4j和java util logging在level的划分上有所不同,log4j的level分为:TRACE,DEBUG,INFO,WARN,ERROR,FATAL,ALL。
1.工程结构
2.配置文件(本文以property方式,xml方式请查看其他)
####输出级别为 debug,目的地为appender1(可以指定多个):
log4j.rootLogger=debug,appender1,appender2,appender3
####appender1 配置(控制台输出):
#输出位置:
log4j.appender.appender1=org.apache.log4j.ConsoleAppender
#输出格式:
log4j.appender.appender1.layout=org.apache.log4j.TTCCLayout
####appender2 配置(文件输出,html格式):
#输出位置:
log4j.appender.appender2=org.apache.log4j.FileAppender
#输出位置:
log4j.appender.appender2.File=D:/appender2.html
#输出格式:
log4j.appender.appender2.layout=org.apache.log4j.HTMLLayout
####appender3 配置(文件输出,自定义格式):
#输出位置:
log4j.appender.appender3=org.apache.log4j.FileAppender
#输出位置:
log4j.appender.appender3.File=D:/appender3.txt
#输出格式:
log4j.appender.appender3.layout=org.apache.log4j.PatternLayout
#自定义样式 , %r 时间 ,%t方法名 main,%p优先级 DEBUG/INFO/ERROR ,
#%c所属类的全名(包括包名),%l 发生的位置,在某个类的某行 ,%m 输出代码中指定的讯息,%n输出一个换行符号
log4j.appender.appender3.layout.ConversionPattern=[%d{yy/MM/dd HH:mm:ss:SSS}][%C-%M] %m%n
说明:
1).配置根Logger,其语法为:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定义的级别。Log4j建议只使用四个级别,优 先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定 义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来。 appenderName就是指B日志信息输出到哪个地方。您可以同时指定多个输出目的地。
2).配置日志信息输出目的地Appender,其语法为:
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.option = valueN
其中,Log4j提供的appender有以下几种:
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
3).配置日志信息的格式(布局),其语法为:
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.option = valueN
其中,Log4j提供的layout有以e几种:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下: %m 输出代码中指定的消息
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出所属的类目,通常就是所在类的全名
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符,Windows平台为“rn”,Unix平台为“n”
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921
%l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。
3.代码:
package com.chenjazz;
import org.apache.log4j.*;
public class Log4jTest {
//第一步:日志记录
private static Logger log = Logger.getLogger(Log4jTest.class);
public static void main(String[] args) throws Exception {
//第二步:读取配置文件(默认读取根目录下log4j.properties)
/*
BasicConfigurator.configure (): 自动快速地使用缺省Log4j环境。
PropertyConfigurator.configure ( String configFilename) :读取使用Java的特性文件编写的配置文件。
DOMConfigurator.configure ( String filename ) :读取XML形式的配置文件。
*/
//第三步:插入日志信息
log.debug("debug...信息");
log.info("info...信息");
log.error("error...信息");
}
}
4.效果:
Commons-logging
目的是为所有流行的logging提供一个通用接口。用户在开发的时候只需要调用commons logging的接口。而运行环境中具体使用的是log4j,util logging或其它的logging, 则由commons logging配置文件或者commons logging的自动探测来决定。
在系统开发中,统一按照commons-logging的API进行开发,在部署时,选择不同的日志系统包,即可自动转换到不同的日志系统上。比如:开始选择JDK自带的日志系统,,如果中途无法忍受JDK自带的日志系统了,想换成log4j的日志系统,仅需要导入log4j.jar即可
Commons Logging包含三个jar:
commons-logging-api.jar 这里面包含了commons logging的通用接口以及两个logger的实现:SimpleLog和NoOpLog.
commons-logging.jar 这里面包含了通用接口,以及Log4j,JDK logger等的适配器。这个是最常用的包。
commons-logging-adapters.jar 只包含了第三方logger的适配器。必须和上面两个包中的一个搭配使用。
使用Commons-logging的LogFactory获取日志处理类时:
1) 首先在classpath下寻找自己的配置文件commons-logging.properties,如果找到,则使用其中定义的Log实现类;
2) ???如果找不到commons-logging.properties文件,则在查找是否已定义系统环境变量org.apache.commons.logging.Log,找到则使用其定义的Log实现类;
3) 否则,查看classpath中是否有Log4j的包,如果发现,则自动使用Log4j作为日志实现类;
4) 否则,使用JDK自身的日志实现类(JDK1.4以后才有日志实现类);
5) 否则,使用commons-logging自己提供的一个简单的日志实现类SimpleLog;
使用Log4j:
配置文件与上节提到的相同,只是代码略有改动:
生成文件:略
SLF4J
Simple logging facades for java也是一种通用的logging接口。它跟commons logging类似,区别在于commons logging是运行时运用classLoader动态探测实际logging,而SLF4J是开发时使用import class静态声明binding。这解决了在类似OSGI下(面向Java的动态模型系统),commons logging工作存在的问题。SLF4J的产生,就是为了改变commons logging的动态探测。
SLF4J与commons-logging的比较:http://www.360doc.com/content/10/1216/23/573136_78845816.shtml
SLF4J获得log对象(与commons相比还是有区别的)
private static final Logger logger = LoggerFactory.getLogger(Test.class);