亚洲精品国产福利片,久久精品国产亚洲AV无码麻豆 ,亚洲AV无码乱码在线观看牲色

log4j教程

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. 參考資料 (以及一些有參考價值的鏈接)

1.簡介

程序開發(fā)環(huán)境中的日志記錄是由嵌入在程序中以輸出一些對開發(fā)人員有用信息的語句所組成。例如，跟蹤語句（trace），結(jié)構(gòu)轉(zhuǎn)儲和常見的 System.out.println或printf調(diào)試語句。log4j提供分級方法在程序中嵌入日志記錄語句。日志信息具有多種輸出格式和多個輸出級別。

使用一個專門的日志記錄包，可以減輕對成千上萬的System.out.println語句的維護(hù)成本，因為日志記錄可以通過配置腳本在運(yùn)行時得以控制。 log4j維護(hù)嵌入在程序代碼中的日志記錄語句。通過規(guī)范日志記錄的處理過程，一些人認(rèn)為應(yīng)該鼓勵更多的使用日志記錄并且獲得更高程度的效率。

2.安裝

為了使用我們即將要安裝的日志記錄工具，還必須要設(shè)置操作環(huán)境，只有這樣，工具才能知道從哪里找到它所需要的信息，并且操作系統(tǒng)知道從哪里找到這個工具。那么，怎樣做呢？實際上，它要求更改操作環(huán)境。

從 http://jakarta.apache.org/log4j/docs/download.html下載log4j發(fā)行版。
解壓存檔文件到合適的目錄中。
添加文件 dist/lib/log4j-1.2.6.jar 到 CLASSPATH 環(huán)境變量中。

3.log4j的基本概念

使用log4j大概涉及3個主要概念:

公共類 Logger
Logger 負(fù)責(zé)處理日志記錄的大部分操作。
公共接口 Appender
Appender 負(fù)責(zé)控制日志記錄操作的輸出。
公共抽象類Layout
Layout 負(fù)責(zé)格式化Appender的輸出。

3.1.Logger

