HelloWorld 善战者,求之于势,不责于人;故能择人而任势。

知止而后有定,定而后能静,静而后能安,安而后能虑,虑而后能得。物有本末,事有终始。知所先后,则近道矣。

  BlogJava :: 首页 ::  :: 联系 ::  :: 管理 ::
  167 随笔 :: 1 文章 :: 40 评论 :: 0 Trackbacks

一 最好与commons-logging一起用,why?

    1.标准接口,即使将来脱离了log4j也一样用
    2.简化了编码,减少耦合度:不需在代码中指定log4j配制文件位置,代码中不需要引用log4j的包
    3.基本所有框架都是这么用的。。。。。。(我相信群众)

    附加提供一下commons-logging寻找配置文件的顺序(从别人那抄的)
      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;


二 具体实现

    1.把commons-logging的jar加到classpath中
    2.把log4j的jar加到classpath中
    3.在classpath的根目录下,建立log4j.properties(必须是这个地方,必须叫这个名,才不用特殊配置),可以直接复制后边的模板
    4.在需要log的类中:
        import org.apache.commons.logging.Log;
        import org.apache.commons.logging.LogFactory;

        private static Log log = LogFactory.getLog(xxxx.class);
          为什么要使用static?因为避免产生多个实例
          为什么不使用this.class?因为是static不能用this(我经常犯这个错误。。。)
          为什么不使new XXXX().getClass()?因为。。。。你猜呢?
    5.根据实际需要log.debug()、log.info()、log.warn()、log.error()、log.fatal()    就可以输出不同等级的log


三 log的等级

    1.为什么需要等级?写代码的时候可能需要很多调试信息,运行的时候可能需要显示提示信息,如果在服务器上发生严重错误的时候,可能需要给管理员发邮件。这种:调试,提示,错误就是等级。
    2.都有什么等级? 调试(DEBUG)<信息(INFO)<警告(WARN)<错误(ERROR)<致命错误(FATAL)
    3.怎么用?         log.debug() log.info() log.warn() log.error() log.fatal()依次对应上边的等级


四 log4j的配制

