Log4j是Apache的一个开放源代码目Q通过使用Log4jQ我们可以控制日志信息输送的目的地是控制台、文?/font>
、GUIlg、甚x套接口服务器、NT的事件记录器、UNIX Syslog守护q程{；我们也可以控制每一条日志的输出格式
Q通过定义每一条日志信息的U别Q我们能够更加细致地控制日志的生成过E。最令h感兴的是Q这些可以通过一
个配|文件来灉|地进行配|，而不需要修改应用的代码?br />
此外Q通过Log4j其他语言接口Q您可以在C、C++?Net、PL/SQLE序中用Log4jQ其语法和用法与在JavaE序?/font>
一P使得多语a分布式系l得C个统一一致的日志lg模块。而且Q通过使用各种W三Ҏ展，您可以很方便地将
Log4j集成到J2EE、JINI甚至是SNMP应用中?/font>
二，使用前的准备?br /> 1、下载log4j 地址为：http://jakarta.apache.org/log4j/docs/download.html.
2、你可能要用到的jar文g有：
如果需要将日志发送到邮箱Q则需要javamail API,JAF API (the JavaBeans Activation Framework)
下蝲地址Q http://java.sun.com/products/javamail/
http://java.sun.com/beans/glasgow/jaf.html
如果需要jms的支持，则需要jms API 下蝲地址为：
http://java.sun.com/products/jms/vendors.html
三， Log4j介绍
Log4j׃个重要的lg构成Q日志信息的优先U?priorityQ日志信息的输出目的地AppenderQ日志信息的?/font>
出格式（布局Qlayout?br /> 1、日志的优先U，
从低到高Q依ơ有QDEBUG,INFO,WARN,ERROR,分别用来指定q条日志信息的重要程度；如果定义了了输入的
别ؓINFOQ则只有{于及高于这个别的才进行处理，此时输入INFO,WARN,ERROR。值得注意的是Q别中q有两个?/font>
键字Q?br /> ALL:打印所有的日志Q?br /> OFFQ关闭所有的日志输出?br />
2、输出端 Appender
log4j提供了以下几U常用的输出目的圎ͼ
org.apache.log4j.ConsoleAppenderQ将日志信息输出到控制台
org.apache.log4j.FileAppenderQ将日志信息输出C个文?br /> org.apache.log4j.DailyRollingFileAppenderQ将日志信息输出C个，q且每天输出C个新的日志文?
按照不同的配|可以定义每月一个日志文Ӟ或者每周，每天Q每时Q每分钟{输Z个新的日志文件?br /> org.apache.log4j.RollingFileAppenderQ将日志信息输出C个文Ӟ通过指定文g的的寸Q当文g大小
到达指定寸的时候会自动把文件改名，如名为example.log的文件会改名为example.log.1Q同时生一个新?/font>
example.log文g。如果新的文件再ơ达到指定尺寸，又会自动把文件改名ؓexample.log.2Q同时生一个example.log
文g。依此类推，直到example.log. MaxBackupIndexQMaxBackupIndex的值可在配|文件中定义?br /> org.apache.log4j.WriterAppenderQ将日志信息以流格式发送到L指定的地斏V?br /> org.apache.log4j.jdbc.JDBCAppenderQ通过JDBC把日志信息输出到数据库中?br /> org.apache.log4j.net.SMTPAppender,日志信息以邮g的方式发送到指定的邮?/font>
3、输出格式（布局Qlayout
通过appender可以控制输出的目的地Q而如果要控制输出的格式，可通过log4j的layoutlg来实现。通过?/font>
|文件定义一个appender的输出格式，Log4j提供的布局模式有以下几U：
org.apache.log4j.ConsoleAppenderQ输出到控制?br /> org.apache.log4j.HTMLLayoutQ以HTML表格形式布局
org.apache.log4j.PatternLayoutQ可以灵zd指定布局模式
org.apache.log4j.SimpleLayoutQ包含日志信息的U别和信息字W串
值得一提的是org.apache.log4j.PatternLayout 以Pattern方式的布局Q用Pattern的方式来指定布局?/font>
pattern 的参数如下：ConversionPattern参数的格式含?br /> 格式?含义
%c 输出日志信息所属的cȝ全名
%d 输出日志旉点的日期或时_默认格式为ISO8601Q也可以在其后指定格式，比如Q?d{yyy-MM-dd
HH:mm:ss }Q输出类|2002-10-18- 22Q?0Q?8 ;比如 %d{HH:mm:ss,SSS} ?%d{dd MMM yyyy HH:mm:ss,SSS}.
格式可以参?javac?SimpleDateFormat,不过 按照此类的设|会影响速度。你可以选择更快的方?%d{ISO8601},
%d{ABSOLUTE}, %d{RELATIVE}.或者用log4j的ISO8601DateFormat, AbsoluteTimeDateFormat,
RelativeTimeDateFormat ?DateTimeDateFormat 方式.
%f 输出日志信息所属的cȝcd
%l 输出日志事g的发生位|，卌出日志信息的语句处于它所在的cȝW几?br /> %m 输出代码中指定的信息Q如log(message)中的message
%M 输出日志信息中所发生的方法名?br /> %n 输出一个回车换行符QWindowsq_为“\r\n”，Unixq_为“\n?br /> %p 输出优先U，即DEBUGQINFOQWARNQERRORQFATAL。如果是调用debug()输出的，则ؓDEBUGQ依此类?br /> %r 输出自应用启动到输出该日志信息所耗费的毫U数
%t 输出产生该日志事件的U程?br />四、?/strong>
4.1.1 SimpleLayout ?FileAppender 方式
以下是以文g的输出方式Appender和简单的布局方式SimpleLayout的例子：
import org.apache.log4j.Level;
import org.apache.log4j.Logger;
import org.apache.log4j.SimpleLayout;
import org.apache.log4j.FileAppender;
public class simpandfile {
static Logger logger = Logger.getLogger(simpandfile.class);
public static void main(String args[]) {
SimpleLayout layout = new SimpleLayout();
FileAppender appender = null;
try {
appender = new FileAppender(layout,"output1.txt",false);
} catch(Exception e) {}
logger.addAppender(appender);
logger.setLevel((Level) Level.DEBUG);
logger.debug("Here is some DEBUG");
logger.info("Here is some INFO");
logger.warn("Here is some WARN");
logger.error("Here is some ERROR");
logger.fatal("Here is some FATAL");
}
}
首先实例化Logger对象。static Logger logger = Logger.getLogger(simpandfile.class);然后指定输出的方
式和布局 appender = new FileAppender(layout,"output1.txt",false);logger.addAppender(appender);
最后定义别：logger.addAppender(appender);q样完成了log4j日志cȝ初始?接着可以进行日志输Z。这是
log4j日志cȝ使用时的一般顺序。因以下E序比较单，特别的地方将会有注释Q将不再解释?/font>
4.1.2. HTMLLayout ?WriterAppender
import java.io.*;
import org.apache.log4j.Level;
import org.apache.log4j.Logger;
import org.apache.log4j.HTMLLayout;
import org.apache.log4j.WriterAppender;
public class htmlandwrite {
static Logger logger = Logger.getLogger(htmlandwrite.class);
public static void main(String args[]) {
HTMLLayout layout = new HTMLLayout();
WriterAppender appender = null;
try {
FileOutputStream output = new FileOutputStream("output2.html");
appender = new WriterAppender(layout,output);
} catch(Exception e) {}
logger.addAppender(appender);
logger.setLevel((Level) Level.DEBUG);
logger.debug("Here is some DEBUG");
logger.info("Here is some INFO");
logger.warn("Here is some WARN");
logger.error("Here is some ERROR");
logger.fatal("Here is some FATAL");
}
}
4.1.3. PatternLayout and ConsoleAppender
import org.apache.log4j.Level;
import org.apache.log4j.Logger;
import org.apache.log4j.PatternLayout;
import org.apache.log4j.ConsoleAppender;
public class consandpatt {
static Logger logger = Logger.getLogger(consandpatt.class);
public static void main(String args[]) {
// Note, %n is newline
String pattern = "Milliseconds since program start: %r %n";
pattern += "Classname of caller: %C %n";
pattern += "Date in ISO8601 format: %d{ISO8601} %n";
pattern += "Location of log event: %l %n";
pattern += "Message: %m %n %n";
PatternLayout layout = new PatternLayout(pattern);
ConsoleAppender appender = new ConsoleAppender(layout);
logger.addAppender(appender);
logger.setLevel((Level) Level.DEBUG);
logger.debug("Here is some DEBUG");
logger.info("Here is some INFO");
logger.warn("Here is some WARN");
logger.error("Here is some ERROR");
logger.fatal("Here is some FATAL");
}
}
4.2 使用配置文g来定义输出Appender和布局格式Layout
log4j支持两种方式的配|方式，.properties 二进制文件和xml文g的方式。我们简单讲一?properties的配
|方式后Q将主要讨论xml文g的配|方式?br />
4.2.1 我们以.properties文g的格式定义两U输出方式，一U是输出到文件中Q另一U是输出到数据库?/font>
?
首先定义simple.properties文g,文g定义如下Q?br />
#定义了两个输出端
log4j.rootLogger = INFO,f,db
# 定义f输出到文?q且文g是随着大小而增加的
log4j.appender.f = org.apache.log4j.RollingFileAppender
log4j.appender.f.File = F:\\nepalon\\classes\\test1.log
log4j.appender.f.MaxFileSize = 1000KB
log4j.appender.f.MaxBackupIndex = 3
log4j.appender.f.layout = org.apache.log4j.PatternLayout
log4j.appender.f.layout.ConversionPattern = %d{yyyy-MM-dd hh:mm:ss}:%p %t %c - %m%n
#定义db输出到数据库
log4j.appender.db = org.apache.log4j.jdbc.JDBCAppender
log4j.appender.db.BufferSize = 40
log4j.appender.db.Driver = com.microsoft.jdbc.sqlserver.SQLServerDriver
log4j.appender.db.URL = jdbc:microsoft:sqlserver://127.0.0.1:1433;DatabaseName=test
log4j.appender.db.User = sa
log4j.appender.db.Password =
log4j.appender.db.layout = org.apache.log4j.PatternLayout
log4j.appender.db.layout.ConversionPattern = INSERT INTO log4j (createDate, thread, priority,
category, message) values('%d{ISO8601}', '%t', '%-5p', '%c', '%m')
然后E序中将引用q配|文件。定义如下：
import org.apache.log4j.Logger;
import org.apache.log4j.xml.DOMConfigurator;
public class Test {
static Logger logger = Logger.getLogger(Test.class);
public static void main(String args[]) {
//以property方式d配置文g?br /> PropertyConfigurator.configure ( "simple.properties" ) ;
logger.debug("Here is some DEBUG");
logger.info("Here is some INFO");
logger.warn("Here is some WARN");
logger.error("Here is some ERROR");
logger.fatal("Here is some FATAL");
}
}
4.2.2 以xml配置
E序如下Q?br /> import org.apache.log4j.Logger;
import org.apache.log4j.xml.DOMConfigurator;
public class Test {
static Logger logger = Logger.getLogger(Test.class);
public static void main(String args[]) {
//以XML方式d配置文g?br /> DOMConfigurator.configure("xmllog4jconfig.xml");
logger.debug("Here is some DEBUG");
logger.info("Here is some INFO");
logger.warn("Here is some WARN");
logger.error("Here is some ERROR");
logger.fatal("Here is some FATAL");
}
}
xmllog4jconfig.xml 如下Q?/font>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="appender" class="org.apache.log4j.FileAppender">
<param name="File" value="Indentify-Log.txt"/>
<param name="Append" value="false"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d [%t] %p - %m%n"/>
</layout>
</appender>
<root>
<priority value ="debug"/>
<appender-ref ref="appender"/>
</root>
</log4j:configuration>
Ҏproperties方式和xml方式Q可以看Z们程序中Q除了定义读取配|文件的方式不同?其它的根本就?/font>
有区别了Q这也就是log4j的魅力所在了Q不需要改变程序，只需要通过改变定义的配|文Ӟ我们可以控制日志的?/font>
出方式，是否输出Q输出格式。我们可以通过定义不同的xml文g来控制输出方?以下是各U输出方式与布局的例子?br />
4.2.3 比较单的一个?br /> <?xml version="1.0" encoding="gb2312" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<!--
配置输出的日志目录ؓ在控制台?br /> 格式采用为PatternLoyout,q且样式为：%d{ISO8601} %r [%c :: %p %m]%n
-->
<appender name="CA" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d{ISO8601} %r [%c :: %p %m]%n"/>
</layout>
</appender>
<root>
<priority value ="debug"/>
<appender-ref ref="CA"/>
</root>
</log4j:configuration>
4.2.4 文g的输?pattern的布局
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="appender" class="org.apache.log4j.FileAppender">
<param name="File" value="Indentify-Log.txt"/>
<param name="Append" value="false"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d [%t] %p - %m%n"/>
</layout>
</appender>
<root>
<priority value ="debug"/>
<appender-ref ref="appender"/>
</root>
</log4j:configuration>
4.2.5 控制台的输出 和简单的布局
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.SimpleLayout"/>
</appender>
<root>
<priority value ="debug" />
<appender-ref ref="ConsoleAppender"/>
</root>
</log4j:configuration>
4.2.6 定义三种输出方式Q按照不同的U别Q选择不同的输出方?debug,info,U别通过System.out来打印?br /> WARN,FATAL通过System.err来输出。ERROR,FATAL发送到邮箱?/font>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration>
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<param name="Target" value="System.out" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{ISO8601}] %-5p %c %m %n" />
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="DEBUG"/>
<param name="LevelMax" value="INFO"/>
</filter>
</appender>
<appender name="STDERR" class="org.apache.log4j.ConsoleAppender">
<param name="Target" value="System.err" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{ISO8601}] %-5p %c %m %n" />
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="WARN"/>
<param name="LevelMax" value="FATAL"/>
</filter>
</appender>
<!-- -->
<!-- Declare the SMTPAppender -->
<!-- -->
<appender name="EMAIL" class="org.apache.log4j.net.SMTPAppender">
<param name="BufferSize" value="512" />
<param name="SMTPHost" value="mail.suiyuanwu.com" />
<param name="From" value="log4j@server5" />
<param name="To" value="web@suiyuanwu.com" />
<param name="Subject" value="[SMTPAppender] Application message" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d{ISO8601}]%n%n%-5p%n%n%c%n%n%m%n%n" />
</layout>
<filter class="org.apache.log4j.varia.LevelRangeFilter">
<param name="LevelMin" value="ERROR"/>
<param name="LevelMax" value="FATAL"/>
</filter>
</appender>
<!-- -->
<!-- setup log4j's root logger -->
<!-- -->
<root>
<level value="all" />
<appender-ref ref="STDOUT"/>
<appender-ref ref="STDERR"/>
<appender-ref ref="EMAIL" />
</root>
</log4j:configuration>
五、参考资?/strong>
1.http://www.vipan.com/htdocs/log4jhelp.html
Don't Use System.out.println! Use Log4j - Vipan Singla
2.http://jakarta.apache.org/log4j/docs/manual.html
Short introduction to log4j - Ceki Gülcü - March 2002
3.http://www-128.ibm.com/developerworks/cn/java/jw-log4j/
log4j提供了对日志记录的控?br /> 4.http://logging.apache.org/log4j/docs/documentation.html
log4j提供的文档?/font>
]]>
]]>