一:根節(jié)點<configuration>包含的屬性:
scan:
當此屬性設置為true時,配置文件如果發(fā)生改變,將會被重新加載,默認值為true。
scanPeriod:
設置監(jiān)測配置文件是否有修改的時間間隔,如果沒有給出時間單位,默認單位是毫秒。當scan為true時,此屬性生效。默認的時間間隔為1分鐘。
debug:
當此屬性設置為true時,將打印出logback內部日志信息,實時查看logback運行狀態(tài)。默認值為false。
例如:
Xml代碼
1. <configuration scan="true" scanPeriod="60 seconds" debug="false">
2.
3. </configuration>
二:根節(jié)點<configuration>的子節(jié)點:

2.1設置上下文名稱:<contextName>
每個logger都關聯(lián)到logger上下文,默認上下文名稱為“default”。但可以使用<contextName>設置成其他名字,用于區(qū)分不同應用程序的記錄。一旦設置,不能修改。
Xml代碼
1. <configuration scan="true" scanPeriod="60 seconds" debug="false">
2. <contextName>myAppName</contextName>
3.
4. </configuration>
2.2設置變量: <property>
用來定義變量值的標簽,<property> 有兩個屬性,name和value;其中name的值是變量的名稱,value的值時變量定義的值。通過<property>定義的值會被插入到logger上下文中。定義變量后,可以使“${}”來使用變量。
例如使用<property>定義上下文名稱,然后在<contentName>設置logger上下文時使用。
Xml代碼
1. <configuration scan="true" scanPeriod="60 seconds" debug="false">
2. <property name="APP_Name" value="myAppName" />
3. <contextName>${APP_Name}</contextName>
4.
5. </configuration>
2.3獲取時間戳字符串:<timestamp>
兩個屬性 key:標識此<timestamp> 的名字;datePattern:設置將當前時間(解析配置文件的時間)轉換為字符串的模式,遵循java.txt.SimpleDateFormat的格式。
例如將解析配置文件的時間作為上下文名稱:
Xml代碼
1. <configuration scan="true" scanPeriod="60 seconds" debug="false">
2. <timestamp key="bySecond" datePattern="yyyyMMdd'T'HHmmss"/>
3. <contextName>${bySecond}</contextName>
4.
5. </configuration>
2.4設置loger:
<loger>
用來設置某一個包或者具體的某一個類的日志打印級別、以及指定<appender>。<loger>僅有一個name屬性,一個可選的level和一個可選的addtivity屬性。
name:
用來指定受此loger約束的某一個包或者具體的某一個類。
level:
用來設置打印級別,大小寫無關:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,還有一個特俗值INHERITED或者同義詞NULL,代表強制執(zhí)行上級的級別。
如果未設置此屬性,那么當前l(fā)oger將會繼承上級的級別。
addtivity:
是否向上級loger傳遞打印信息。默認是true。
<loger>可以包含零個或多個<appender-ref>元素,標識這個appender將會添加到這個loger。
<root>
也是<loger>元素,但是它是根loger。只有一個level屬性,應為已經被命名為"root".
level:
用來設置打印級別,大小寫無關:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能設置為INHERITED或者同義詞NULL。
默認是DEBUG。
<root>可以包含零個或多個<appender-ref>元素,標識這個appender將會添加到這個loger。
例如:
LogbackDemo.java類
Java代碼
1. package logback;
3. import org.slf4j.Logger;
4. import org.slf4j.LoggerFactory;
6. public class LogbackDemo {
7. private static Logger log = LoggerFactory.getLogger(LogbackDemo.class);
8. public static void main(String[] args) {
9. log.trace("======trace");
10. log.debug("======debug");
11. log.info("======info");
12. log.warn("======warn");
13. log.error("======error");
14. }
15. }
logback.xml配置文件
第1種:只配置root
Xml代碼
1. <configuration>
3. <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
4.
5. <encoder>
6. <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
7. </encoder>
8. </appender>
10. <root level="INFO">
11. <appender-ref ref="STDOUT" />
12. </root>
14. </configuration>
其中appender的配置表示打印到控制臺(稍后詳細講解appender );
<root level="INFO">將root的打印級別設置為“INFO”,指定了名字為“STDOUT”的appender。
當執(zhí)行l(wèi)ogback.LogbackDemo類的main方法時,root將級別為“INFO”及大于“INFO”的日志信息交給已經配置好的名為“STDOUT”的appender處理,“STDOUT”appender將信息打印到控制臺;
打印結果如下:
Xml代碼
1. 13:30:38.484 [main] INFO logback.LogbackDemo - ======info
2. 13:30:38.500 [main] WARN logback.LogbackDemo - ======warn
3. 13:30:38.500 [main] ERROR logback.LogbackDemo - ======error
** 第2種:帶有l(wèi)oger的配置,不指定級別,不指定appender,**
Xml代碼
1. <configuration>
3. <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
4.
5. <encoder>
6. <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
7. </encoder>
8. </appender>
10.
11. <logger name="logback"/>
13. <root level="DEBUG">
14. <appender-ref ref="STDOUT" />
15. </root>
17. </configuration>
其中appender的配置表示打印到控制臺(稍后詳細講解appender );
<logger name="logback" />將控制logback包下的所有類的日志的打印,但是并沒用設置打印級別,所以繼承他的上級<root>的日志級別“DEBUG”;
沒有設置addtivity,默認為true,將此loger的打印信息向上級傳遞;
沒有設置appender,此loger本身不打印任何信息。
<root level="DEBUG">將root的打印級別設置為“DEBUG”,指定了名字為“STDOUT”的appender。
當執(zhí)行l(wèi)ogback.LogbackDemo類的main方法時,因為LogbackDemo 在包logback中,所以首先執(zhí)行<logger name="logback" />,將級別為“DEBUG”及大于“DEBUG”的日志信息傳遞給root,本身并不打??;
root接到下級傳遞的信息,交給已經配置好的名為“STDOUT”的appender處理,“STDOUT”appender將信息打印到控制臺;
打印結果如下:
Xml代碼
1. 13:19:15.406 [main] DEBUG logback.LogbackDemo - ======debug
2. 13:19:15.406 [main] INFO logback.LogbackDemo - ======info
3. 13:19:15.406 [main] WARN logback.LogbackDemo - ======warn
4. 13:19:15.406 [main] ERROR logback.LogbackDemo - ======error
第3種:帶有多個loger的配置,指定級別,指定appender
Xml代碼
1. <configuration>
2. <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
3.
4. <encoder>
5. <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
6. </encoder>
7. </appender>
9.
10. <logger name="logback"/>
11.
12. <logger name="logback.LogbackDemo" level="INFO" additivity="false">
13. <appender-ref ref="STDOUT"/>
14. </logger>
16. <root level="ERROR">
17. <appender-ref ref="STDOUT" />
18. </root>
19. </configuration>
其中appender的配置表示打印到控制臺(稍后詳細講解appender );
<logger name="logback" />將控制logback包下的所有類的日志的打印,但是并沒用設置打印級別,所以繼承他的上級<root>的日志級別“DEBUG”;
沒有設置addtivity,默認為true,將此loger的打印信息向上級傳遞;
沒有設置appender,此loger本身不打印任何信息。
<logger name="logback.LogbackDemo" level="INFO" additivity="false">控制logback.LogbackDemo類的日志打印,打印級別為“INFO”;
additivity屬性為false,表示此loger的打印信息不再向上級傳遞,
指定了名字為“STDOUT”的appender。
<root level="DEBUG">將root的打印級別設置為“ERROR”,指定了名字為“STDOUT”的appender。
當執(zhí)行l(wèi)ogback.LogbackDemo類的main方法時,先執(zhí)行<logger name="logback.LogbackDemo" level="INFO" additivity="false">,將級別為“INFO”及大于“INFO”的日志信息交給此loger指定的名為“STDOUT”的appender處理,在控制臺中打出日志,不再向次loger的上級 <logger name="logback"/> 傳遞打印信息;
<logger name="logback"/>未接到任何打印信息,當然也不會給它的上級root傳遞任何打印信息;
打印結果如下:
Xml代碼
1. 14:05:35.937 [main] INFO logback.LogbackDemo - ======info
2. 14:05:35.937 [main] WARN logback.LogbackDemo - ======warn
3. 14:05:35.937 [main] ERROR logback.LogbackDemo - ======error
如果將<logger name="logback.LogbackDemo" level="INFO" additivity="false">修改為 <logger name="logback.LogbackDemo" level="INFO" additivity="true">那打印結果將是什么呢?
沒錯,日志打印了兩次,想必大家都知道原因了,因為打印信息向上級傳遞,logger本身打印一次,root接到后又打印一次
打印結果如下:
Xml代碼
1. 14:09:01.531 [main] INFO logback.LogbackDemo - ======info
2. 14:09:01.531 [main] INFO logback.LogbackDemo - ======info
3. 14:09:01.531 [main] WARN logback.LogbackDemo - ======warn
4. 14:09:01.531 [main] WARN logback.LogbackDemo - ======warn
5. 14:09:01.531 [main] ERROR logback.LogbackDemo - ======error
6. 14:09:01.531 [main] ERROR logback.LogbackDemo - ======error