此文引用自: http://supportweb.cs.bham.ac.uk/documentation/tutorials/docsystem/build/tutorials/log4j/log4j.html
目录
-
1.
简介
2.
安装
3.
log4j基本概念
-
-
3.1.
Logger
3.2.
Appender
-
-
3.2.1.
使用ConsoleAppender
3.2.2.
使用FileAppender
3.2.3.
使用WriterAppender
3.3.
Layout
3.4.
基本示例
-
-
3.4.1.
SimpleLayout和FileAppender
3.4.2.
HTMLLayout和WriterAppender
3.4.3.
PatternLayout和ConsoleAppender
4.
使用外部配置文件
5.
参考资料 (以及一些有参考价值的链接)
-
为了使用我们即将要安装的日志记录工具,还必须要设置操作环境,只有这样,工具才能知道从哪里找到它所需要的信息,并且操作系统知道从哪里找到这个工具。那么,怎样做呢?实际上,它要求更改操作环境。我有一些这方面的资格文档。 Configuring A Windows Working Environment 和 Configuring A Unix Working Environment.
-
从 http://jakarta.apache.org/log4j/docs/download.html下载log4j发行版。
-
解压存档文件到合适的目录中。
-
添加文件 dist/lib/log4j-1.2.6.jar 到 CLASSPATH 环境变量中。
日志记录器(Logger)是日志处理的核心组件。log4j具有5种正常级别(Level)。 日志记录器(Logger)的可用级别Level (不包括自定义级别 Level), 以下内容就是摘自log4j API (http://jakarta.apache.org/log4j/docs/api/index.html):
-
static Level DEBUG
DEBUG Level指出细粒度信息事件对调试应用程序是非常有帮助的。
-
static Level INFO
INFO level表明 消息在粗粒度级别上突出强调应用程序的运行过程。
-
static Level WARN
WARN level表明会出现潜在错误的情形。
-
static Level ERROR
ERROR level指出虽然发生错误事件,但仍然不影响系统的继续运行。
-
static Level FATAL
FATAL level指出每个严重的错误事件将会导致应用程序的退出。
另外,还有两个可用的特别的日志记录级别: (以下描述来自log4j API http://jakarta.apache.org/log4j/docs/api/index.html):
-
static Level ALL
ALL Level是最低等级的,用于打开所有日志记录。
-
static Level OFF
OFF Level是最高等级的,用于关闭所有日志记录。
日志记录器(Logger)的行为是分等级的。如下表所示:
有很多方法可以创建一个日志记录器(Logger),下面方法可以取回root日志记录器:
Logger logger = Logger.getRootLogger(); |
Logger logger = Logger.getLogger("MyLogger"); |
比较常用的用法,就是根据类名实例化一个静态的全局日志记录器:
static Logger logger = Logger.getLogger(test.class); |
所有这些创建的叫"logger"的日志记录器都可以用下面方法设置级别:
logger.setLevel((Level)Level.WARN); |
Appender 控制日志怎样输出。下面列出一些可用的Appender(log4j API中所描述的 http://jakarta.apache.org/log4j/docs/api/index.html):
-
ConsoleAppender:使用用户指定的布局(layout) 输出日志事件到System.out或者 System.err。默认的目标是System.out。
-
DailyRollingFileAppender 扩展FileAppender,因此多个日志文件可以以一个用户选定的频率进行循环日志记录。
-
FileAppender 把日志事件写入一个文件
-
RollingFileAppender 扩展FileAppender备份容量达到一定大小的日志文件。
-
WriterAppender根据用户的选择把日志事件写入到Writer或者OutputStream。
-
SMTPAppender 当特定的日志事件发生时,一般是指发生错误或者重大错误时,发送一封邮件。
-
SocketAppender 给远程日志服务器(通常是网络套接字节点)发送日志事件(LoggingEvent)对象。
-
SocketHubAppender 给远程日志服务器群组(通常是网络套接字节点)发送日志事件(LoggingEvent)对象。
-
SyslogAppender给远程异步日志记录的后台精灵程序(daemon)发送消息。
-
TelnetAppender 一个专用于向只读网络套接字发送消息的log4j appender。
还可以实现 Appender 接口,创建以自己的方式进行日志输出的Appender。
ConsoleAppender appender = new ConsoleAppender(new PatternLayout()); |
FileAppender appender = null; |
FileAppender(Layout layout, String filename) |
FileAppender(Layout layout, String filename, boolean append) |
WriterAppender appender = null; |
这里是一个非常简单的例子,程序实现了SimpleLayout和FileAppender:
import org.apache.log4j.Level; |
你可以下载: simpandfile.java。 还可以查看它的输出: output1.txt.
这里是一个非常简单的例子,程序实现了 HTMLLayout和WriterAppender:
import java.io.*; |
你可以下载: simpandfile.java. 还可以查看它的输出:output1.txt.
这里是一个非常简单的例子,程序实现了PatternLayout和ConsoleAppender:
import org.apache.log4j.Level; |
你可以下载:simpandfile.java. 还可以查看它的输出: output2.txt.
Log4j经常与外部日志文件联合使用,这样很多可选项不必硬编码在软件中。使用外部配置文件的优点就是修改可选项不需要重新编译程序。唯一的缺点就是,由于用到io 指令,速度稍微有些减慢。
有两个方法可以用来指定外部配置文件:文本文件或者XML文件。既然现在所有事情都写成XML文件,那么该教程就重点讲解XML文件方法,但是也包含相关文本文件的例子。首先,看看下面的XML配置文件示例:
<?xml version="1.0" encoding="UTF-8" ?> |
<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender"> |
<root> |
DOMConfigurator.configure("configurationfile.xml"); |
DOMConfigurator 用一棵DOM树来初始化log4j环境。这里是示例中的XML配置文件:plainlog4jconfig.xml。这里是执行该配置文件的程序: files/externalxmltest.java:
import org.apache.log4j.Logger; |
这里是一个实现带有PatternLayout的FileAppender的日志记录器Logger的XML配置文件:
<?xml version="1.0" encoding="UTF-8" ?> |
你可以从这里下载示例: xmllog4jconfig2.xml。 想要得到更多的使用XML文件配置log4j环境的例子,请查看log4j发行版的目录src/java/org/apache/log4j/xml/examples/ 。
这就是上面讨论的文本文件形式的配置文件:
# initialise root logger with level DEBUG and call it BLAH |
从这里可以下载: plainlog4jconfig.txt。这就是执行该配置文件的程序:
import org.apache.log4j.Logger; |
你可以下载使用该配置文件的示例: externalplaintest.java。想要获得更多的使用文本文件配置log4j环境的例子,请查看log4j发行版中的目录examples。
使用外部配置文件的例子就简单的讨论到这里,现在应该可以肯定你已经有能力独立学习更多的log4j发行版和测试版中提供的例子。
-
http://jakarta.apache.org/log4j/docs/manual.html
log4j的简明介绍 - Ceki G- 2002年3月
-
http://www.vipan.com/htdocs/log4jhelp.html
不要用System.out.println!用Log4j - Vipan Singla
-
http://www.opensymphony.com/guidelines/logging.jsp
LOG4J / OpenSymphony日志记录入门
-
http://builder.com.com/article.jhtml?id=u00820020124kev01.htm
给你的Java应用程序添加日志记录 - Kevin Brown