Ready Test? Go, Go, Go !!!
 

关注测试,也关注成长

公告
  • 关注软件测试自动化,性能测试。
    目前负责医疗软件功能测试以及
    测试过程改进

日历
<2005年6月>
2930311234
567891011
12131415161718
19202122232425
262728293012
3456789
统计
  • 随笔 - 22
  • 文章 - 0
  • 评论 - 87
  • 引用 - 0

导航

常用链接

留言簿(17)

随笔分类

随笔档案

搜索

  •  

最新评论

阅读排行榜

评论排行榜

 

 原文作者:天才    Kylin项目小组

log4j简介

简单的说log4j就是帮助开发人员进行日志输出管理的API类库。它最重要的特点就

可以配置文件灵活的设置日志信息的优先级、日志信息的输出目的地以及日志信息的输出格式。

Log4j除了可以记录程序运行日志信息外还有一重要的功能就是用来显示调试信息。程序员经常会遇到脱离java ide环境调试程序的情况,这时大多数人会选择使用System.out.println语句输出某个变量值的方法进行调试。这样会带来一个非常麻烦的问题:一旦哪天程序员决定不要显示这些System.out.println的东西了就只能一行行的把这些垃圾语句注释掉。若哪天又需调试变量值,则只能再一行行去掉这些注释恢复System.out.println语句。使用log4j可以很好的处理类似情况。

log4j使用方法

下面介绍的是log4j一些理论方面的知识,读者觉得枯燥的话可以跳过本节直接阅读第三节实例部分。

  1、定义配置文件

   首先使用配置文件将使我们的应用程序更加灵活配置log日志输出方式包括输出优先级、输出目的地、输出格式。Log4j支持两种配置文件格式,一种是XML格式的文件,一种是Java特性文件log4j.properties(键=值)。下面将介绍使用log4j.properties文件作为配置文件的方法:

  配置根Logger,其语法为:0

  log4j.rootLogger = [ level ] , appenderName, appenderName, …

  其中,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来。 appenderName就是指定日志信息输出到哪个地方。可同时指定多个输出目的地。

  配置日志信息输出目的地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(将日志信息以流格式发送到任意指定的地方)

  配置日志信息的格式(布局),其语法为:

  log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
  log4j.appender.appenderName.layout.option1 = value1
  …
  log4j.appender.appenderName.layout.option = valueN

  其中,Log4j提供的layout有以下几种:
  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平台为“\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)

  2、在代码中使用Log4j

  得到记录器

  使用Log4j,第一步就是获取日志记录器,这个记录器将负责控制日志信息。其语法为:

  public static Logger getLogger( String name)

  通过指定的名字获得记录器,如果必要的话,则为这个名字创建一个新的记录器。Name一般取本类的名字,比如:

  static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )

  读取配置文件

  当获得了日志记录器之后,第二步将配置Log4j环境,其语法为:

BasicConfigurator.configure (): 自动快速地使用缺省Log4j环境。
  PropertyConfigurator.configure ( String configFilename) :读取使用Java的特性文件编写的配置文件。

例:PropertyConfigurator.configure(".\\src\\log4j.properties")
  DOMConfigurator.configure ( String filename ) :读取XML形式的配置文件。

  插入记录信息(格式化日志信息)

  当上两个必要步骤执行完毕,就可轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方,其语法如下:

  Logger.debug ( Object message ) ;
  Logger.info ( Object message ) ;
  Logger.warn ( Object message ) ;
  Logger.error ( Object message ) ;

log4j范例程序

下面将使用一个最简单的范例程序来进一步说明log4j的使用方法。程序代码如下:

 

import org.apache.log4j.*;

 

public class LogTest {

 

 

    static Logger logger = Logger.getLogger(LogTest.class.getName());

 

    public static void main(String[] args) {

 

        PropertyConfigurator.configure ( “.\\src\log4j.properties”)

logger.debug("Debug ...");

 

        logger.info("Info ...");

 

        logger.warn("Warn ...");

 

        logger.error("Error ...");

 

    }

}

程序说明:

static Logger logger = Logger.getLogger(LogTest.class.getName());就是创建一个属于LogTest类的Logger对象,创建时要告知Logger你当前的Class是什么。

PropertyConfigurator.configure ( “log4j.properties”)就是说使用当前工程目录下的src文件夹中的log4j.properties文件作为配置文件。若将log4j.properties放在工程根目录下也可不写此句,程序会自动找到配置文件。

logger.debug就是输出debug的信息,logger.info就是输出提示信息,logger.warn就是显示警告信息,logger.error就是显示错误信息。

 

下面是配置文件log4j.properties的内容:

log4j.rootCategory=DEBUG, stdoutR

log4j.appender.stdout=org.apache.log4j.ConsoleAppender

log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

log4j.appender.stdout.layout.ConversionPattern=%5p (%F:%L) - %m%n

log4j.appender.R=org.apache.log4j.RollingFileAppender

log4j.appender.R.File=log.txt

log4j.appender.R.MaxFileSize=100KB

log4j.appender.R.MaxBackupIndex=1

log4j.appender.R.layout=org.apache.log4j.PatternLayout

log4j.appender.R.layout.ConversionPattern=%d{yyyy MMM dd HH:mm:ss} %-5p %c - %m%n

程序说明:

log4j.rootCategory=DEBUG, stdoutR

就是说我要显示所有优先权等於和高于Debug的信息。
"stdout",
”R”表示我定义了两个输出端(随便什么名字都好)

下面的三行说stdout输出端其实是标准输出Console,也就是屏幕。输出的格式是PatternLayout。转换方式是%5p (%F:%L) - %m%n,即前五格用来显示优先权,再显示当前的文件名,加当前的行数。最后是logger.debug()logger.info()logger.warn()logger.error()里的信息。%n表示回车空行。

再加上下面六行则log信息不光显示在屏幕上,而且将被保存在一个叫"log.txt"的文件里,文件最大为100KB。如果文件大小超过100KB,文件会被备份成"log.txt.1",新的"log.txt"继续记录log信息。

接下来我们可以改变log4j.properties,而不需重新编译就可以控制log信息是否显示、log信息的输出端类型、输出方式、输出格式,等等。举例如下:

log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改写成"log4j.rootCategory=OFF, stdout,R",这样所有的log信息都不会显示了;解决了本文开始提出的问题。
log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改写成"log4j.rootCategory=INFO, stdout,R",这样只显示INFO, WARN, ERRORlog信息,而DEBUG信息不会被显示;

 

web程序中使用log4j注意问题

1、    由于jsp或servlet在执行状态时没有当前路径概念,所有使用PropertyConfigurator.configureString)语句找log4j.properties文件时要给出相对于当前jspservlet的路径转化成为一个绝对的文件系统路径。方法是使用servletcontext.getrealpath(string)语句。例:

//得到当前jsp路径

String prefix =  getServletContext().getRealPath("/");

//读取log4j.properties

PropertyConfigurator.configure(prefix+"\\WEB-INF\\log4j.properties");

2、相应的log4j.properties设置某个属性时也要在程序中设置绝对路径。例:

log4j.appender.R.File属性设置日志文件存放位置。我们可以用读写.properties配置文件的方法进行灵活设置。


log4e使用说明

在了解了log4j的功能后,我们肯定会我们的程序中编写一些Log4j日志记录。对于使用Eclipse的程序员Log4e将是我们最得力的log4j日志编写助手,现在开始Log4e之旅。

Log4e是一个免费的Eclipse Plugin,它可帮助你在你的Java工程中快速加入Log 我们可以在http://log4e.jayefem.de/index.php/Download网站上下载Log4e最新版本。下载后将相应文件夹拷贝到Eclipse的插件目录下,重新Eclipse,在首选项中会多出一个Log4e选项。

Log4e可以有多个插入Log为一个方法、类,当然也可以在当前位置插入Log,同时其也可以把Sysout.out.println()的转换为log;所有的这一切只需要你点点鼠标或者按一次快捷键,下面我们只以为一个方法插入Log为例来讲解

1.JPG

Java编辑上下文中点击右键,选择Log4E,你将看到如下界面:

2.JPG点击Insert Log Statement For This Method,你将看到验证页面:

3.JPG
Finish
后这时你将看到插入Log后的函数如下:
4.JPG
Log4e
更多的实例参照http://log4e.jayefem.de

 

 -==========
郁闷,格式总是调不好,不能在这里浪费时间了
有点失望~