1.基本参数解释:
    ⑴全局配制
      log4j.rootLogger = [ level ] , appenderName, appenderName,..........appenderName
      ★log4j.rootLogger的意思可以理解为:根log或者所有的log
      ★level就是输出级别,只能设置一个值。
       ·关于等级,前边已经说过了有5种,他们之间的关系可以理解为:
          调试(DEBUG):包含调试(DEBUG)、信息(INFO)、警告(WARN)、错误(ERROR)、致命错误(FATAL)
          信息(INFO):包含信息(INFO)、警告(WARN)、错误(ERROR)、致命错误(FATAL)
          警告(WARN):包含警告(WARN)、错误(ERROR)、致命错误(FATAL)
          错误(ERROR):包含错误(ERROR)、致命错误(FATAL)
          致命错误(FATAL):只有他自己
          这样,如果log4j.rootLogger = INFO,那么 INFO,WARN,ERROR,FATAL就全部会被输出
          如果log4j.rootLogger = ERROR,那么ERROR,FATAL就全部会被输出
      ★appenderName就是记录的目标,目标可以多个,中间用『,』分割,appenderName是自己定义的,换句话说,名字是随便起的,起了名之后,就需要在下边设定具体配制
      总结一下这部分,比如说有这么一句log4j.rootLogger = INFO , F1,F2那么就以为着要将所有INFO,WARN,ERROR,FATAL的log全部输出到F1,F2上。F1,F2是什么?往下看。。。。
    ⑵具体配制
      log4j.appender.F1=org.apache.log4j.ConsoleAppender
      log4j.appender.F1.layout=org.apache.log4j.PatternLayout
      log4j.appender.F1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n
      ★log4j.appender.F1=org.apache.log4j.ConsoleAppender的意思就是:将F1设置为控制台输出
       ·还可以设置成什么?
          org.apache.log4j.ConsoleAppender(控制台),
          org.apache.log4j.FileAppender(文件),
          org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
          org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
          org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
      ★log4j.appender.F1.layout=org.apache.log4j.PatternLayout的意思就是:将F1的输出布局设置为自定义输出布局。
       ·还可以设置成什么?
          org.apache.log4j.HTMLLayout(以HTML表格形式布局)
          org.apache.log4j.xml.XMLLayout(以XML形式布局)
          org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
          org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
          org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
      ★log4j.appender.F1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n既然上边定义的是自定义输出布局,那么就要定义一下具体输出什么样了~~上边的%c %p %m 等以%开头的都是模式字符串,除了模式字符串外[]-空格等这些字符会按照原样显示。
       ·模式字符串解释:
          %m:消息本身
          %p:消息的级别INFO,WARN,ERROR。。。
          %r:从程序开始执行到当前日志产生时的时间间隔(微秒)
          %c:输出当前日志动作所在的category名称。例如:如果category名称是"a.b.c","%c{2}"将会输出"b.c". {2}意谓着输出“以点分隔开的category名称的后两个组件”,如果 {n}没有,将会输出整个category名称.
          %t:输出当前线程的名称
          %x:输出和当前线程相关联的NDC,尤其用到像java servlets这样的多客户多线程的应用中。
          %n:输出平台相关的换行符。
          %%:输出一个"%"字符
          %d:输出日志产生时候的日期,当然可以对日期的格式进行定制。例如:%d{HH:mm:ss,SSSS}或者是%d{dd MMM yyyy HH:mm:ss,SSSS},如果没有指定后面的格式,将会输出ISO8601的格式。
          %l:输出位置信息,相当于%C.%M(%F:%L)的组合。
          %C:输出日志消息产生时所在的类名,如果类名是“test.page.Class1”%C{1}表示输出类名"Class1",%C{2}输出"page.Class1",而%C则输出"test.page.Class1"。
          %M:输出日志消息产生时的方法名称
          %F:输出日志消息产生时所在的文件名称
          %L:输出代码中的行号
       ·可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
          1)%20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
          2)%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,"-"号指定左对齐。
          3)%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
          4)%20.30c:如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边交远销出的字符截掉。
      总结一下,现在来我们所配制的F1的全部内容
      ·我们把它配制成了屏幕输出
      ·输出的布局为:自定义布局
      ·我们又定义了自定义布局的格式:日期时间(格式为:yyyy-MM-dd HH:mm:ss,SSS)[产生该日志的包名类名方法名] [等级] 信息+回车
      如果想配制F2为每天产生一个日志文件,并且保存为xml,就这么写:
      log4j.appender.F2=org.apache.log4j.DailyRollingFileAppender
      log4j.appender.F2.layout=org.apache.log4j.xml.XMLLayout
      这样就可以了吗?当然不是,既然保存为文件。。至少要指定一个文件名吧
      log4j.appender.F2.File=c:/logs/log.xml
      可以了吗?可以运行了。。。但是。。既然每天都产生一个文件,那么前一天的怎么办呢?
      log4j.appender.F2.DatePattern=yyyyMMdd'.xml.back'
      这样log4j会在第一次产生今天的log的同时,将昨天的log备份为 log文件名.扩展名yyyyMMdd.xml.back。对应我们这个文件,今天的log到明天有新log产生的时候,就会变为log.xml20070420.xml.back
      这样的参数到底有多少?常用的有:
      ★ConsoleAppender选项
       ·Threshold=WARN:指定日志消息的输出最低层次。
       ·ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
       ·Target=System.err:默认情况下是:System.out,指定输出控制台
      ★FileAppender 选项
       ·Threshold=WARN:指定日志消息的输出最低层次。
       ·ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
       ·File=mylog.txt:指定消息输出到mylog.txt文件。
       ·Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
      ★RollingFileAppender 选项
       ·Threshold=WARN:指定日志消息的输出最低层次。
       ·ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
       ·File=mylog.txt:指定消息输出到mylog.txt文件。
       ·Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
       ·MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件。
       ·MaxBackupIndex=2:指定可以产生的滚动文件的最大数。
      ★DailyRollingFileAppender 选项
       ·Threshold=WARN:指定日志消息的输出最低层次。
       ·ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
       ·File=mylog.txt:指定消息输出到mylog.txt文件。
       ·Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
       ·DatePattern='.'yyyy-ww:每周滚动一次文件,即每周产生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如下:
         1)'.'yyyy-MM: 每月
         2)'.'yyyy-ww: 每周
         3)'.'yyyy-MM-dd: 每天
         4)'.'yyyy-MM-dd-a: 每天两次
         5)'.'yyyy-MM-dd-HH: 每小时
         6)'.'yyyy-MM-dd-HH-mm: 每分钟
      ★PatternLayout 选项
       ·ConversionPattern=%m%n :指定怎样格式化指定的消息。
      ★HTMLLayout 选项
       ·LocationInfo=true:默认值是false,输出java文件名称和行号
       ·Title=my app file: 默认值是 Log4J Log Messages.
      ★XMLLayout 选项
       ·LocationInfo=true:默认值是false,输出java文件和行号
      现在来看一下我们完整的第一个配制文件:
