簡單的說log4j就是幫助開發人員進行日志輸出管理的API類庫。它最重要的特點就
可以
配置文件靈活的設置
日志信息的優先級、日志信息的輸出目的地以及日志信息的輸出格式。
Log4j除了可以記錄程序運行日志信息外還有一重要的功能就是用來
顯示調試信息。程序員經常會遇到脫離java ide環境調試程序的情況，這時大多數人會選擇使用System.out.println語句輸出某個變量值的方法進行調試。這樣會帶來一個非常麻煩的問題：一旦哪天程序員決定不要顯示這些System.out.println的東西了就只能一行行的把這些垃圾語句注釋掉。若哪天又需調試變量值，則只能再一行行去掉這些注釋恢復System.out.println語句。使用log4j可以很好的處理類似情況。
log4j使用方法
下面介紹的是log4j一些理論方面的知識，讀者覺得枯燥的話可以跳過本節直接閱讀第三節實例部分。
1、定義配置文件
? 首先使用配置文件將使我們的應用程序更加靈活配置log日志輸出方式包括輸出優先級、輸出目的地、輸出格式。Log4j支持兩種配置文件格式，一種是XML 格式的文件，一種是Java特性文件log4j.properties（鍵=值）。下面將介紹使用log4j.properties文件作為配置文件的方法：
①
配置根Logger，其語法為：0
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（將日志信息以流格式發送到任意指定的地方）
③
配置日志信息的格式（布局），其語法為：
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（包含日志產生的時間、線程、類別等等信息）
Log4J采用類似C語言中的printf函數的打印格式格式化日志信息，打印參數如下： %m 輸出代碼中指定的消息
%p 輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL
%r 輸出自應用啟動到輸出該log信息耗費的毫秒數
%c 輸出所屬的類目，通常就是所在類的全名
%t 輸出產生該日志事件的線程名
%n 輸出一個回車換行符，Windows平臺為“\r\n”，Unix平臺為“\n”
%d 輸出日志時間點的日期或時間，默認格式為ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：
2002年10月18日
22：10：28，921
%l 輸出日志事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數。舉例：Testlog4.main(TestLog4.java:10)
2、在代碼中使用Log4j
①
得到記錄器
使用Log4j，第一步就是獲取日志記錄器，這個記錄器將負責控制日志信息。其語法為：
public static Logger getLogger( String name)
通過指定的名字獲得記錄器，如果必要的話，則為這個名字創建一個新的記錄器。Name一般取本類的名字，比如：
static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )
②
讀取配置文件
當獲得了日志記錄器之后，第二步將配置Log4j環境，其語法為：
BasicConfigurator.configure ()： 自動快速地使用缺省Log4j環境。
PropertyConfigurator.configure ( String configFilename) ：讀取使用Java的特性文件編寫的配置文件。
例：PropertyConfigurator.configure
(".\\src\\log4j.properties")
DOMConfigurator.configure ( String filename ) ：讀取XML形式的配置文件。
③
插入記錄信息（格式化日志信息）
當上兩個必要步驟執行完畢，就可輕松地使用不同優先級別的日志記錄語句插入到您想記錄日志的任何地方，其語法如下：
Logger.debug ( Object message ) ;
Logger.info ( Object message ) ;
Logger.warn ( Object message ) ;
Logger.error ( Object message ) ;
log4j范例程序
下面將使用一個最簡單的范例程序來進一步說明log4j的使用方法。程序代碼如下：
?
import org.apache.log4j.*;
?
public class
LogTest
{
?
?
??? static
Logger logger = Logger.getLogger(LogTest.class.getName());
?
??? public
static
void
main(String[] args)
{
?
???????
PropertyConfigurator.configure ( “.\\src\
log4j.properties
”)
；
logger.debug(
"Debug ..."
);
?
??????? logger.info(
"Info ..."
);
?
??????? logger.warn(
"Warn ..."
);
?
??????? logger.error(
"Error ..."
);
?
???
}
}
程序說明：
①
static Logger logger = Logger.getLogger(LogTest.class.getName());
就是創建一個屬于
LogTest
類的
Logger
對象，創建時要告知
Logger
你當前的
Class
是什么。
②
PropertyConfigurator.configure ( “
log4j.properties
”)
就是說使用當前工程目錄下的
src
文件夾中的
log4j.properties
文件作為配置文件。若將
log4j.properties
放在工程根目錄下也可不寫此句，程序會自動找到配置文件。
③
logger.debug
就是輸出
debug
的信息，
logger.info
就是輸出提示信息，
logger.warn
就是顯示警告信息，
logger.error
就是顯示錯誤信息。
?
下面是配置文件
log4j.properties
的內容：
log4j.rootCategory=DEBUG, stdout
，
R
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p (%F:%L) - %m%n
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=log.txt
log4j.appender.R.MaxFileSize=100KB
log4j.appender.R.MaxBackupIndex=1
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d
{
yyyy MMM dd HH:mm:ss
}
%-5p %c - %m%n
程序說明：
①
log4j.rootCategory=DEBUG, stdout
，
R
就是說我要顯示所有優先權等於和高于
Debug的信息。
"stdout"，
”R”
表示我定義了兩個輸出端
(
隨便什么名字都好
)
。
②
下面的三行說
stdout
輸出端其實是標準輸出
Console
，也就是屏幕。輸出的格式是
Pattern
Layout
。轉換方式是
%5p (%F:%L) - %m%n
，即前五格用來顯示優先權，再顯示當前的文件名，加當前的行數。最后是
logger.debug()
或
logger.info()
或
logger.warn()
或
logger.error()
里的信息。
%n
表示回車空行。
③
再加上下面六行則
log
信息不光顯示在屏幕上，而且將被保存在一個叫
"log.txt"
的文件里，文件最大為
100KB
。如果文件大小超過
100KB
，文件會被備份成
"log.txt.1"
，新的
"log.txt"
繼續記錄
log
信息。
接下來我們可以改變
log4j.properties
，而不需重新編譯就可以控制
log
信息是否顯示、
log
信息的輸出端類型、輸出方式、輸出格式，等等。舉例如下：
①
在
log4j.properties
文件里把
"log4j.rootCategory=DEBUG,stdout,R"
改寫成
"log4j.rootCategory=OFF, stdout,R"
，這樣所有的
log信息都不會顯示了；解決了本文開始提出的問題。
②
在
log4j.properties
文件里把
"log4j.rootCategory=DEBUG,stdout,R"
改寫成
"log4j.rootCategory=INFO, stdout,R"
，這樣只顯示
INFO, WARN, ERROR
的
log
信息，而
DEBUG
信息不會被顯示；
?
在web程序中使用log4j注意問題
1、???
由于jsp或servlet在執行狀態時沒有當前路徑概念，所有使用
PropertyConfigurator.configure
（
String
）語句找
log4j.properties
文件時要給出相對于當前
jsp
或
servlet
的路徑轉化成為一個絕對的文件系統路徑。方法是使用
servletcontext.getrealpath(string)
語句。例：
//得到當前jsp路徑
String prefix =? getServletContext().getRealPath(
"/");
//讀取
log4j.properties
PropertyConfigurator.configure(prefix+
"\\WEB-INF\\log4j.properties");
2、相應的log4j.properties設置某個屬性時也要在程序中設置絕對路徑。例：
log4j.appender.R.File屬性設置日志文件存放位置。我們可以用讀寫.properties配置文件的方法進行靈活設置。
log4e使用說明
在了解了log4j的功能后，我們肯定會我們的程序中
編寫一些
Log4j
日志記錄。對于使用
Eclipse
的程序員
Log4e
將是我們最得力的
log4j
日志編寫助手，現在開始
Log4e
之旅。
Log4e
是一個免費的
Eclipse Plugin
，它可幫助你在你的
Java
工程中快速加入
Log
；
我們可以在
http://log4e.jayefem.de/index.php/Download
網站上下載
Log4e
最新版本。下載后將相應文件夾拷貝到
Eclipse
的插件目錄下，重新
Eclipse
，在首選項中會多出一個
Log4e
選項。
Log4e
可以有多個插入
Log
為一個方法、類，當然也可以在當前位置插入
Log
，同時其也可以把
Sysout.out.println()
的轉換為
log
；所有的這一切只需要你點點鼠標或者按一次快捷鍵，下面我們只以為一個方法插入
Log
為例來講解
在
Java
編輯上下文中點擊右鍵，選擇
Log4E
，你將看到如下界面：
點擊
Insert Log Statement For This Method
，你將看到驗證頁面：
Finish
后這時你將看到插入
Log后的函數如下：