日志記錄器(Logger)是日志處理的核心組件。log4j具有5種正常級別(Level)。日志記錄器(Logger)的可用級別Level (不包括自定義級別 Level)，以下內(nèi)容就是摘自log4j API (http://jakarta.apache.org/log4j/docs/api/index.html):

static Level DEBUG
DEBUG Level指出細(xì)粒度信息事件對調(diào)試應(yīng)用程序是非常有幫助的。
static Level INFO
INFO level表明消息在粗粒度級別上突出強(qiáng)調(diào)應(yīng)用程序的運(yùn)行過程。
static Level WARN
WARN level表明會出現(xiàn)潛在錯誤的情形。
static Level ERROR
ERROR level指出雖然發(fā)生錯誤事件，但仍然不影響系統(tǒng)的繼續(xù)運(yùn)行。
static Level FATAL
FATAL level指出每個嚴(yán)重的錯誤事件將會導(dǎo)致應(yīng)用程序的退出。

另外，還有兩個可用的特別的日志記錄級別: (以下描述來自log4j APIhttp://jakarta.apache.org/log4j/docs/api/index.html):

static Level ALL
ALL Level是最低等級的，用于打開所有日志記錄。
static Level OFF
OFF Level是最高等級的，用于關(guān)閉所有日志記錄。

日志記錄器（Logger）的行為是分等級的。

日志記錄器（Logger）將只輸出那些級別高于或等于它的級別的信息。如果沒有設(shè)置日志記錄器（Logger）的級別，那么它將會繼承最近的祖先的級別。因此，如果在包com.foo.bar中創(chuàng)建一個日志記錄器（Logger）并且沒有設(shè)置級別，那它將會繼承在包com.foo中創(chuàng)建的日志記錄器（Logger）的級別。如果在com.foo中沒有創(chuàng)建日志記錄器（Logger）的話,那么在com.foo.bar中創(chuàng)建的日志記錄器（Logger）將繼承root 日志記錄器（Logger）的級別，root日志記錄器（Logger）經(jīng)常被實例化而可用，它的級別為DEBUG。

有很多方法可以創(chuàng)建一個日志記錄器（Logger），下面方法可以取回root日志記錄器:

Logger logger = Logger.getRootLogger();

還可以這樣創(chuàng)建一個新的日志記錄器:

Logger logger = Logger.getLogger("MyLogger");

比較常用的用法，就是根據(jù)類名實例化一個靜態(tài)的全局日志記錄器:

static Logger logger = Logger.getLogger(test.class);

所有這些創(chuàng)建的叫"logger"的日志記錄器都可以用下面方法設(shè)置級別:

logger.setLevel((Level)Level.WARN);

可以使用7個級別中的任何一個; Level.DEBUG, Level.INFO, Level.WARN, Level.ERROR, Level.FATAL, Level.ALL and Level.OFF.

3.2.Appender

Appender 控制日志怎樣輸出。下面列出一些可用的Appender(log4j API中所描述的 http://jakarta.apache.org/log4j/docs/api/index.html):

ConsoleAppender:使用用戶指定的布局(layout) 輸出日志事件到System.out或者 System.err。默認(rèn)的目標(biāo)是System.out。
DailyRollingFileAppender 擴(kuò)展FileAppender，因此多個日志文件可以以一個用戶選定的頻率進(jìn)行循環(huán)日志記錄。
FileAppender 把日志事件寫入一個文件
RollingFileAppender 擴(kuò)展FileAppender備份容量達(dá)到一定大小的日志文件。
WriterAppender根據(jù)用戶的選擇把日志事件寫入到Writer或者OutputStream。
SMTPAppender 當(dāng)特定的日志事件發(fā)生時，一般是指發(fā)生錯誤或者重大錯誤時，發(fā)送一封郵件。
SocketAppender 給遠(yuǎn)程日志服務(wù)器（通常是網(wǎng)絡(luò)套接字節(jié)點）發(fā)送日志事件（LoggingEvent）對象。
SocketHubAppender 給遠(yuǎn)程日志服務(wù)器群組（通常是網(wǎng)絡(luò)套接字節(jié)點）發(fā)送日志事件（LoggingEvent）對象。
SyslogAppender給遠(yuǎn)程異步日志記錄的后臺精靈程序(daemon)發(fā)送消息。
TelnetAppender 一個專用于向只讀網(wǎng)絡(luò)套接字發(fā)送消息的log4j appender。

還可以實現(xiàn) Appender 接口，創(chuàng)建以自己的方式進(jìn)行日志輸出的Appender。

3.2.1.使用ConsoleAppender

ConsoleAppender可以用這種方式創(chuàng)建：

ConsoleAppender appender = new ConsoleAppender(new PatternLayout());

創(chuàng)建了一個控制臺appender，具有一個默認(rèn)的PatternLayout。它使用了默認(rèn)的System.out 輸出。

3.2.2.使用FileAppender

FileAppender可以用這種方式創(chuàng)建:

FileAppender appender = null;

try {

appender = new FileAppender(new PatternLayout(),"filename");

} catch(Exception e) {}

上面用到的構(gòu)造函數(shù):

FileAppender(Layout layout, String filename)

實例化一個FileAppender并且打開變量"filename"指定的文件。

另一個有用的構(gòu)造函數(shù)是：

FileAppender(Layout layout, String filename, boolean append)

實例化一個FileAppender并且打開變量"filename"指定的文件。

這個構(gòu)造函數(shù)還可以選擇是否對指定的文件進(jìn)行追加的方式輸出。如果沒有指定值，那么默認(rèn)的方式就是追加。

3.2.3.使用WriterAppender

WriterAppender可以用這種方式創(chuàng)建:

WriterAppender appender = null;

try {

appender = new WriterAppender(new PatternLayout(),new FileOutputStream("filename"));

} catch(Exception e) {}

這個WriterAppender使用的構(gòu)造函數(shù)帶有PatternLayout和OutputStream參數(shù)，在這種情況下， FileOutputStream用于向一個文件輸出。當(dāng)然，它還具有其他可用的構(gòu)造函數(shù)。

3.3.Layout

HTMLLayout 格式化日志輸出為HTML表格。
PatternLayout 根據(jù)指定的 轉(zhuǎn)換模式格式化日志輸出，或者如果沒有指定任何轉(zhuǎn)換模式，就使用默認(rèn)的轉(zhuǎn)換模式。
SimpleLayout 以一種非常簡單的方式格式化日志輸出，它打印級別 Level，然后跟著一個破折號“-“ ，最后才是日志消息。

3.4.基本示例

3.4.1.SimpleLayout和 FileAppender

這里是一個非常簡單的例子，程序?qū)崿F(xiàn)了SimpleLayout和FileAppender:

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");

你可以下載: simpandfile.java。還可以查看它的輸出： output1.txt.

3.4.2.HTMLLayout和 WriterAppender

這里是一個非常簡單的例子，程序?qū)崿F(xiàn)了 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");

你可以下載: simpandfile.java. 還可以查看它的輸出：output1.txt.

3.4.3.PatternLayout和 ConsoleAppender

這里是一個非常簡單的例子，程序?qū)崿F(xiàn)了PatternLayout和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");