========================================================================================
log4j.rootLogger = INFO,F1,F2

log4j.appender.F1=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.F1.Target=System.out
log4j.appender.F1.layout=org.apache.log4j.PatternLayout
log4j.appender.F1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

log4j.appender.F2=org.apache.log4j.DailyRollingFileAppender
log4j.appender.F2.File=c:/logs/log.xml
log4j.appender.F2.DatePattern=yyyyMMdd-HH'.xml.back'
log4j.appender.F2.layout=org.apache.log4j.xml.XMLLayout
========================================================================================
      编段代码看看效果
========================================================================================
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class Main{
      private static Log log = LogFactory.getLog(Main.class);
      public static void main(String[] args) throws Exception{
          log.info("info");
          log.debug("debug");
          log.warn("warn");
          log.error("error");
      }

}
========================================================================================
      运行效果
========================================================================================
2007-04-20 12:36:22,531 [cn.yyun.test.Main]-[INFO] info
2007-04-20 12:36:22,531 [cn.yyun.test.Main]-[WARN] warn
2007-04-20 12:36:22,531 [cn.yyun.test.Main]-[ERROR] error
========================================================================================
      并且在c:/logs/下有log.xml生成,里边的内容为:
========================================================================================
<log4j:event logger="cn.yyun.test.Main" timestamp="1177043782531" level="INFO" thread="main">
<log4j:message><![CDATA[info]]></log4j:message>
</log4j:event>

<log4j:event logger="cn.yyun.test.Main" timestamp="1177043782531" level="WARN" thread="main">
<log4j:message><![CDATA[warn]]></log4j:message>
</log4j:event>

<log4j:event logger="cn.yyun.test.Main" timestamp="1177043782531" level="ERROR" thread="main">
<log4j:message><![CDATA[error]]></log4j:message>
</log4j:event>
========================================================================================
      仔细看一下会发现,虽然我们在代码里写了log.debug("debug")但是debug并没有出现在log中,这是因为我们配置文件中,定义了log的等级为INFO,debug的等级小于info,所以不会显示,而warn,error的大于info,所以也会被显示出来


2.根据package生成不同的log文件
    ⑴配置
      log4j.logger.cn.yyun.test.abc=INFO,abc2,abc1

      log4j.appender.abc2=org.apache.log4j.ConsoleAppender
      log4j.appender.abc2.layout=org.apache.log4j.PatternLayout
      log4j.appender.abc2.layout.ConversionPattern=abc:[%p] %m%n

      log4j.appender.abc1=org.apache.log4j.DailyRollingFileAppender
      log4j.appender.abc1.File=C:/logs/abc.log
      log4j.appender.abc1.DatePattern='.'yyyyMMdd
      log4j.appender.abc1.layout=org.apache.log4j.PatternLayout
      log4j.appender.abc1.layout.ConversionPattern=%d %r [%t] %5p - %m%n

      log4j.logger.cn.yyun.test.def=INFO,def
      log4j.appender.def=org.apache.log4j.ConsoleAppender
      log4j.appender.def.layout=org.apache.log4j.PatternLayout
      log4j.appender.def.layout.ConversionPattern=def: [%p] %m%n

      把logger.cn.yyun.test.abc换成需要的package就可以了(整个log4j配制文件中只有这些就可以了 )。但是这样会有另一个问题,如果cn.yyun.test.Main这个类中,如果有log操作,会报告:log4j:WARN No appenders could be found for logger (cn.yyun.test.Main).所以要加上log4j.rootCategory=INFO,F1    这样所有的log都会被纪录了。。但是这样又做之后:cn.yyun.test.def里的log,会同时出现在def和F1中,cn.yyun.test.abc里的log,会同时出现在abc1,abc2和F1中。。。。。所以定义的时候一定要规划好。
    ⑵制定package的log等级
      log4j.logger.org.hibernate=DEBUG



</script>

posted on 2007-08-13 19:04 helloworld2008 阅读(711) 评论(0)  编辑  收藏

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


网站导航: