码迷,mamicode.com
首页 > Web开发 > 详细

Apache Commons logging简介和使用

时间:2014-12-19 12:15:18      阅读:6409      评论:0      收藏:0      [点我收藏+]

标签:apache   java   log4j   

本章节内容主要来自网络和整理。

Apache Commons Logging,又叫做JakartaCommons Logging (JCL),他提供的是一个日志(Log)接口(interface),同时兼顾轻量级和不依赖于具体的日志实现工具。它提供给中间件/日志工具开发者一个简单的日志操作抽象,允许程序开发人员使用不同的具体日志实现工具。用户被假定已熟悉某种日志实现工具的更高级别的细节。JCL提供的接口,对其它一些日志工具,包括Log4J, Avalon LogKit, and JDK等,进行了简单的包装,此接口更接近于Log4J和LogKit的实现.

执行顺序

JCL有两个基本的抽象类:Log(基本记录器)和LogFactory(负责创建Log实例)。当commons-logging.jar被加入到CLASSPATH之后,它会心可能合理地猜测你想用的日志工具,然后进行自我设置,用户根本不需要做任何设置。

默认的LogFactory是按照下列的步骤去发现并决定那个日志工具将被使用的,LogFactory按照顺序寻找,找到第一个工具后中止。

   1.寻找当前factory中名叫org.apache.commons.logging.Log配置属性的值

   2.寻找系统中属性中名叫org.apache.commons.logging.Log的值

   3.如果应用程序的classpath中有log4j,则使用相关的包装(wrapper)类(Log4JLogger)

   4.如果应用程序运行在jdk1.4的系统中,使用相关的包装类(Jdk14Logger);如果是其他版本的JDK,也会调用类似的包;

   5.使用简易日志包装类(SimpleLog)(新版本不用再考虑)

提示:如果在应用中有多个地方配置了日志的相关属性,可能最终执行的时候,没有按照预期进行执行,那么就有可能在其他优先级更加高的地方也设置了日志属性;导致最关注的日志属性根本没有得到执行,那么就可以按照这个执行顺序去寻找。

 

 

使用JCL开发

比较流行的是Commons-logging和Log4j结合使用。

1. 部署日志器

   下载commons-logging.jar和log4j.jar包(下载参考地址:http://www.ibiblio.org/maven/或http://jakarta.apache.org/),能后把它们放到工程的lib目录下,引入工程中。

2. 指定日志器

   在属性文件common-logging.properties中设置实现接口的类。如下:

#commons-logging.properties文件配置信息                                    

#org.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog       

# Must be one of ("trace","debug", "info", "warn", "error", or"fatal").                             

#利用log4j为输出介质                                                      

org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JCategoryLog

#JDK5 Logger                                                                                                           

#org.apache.commons.logging.Log=org.apache.commons.logging.impl.Jdk14Logger      

   在属性文件log4j.properties中设置日志的输出信息

#log4j.properties文件配置信息

log4j.rootLogger=ERROR,stdout,LF5,,file                                                                                                                                     

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

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

log4j.appender.stdout.layout.ConversionPattern=[start]%d{yyyy/MM/dd/HH:mm:ss}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]n%c[CATEGORY]%n%m[MESSAGE]%n%n                                                                                                                                     

log4j.appender.file=org.apache.log4j.RollingFileAppender                                                                                                              

log4j.appender.file.File=sdcrm.log                                                                                                                                                

log4j.appender.file.MaxFileSize=100KB                                                                                                                                       

log4j.appender.file.MaxBackupIndex=5                                                                                                                                        

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

log4j.appender.file.layout.ConversionPattern=[start]%d{yyyy/MM/dd/HH:mm:ss}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n                                                                                                                                             

log4j.appender.LF5=org.apache.log4j.lf5.LF5Appender                                                                                                                    

log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000                                                                                                       

    最后要把properties属性文件保存到Web-INF/classes目录下。

实现例:

//在程序文件头部import相关的类

import org.apache.commons.logging.Log;

importorg.apache.commons.logging.LogFactory;

......

//在类中获取一个实例

public class MYCLASS

{

private static Log log =LogFactory.getLog(MyCLASS.class);

...

 }

 

日志信息被送往记录器,如上例中的log。这个发送过程,是通过调用Log接口中定义的方法完成的,不同方法跟不同的级别联系在一起,日志信息通过哪个级别的方法发送,就标明了日志信息的级别。org.apache.commons.logging.Log接口中定义的方法,按严重性由高到低的顺序有:

 

log.fatal(Object message);

 

log.fatal(Object message, Throwable t);

 

log.error(Object message);

 

log.error(Object message, Throwable t);

 

log.warn(Object message);

 

log.warn(Object message, Throwable t);

 

log.info(Object message);

 

log.info(Object message, Throwable t);

 

log.debug(Object message);

 

log.debug(Object message, Throwable t);

 

log.trace(Object message);

 

log.trace(Object message, Throwable t);

除此以外,还提供下列方法以便代码保护.

log.isFatalEnabled();

 

log.isErrorEnabled();

 

log.isWarnEnabled();

 

log.isInfoEnabled();

 

log.isDebugEnabled();

 

log.isTraceEnabled();

 

  信息级别

  确保日志信息在内容上和反应问题的严重程度上的恰当,是非常重要的。

fatal非常严重的错误,导致系统中止。期望这类信息能立即显示在状态控制台上。

 

error其它运行期错误或不是预期的条件。期望这类信息能立即显示在状态控制台上。

 

warn使用了不赞成使用的API、非常拙劣使用API, ‘几乎就是‘错误, 其它运行时不合需要和不合预期的状态但还没必要称为 "错误"。期望这类信息能立即显示在状态控制台上。

 

info运行时产生的有意义的事件。期望这类信息能立即显示在状态控制台上。

 

debug系统流程中的细节信息。期望这类信息仅被写入log文件中。

 

trace更加细节的信息。期望这类信息仅被写入log文件中。

 

通常情况下,记录器的级别不应低于info.也就是说,通常情况下debug的信息不应被写入log文件中。

 

生命周期

JCL LogFactory必须实现建立/断开到日志工具的连接,实例化/初始化/解构一个日志工具.

 

异常处理

JCL Log 接口没有指定任何异常处理,对接口的实现必须捕获并处理异常。

 

多线程

JCL Log 和 LogFactory 的实现,必须确保任何日志工具对并行的要求.

 

历史渊源

org.apache.commons.logging.Log 和org.apache.log4j.Logger 这两个类,通过包名我们可以发现它们都是 apache 的项目,既然如此,为何要动如此大的动作搞两个东西(指的是 commons-logging 和 log4j)出来呢?事实上,在 sun 开发 logger 前,apache 项目已经开发了功能强大的 log4j 日志工具,并向 sun 推荐将其纳入到 jdk 的一部分,可是 sun 拒绝了 apache 的提议,sun 后来自己开发了一套记录日志的工具。可是现在的开源项目都使用的是 log4j,log4j 已经成了事实上的标准,但由于又有一部分开发者在使用 sun logger,因此 apache 才推出 commons-logging,使得我们不必关注我们正在使用何种日志工具。

Apache Commons logging简介和使用

标签:apache   java   log4j   

原文地址:http://blog.csdn.net/ffm83/article/details/42024685

(0)
(1)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!