log4j的基本用法

Log4j由三种主要组件组成:Logger,Appender,Layout。

 

Logger负责产生日志并筛选日志信息，控制日志的输出。日志分为5个级别，从高到低依次是FATAL，ERROR，WARN，INFO，DEBUG.如果一个记录器没有指定日志级别，那么它将从最近的一个指定了级别的祖先继承级别。在Logger类中定义的生成日志信息的打印方法有:debug(),info(),warn(),error(),fatal()和log()。

 

Appender主要有以下几种：

org.apche.log4j.ConosleAppender 输出到控制台。

org.apche.log4j.FileAppender 输出到文件。

org.apche.log4j.DailyRollingFileAppender 按指定时间频率滚动产生日志。

org.apche.log4j.RollingFileAppender  当文件到达一定大小时备份日志文件。

 

Layout有如下几种:

org.apche.log4j.SimpleLayout 输出  日志级别-日志消息。

org.apche.log4j.HTMLLayout  以HTML表格的方式输出日志消息。

org.apche.log4j.xml.XMLLayout  由一系列在log4j.dtd中定义的<log4j:event>元素组成。

org.apche.log4j.TTCCLayout 输出time，thread,category,context信息组成。

org.apche.log4j.PatternLayout  提供格式化的输出结果。

 

 

定义配置文件

其实您也可以完全不使用配置文件，而是在代码中配置Log4j环境。但是，使用配置文件将使您的应用程序更加灵活。

Log4j支持两种配置文件格式，一种是XML格式的文件，一种是Java特性文件（键=值）。下面介绍使用Java特性文件做为配置文件的方法：

1. 配置根Logger，其语法为：

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

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

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

3. 配置日志信息的格式（布局），其语法为：

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

程序中使用Log4j:

1.得到记录器 

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

public static Logger getLogger( String name)，

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

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

2.读取配置文件 

当获得了日志记录器之后，第二步将配置Log4j环境，其语法为： 
BasicConfigurator.configure ()： 自动快速地使用缺省Log4j环境。 
PropertyConfigurator.configure ( String configFilename) ：读取使用Java的特性文件编写的配置文件。 
DOMConfigurator.configure ( String filename ) ：读取XML形式的配置文件。 

3.插入记录信息 

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

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