posted on 2005-06-13 11:34 Cinderella 阅读(14689) 评论(20)  编辑  收藏 所属分类: 程序设计
评论:
  • # re: log4j/log4e的使用  hedong Posted @ 2005-06-17 16:15
    如果在每次调用logger.debug或info之前,检测一下这个功能是否enabled,可能是个好习惯。因为log的信息的生成,还是有一定的性能消耗的。遗憾的是,log4j举得例子里,也少有提到这一点。

    女生就是女生,好端端的一个blog界面,改得花里胡哨的,让人眼晕啊。  回复  更多评论   

  • # re: log4j/log4e的使用  Cinderella Posted @ 2005-06-17 17:22
    |||_!我正准备加音乐呢,让您这一说~唉~无论如何,谢谢您的回复^_^至于花里胡哨的问题,过两天再改吧~毕竟是爱美的女生,先让我欢喜两天再修改成符合大众口味吧^_^  回复  更多评论   

  • # re: log4j/log4e的使用  wwx Posted @ 2005-06-20 10:30
    强烈要求公开小荷mm的qq
    偶的29204760 ^_^
    至少得加我一下吧  回复  更多评论   

  • # 一个喜欢你的文章的人  f_qiangqiang Posted @ 2005-07-11 16:36
    我的泡泡 f_qiangqiang,加我吧,求你了!  回复  更多评论   

  • # re: log4j/log4e的使用  blood Posted @ 2005-07-12 14:06
    感谢小荷MM,你的文章让我log4j入门了  回复  更多评论   

  • # re: log4j/log4e的使用  丑男 Posted @ 2005-07-25 00:15
    你的版本是多少?我安装没有成功
    eclipse 3.02 + de.jayefem.log4e_free_1.0.3.zip
      回复  更多评论   

  • # re: log4j/log4e的使用  Cinderella Posted @ 2005-07-25 18:54
    eclipse 3.01 + de.jayefem.log4e_0.7.7  回复  更多评论   

  • # re: log4j/log4e的使用  Pearson Posted @ 2005-07-25 21:58
    已经很不错了,谢谢整理~  回复  更多评论   

  • # re: log4j/log4e的使用  yw Posted @ 2005-08-03 14:50
    我作为新手有豁然开朗的感觉,非常感谢,  回复  更多评论   

  • # re: log4j/log4e的使用  samplerain Posted @ 2005-08-19 17:02
    日志文件的路径怎么配?请问!  回复  更多评论   

  • # re: log4j/log4e的使用  ddm Posted @ 2006-01-12 00:47
    如果在每次调用logger.debug或info之前,检测一下这个功能是否enabled,可能是个好习惯。
    --log4j的logger类代码已经实现了,不需要自己检测  回复  更多评论   

  • # re: log4j/log4e的使用  andpass Posted @ 2006-01-12 15:08
    最恐怖的东西不在于是否isDebugenabled,而在于Log信息拼接消耗的时序,JDK1.5推荐用StringBuilder,可以在eclise中型以一个代码模板,

    if (logger.isDebugEnabled())
      logger.error(new StringBuilder("@--->").append(${cursor}).toString(), e);

    从而借助hotkey而不是右键菜单(快一点,再快一点,……),我最喜欢Log4E的就是Ctrl+Alt+D了,至于log格式还是自己定义模版会比较舒服吧~
    不过这里发帖子想泡妞的人还真是很多……  回复  更多评论   

  • # re: log4j/log4e的使用  Joule Posted @ 2006-07-01 13:00
    log4j.appender.R.File=log.txt
    log.txt的路径是?
    相对与什么的,
      回复  更多评论   

  • # re: log4j/log4e的使用  LOG4E Posted @ 2006-07-04 09:12
    LOG.TXT应该是放在根目录下面  回复  更多评论   

  • # re: log4j/log4e的使用  若凡 Posted @ 2006-08-09 15:59
    我在项目中使用了log4j,几乎是每个类的方法的入口和出口都使用了,这样好象对性能有很大的影响啊(即使关闭了日志的开关),不知道有没有更好的办法?  回复  更多评论   

  • # re: log4j/log4e的使用  yaoyao Posted @ 2006-09-06 11:35
    谢了MM.受益匪浅.  回复  更多评论   

  • # re: log4j/log4e的使用  freezingxu Posted @ 2007-03-04 21:49
    google到这里来的
    谢谢楼主,不介意的话我把这篇引用到自己那里去了  回复  更多评论   

  • # re: log4j/log4e的使用  王巍 Posted @ 2007-07-22 21:33
    崇拜啊,以前光用,先在终于有点懂了,顶啊  回复  更多评论   

  • # re: log4j/log4e的使用[未登录]  paul Posted @ 2007-11-23 17:44
    # re: log4j/log4e的使用 hedong Posted @ 2005-06-17 16:15
    如果在每次调用logger.debug或info之前,检测一下这个功能是否enabled,可能是个好习惯。因为log的信息的生成,还是有一定的性能消耗的。遗憾的是,log4j举得例子里,也少有提到这一点。


    同意这个说法,在输出前先判断enabled,这样效率会有提高  回复  更多评论   

  • # re: log4j/log4e的使用  游客 Posted @ 2008-06-03 12:48
    还是有点模糊  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 
 
Copyright © Cinderella Powered by: 博客园 模板提供:沪江博客