log4j的詳細介紹

時間 2021-03-17

標籤 java mysql web sql 數據庫 apache 編程服務器網絡多線程欄目 Log4j 简体版

原文原文鏈接

轉載至程式先鋒技術維客[url]www.javabiz.cn[/url] >>>1. 概述<<<< 　　1.1. 背景　　　　在應用程序中添加日誌記錄總的來講基於三個目的：監視代碼中變量的變化狀況，週期性的記錄到文件中供其餘應用進行統計分析工做；跟蹤代碼運行時軌跡，做爲往後審計的依據；擔當集成開發環境中的調試器的做用，向文件或控制檯打印代碼的調試信息。　　　　最普通的作法就是在代碼中嵌入許多的打印語句，這些打印語句能夠輸出到控制檯或文件中，比較好的作法就是構造一個日誌操做類來封裝此類操做，而不是讓一系列的打印語句充斥了代碼的主體。　　　　1.2. Log4j簡介　　　　在強調可重用組件開發的今天，除了本身從頭至尾開發一個可重用的日誌操做類外，Apache爲咱們提供了一個強有力的日誌操做包-Log4j。　　　　Log4j是Apache的一個開放源代碼項目，經過使用Log4j，咱們能夠控制日誌信息輸送的目的地是控制檯、文件、GUI組件、甚至是套接口服務器、NT的事件記錄器、UNIX Syslog守護進程等；咱們也能夠控制每一條日誌的輸出格式；經過定義每一條日誌信息的級別，咱們可以更加細緻地控制日誌的生成過程。最使人感興趣的就是，這些能夠經過一個配置文件來靈活地進行配置，而不須要修改應用的代碼。　　　　此外，經過Log4j其餘語言接口，您能夠在C、C+ +、.Net、PL/SQL程序中使用Log4j，其語法和用法與在Java程序中同樣，使得多語言分佈式系統獲得一個統一一致的日誌組件模塊。並且，通過使用各類第三方擴展，您能夠很方便地將Log4j集成到J2EE、JINI甚至是SNMP應用中。　　　　本文介紹的Log4j版本是 1.2.3。做者試圖經過一個簡單的客戶/服務器Java程序例子對比使用與不使用Log4j 1.2.3的差異，並詳細講解了在實踐中最常使用Log4j的方法和步驟。在強調可重用組件開發的今天，相信Log4j將會給廣大的設計開發人員帶來方便。加入到Log4j的隊伍來吧！　　 >>>> 2. 一個簡單的例子 <<<< 　　咱們先來看一個簡單的例子，它是一個用Java實現的客戶/服務器網絡程序。剛開始咱們不使用Log4j，而是使用了一系列的打印語句，而後咱們將使用Log4j來實現它的日誌功能。這樣，你們就能夠清楚地比較出先後兩個代碼的差異。　　　　2.1. 不使用Log4j 　　　　2.1.1. 客戶程序　　package log4j ; 　　　　import java.io.* ; 　　import java.net.* ; 　　　　/** 　　 * 　　 * Client Without Log4j 　　 * Description: a sample with log4j 　　 * @version 1.0 　　 */ 　　public class ClientWithoutLog4j { 　　　　　　/** 　　　　 * 　　　　 * @param args 　　　　 */ 　　　　public static void main ( String args [] ) { 　　　　　　　　String welcome = null; 　　　　　　String response = null; 　　　　　　BufferedReader reader = null; 　　　　　　PrintWriter writer = null; 　　　　　　InputStream in = null; 　　　　　　OutputStream out = null; 　　　　　　Socket client = null; 　　　　　　　　try { 　　　　　　　　client = new Socket ( "localhost", 8001 ) ; 　　　　　　　　System.out.println ( "info: Client socket: " + client ) ; 　　　　　　　　in = client.getInputStream () ; 　　　　　　　　out = client.getOutputStream () ; 　　　　　　} catch ( IOException e ) { 　　　　　　　　System.out.println ( "error: IOException : " + e ) ; 　　　　　　　　System.exit ( 0 ) ; 　　　　　　} 　　　　　　　　try{ 　　　　　　　　reader = new BufferedReader( new InputStreamReader ( in ) ) ; 　　　　　　　　writer = new PrintWriter ( new OutputStreamWriter ( out ), true ) ; 　　　　　　　　　　welcome = reader.readLine () ; 　　　　　　　　System.out.println ( "debug: Server says: '" + welcome + "'" ) ; 　　　　　　　　　　System.out.println ( "debug: HELLO" ) ; 　　　　　　　　writer.println ( "HELLO" ) ; 　　　　　　　　response = reader.readLine () ; 　　　　　　　　System.out.println ( "debug: Server responds: '" + response + "'") ; 　　　　　　　　　　System.out.println ( "debug: HELP" ) ; 　　　　　　　　writer.println ( "HELP" ) ; 　　　　　　　　response = reader.readLine () ; 　　　　　　　　System.out.println ( "debug: Server responds: '" + response + "'" ) ; 　　　　　　　　　　System.out.println ( "debug: QUIT" ) ; 　　　　　　　　writer.println ( "QUIT" ) ; 　　　　　　} catch ( IOException e ) { 　　　　　　　　System.out.println ( "warn: IOException in client.in.readln()" ) ; 　　　　　　　　System.out.println ( e ) ; 　　　　　　} 　　　　　　try{ 　　　　　　　　Thread.sleep ( 2000 ) ; 　　　　　　} catch ( Exception ignored ) {} 　　　　} 　　} 　　　　2.1.2. 服務器程序　　package log4j ; 　　　　import java.util.* ; 　　import java.io.* ; 　　import java.net.* ; 　　　　/** 　　 * 　　 * Server Without Log4j 　　 * Description: a sample with log4j 　　 * @version 1.0 　　 */ 　　public class ServerWithoutLog4j { 　　　　　　final static int SERVER_PORT = 8001 ; // this server's port 　　　　　　/** 　　　　 * 　　　　 * @param args 　　　　 */ 　　　　public static void main ( String args [] ) { 　　　　　　String clientRequest = null; 　　　　　　BufferedReader reader = null; 　　　　　　PrintWriter writer = null; 　　　　　　ServerSocket server = null; 　　　　　　Socket socket = null; 　　　　　　InputStream in = null; 　　　　　　OutputStream out = null; 　　　　　　　　try { 　　　　　　　　server = new ServerSocket ( SERVER_PORT ) ; 　　　　　　　　System.out.println ( "info: ServerSocket before accept: " + server ) ; 　　　　　　　　System.out.println ( "info: Java server without log4j, on-line!" ) ; 　　　　　　　　　　// wait for client's connection 　　　　　　　　socket = server.accept () ; 　　　　　　　　System.out.println ( "info: ServerSocket after accept: " + server )　; 　　　　　　　　　　in = socket.getInputStream () ; 　　　　　　　　out = socket.getOutputStream () ; 　　　　　　　　} catch ( IOException e ) { 　　　　　　　　System.out.println( "error: Server constructor IOException: " + e ) ; 　　　　　　　　System.exit ( 0 ) ; 　　　　　　} 　　　　　　reader = new BufferedReader ( new InputStreamReader ( in ) ) ; 　　　　　　writer = new PrintWriter ( new OutputStreamWriter ( out ) , true ) ; 　　　　　　　　// send welcome string to client 　　　　　　writer.println ( "Java server without log4j, " + new Date () ) ; 　　　　　　　　while ( true ) { 　　　　　　　　try { 　　　　　　　　　　// read from client 　　　　　　　　　　clientRequest = reader.readLine () ; 　　　　　　　　　　System.out.println ( "debug: Client says: " + clientRequest ) ; 　　　　　　　　　　if ( clientRequest.startsWith ( "HELP" ) ) { 　　　　　　　　　　　　System.out.println ( "debug: OK!" ) ; 　　　　　　　　　　　　writer.println ( "Vocabulary: HELP QUIT" ) ; 　　　　　　　　　　} 　　　　　　　　　　else { 　　　　　　　　　　　　if ( clientRequest.startsWith ( "QUIT" ) ) { 　　　　　　　　　　　　　　System.out.println ( "debug: OK!" ) ; 　　　　　　　　　　　　　　System.exit ( 0 ) ; 　　　　　　　　　　　　} 　　　　　　　　　　　　else{ 　　　　　　　　　　　　　　System.out.println ( "warn: Command '" + 　　 clientRequest + "' not understood." ) ; 　　　　　　　　　　　　　　writer.println ( "Command '" + clientRequest 　　 + "' not understood." ) ; 　　　　　　　　　　　　} 　　　　　　　　　　} 　　　　　　　　} catch ( IOException e ) { 　　　　　　　　　　System.out.println ( "error: IOException in Server " + e ) ; 　　　　　　　　　　System.exit ( 0 ) ; 　　　　　　　　} 　　　　　　} 　　　　} 　　} 　　　　2.2. 遷移到Log4j 　　　　2.2.1. 客戶程序　　　　package log4j ; 　　　　import java.io.* ; 　　import java.net.* ; 　　　　// add for log4j: import some package 　　import org.apache.log4j.PropertyConfigurator ; 　　import org.apache.log4j.Logger ; 　　import org.apache.log4j.Level ; 　　　　/** 　　 * 　　 * Client With Log4j 　　 * Description: a sample with log4j 　　 * @version 1.0 　　 */ 　　public class ClientWithLog4j { 　　　　　　/* 　　　　add for log4j: class Logger is the central class in the log4j package. 　　　　we can do most logging operations by Logger except configuration. 　　　　getLogger(...): retrieve a logger by name, if not then create for it. 　　　　*/ 　　　　static Logger logger = Logger.getLogger 　　 ( ClientWithLog4j.class.getName () ) ; 　　　　　　/** 　　　　 * 　　　　 * @param args : configuration file name 　　　　 */ 　　　　public static void main ( String args [] ) { 　　　　　　　　String welcome = null ; 　　　　　　String response = null ; 　　　　　　BufferedReader reader = null ; 　　　　　　PrintWriter writer = null ; 　　　　　　InputStream in = null ; 　　　　　　OutputStream out = null ; 　　　　　　Socket client = null ; 　　　　　　　　/* 　　　　　　add for log4j: class BasicConfigurator can quickly configure the package. 　　　　　　print the information to console. 　　　　　　*/ 　　　　　　PropertyConfigurator.configure ( "ClientWithLog4j.properties" ) ; 　　　　　　　　// add for log4j: set the level 　　//　　　　logger.setLevel ( ( Level ) Level.DEBUG ) ; 　　　　　　　　try{ 　　　　　　　　client = new Socket( "localhost" , 8001 ) ; 　　　　　　　　　　// add for log4j: log a message with the info level 　　　　　　　　logger.info ( "Client socket: " + client ) ; 　　　　　　　　　　in = client.getInputStream () ; 　　　　　　　　out = client.getOutputStream () ; 　　　　　　} catch ( IOException e ) { 　　　　　　　　　　// add for log4j: log a message with the error level 　　　　　　　　logger.error ( "IOException : " + e ) ; 　　　　　　　　　　System.exit ( 0 ) ; 　　　　　　} 　　　　　　　　try{ 　　　　　　　　reader = new BufferedReader ( new InputStreamReader ( in ) ) ; 　　　　　　　　writer = new PrintWriter ( new OutputStreamWriter ( out ), true ) ; 　　　　　　　　　　welcome = reader.readLine () ; 　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　logger.debug ( "Server says: '" + welcome + "'" ) ; 　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　logger.debug ( "HELLO" ) ; 　　　　　　　　　　writer.println ( "HELLO" ) ; 　　　　　　　　response = reader.readLine () ; 　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　logger.debug ( "Server responds: '" + response + "'" ) ; 　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　logger.debug ( "HELP" ) ; 　　　　　　　　　　writer.println ( "HELP" ) ; 　　　　　　　　response = reader.readLine () ; 　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　logger.debug ( "Server responds: '" + response + "'") ; 　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　logger.debug ( "QUIT" ) ; 　　　　　　　　　　writer.println ( "QUIT" ) ; 　　　　　　} catch ( IOException e ) { 　　　　　　　　　　// add for log4j: log a message with the warn level 　　　　　　　　logger.warn ( "IOException in client.in.readln()" ) ; 　　　　　　　　　　System.out.println ( e ) ; 　　　　　　} 　　　　　　try { 　　　　　　　　Thread.sleep ( 2000 ) ; 　　　　　　} catch ( Exception ignored ) {} 　　　　} 　　} 　　　　2.2.2. 服務器程序　　　　package log4j; 　　　　import java.util.* ; 　　import java.io.* ; 　　import java.net.* ; 　　　　// add for log4j: import some package 　　import org.apache.log4j.PropertyConfigurator ; 　　import org.apache.log4j.Logger ; 　　import org.apache.log4j.Level ; 　　　　/** 　　 * 　　 * Server With Log4j 　　 * Description: a sample with log4j 　　 * @version 1.0 　　 */ 　　public class ServerWithLog4j { 　　　　　　final static int SERVER_PORT = 8001 ; // this server's port 　　　　　　/* 　　　　add for log4j: class Logger is the central class in the log4j package. 　　　　we can do most logging operations by Logger except configuration. 　　　　getLogger(...): retrieve a logger by name, if not then create for it. 　　　　*/ 　　　　static Logger logger = Logger.getLogger 　　 ( ServerWithLog4j.class.getName () ) ; 　　　　　　/** 　　　　 * 　　　　 * @param args 　　　　 */ 　　　　public static void main ( String args[]) { 　　　　　　String clientRequest = null ; 　　　　　　BufferedReader reader = null ; 　　　　　　PrintWriter writer = null ; 　　　　　　ServerSocket server = null ; 　　　　　　Socket socket = null ; 　　　　　　　　InputStream in = null ; 　　　　　　OutputStream out = null ; 　　　　　　　　/* 　　　　　　add for log4j: class BasicConfigurator can quickly configure the package. 　　　　　　print the information to console. 　　　　　　*/ 　　　　　　PropertyConfigurator.configure ( "ServerWithLog4j.properties" ) ; 　　　　　　　　// add for log4j: set the level 　　//　　　　logger.setLevel ( ( Level ) Level.DEBUG ) ; 　　　　　　　　try{ 　　　　　　　　server = new ServerSocket ( SERVER_PORT ) ; 　　　　　　　　　　// add for log4j: log a message with the info level 　　　　　　　　logger.info ( "ServerSocket before accept: " + server ) ; 　　　　　　　　　　// add for log4j: log a message with the info level 　　　　　　　　logger.info ( "Java server with log4j, on-line!" ) ; 　　　　　　　　　　// wait for client's connection 　　　　　　　　socket = server.accept() ; 　　　　　　　　　　// add for log4j: log a message with the info level 　　　　　　　　logger.info ( "ServerSocket after accept: " + server ) ; 　　　　　　　　　　in = socket.getInputStream() ; 　　　　　　　　out = socket.getOutputStream() ; 　　　　　　　　} catch ( IOException e ) { 　　　　　　　　　　// add for log4j: log a message with the error level 　　　　　　　　logger.error ( "Server constructor IOException: " + e ) ; 　　　　　　　　System.exit ( 0 ) ; 　　　　　　} 　　　　　　reader = new BufferedReader ( new InputStreamReader ( in ) ) ; 　　　　　　writer = new PrintWriter ( new OutputStreamWriter ( out ), true ) ; 　　　　　　　　// send welcome string to client 　　　　　　writer.println ( "Java server with log4j, " + new Date () ) ; 　　　　　　　　while ( true ) { 　　　　　　　　try { 　　　　　　　　　　// read from client 　　　　　　　　　　clientRequest = reader.readLine () ; 　　　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　　　logger.debug ( "Client says: " + clientRequest ) ; 　　　　　　　　　　　　if ( clientRequest.startsWith ( "HELP" ) ) { 　　　　　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　　　　　logger.debug ( "OK!" ) ; 　　　　　　　　　　　　　　writer.println ( "Vocabulary: HELP QUIT" ) ; 　　　　　　　　　　} 　　　　　　　　　　else { 　　　　　　　　　　　　if ( clientRequest.startsWith ( "QUIT" ) ) { 　　　　　　　　　　　　　　　　// add for log4j: log a message with the debug level 　　　　　　　　　　　　　　logger.debug ( "OK!" ) ; 　　　　　　　　　　　　　　　　System.exit ( 0 ) ; 　　　　　　　　　　　　} 　　　　　　　　　　　　else { 　　　　　　　　　　　　　　　　// add for log4j: log a message with the warn level 　　　　　　　　　　　　　　logger.warn ( "Command '" 　　 + clientRequest + "' not understood." ) ; 　　　　　　　　　　　　　　　　writer.println ( "Command '" 　　 + clientRequest + "' not understood." ) ; 　　　　　　　　　　　　} 　　　　　　　　　　} 　　　　　　　　} catch ( IOException e ) { 　　　　　　　　　　　　// add for log4j: log a message with the error level 　　　　　　　　　　logger.error( "IOException in Server " + e ) ; 　　　　　　　　　　　　System.exit ( 0 ) ; 　　　　　　　　} 　　　　　　} 　　　　} 　　} 　　　　2.2.3. 配置文件　　　　2.2.3.1. 客戶程序配置文件　　　　log4j.rootLogger=INFO, A1 　　　　log4j.appender.A1=org.apache.log4j.ConsoleAppender 　　　　log4j.appender.A1.layout=org.apache.log4j.PatternLayout 　　　　log4j.appender.A1.layout.ConversionPattern=%-4r %-5p [%t] %37c %3x - %m%n 　　　　2.2.3.2. 服務器程序配置文件　　　　log4j.rootLogger=INFO, A1 　　　　log4j.appender.A1=org.apache.log4j.ConsoleAppender 　　　　log4j.appender.A1.layout=org.apache.log4j.PatternLayout 　　　　log4j.appender.A1.layout.ConversionPattern=%-4r %-5p [%t] %37c %3x - %m%n 　　　　2.3. 比較　　　　比較這兩個應用能夠看出，採用Log4j進行日誌操做的整個過程至關簡單明瞭，與直接使用System.out.println語句進行日誌信息輸出的方式相比，基本上沒有增長代碼量，同時可以清楚地理解每一條日誌信息的重要程度。經過控制配置文件，咱們還能夠靈活地修改日誌信息的格式，輸出目的地等等方面，而單純依靠System.out.println語句，顯然須要作更多的工做。 >>>> 3 . Log4j日誌管理系統簡單使用說明 <<<< 一般，咱們都提供一個名爲 log4j.properties的文件，在第一次調用到Log4J時，Log4J會在類路徑（../web-inf/class/固然也能夠放到其它任何目錄，只要該目錄被包含到類路徑中便可）中定位這個文件，並讀入這個文件完成的配置。這個配置文件告訴Log4J以什麼樣的格式、把什麼樣的信息、輸出到什麼地方。　　Log4j有三個主要的組件：Loggers(記錄器)，Appenders(輸出源)和Layouts(佈局)，這裏可簡單理解爲日誌類別，日誌要輸出的地方和日誌以何種形式輸出。綜合使用這三個組件能夠輕鬆的記錄信息的類型和級別，並能夠在運行時控制日誌輸出的樣式和位置。下面對三個組件分別進行說明：　　　　一、 Loggers 　　Loggers組件在此係統中被分爲五個級別：DEBUG、 INFO、WARN、ERROR和FATAL。這五個級別是有順序的，DEBUG < INFO < WARN < ERRor < FATAL，分別用來指定這條日誌信息的重要程度,明白這一點很重要，這裏Log4j有一個規則：假設Loggers級別爲P，若是在Loggers中發生了一個級別Q比P高，則能夠啓動，不然屏蔽掉。假設你定義的級別是info，那麼error和warn的日誌能夠顯示而比他低的debug信息就不顯示了。　　　Java程序舉例來講：　　　　//創建Logger的一個實例，命名爲「com.foo」　　　Logger　logger = Logger.getLogger("com.foo"); //"com.foo"是實例進行命名，也能夠任意　　//設置logger的級別。一般不在程序中設置logger的級別。通常在配置文件中設置。　　logger.setLevel(Level.INFO); 　　Logger barlogger = Logger.getLogger("com.foo.Bar"); 　　//下面這個請求可用，由於WARN >= INFO 　　logger.warn("Low fuel level."); 　　//下面這個請求不可用，由於DEBUG < INFO 　　logger.debug("Starting search for nearest gas station."); 　　//命名爲「com.foo.bar」的實例barlogger會繼承實例「com.foo」的級別。所以，下面這個請求可用，由於INFO >= INFO 　　barlogger.info("Located nearest gas station."); 　　//下面這個請求不可用，由於DEBUG < INFO 　　barlogger.debug("Exiting gas station search"); 　　這裏「是否可用」的意思是可否輸出Logger信息。　　　　在對Logger實例進行命名時，沒有限制，能夠取任意本身感興趣的名字。通常狀況下建議以類的所在位置來命名Logger實例，這是目前來說比較有效的Logger命名方式。這樣可使得每一個類創建本身的日誌信息，便於管理。好比：　　　　static Logger logger = Logger.getLogger(ClientWithLog4j.class.getName()); 　　　　二、Appenders 　　禁用與使用日誌請求只是Log4j其中的一個小小的地方，Log4j日誌系統容許把日誌輸出到不一樣的地方，如控制檯（Console）、文件（Files）、根據天數或者文件大小產生新的文件、以流的形式發送到其它地方等等。　　　　其語法表示爲：　　　　org.apache.log4j.ConsoleAppender（控制檯）　　org.apache.log4j.FileAppender（文件）　　org.apache.log4j.DailyRollingFileAppender（天天產生一個日誌文件） org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件）　　org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方）　　　　配置時使用方式爲：　　log4j.appender.appenderName = fully.qualified.name.of.appender.class 　　log4j.appender.appenderName.option1 = value1 　　… log4j.appender.appenderName.option = valueN 　　這樣就爲日誌的輸出提供了至關大的便利。　　　　三、Layouts 　　有時用戶但願根據本身的喜愛格式化本身的日誌輸出。Log4j能夠在Appenders的後面附加Layouts來完成這個功能。Layouts提供了四種日誌輸出樣式，如根據HTML樣式、自由指定樣式、包含日誌級別與信息的樣式和包含日誌時間、線程、類別等信息的樣式等等。　　　　其語法表示爲：　　　　org.apache.log4j.HTMLLayout（以HTML表格形式佈局），　　org.apache.log4j.PatternLayout（能夠靈活地指定佈局模式），　　org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串），　　org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息）　　　　配置時使用方式爲：　　　　log4j.appender.appenderName.layout =fully.qualified.name.of.layout.class 　　log4j.appender.appenderName.layout.option1 = value1 　　… 　　log4j.appender.appenderName.layout.option = valueN >>>> 4 . Log4j的配置 <<<<　　　　　　以上是從原理方面說明Log4j的使用方法，在具體Java編程使用Log4j能夠參照如下示例：　　　　一、創建Logger實例：　　語法表示：public static Logger getLogger( String name) 　　實際使用：static Logger logger = Logger.getLogger(ServerWithLog4j.class.getName ()) ; 　　　　二、讀取配置文件：　　得到了Logger的實例之，接下來將配置Log4j使用環境：　　語法表示：　　BasicConfigurator.configure()：自動快速地使用缺省Log4j環境。　　PropertyConfigurator.configure(String configFilename)：讀取使用Java的特性文件編寫的配置文件。　　DOMConfigurator.configure(String filename)：讀取XML形式的配置文件。　　實際使用： PropertyConfigurator.configure("ServerWithLog4j.properties"); 　　　　三、插入日誌信息　　完成了以上連個步驟之後，下面就能夠按日誌的不一樣級別插入到你要記錄日誌的任何地方了。　　語法表示：　　Logger.debug(Object message);//調試信息　　Logger.info(Object message);//通常信息　　Logger.warn(Object message);//警告信息　　Logger.error(Object message);//錯誤信息　　Logger.fatal(Object message);//致命錯誤信息　　實際使用：logger.info("ServerSocket before accept: " + server); 　　　>>>> 5. 配置過程 <<<< 　在實際編程時，要使Log4j真正在系統中運行事先還要對配置文件進行定義。定義步驟就是對Logger、Appender及Layout的分別使用。 Log4j支持兩種配置文件格式，一種是XML格式的文件，一種是java properties（key=value）【Java特性文件（鍵=值）】。下面咱們介紹使用Java特性文件作爲配置文件的方法具體以下：　　　　一、配置根Logger，其語法爲：　　log4j.rootLogger = [ level ] , appenderName1, appenderName2, … level : 是日誌記錄的優先級，分爲OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定義的級別。Log4j建議只使用四個級別，優先級從高到低分別是ERROR、WARN、INFO、DEBUG。經過在這裏定義的級別，您能夠控制到應用程序中相應級別的日誌信息的開關。好比在這裏定義了INFO級別，則應用程序中全部DEBUG級別的日誌信息將不被打印出來。　　 appenderName:就是指定日誌信息輸出到哪一個地方。您能夠同時指定多個輸出目的地。例如：log4j.rootLogger＝info,A1,B2,C3 　　　　二、配置日誌信息輸出目的地，其語法爲：　　log4j.appender.appenderName = fully.qualified.name.of.appender.class // 　　 "fully.qualified.name.of.appender.class" 能夠指定下面五個目的地中的一個： 1.org.apache.log4j.ConsoleAppender（控制檯） 2.org.apache.log4j.FileAppender（文件） 3.org.apache.log4j.DailyRollingFileAppender（天天產生一個日誌文件） 4.org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件） 5.org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方） 1.ConsoleAppender選項 Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。 Target=System.err：默認狀況下是：System.out,指定輸出控制檯 2.FileAppender 選項 Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。 File=mylog.txt:指定消息輸出到mylog.txt文件。 Append=false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容。 3.DailyRollingFileAppender 選項 Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。 File=mylog.txt:指定消息輸出到mylog.txt文件。 Append=false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容。 DatePattern='.'yyyy-ww:每週滾動一次文件，即每週產生一個新的文件。固然也能夠指定按月、周、天、時和分。即對應的格式以下： 1)'.'yyyy-MM: 每個月 2)'.'yyyy-ww: 每週 3)'.'yyyy-MM-dd: 天天 4)'.'yyyy-MM-dd-a: 天天兩次 5)'.'yyyy-MM-dd-HH: 每小時 6)'.'yyyy-MM-dd-HH-mm: 每分鐘 4.RollingFileAppender 選項 Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。 File=mylog.txt:指定消息輸出到mylog.txt文件。 Append=false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容。 MaxFileSize=100KB: 後綴能夠是KB, MB 或者是 GB. 在日誌文件到達該大小時，將會自動滾動，即將原來的內容移到mylog.log.1文件。 MaxBackupIndex=2:指定能夠產生的滾動文件的最大數。實際應用：　　log4j.appender.A1=org.apache.log4j.ConsoleAppender //這裏指定了日誌輸出的第一個位置A1是控制檯ConsoleAppender 　　　　三、配置日誌信息的格式，其語法爲：　　A. log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class "fully.qualified.name.of.layout.class" 能夠指定下面4個格式中的一個： 1.org.apache.log4j.HTMLLayout（以HTML表格形式佈局），　　 2.org.apache.log4j.PatternLayout（能夠靈活地指定佈局模式），　　 3.org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串），　　 4.org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息） 1.HTMLLayout 選項 LocationInfo=true:默認值是false,輸出java文件名稱和行號 Title=my app file: 默認值是 Log4J Log Messages. 2.PatternLayout 選項 ConversionPattern=%m%n :指定怎樣格式化指定的消息。 3.XMLLayout 選項 LocationInfo=true:默認值是false,輸出java文件和行號實際應用：　　log4j.appender.A1.layout=org.apache.log4j.PatternLayout B. log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n 這裏須要說明的就是日誌信息格式中幾個符號所表明的含義：　　－X號: X信息輸出時左對齊； %p: 輸出日誌信息優先級，即DEBUG，INFO，WARN，ERROR，FATAL, %d: 輸出日誌時間點的日期或時間，默認格式爲ISO8601，也能夠在其後指定格式，好比：%d{yyy MMM dd HH:mm:ss,SSS}，輸出相似：2002年10月18日 22：10：28，921 %r: 輸出自應用啓動到輸出該log信息耗費的毫秒數 %c: 輸出日誌信息所屬的類目，一般就是所在類的全名 %t: 輸出產生該日誌事件的線程名 %l: 輸出日誌事件的發生位置，至關於%C.%M(%F:%L)的組合,包括類目名、發生的線程，以及在代碼中的行數。舉例：Testlog4.main(TestLog4.java:10) %x: 輸出和當前線程相關聯的NDC(嵌套診斷環境),尤爲用到像java servlets這樣的多客戶多線程的應用中。 %%: 輸出一個"%"字符 %F: 輸出日誌消息產生時所在的文件名稱 %L: 輸出代碼中的行號 %m: 輸出代碼中指定的消息,產生的日誌具體信息 %n: 輸出一個回車換行符，Windows平臺爲"\r\n"，Unix平臺爲"\n"輸出日誌信息換行能夠在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如： 1)%20c：指定輸出category的名稱，最小的寬度是20，若是category的名稱小於20的話，默認的狀況下右對齊。 2)%-20c:指定輸出category的名稱，最小的寬度是20，若是category的名稱小於20的話，"-"號指定左對齊。 3)%.30c:指定輸出category的名稱，最大的寬度是30，若是category的名稱大於30的話，就會將左邊多出的字符截掉，但小於30的話也不會有空格。 4)%20.30c:若是category的名稱小於20就補空格，而且右對齊，若是其名稱長於30字符，就從左邊交遠銷出的字符截掉。　　這裏上面三個步驟是對前面Log4j組件說明的一個簡化；下面給出一個具體配置例子，在程序中能夠參照執行：　　log4j.rootLogger=INFO,A1，B2 　　log4j.appender.A1=org.apache.log4j.ConsoleAppender 　　log4j.appender.A1.layout=org.apache.log4j.PatternLayout 　　log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n 　　根據上面的日誌格式，某一個程序的輸出結果以下：　　0　　INFO　2003-06-13 13:23:46968 ClientWithLog4j Client socket: Socket[addr=localhost/127.0.0.1,port=8002,localport=2014] 16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server says: 'Java server with log4j, Fri Jun 13 13:23:46 CST 2003' 　　16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j GOOD 　　16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Command 'HELLO' not understood.' 　　16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j HELP 　　16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Vocabulary: HELP QUIT' 　　16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j QUIT 4. # 當輸出信息於回滾文件時 log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender //指定以文件的方式輸出日誌 log4j.appender.ROLLING_FILE.Threshold=ERROR log4j.appender.ROLLING_FILE.File=rolling.log //文件位置,也能夠用變量${java.home}、rolling.log log4j.appender.ROLLING_FILE.Append=true log4j.appender.ROLLING_FILE.MaxFileSize=10KB //文件最大尺寸 log4j.appender.ROLLING_FILE.MaxBackupIndex=1 //備份數 log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 　　 ×××××××××××××××××××××××××××××××××××××××××××××××× >>>> 6. Log4j比較全面的配置 <<<< LOG4J的配置之簡單使它遍佈於愈來愈多的應用中了：Log4J配置文件實現了輸出到控制檯、文件、回滾文件、發送日誌郵件、輸出到數據庫日誌表、自定義標籤等全套功能。擇其一二使用就夠用了， log4j.rootLogger=DEBUG,CONSOLE,A1,im log4j.addivity.org.apache=true # 應用於控制檯 log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender log4j.appender.Threshold=DEBUG log4j.appender.CONSOLE.Target=System.out log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n #log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n #應用於文件 log4j.appender.FILE=org.apache.log4j.FileAppender log4j.appender.FILE.File=file.log log4j.appender.FILE.Append=false log4j.appender.FILE.layout=org.apache.log4j.PatternLayout log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n # Use this layout for LogFactor 5 analysis # 應用於文件回滾 log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender log4j.appender.ROLLING_FILE.Threshold=ERRor log4j.appender.ROLLING_FILE.File=rolling.log //文件位置,也能夠用變量${java.home}、rolling.log log4j.appender.ROLLING_FILE.Append=true //true:添加 false:覆蓋 log4j.appender.ROLLING_FILE.MaxFileSize=10KB //文件最大尺寸 log4j.appender.ROLLING_FILE.MaxBackupIndex=1 //備份數 log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n #應用於socket log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender log4j.appender.SOCKET.RemoteHost=localhost log4j.appender.SOCKET.Port=5001 log4j.appender.SOCKET.LocationInfo=true # Set up for Log Facter 5 log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n # Log Factor 5 Appender log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000 # 發送日誌給郵件 log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender log4j.appender.MAIL.Threshold=FATAL log4j.appender.MAIL.BufferSize=10 log4j.appender.MAIL.From=web@[url]www.wuset.com[/url] log4j.appender.MAIL.SMTPHost=www.wusetu.com log4j.appender.MAIL.Subject=Log4J Message log4j.appender.MAIL.To=web@[url]www.wusetu.com[/url] log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n # 用於數據庫 log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver log4j.appender.DATABASE.user=root log4j.appender.DATABASE.password= log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n') log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender log4j.appender.A1.File=SampleMessages.log4j log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j' log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout #自定義Appender log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender log4j.appender.im.host = mail.cybercorlin.net log4j.appender.im.username = username log4j.appender.im.password = password log4j.appender.im.recipient = [email]corlin@cybercorlin.net[/email] log4j.appender.im.layout=org.apache.log4j.PatternLayout log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n Trackback: [url]http://tb.blog.csdn.net/TrackBack.aspx?PostId=488099[/url] Trackback: [url]http://tb.blog.csdn.net/TrackBack.aspx?PostId=578231[/url]