1下載
http://jakarta.apache.org/log4j/docs/download.html
2log4j的簡明手冊(english)
http://jakarta.apache.org/log4j/docs/manual.html
3安裝
log4j不需要安裝,只需要把①LOG4J_HOME/dist/lib/log4j-VERSION.jar,②LOG4J_HOME/dist/classes③一 個JAXP編譯 XML的剖析器(即parser.jar文件).放在classpath中你就可以使用。(LOG4J_HOME是你放置log4j的目錄)
4使用
4.1簡介
Log4j由三個重要的組件構成:日志信息的優先級,日志信息的輸出目的地,日志信息的輸出格式。日志信息的優先級從高到低有ERROR、WARN、INFO、DEBUG,分別用來指定這條日志信息的重要程度;日志信息的輸出目的地指定了日志將打印到控制臺還是文件中;而輸出格式則控制了日志信息的顯示內容。
4.2、使用Java特性文件做為配置文件的方法:
4.2.1配置根Logger,其語法為:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中,level 是日志記錄的優先級,分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定義的級別。Log4j建議只使用四個級別,優先級從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這里定義的級別,您可以控制到應用程序中相應級別的日志信息的開關。比如在這里定義了INFO級別,則應用程序中所有DEBUG級別的日志信息將不被打印出來。
appenderName就是指定日志信息輸出到哪個地方。您可以同時指定多個輸出目的地。
配置日志信息輸出目的地Appender,其語法為
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.option = valueN
其中,Log4j提供的appender有以下幾種:
org.apache.log4j.ConsoleAppender(控制臺),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天產生一個日志文件),org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件),
org.apache.log4j.WriterAppender(將日志信息以流格式發送到任意指定的地
4.2.2置日志信息的格式(布局),其語法為:
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.option = valueN
其中,Log4j提供的layout有以下幾種:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以靈活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串),
org.apache.log4j.TTCCLayout(包含日志產生的時間、線程、類別等等信息)
4.3在代碼中使用Log4j
4.3.1得到記錄器
使用Log4j,第一步就是獲取日志記錄器,這個記錄器將負責控制日志信息。其語法為:
public static Logger getLogger( String name),
通過指定的名字獲得記錄器,如果必要的話,則為這個名字創建一個新的記錄器。Name一般取本類的名字,比如:
static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () ) ;
4.3.2讀取配置文件
當獲得了日志記錄器之后,第二步將配置Log4j環境,其語法為:
BasicConfigurator.configure (): 自動快速地使用缺省Log4j環境。
PropertyConfigurator.configure ( String configFilename) :讀取使用Java的特性文件編寫的配置文件。
DOMConfigurator.configure ( String filename ) :讀取XML形式的配置文件。
4.3.3插入記錄信息(格式化日志信息)
當上兩個必要步驟執行完畢,您就可以輕松地使用不同優先級別的日志記錄語句插入到您想記錄日志的任何地方,其語法如下:
Logger.debug ( Object message ) ;
Logger.info ( Object message ) ;
Logger.warn ( Object message ) ;
Logger.error ( Object message ) ;
5示例(源文件和屬性文件)
//TestLog4j.java
package TestLog;
import java.io.IOException;
import java.net.URL;
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;
public class TestLog4j
{
private static Logger
logger=Logger.getLogger(TestLog.TestLog4j.class.getName());
public TestLog4j()
{
}
public static void main(String argv[])
{
String resource ="/TestLog/TestLog4j.properties";
URL configFileResource =
TestLog4j.class.getResource(resource);
PropertyConfigurator.configure(configFileResource);
logger.debug("Hello, my name is Maggie Simpson.");
logger.info("info");
}
}
//TestLog4j.properties
#設置logger和level
log4j.rootCategory=DEBUG, R
#文件大小達到指定尺寸時產生新文件
log4j.appender.R=org.apache.log4j.RollingFileAppender
#輸出的日志文件名
log4j.appender.R.File=log.html
#文件格式
log4j.appender.R.layout=org.apache.log4j.HTMLLayout
#指定文件大小
log4j.appender.R.MaxFileSize=3KB
#產生新文件,原文件名為log.html.1,...,log.html.MaxBackupIndex
log4j.appender.R.MaxBackupIndex=2