这个文档资料描述了log4j API，它的独特的特性和设计原理。Log4j是由许多作者共同参与的开放源代码项目。它允许开发人员以任意的精细程度控制哪些日志说明被输出。通过使用外部的配置文件，可以在运行时配置它。最好的是，log4j 开发包很容易上手。注意，它也可能会使一些开发人员着迷.
详情请进:log4j简明手册



另外一篇文章:

作者:廖武锋
MSN:liaowufeng1111@hotmail.com

1 log4j是什么?
Log4j是一个开源的日志记录组件，其产品已经相当的成熟，且使用非常的广泛。在工程中以易用，方便等代替了 System.out 等打印语句。
Log4j的目标是：它允许开发人员以任意的精细程度控制哪些日志说明被输出。通过使用外部的配置文件，可以在运行时配置它。
通过其要实现的目标，我们已理解出log4j将是一个十分好用的组件。
Log4j的具体在 http://logging.apache.org/log4j/找到 它。另外，log4j已经被转换成 C, C++, C#, Perl, Python, Ruby, 和 Eiffel 语言。
下面，我就从log4j的配置文件来具体讲述，log4j的功能，通过配置文件来学习新技术已是一个很好的学习方法。
Log4j有两个重要的概念：一是日志级别,其日志级别关系为
DEBUG>INFO>WARN>ERROR>FATAL 原则，高级别将显示低级别的日志
二是appender(也是输出目标),在这上的还有输出格式
其支持的输出目标为 文件，控制台，数据库,且支持一次指定多个输出目标
Log4j的配置文件除了支持：*.properties 文件名，还支持运用十分广泛的xml文件。
下面的讲述中，我只通过*.properties文件来说明。
Log4j的属性文件的讲述
# 定义根日志,日志级别为DEBUG 输出目标为控制台，文件
log4j.rootLogger=INFO,A1,R
# 包com.liaowf日志,日志级别为DEBUG 输出目标为控制台，文件(注意，包com.liaowf下的所有类将自动拥有此日志属性)
log4j.logger.com.liaowf=DEBUG,A1,R
# 名称为IAMLogInfo日志，日志级别为INFO,输出目标为数据库(注意，所有使用IAMLogInfo作为名称的日志将拥用些日志属性)
log4j.logger.IAMLogInfo=INFO,DATABASE

# 类com.liaowf.console.connector.Synchro日志,日志级别为DEBUG,输出目标为控制台
log4j.logger.com.liaowf.console.connector.Synchro=DEBUG,A1,userSynR
# 类com.liaowf.console.authorization.dao.UserDao日志,级别为DEBUG，输出目标为文件
log4j.logger.com.liaowf.console.authorization.dao.UserDao=DEBUG,A1,userTelnet

# 配置TRUE
log4j.addivity.org.apache=true

# 定义控制台Appender
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

# 输出到文件Appender
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=c:/iamSystem.log
log4j.appender.R.MaxFileSize=500KB
log4j.appender.R.MaxBackupIndex=1
#log4j.appender.R.layout=org.apache.log4j.HTMLLayout
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n


# JDBC 输出到数据库的Appender
#log4j.appender.DATABASE.Threshold=INFO
#log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
#log4j.appender.DATABASE.BufferSize=10
#log4j.appender.DATABASE.URL=jdbc:microsoft:sqlserver://10.170.88.4:1433;DatabaseName=iamconfig
#log4j.appender.DATABASE.driver=com.microsoft.jdbc.sqlserver.SQLServerDriver
#log4j.appender.DATABASE.user=iamconfig
#log4j.appender.DATABASE.password=iamconfig
#log4j.appender.DATABASE.sql=INSERT INTO wap_mail_jws_log  VALUES ('%d{yyyy-MM-dd HH:mm:ss}', '%t', '%p', '%l', '%m', '')
#log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout

# 输出到文件的appender
log4j.appender.userSynR=org.apache.log4j.RollingFileAppender
log4j.appender.userSynR.File=c:/iamSystem_userSynR.log
log4j.appender.userSynR.MaxFileSize=500KB
log4j.appender.userSynR.MaxBackupIndex=1
#log4j.appender.userSynR.layout=org.apache.log4j.HTMLLayout
log4j.appender.userSynR.layout=org.apache.log4j.PatternLayout
log4j.appender.userSynR.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

# 输出到文件Appender
log4j.appender.userTelnet=org.apache.log4j.RollingFileAppender
log4j.appender.userTelnet.File=c:/iamTelnet.log
log4j.appender.userTelnet.MaxFileSize=500KB
log4j.appender.userTelnet.MaxBackupIndex=1
#log4j.appender.userTelnet.layout=org.apache.log4j.HTMLLayout
log4j.appender.userTelnet.layout=org.apache.log4j.PatternLayout
log4j.appender.userTelnet.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

log4j倒底能提供我们什么功能，我们来总结一下：
1 根据我们设置的日志级别，控制日志的输出
2 日志的输出支持自增式文件，控制台，数据库，还可以扩展。
3 日志的属性,当按"."命名有继承性，我们常使用类名来命名日志
2 通过上面的介始，我们给一个工程没有log4j的工程增加log4j功能的。根据下面几个步骤，你将很轻松的完成。
1 下载log4j的jar包(这个不用多说了)
2 编写一个log4j.properties 属性文件，放到你的源文件的根下，再根据具体修改
3 在每一个需要记录日的类中，增加一个类成员
    // 初始化日志处理类
  Logger log = Logger.getLogger(类名.class.getName());

4 在你需要打日志信息的代码中，如下写出
打info信息
Log4j.infor("");
打debug信息
If(log4j.isDebuged()) {
  Log4j.debug("");
}
打error信息
Log4j.error("");