你可以下載:simpandfile.java. 還可以查看它的輸出： output2.txt.

4.使用外部配置文件

Log4j經(jīng)常與外部日志文件聯(lián)合使用，這樣很多可選項不必硬編碼在軟件中。使用外部配置文件的優(yōu)點就是修改可選項不需要重新編譯程序。唯一的缺點就是，由于用到io 指令，速度稍微有些減慢。

有兩個方法可以用來指定外部配置文件：文本文件或者XML文件。既然現(xiàn)在所有事情都寫成XML文件，那么該教程就重點講解XML文件方法，但是也包含相關(guān)文本文件的例子。首先，看看下面的XML配置文件示例：

<?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>

文件以標(biāo)準(zhǔn)的XML聲明作為開始，后面跟著指出DTD（文檔類型定義）的DOCTYPE聲明，它定義了XML文件的結(jié)構(gòu)，例如，什么元素可以嵌入在其他元素中等等。上面文件在log4j發(fā)行版的src/java/org/apache/log4j/xml目錄中。接著看看封裝所有元素的 log4j:configuration 元素，它在DOCTYPE聲明中被指定為根元素。嵌入在根元素中有兩個結(jié)構(gòu)：

<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">

<layout class="org.apache.log4j.SimpleLayout"/>

</appender>

這里創(chuàng)建一個名叫"ConsoleAppender"的 Appender，注意，你可以選擇任何名字，該示例之所以選擇"ConsoleAppender"，完全是為了示例的設(shè)計。接著這個appender類以全名形式給出，經(jīng)常用規(guī)范（fully qualified）類名。 Appender必須具有一個指定的 name和class。嵌入在 Appender之內(nèi)的是 layout元素，這里它被指定為SimpleLayout。 Layout 必須具有一個 class屬性。

<root>

<priority value ="debug" />

<appender-ref ref="ConsoleAppender"/>

</root>

root元素必須存在且不能被子類化。示例中的優(yōu)先級被設(shè)置為"debug"，設(shè)置appender飽含一個appender-ref元素。還有更多的屬性或元素可以指定。查看log4j發(fā)行版中的src/java/org/apache/log4j/xml/log4j.dtd以了解關(guān)于XML配置文件結(jié)構(gòu)的更多信息。可以用下面這種方法把配置信息文件讀入到Java程序中:

DOMConfigurator.configure("configurationfile.xml");

DOMConfigurator 用一棵DOM樹來初始化log4j環(huán)境。這里是示例中的XML配置文件：plainlog4jconfig.xml。這里是執(zhí)行該配置文件的程序: files/externalxmltest.java:

import org.apache.log4j.Logger;

import org.apache.log4j.xml.DOMConfigurator;

public class externalxmltest {

static Logger logger = Logger.getLogger(filetest.class);

public static void main(String args[]) {

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");

這里是一個實現(xiàn)帶有PatternLayout的FileAppender的日志記錄器Logger的XML配置文件:

<?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>

你可以從這里下載示例: xmllog4jconfig2.xml。想要得到更多的使用XML文件配置log4j環(huán)境的例子，請查看log4j發(fā)行版的目錄src/java/org/apache/log4j/xml/examples/ 。

這就是上面討論的文本文件形式的配置文件:

# initialise root logger with level DEBUG and call it BLAHlog4j.rootLogger=DEBUG,

BLAH# add a ConsoleAppender to the logger BLAHlog4j.appender.BLAH=

org.apache.log4j.ConsoleAppender# set set that layout to be SimpleLayoutlog4j.appender.BLAH.layout=

org.apache.log4j.SimpleLayout

從這里可以下載: plainlog4jconfig.txt。這就是執(zhí)行該配置文件的程序:

import org.apache.log4j.Logger;

import org.apache.log4j.PropertyConfigurator;

public class externalplaintest {

static Logger logger = Logger.getLogger(externalplaintest.class);

public static void main(String args[]) {

PropertyConfigurator.configure("plainlog4jconfig.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");

你可以下載使用該配置文件的示例： externalplaintest.java。想要獲得更多的使用文本文件配置log4j環(huán)境的例子，請查看log4j發(fā)行版中的目錄examples。

使用外部配置文件的例子就簡單的討論到這里，現(xiàn)在應(yīng)該可以肯定你已經(jīng)有能力獨立學(xué)習(xí)更多的log4j發(fā)行版和測試版中提供的例子。

posted on 2011-11-30 11:36 hellxoul 閱讀(16826) 評論(5) 編輯收藏

常用鏈接

留言簿

隨筆分類

隨筆檔案

搜索

最新評論

閱讀排行榜

評論排行榜