Logback学习

最新推荐文章于 2024-03-01 18:04:29 发布
最新推荐文章于 2024-03-01 18:04:29 发布
阅读量5.8k 收藏 3
点赞数 2
分类专栏： Java 文章标签： thread user email layout string xml

Logback介绍

Logback 分为三个模块：Core、Classic 和 Access。Core模块是其他两个模块的基础。 Classic模块扩展了core模块。 Classic模块相当于log4j的显著改进版。Logback-classic 直接实现了 SLF4J API。

要引入logback，由于Logback-classic依赖slf4j-api.jar和logback-core.jar，所以要把slf4j-api.jar、logback-core.jar、logback-classic.jar，添加到要引入Logbac日志管理的项目的class path中.



Logback的配置

Logger、Appender和 Layout

Logback建立于三个主要类之上：Logger、Appender 和 Layout。Logger类是logback-classic模块的一部分，而Appender和Layout接口来自logback-core。作为一个多用途模块，logback-core 不包含任何 logger。

Logger作为日志的记录器，把它关联到应用的对应的context上后，主要用于存放日志对象，也可以定义日志类型、级别。Appender主要用于指定日志输出的目的地，目的地可以是控制台、文件、远程套接字服务器、 MySQL、 PostreSQL、 Oracle和其他数据库、 JMS和远程UNIX Syslog守护进程等。Layout 负责把事件转换成字符串，格式化的日志信息的输出。



Logger context

各个logger 都被关联到一个 LoggerContext，LoggerContext负责制造logger，也负责以树结构排列各 logger。

如果 logger的名称带上一个点号后是另外一个 logger的名称的前缀，那么，前者就被称为后者的祖先。如果 logger与其后代 logger之间没有其他祖先，那么，前者就被称为子logger 之父。比如，名为 "com.foo""的 logger 是名为"com.foo.Bar"之父。root logger 位于 logger 等级的最顶端，root logger 可以通过其名称取得，如下所示：

Logger rootLogger =LoggerFactory.getLogger(org.slf4j.Logger.ROOT_LOGGER_NAME);

其他所有logger也通过org.slf4j.LoggerFactory 类的静态方法getLogger取得。 getLogger方法以 logger 名称为参数。用同一名字调用LoggerFactory.getLogger 方法所得到的永远都是同一个logger对象的引用。

   

有效级别与级别继承

Logger 可以被分配级别。级别包括：TRACE、DEBUG、INFO、WARN 和 ERROR，定义于 ch.qos.logback.classic.Level类。如果 logger没有被分配级别，那么它将从有被分配级别的最近的祖先那里继承级别。root logger 默认级别是 DEBUG。



打印方法与基本选择规则

打印方法决定记录请求的级别。例如，如果 L 是一个 logger 实例，那么，语句 L.info("..")是一条级别为 INFO 的记录语句。记录请求的级别在高于或等于其 logger 的有效级别时被称为被启用，否则，称为被禁用。

记录请求级别为 p，其 logger的有效级别为 q，只有则当 p>=q时，该请求才会被执行。

该规则是 logback 的核心。级别排序为： TRACE < DEBUG < INFO < WARN < ERROR。



Logger、Appenders及layouts的关系

一个 logger 可以被关联多个 appender。方法 addAppender() 为指定的 logger 添加一个 appender。对于 logger 的每个启用了的记录请求，都将被发送到 logger 里的全部 appender 及更高等级的 appender。换句话说，appender叠加性地继承了 logger 的层次等级。

Logger L的记录语句的输出会发送给 L及其祖先的全部 appender。如果 logger L的某个祖先 P设置叠加性标识为 false，那么，L的输出会发送给L 与 P之间（含P）的所有 appender，但不会发送给P的任何祖先的appender。

Logger 的叠加性默认为 true。如果希望定制输出格式。这时为 appender 关联一个 layout 即可。Layout 负责根据用户意愿对记录请求进行格式化，appender 负责将格式化化后的输出发送到目的地。

例如，转换模式"%-4relative [%thread] %-5level %logger{32} - %msg%n"在 PatternLayout里会输出形如：

176 [main] DEBUG manual.architecture.HelloWorld2 - Hello world.

第一个字段是自程序启动以来的逝去时间，单位是毫秒。

第二个地段发出记录请求的线程。

第三个字段是记录请求的级别。

第四个字段是与记录请求关联的 logger 的名称。

"-"之后是请求的消息文字。



Logback的默认配置

如果配置文件 logback-test.xml 和 logback.xml 都不存在，那么 logback 默认地会调用BasicConfigurator ，创建一个最小化配置。最小化配置由一个关联到根 logger 的ConsoleAppender 组成。输出用模式为%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n 的 PatternLayoutEncoder 进行格式化。root logger 默认级别是 DEBUG。

logback配置文件

Logback 配置文件的语法非常灵活。正因为灵活，所以无法用 DTD 或 XML schema 进行定义。尽管如此，可以这样描述配置文件的基本结构：以<configuration>开头，后面有零个或多个<appender>元素，有零个或多个<logger>元素，有最多一个<root>元素。




Logback默认配置的采用的步骤

1. 尝试在 classpath 下查找文件 logback-test.xml；

2. 如果文件不存在，则查找文件 logback.xml；

3. 如果两个文件都不存在，logback 用 Bas icConfigurator 自动对自己进行配置，这会导致记录输出到控制台。



假设配置文件 logback-test.xml 和 logback.xml 都不存在，那么 logback 默认地会调用BasicConfigurator ，创建一个最小化配置。最小化配置由一个关联到根 logger 的ConsoleAppender 组成。输出用模式为%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n 的 PatternLayoutEncoder 进行格式化。还有，根 logger 默认级别是 DEBUG。

最简单的配置方法就是使用默认配置。以下是logback用BasicConfigurator 配置的简单例子：

Java代码 复制代码  收藏代码
  1. package com.ttpod.chapters.configuration;   
  2.   
  3. import org.slf4j.Logger;   
  4.   
  5. import org.slf4j.LoggerFactory;   
  6.   
  7. publicclass MyApp1 {   
  8.   
  9. finalstatic Logger logger = LoggerFactory.getLogger(MyApp1.class);   
  10.   
  11. publicstaticvoid main(String[] args) {   
  12.   
  13. logger.info("Entering application.");    //进行另一个application中   
  14.   
  15. Foo foo = new Foo();   
  16.   
  17. foo.doIt();        //执行其它中的日志输出方法   
  18.   
  19. logger.info("Exiting application.");    //退出另一个application   
  20.   
  21. }   
  22.   
  23. }  
package com.ttpod.chapters.configuration;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

publicclass MyApp1 {

finalstatic Logger logger = LoggerFactory.getLogger(MyApp1.class);

publicstaticvoid main(String[] args) {

logger.info("Entering application.");    //进行另一个application中

Foo foo = new Foo();

foo.doIt();        //执行其它中的日志输出方法

logger.info("Exiting application.");    //退出另一个application

}

}

 
该类定义了一个静态变量 logger，然后实例化一个 Foo 对象。Foo 类如下

Java代码 复制代码  收藏代码
  1. package com.ttpod.chapters.configuration;   
  2.   
  3. import org.slf4j.Logger;   
  4.   
  5. import org.slf4j.LoggerFactory;   
  6.   
  7. publicclass Foo {   
  8.   
  9. staticfinal Logger logger = LoggerFactory.getLogger(Foo.class);   
  10.   
  11. publicvoid doIt() {   
  12.   
  13. logger.debug("Did it again!");    //定义一个debug级别的日志输出   
  14.   
  15. }   
  16.   
  17.     …………   
  18.   
  19. }  
package com.ttpod.chapters.configuration;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

publicclass Foo {

staticfinal Logger logger = LoggerFactory.getLogger(Foo.class);

publicvoid doIt() {

logger.debug("Did it again!");    //定义一个debug级别的日志输出

}

    …………

}

 


自动打印警告和错误消息

当解析配置文件有警告或出错时，logback 会在控制台上自动打印状态数据。如果没有警告或错误，还是想检查 logback 的内部状态的话，可以调用 StatusPrinter 的 print()方法。示例如下：

Java代码 复制代码  收藏代码
  1. finalstatic Logger logger = LoggerFactory.getLogger(MyApp2.class);   
  2.   
  3. publicstaticvoid main(String[] args) {   
  4.   
  5. // 在当前环境中假设 SLF4J 已经被绑定到logback   
  6.   
  7. LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();   
  8.   
  9. // 打印logback的内部状态   
  10.   
  11. StatusPrinter.print(lc);   
  12.   
  13. …………   
  14.   
  15. }   
  16.   
  17. }  
finalstatic Logger logger = LoggerFactory.getLogger(MyApp2.class);

publicstaticvoid main(String[] args) {

// 在当前环境中假设 SLF4J 已经被绑定到logback

LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();

// 打印logback的内部状态

StatusPrinter.print(lc);

…………

}

}

 

对应的配置文件：

Xml代码 复制代码  收藏代码
  1. <?xmlversionxmlversion="1.0"encoding="UTF-8"?>  
  2.   
  3. <configuration>  
  4.   
  5. <!--定义一个名为STDOUT的appender，并将其关联到ch.qos.logback.core.ConsoleAppender-->  
  6.   
  7. <appendernameappendername="STDOUT"  
  8.   
  9. class="ch.qos.logback.core.ConsoleAppender">  
  10.   
  11. <!-- encoders 作用是将logger事件转换成字节数组，并将字节数组写入到输出流-->  
  12.   
  13. <encoder>  
  14.   
  15.     <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度   
  16.   
  17. %msg：日志消息，%n是换行符-->  
  18.   
  19. <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>  
  20.   
  21. </encoder>  
  22.   
  23. </appender>  
  24.   
  25. <rootlevelrootlevel="debug">    <!-- root logger，定义级别为debug-->  
  26.   
  27. <appender-refrefappender-refref="STDOUT"/>    <!--将名为STDOUT的appender添加到root logger下-->  
  28.   
  29. </root>  
  30.   
  31. </configuration>  

 

控制台输出结果如下：

Xml代码 复制代码  收藏代码
  1. …………   
  2.   
  3. 20:12:33,359 |-INFO in ch.qos.logback.classic.LoggerContext[default] - Could NOT find resource [logback.groovy]   
  4.   
  5. 20:12:33,359 |-INFO in ch.qos.logback.classic.LoggerContext[default] - Could NOT find resource [logback-test.xml]   
  6.   
  7. 20:12:33,359 |-INFO in ch.qos.logback.classic.LoggerContext[default] - Found resource [logback.xml] at [file:/D:/Workspaces/MyEclipse%208.5/logback_test/WebRoot/WEB-INF/classes/logback.xml]   
  8.   
  9. 20:12:33,484 |-INFO in ch.qos.logback.core.joran.action.AppenderAction - About to instantiate appender of type [ch.qos.logback.core.ConsoleAppender]   
  10.   
  11. 20:12:33,484 |-INFO in ch.qos.logback.core.joran.action.AppenderAction - Naming appender as [STDOUT]   
  12.   
  13. 20:12:33,500 |-INFO in ch.qos.logback.core.joran.action.NestedComplexPropertyIA - Assuming default type [ch.qos.logback.classic.encoder.PatternLayoutEncoder] for [encoder] property   
  14.   
  15. 20:12:33,593 |-INFO in ch.qos.logback.classic.joran.action.RootLoggerAction - Setting level of ROOT logger to DEBUG   
  16.   
  17. 20:12:33,593 |-INFO in ch.qos.logback.core.joran.action.AppenderRefAction - Attaching appender named [STDOUT] to Logger[ROOT]   
  18.   
  19. 20:12:33,593 |-INFO in ch.qos.logback.classic.joran.action.ConfigurationAction - End of configuration.   
  20.   
  21. 20:12:33,593 |-INFO in ch.qos.logback.classic.joran.JoranConfigurator@cb6009 - Registering current configuration as safe fallback point   
  22.   
  23. …………  

 



Logback自定义配置

配置root logger

<root>元素配置根 logger。该元素有一个 level属性。没有 name 属性，因为已经被命名为"ROOT"。 Level 属性的值大小写无关，其值为下面其中一个字符串：TRACE、DEBUG、INFO、WARN、ERROR、ALL和 OFF。注意不能设置为"INHERITED" 或"NULL"。 <logger>元素可以包含零个或多个<appender-ref>元素。与<logger>元素类似，声明<root>元素后，会先关闭然后移除全部当前 appender，只引用声明了的 appender。如果 root 元素没有引用任何 appender，就会失去所有 appender。

假设我们不想看到"com.ttpod.file"包里的任何组件的任何 DEBUG 信息，可以设置如下：

Xml代码 复制代码  收藏代码
  1. <?xmlversionxmlversion="1.0"encoding="UTF-8"?>  
  2.   
  3. <configuration>  
  4.   
  5. <appendernameappendername="STDOUT"class="ch.qos.logback.core.ConsoleAppender">  
  6.   
  7. <encoder>  
  8.   
  9. <pattern>  
  10.   
  11. %d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n   
  12.   
  13.      </pattern>  
  14.   
  15. </encoder>  
  16.   
  17.     </appender>  
  18.   
  19.     <!-- 设置configuration下的logger的级别为INFO，默认是继承root logger的debug级别 -->  
  20.   
  21.     <loggernameloggername="chapters.configuration"level="INFO"/>  
  22.   
  23.     <!-- 严格来说, root logger 的level属性没有必要设置，因为 -->  
  24.   
  25.     <!-- root logger的级别被默认设置为DEBUG -->  
  26.   
  27.     <rootlevelrootlevel="DEBUG">  
  28.   
  29.         <!--   
  30.   
  31.          在root标签内没有引入chapters.configuration，所有在此包下不会   
  32.   
  33.         显示任何组件的任何 DEBUG 信息   
  34.   
  35.         -->  
  36.   
  37.         <appender-refrefappender-refref="STDOUT"/>    <!-- 将appender引入到root logger -->  
  38.   
  39.     </root>  
  40.   
  41. </configuration>  

 

注意：由名为"chapters.configuration.Foo"的 logger 生成的 DEBUG 级别的信息都被屏蔽了.同样，也可以为任意数量的 logger 设置级别。

配置 Appenders

Appender 用<appender>元素配置，该元素必要属性 name 和 class。 name 属性指定 appender 的名称，class 属性指定 appender 类的全限定名。 <appender>元素可以包含零个或多个<layout>元素、零个或多个<encoder>元素和零个或多个<filter>元素。除了这三个常用元素之外，还可以包含 appender 类的任意数量的 javabean

属性。下图演示了常用结构，注意对 javabean 属性的支持在图中不可见。




记录输出到多个 appender 很简单，先定义各种 appender，然后在 logger 里进行引用，就行了。如下面的配置文件所示：

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3.     <appendernameappendername="FILE"class="ch.qos.logback.core.FileAppender">  
  4.   
  5.         <file>myApp.log</file>  
  6.   
  7. <!-- encoders are assigned by default the type   
  8.   
  9. ch.qos.logback.classic.encoder.PatternLayoutEncoder -->  
  10.   
  11. <encoder>  
  12.   
  13.             <pattern>%date %level [%thread] %logger{10} [%file:%line] %msg%n</pattern>  
  14.   
  15. </encoder>  
  16.   
  17.     </appender>  
  18.   
  19.   
  20.   
  21.     <appendernameappendername="STDOUT"class="ch.qos.logback.core.ConsoleAppender">  
  22.   
  23. <encoder>  
  24.   
  25. <pattern>%msg%n</pattern>  
  26.   
  27. </encoder>  
  28.   
  29.     </appender>  
  30.   
  31.   
  32.   
  33.     <rootlevelrootlevel="debug">  
  34.   
  35.         <appender-refrefappender-refref="FILE"/>  
  36.   
  37.         <appender-refrefappender-refref="STDOUT"/>  
  38.   
  39.     </root>  
  40.   
  41. </configuration>  

 

该配置文件定义了两个 appender，分别是"FILE"和"STDOUT"。"FILE"这个 appender 把记录输出到文件"myapp.log "，它的 encoder 是PatternLayoutEncoder，输出了日期、级别、线程名、logger 名、文件名及记录请求的行号、消息和行分隔符。"STDOUT"这个 appender 把记录输出到控制台，它的 encoder 只是输出消息和行分隔符。 myApp.log文件内容如下：

Xml代码 复制代码  收藏代码
  1. 2011-12-25 16:56:48,593 INFO [main] c.t.c.c.MyApp3 [MyApp3.java:48] Entering application.   
  2.   
  3. 2011-12-25 16:56:48,593 DEBUG [main] c.t.c.c.Foo [Foo.java:24] Did it again!   
  4.   
  5. 2011-12-25 16:56:48,593 INFO [main] c.t.c.c.MyApp3 [MyApp3.java:52] Exiting application.  

 
    注意每个 appender 都有自己的 encoder。Encoder 通常不能被多个 appender 共享，layout也是。所以，logback 的配置文件里没有共享 encoder 或 layout 的语法。

Appender累积

默认情况下，appender 是可累积的：logger 会把记录输出到它自身的 appender 和它所有祖先的 appender。因此，把同一 appender 关联到多个 logger 会导致重复输出，如下面的配置文件会导致重复的输出：

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3.     <appendernameappendername="STDOUT"  
  4.   
  5.         class="ch.qos.logback.core.ConsoleAppender">  
  6.   
  7.         <encoder>  
  8.   
  9.             <pattern>  
  10.   
  11.                 %d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n   
  12.   
  13.             </pattern>  
  14.   
  15. </encoder>  
  16.   
  17.     </appender>  
  18.   
  19.     <loggernameloggername="chapters.configuration">  
  20.   
  21.         <appender-refrefappender-refref="STDOUT"/>  
  22.   
  23.     </logger>  
  24.   
  25.     <rootlevelrootlevel="debug">  
  26.   
  27.         <appender-refrefappender-refref="STDOUT"/> <!—这会导致重复输出-->  
  28.   
  29.     </root>  
  30.   
  31. </configuration>  

 

输出结果如下：

Xml代码 复制代码  收藏代码
  1. 20:53:29.328 [main] INFO c.t.chapters.configuration.MyApp2 - Entering application.   
  2.   
  3. 20:53:29.328 [main] INFO c.t.chapters.configuration.MyApp2 - Entering application.   
  4.   
  5. 20:53:29.328 [main] DEBUG com.ttpod.chapters.configuration.Foo - Did it again!   
  6.   
  7. 20:53:29.328 [main] DEBUG com.ttpod.chapters.configuration.Foo - Did it again!   
  8.   
  9. 20:53:29.328 [main] INFO c.t.chapters.configuration.MyApp2 - Exiting application.   
  10.   
  11. 20:53:29.328 [main] INFO c.t.chapters.configuration.MyApp2 - Exiting application.  

 



覆盖默认的累积行为

如果你觉得默认的累积行为不合适，可以设置叠加性标识为 false 以关闭它。这样的话，logger 树里的某个分支可以输出到与其他 logger 不同的 appender。

示例：叠加性标识

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3.     …………   
  4.   
  5.     <loggernameloggername="com.ttpod.chapters.configuration.Foo"additivity="false">  
  6.   
  7.         <appender-refrefappender-refref="FILE"/>  
  8.   
  9.     </logger>  
  10.   
  11.     <rootlevelrootlevel="debug">  
  12.   
  13.         <appender-refrefappender-refref="STDOUT"/>  
  14.   
  15.     </root>  
  16.   
  17. </configuration>  

 

输出结果：

Xml代码 复制代码  收藏代码
  1. Entering application.   
  2.   
  3. Exiting application.  

 

此例中，logger"chapters.configuration.Foo"关联 appender"FILE"，它的叠加性标记为false，这样它的记录输出仅会被发送到 appender"FILE"，不会被发送到更高 logger 等级关联的 appender。其他 logger 不受此影响。用 additivityFlag.xml 配置 MyApp3 ，运行后，控制台上由输出由"chapters.configuration.MyApp3"产生的记录。而 logger" chapters.configuration.Foo"将且仅仅将输出到文件 foo.log。

Layout格式化输出日志

配置自定义 layout

配置自定义layout与配置其他layout是一样的。 FileAppender和其子类需要一个encoder。如链接中的例子：javascript:mctmp(0);

    此类中定义了一个处理格式的输出类，为了满足自定义的格式化的输出，把包裹了 MySampleLayout 的 LayoutWrappingEncoder 实例传递给FileAppender。下面是配置文件：

Xml代码 复制代码  收藏代码
  1. <configurationdebugconfigurationdebug="true">  
  2.   
  3. <appendernameappendername="STDOUT"class="ch.qos.logback.core.ConsoleAppender">  
  4.   
  5. <encoderclassencoderclass="ch.qos.logback.core.encoder.LayoutWrappingEncoder">  
  6.   
  7.      <!—自定义的格式化输出处理类-->  
  8.   
  9. <layoutclasslayoutclass="com.ttpod.chapters.layouts.MySampleLayout"/>  
  10.   
  11. </encoder>  
  12.   
  13. </appender>  
  14.   
  15. <rootlevelrootlevel="DEBUG">  
  16.   
  17. <appender-refrefappender-refref="STDOUT"/>  
  18.   
  19. </root>  
  20.   
  21. </configuration>  

 

输出结果如下：

Xml代码 复制代码  收藏代码
  1. 250 DEBUG [main] com.ttpod.chapters.introduction.HelloWorld1 - Hello world.  

 



layout转换符

它和C语言的printf方法非常类似。格式转换由普通字符和转换字符组合而成。转换字符由%开始，紧跟着的是可选的格式修饰符和转换字符标示。使用%前缀的表示符号将被转换到实际的内容。如name, level, date, thread name.可用的转换符有：

转换符

描述

c
调用日志事件的所在记录器的名字，如一个logger的名字是my.test.bbb.ccc，调用的是WARN级别的日志输出，那么输出的是输出my.test.bbb.ccc，可以在其右边指定了精度，如%c{2}那么输出的是bbb.ccc

C
调用日志事件的所在的类名，和c转换符一样，可以在右边指定宽度，如%C{2}输出%C{2}

d
日志调用所发生的时间，日期格式在其后跟着的大括号内的格式指定如%d{yyyy-MM-dd HH:mm:ss}，我现在输出的结果是2011-07-11 21:05:22，推荐使用的是log4j本身提供的日期格式，如%d{ISO8601}，%d{ABSOLUTE}，%d{DATE}

F
所处所在文件名，如上面说C转换符的例子，输出结果是LayoutTest.java

l
是的日志事件发生的位置信息，这个和虚拟机的实现有点关系，一般境况下能得到类，方法，行数源文件等信息，

L
只是输出触发日志事件代码所在的行号，性能损耗会小很多。

m
显示应用给日志提供的其他信息，如消息。logger.warn("Message 2");那么%m将得到的是Message 2

M
输出调用者所在的方法名

n
换行，和\r \r\n有相同功能，能识别系统的换行符，自动转换成\r或者\r\n，log4j推荐使用这个转换符，而不是\r或者\r\n

p
输出调用的日志的级别，如我是调用logger.debug方法，那么级别就是debug

r
输出自应用启动后第一次调用logger的日志输出方法，到输出该log信息耗费的毫秒数

t
输出所在线程的名字

x
输出产生的日志事件的线程的NDC（嵌套诊断上下文）

X
输出与生成的日志事件的线程关联的MDC（映射诊断上下文）。X转换符括号之间放置了一个key，就像在％X {clientNumber}中的clientNumberkey 一样。在MDC correspondingvalue将被输出。

%
写上%%后将直接输出一个%符号



layout格式修饰符

如给定的一个格式：%-5p [%t]: %m%n中，并没有明确的分隔转换字符和普通文本的字符存在。PatternLayout能自己区分普通文本和转换字符。其中%-5p是日志的调用级别。事件是左对齐的，5个字符宽度。

格式修饰符，放在%和转换符之间。 第一个可选的格式修饰符是左对齐(-)；第二个可选的格式修饰符是字段最小宽度。一个整数。表示输出的最小字符数。如果数据未达到指定最小大小，那么它将以左填充（默认）或者右填充方式（左对齐情况下只能使用右填充了）。用空格填充，直到达到最小宽度。如果大于指定最小宽度，不会被截断 。当然可以指定最大字符数，使用.符号加数字表示最大字符数。如果大于指定长度，多余的字符会被删除。它是从前面删除，而不是从后面删除的。如最大字符是8个，数据有10个字符，那么前面两个字符会被删除。

%20c 右对齐，最少20字符，没有左边用空格填充

%-20c 左对齐，最少20字符，没有右边用空格填充

%.30c 右对齐，最多30字符，超过左边的截取掉

%20.30c 右对齐，最少20字符，最多30字符，填充或截取规则略

%-20.30c 左对齐，最少20字符，最多30字符，填充或截取规则略



在程序里启用logback记录

三个必须步骤：

1. 配置 logback 环境。

2. 在每个需要执行记录的类里，调用 org.slf4j.LoggerFactory 类的 getLogger()方法获

取一个 Logger 实例，以当前类名或类本身作为参数。

3. 调用取得的 logger 实例的打印方法，即 debug()、info()、warn()和 error()，把记录

输出到配置里的各 appender。

直接调用JoranConfigurator

Logback 依赖Joran，Joran是 logback-core 的一部分，是个配置类库。Logback 的默认配置机制是调用JoranConfigurator对classpath上的默认配置文件进行处理。不管出于什么理由，如果你想重新实现 logback 的默认配置机制的话，你可以直接调用 JoranConfigurator。下面程序 MyApp1 就调用了 JoranConfigurator 对作为参数传入的配置文件进行处理。

示例1

(com/ttpod/file/ MyApp1.java)

Java代码 复制代码  收藏代码
  1. package com.ttpod.file;   
  2.   
  3. import org.slf4j.Logger;                //用于声明Logger   
  4.   
  5. import org.slf4j.LoggerFactory;     //用于获取Logger以及LoggerContext   
  6.   
  7. import ch.qos.logback.classic.LoggerContext;         //用于声明LoggerContext   
  8.   
  9. import ch.qos.logback.classic.joran.JoranConfigurator;//用于定义Logback的配置机制   
  10.   
  11. import ch.qos.logback.core.joran.spi.JoranException; //用于定义JoranException   
  12.   
  13. import ch.qos.logback.core.util.StatusPrinter; //用于打印logback的内部状态   
  14.   
  15. publicclass MyApp1 {   
  16.   
  17. finalstatic Logger logger = LoggerFactory.getLogger(MyApp1.class);    //定义一个全局的记录器，通过LoggerFactory获取   
  18.   
  19. publicstaticvoid main(String[] args) {   
  20.   
  21.     //通过getILoggerFactory()方法得到logger上下文件环境，logback默认获得当前应用的logger context   
  22.   
  23. LoggerContext context = (LoggerContext) LoggerFactory.getILoggerFactory();    //得到当前应用中logger上下文   
  24.   
  25. try {   
  26.   
  27. JoranConfigurator configurator = new JoranConfigurator();    //定义一个(JoranConfigurator)配置器   
  28.   
  29. configurator.setContext(context);    //将当前应用的logger context的关联到到configurator对象   
  30.   
  31. context.reset();                        //清除以前的配置器中的所有内容   
  32.   
  33. //configurator.doConfigure(args[0]);    //接收从命令行传入的参数，加载配置文件，并设置到配置器   
  34.   
  35. configurator.doConfigure("src/com/ttpod/file/MyApp1Config.xml");   
  36.   
  37. //配置文件的路径：src/com/ttpod/file/MyApp1Config.xml   
  38.   
  39. } catch (JoranException je) {   
  40.   
  41. logger.error("JoranException occur at:"+je.getMessage());    //将此处异常也记录到日志   
  42.   
  43. je.printStackTrace();    //在控制打印出异常跟踪信息   
  44.   
  45. }   
  46.   
  47. //打印出logger context中的error和供气ing,在此处作用相当于catch中的je.printStackTrace（）;   
  48.   
  49. StatusPrinter.printInCaseOfErrorsOrWarnings(context);       
  50.   
  51. //流程进入有日志生成的类中   
  52.   
  53. logger.info("Entering application.demo class Foo >>>");       
  54.   
  55. Foo foo = new Foo();   
  56.   
  57. foo.doIt();    //执行foo中的一个生成了日志的方法，输出日志   
  58.   
  59. logger.info("Exiting application. demo class Foo <<<");   
  60.   
  61. }   
  62.   
  63. }  
package com.ttpod.file;

import org.slf4j.Logger;                //用于声明Logger

import org.slf4j.LoggerFactory;     //用于获取Logger以及LoggerContext

import ch.qos.logback.classic.LoggerContext;         //用于声明LoggerContext

import ch.qos.logback.classic.joran.JoranConfigurator;//用于定义Logback的配置机制

import ch.qos.logback.core.joran.spi.JoranException; //用于定义JoranException

import ch.qos.logback.core.util.StatusPrinter; //用于打印logback的内部状态

publicclass MyApp1 {

finalstatic Logger logger = LoggerFactory.getLogger(MyApp1.class);    //定义一个全局的记录器，通过LoggerFactory获取

publicstaticvoid main(String[] args) {

    //通过getILoggerFactory()方法得到logger上下文件环境，logback默认获得当前应用的logger context

LoggerContext context = (LoggerContext) LoggerFactory.getILoggerFactory();    //得到当前应用中logger上下文

try {

JoranConfigurator configurator = new JoranConfigurator();    //定义一个(JoranConfigurator)配置器

configurator.setContext(context);    //将当前应用的logger context的关联到到configurator对象

context.reset();                        //清除以前的配置器中的所有内容

//configurator.doConfigure(args[0]);    //接收从命令行传入的参数，加载配置文件，并设置到配置器

configurator.doConfigure("src/com/ttpod/file/MyApp1Config.xml");

//配置文件的路径：src/com/ttpod/file/MyApp1Config.xml

} catch (JoranException je) {

logger.error("JoranException occur at:"+je.getMessage());    //将此处异常也记录到日志

je.printStackTrace();    //在控制打印出异常跟踪信息

}

//打印出logger context中的error和供气ing,在此处作用相当于catch中的je.printStackTrace（）;

StatusPrinter.printInCaseOfErrorsOrWarnings(context);    

//流程进入有日志生成的类中

logger.info("Entering application.demo class Foo >>>");    

Foo foo = new Foo();

foo.doIt();    //执行foo中的一个生成了日志的方法，输出日志

logger.info("Exiting application. demo class Foo <<<");

}

}

 

其它类Foo类，代码如下：

(com/ttpod/file/ Foo.java)

Java代码 复制代码  收藏代码
  1. package com.ttpod.file;   
  2.   
  3. import org.slf4j.Logger;   
  4.   
  5. import org.slf4j.LoggerFactory;   
  6.   
  7. publicclass Foo {   
  8.   
  9. staticfinal Logger logger = LoggerFactory.getLogger(Foo.class);   
  10.   
  11. publicvoid doIt() {   
  12.   
  13. logger.debug("test logger in other class!");   
  14.   
  15. }   
  16.   
  17. publicvoid createLoggingRequest() {   
  18.   
  19.      subMethodToCreateRequest();   
  20.   
  21.      }   
  22.   
  23.      //这个方法执行后创建一条异常信息   
  24.   
  25. privatevoid subMethodToCreateRequest() {   
  26.   
  27. logger.error("error-level request", new Exception("test exception"));   
  28.   
  29. }   
  30.   
  31. }  
package com.ttpod.file;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

publicclass Foo {

staticfinal Logger logger = LoggerFactory.getLogger(Foo.class);

publicvoid doIt() {

logger.debug("test logger in other class!");

}

publicvoid createLoggingRequest() {

     subMethodToCreateRequest();

     }

     //这个方法执行后创建一条异常信息

privatevoid subMethodToCreateRequest() {

logger.error("error-level request", new Exception("test exception"));

}

}

 

此程序通过参数传配置文件的名字，对程序的日志输出配置，本例如下：

(com/ttpod/file/ MyApp1Config.xml)

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3. <!-- 指定属性文件路径 -->  
  4.   
  5. <propertyfilepropertyfile="src/com/ttpod/file/variables.properties"/>  
  6.   
  7.   
  8.   
  9. <!-- 指定日志输出到文件-->  
  10.   
  11. <appendernameappendername="FILE"class="ch.qos.logback.core.FileAppender">  
  12.   
  13. <file>${destination}</file>  
  14.   
  15. <encoder>  
  16.   
  17. <!-- %msg表示日志信息，%n表示换行 -->  
  18.   
  19. <pattern>%msg%n</pattern>  
  20.   
  21. </encoder>  
  22.   
  23. </appender>  
  24.   
  25.   
  26.   
  27. <rootlevelrootlevel="debug">  
  28.   
  29. <appender-refrefappender-refref="FILE"/><!—添加到根logger-->  
  30.   
  31. </root>  
  32.   
  33. </configuration>  

 

对应的properties文件，嵌套的设置了日志文件的输出路径及文件名，如下：

(com/ttpod/file/ variables.properties)

Xml代码 复制代码  收藏代码
  1. #指定USER_HOME目录   
  2.   
  3. USER_HOME=./log   
  4.   
  5.   
  6.   
  7. #指定日志文件名   
  8.   
  9. fileName=myApp.log   
  10.   
  11.   
  12.   
  13. #生成日志文件的目的地   
  14.   
  15. destination=${USER_HOME}/${fileName}  
 
配置好后，右键MyApp3 -> run as… -> run configurations -> 选择MyApp3,及arguments ->

配置program Aguments：src/com/ttpod/MyApp1Config.xml,以指定配置文件，然后运行即可，即可在当前就应用的/log文件夹下生成myApp.log ,输出如下：

Entering application.demo class Foo >>>

test logger in other class!

Exiting application. demo class Foo <<<



运用滚动策略与触发策略
RollingFileAppender 继承 FileAppender，能够滚动记录文件。例如，RollingFileAppender能先记录到文件"log.txt"，然后当符合某个条件时，变成记录到其他文件。 RollingFileAppender 有两个与之互动的重要子组件。第一个是RollingPolicy，负责滚动。第二个是 TriggeringPolicy，决定是否以及何时进行滚动。所以，RollingPolicy 负责"什么"， TriggeringPolicy 负责"何时"。

要想 RollingFileAppender 起作用，必须同时设置 RollingPolicy 和 TriggeringPolicy。不过，如果 RollingPolicy 也实现了 TriggeringPolicy 接口，那么只需要设置 RollingPolicy。

示例2

如下测试程序应用滚动与触发策略，来处理日志文件。

（ com/ttpod/file/MyApp2.java）

Java代码 复制代码  收藏代码
  1. package com.ttpod.file;   
  2.   
  3. import java.util.Date;   
  4.   
  5. publicclass MyApp2 {   
  6.   
  7.     static Timer t;   
  8.   
  9.     publicstaticvoid main(String[] args) {   
  10.   
  11.         // 调用LoggerFactory 类的静态方法getLogger取得一个Logger实例,   
  12.   
  13.         final Logger logOut = LoggerFactory.getLogger("SystemOut"); // 定义一个名为SystemOut的logger   
  14.   
  15.         final Logger logErr = LoggerFactory.getLogger("SystemErr"); // 定义一个名为SystemErr的logger   
  16.   
  17.         LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();   
  18.   
  19.         try {   
  20.   
  21.             JoranConfigurator configurator = new JoranConfigurator();   
  22.   
  23.             configurator.setContext(lc);   
  24.   
  25.             lc.reset();   
  26.   
  27.             //configurator.doConfigure(args[0]);   
  28.   
  29.             configurator.doConfigure("src/com/ttpod/file/logback.xml");   
  30.   
  31.         } catch (JoranException je) {   
  32.   
  33.             je.printStackTrace();   
  34.   
  35.         }   
  36.   
  37.         // 打印logback的内部状态   
  38.   
  39.         StatusPrinter.print(lc);    //固定部分   
  40.   
  41.         t = new Timer(); // 定义一个定时器   
  42.   
  43.         TimerTask tt = new TimerTask() { // 用定义器执行计划(schedule)，并定义一个继承了TimerTask的匿名内部类   
  44.   
  45.             @Override  
  46.   
  47.             publicvoid run() {   
  48.   
  49.                 for (int i = 100; i > 0; i--) {   
  50.   
  51.                     // Timer t=null;   
  52.   
  53.                     MyApp2.t.cancel();   
  54.   
  55.                     logOut.info("测试Logback日志的使用"); // 定义了一个info级别的日志消息   
  56.   
  57.                     logErr.error("发生错误"); // 定义了一个error级别的日志消息   
  58.   
  59.                 }   
  60.   
  61.                 System.out.println("~~~~~~~~~~~~~ ");   
  62.   
  63.             }   
  64.   
  65.         };   
  66.   
  67.         t.schedule(tt, new Date(), 50); // 从当前系统时间开始，每50毫秒执行一次计划   
  68.   
  69.     }   
  70.   
  71. }  
package com.ttpod.file;

import java.util.Date;

publicclass MyApp2 {

    static Timer t;

    publicstaticvoid main(String[] args) {

        // 调用LoggerFactory 类的静态方法getLogger取得一个Logger实例,

        final Logger logOut = LoggerFactory.getLogger("SystemOut"); // 定义一个名为SystemOut的logger

        final Logger logErr = LoggerFactory.getLogger("SystemErr"); // 定义一个名为SystemErr的logger

        LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();

        try {

            JoranConfigurator configurator = new JoranConfigurator();

            configurator.setContext(lc);

            lc.reset();

            //configurator.doConfigure(args[0]);

            configurator.doConfigure("src/com/ttpod/file/logback.xml");

        } catch (JoranException je) {

            je.printStackTrace();

        }

        // 打印logback的内部状态

        StatusPrinter.print(lc);    //固定部分

        t = new Timer(); // 定义一个定时器

        TimerTask tt = new TimerTask() { // 用定义器执行计划(schedule)，并定义一个继承了TimerTask的匿名内部类

            @Override

            publicvoid run() {

                for (int i = 100; i > 0; i--) {

                    // Timer t=null;

                    MyApp2.t.cancel();

                    logOut.info("测试Logback日志的使用"); // 定义了一个info级别的日志消息

                    logErr.error("发生错误"); // 定义了一个error级别的日志消息

                }

                System.out.println("~~~~~~~~~~~~~ ");

            }

        };

        t.schedule(tt, new Date(), 50); // 从当前系统时间开始，每50毫秒执行一次计划

    }

}
 

// 没有自定义它的logback所需的配置文件，程序启动时会自动加载classpath目录下的查找

// logback-test.xml；如果没找到则logback-test.xml,则继续在classpath下查找lobback.xml。

此测试类，在定时器中定义了一个执行计划，按照执行计划生成日志文件。在file包中添加相的logback配置文件，如下：

( com/ttpod/file/logback.xml)

Xml代码 复制代码  收藏代码
  1. <?xmlversionxmlversion="1.0"encoding="UTF-8"?>  
  2.   
  3. <!DOCTYPE configuration>  
  4.   
  5. <configuration>  
  6.   
  7. <jmxConfigurator />  
  8.   
  9. <!-- 配置文件路径 -->  
  10.   
  11. <propertyfilepropertyfile="src/com/ttpod/file/variables.properties"/>  
  12.   
  13. <!--logback的版本必须是0.9.21以上才支持-->  
  14.   
  15. <timestampkeytimestampkey="byDay"datePattern="yyyyMMdd"/>  
  16.   
  17. <!-- 控制台输出日志 -->  
  18.   
  19. <appendernameappendername="STDOUT"class="ch.qos.logback.core.ConsoleAppender">  
  20.   
  21. <layoutclasslayoutclass="ch.qos.logback.classic.PatternLayout">  
  22.   
  23. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>  
  24.   
  25. </layout>  
  26.   
  27. </appender>  
  28.   
  29. <!-- 文件输出日志 (文件大小策略进行文件输出，超过指定大小对文件压缩(.zip)备份)-->  
  30.   
  31. <appendernameappendername="FILE"class="ch.qos.logback.core.rolling.RollingFileAppender">  
  32.   
  33.     <!-- 文件的路径及文件名 -->  
  34.   
  35. <File>${USER_HOME}/SystemOut.log</File>  
  36.   
  37. <!-- 定义窗口滚动策略 -->  
  38.   
  39. <rollingPolicyclassrollingPolicyclass="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">  
  40.   
  41.     <!-- 每触发一次，自动压缩日志文件，%i在1-3之间循环变化 -->  
  42.   
  43. <FileNamePattern>${USER_HOME}/SystemOut_%i.log.zip</FileNamePattern>  
  44.   
  45. <MinIndex>1</MinIndex><!-- %i的最小值为1-->  
  46.   
  47. <MaxIndex>3</MaxIndex><!-- %i的最大值为3-->  
  48.   
  49. </rollingPolicy>  
  50.   
  51. <!-- 触发策略，通常rollingPolicy与triggeringPolicy联合使用 -->  
  52.   
  53. <triggeringPolicy  
  54.   
  55. class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">  
  56.   
  57. <MaxFileSize>10KB</MaxFileSize>  
  58.   
  59. </triggeringPolicy>  
  60.   
  61. <!-- 格式化输出 -->  
  62.   
  63. <!-- %d表示日期,格式为：yyyy-MM-dd HH:mm:ss.SSS ;%thread：线程名;   
  64.   
  65.     %-5level:从左边以5个字符的宽度显示级别; %logger:显示logger名;%msg:日志消息;%n:换行   
  66.   
  67. <layout class="ch.qos.logback.classic.PatternLayout">  
  68.   
  69. <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</Pattern>  
  70.   
  71. </layout>  
  72.   
  73. -->  
  74.   
  75. <!-- 或者用下面的形式格式(推荐)-->  
  76.   
  77. <encoder>  
  78.   
  79.         <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS}%relative%thread%mdc%level%logger%msg</pattern>  
  80.   
  81.         </encoder>  
  82.   
  83. <!-- 以html文件输出 -->  
  84.   
  85. <!--   
  86.   
  87. <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">  
  88.   
  89.     <layout class="ch.qos.logback.classic.html.HTMLLayout">  
  90.   
  91.             <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS}%relative%thread%mdc%level%logger%msg</pattern>  
  92.   
  93.         </layout>  
  94.   
  95.         </encoder>  
  96.   
  97. -->  
  98.   
  99. </appender>  
  100.   
  101. <!-- 输出ERROR级别的日志到文件(同样采用文件大小策略进行文件输出，超过指定大小对文件压缩(.zip)备份) -->  
  102.   
  103. <appendernameappendername="FILE-ERROR"class="ch.qos.logback.core.rolling.RollingFileAppender">  
  104.   
  105. <filterclassfilterclass="ch.qos.logback.classic.filter.LevelFilter">  
  106.   
  107. <level>ERROR</level><!-- 指定要对级别为ERROR日志信息过滤 -->  
  108.   
  109. <OnMismatch>DENY</OnMismatch>     <!-- 如果不匹配，则拒绝处理 -->  
  110.   
  111. <OnMatch>ACCEPT</OnMatch>         <!-- 如果匹配，则立即处理 -->  
  112.   
  113. </filter>  
  114.   
  115. <File>${USER_HOME}/SystemErr.log</File><!-- 文件名即路径 -->  
  116.   
  117. <rollingPolicyclassrollingPolicyclass="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">  
  118.   
  119. <FileNamePattern>${USER_HOME}/SystemErr_%i.log.zip</FileNamePattern>  
  120.   
  121. <MinIndex>1</MinIndex>  
  122.   
  123. <MaxIndex>3</MaxIndex>  
  124.   
  125. </rollingPolicy>  
  126.   
  127. <triggeringPolicyclasstriggeringPolicyclass="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">  
  128.   
  129. <MaxFileSize>10KB</MaxFileSize>  
  130.   
  131. </triggeringPolicy>  
  132.   
  133. <!-- 格式化输出 -->  
  134.   
  135. <!--   
  136.   
  137. <layout class="ch.qos.logback.classic.PatternLayout">  
  138.   
  139. <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</Pattern>  
  140.   
  141. </layout>  
  142.   
  143. -->  
  144.   
  145. <encoder>  
  146.   
  147.         <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS}%relative%thread%mdc%level%logger%msg</pattern>  
  148.   
  149.         </encoder>  
  150.   
  151. </appender>  
  152.   
  153. <!--这里指定logger name 是为jmx设置日志级别做铺垫 -->  
  154.   
  155. <!-- 分别将STDOUT与FILE appender都添加到自定义的logger中，否则将不会输出到appender指定的目的地-->  
  156.   
  157. <loggernameloggername="SystemOut"level="INFO">  
  158.   
  159. <appender-refrefappender-refref="STDOUT"/>  
  160.   
  161. <appender-refrefappender-refref="FILE"/>  
  162.   
  163. </logger>  
  164.   
  165. <loggernameloggername="SystemErr"level="INFO">  
  166.   
  167. <appender-refrefappender-refref="STDOUT"/>  
  168.   
  169. <appender-refrefappender-refref="FILE-ERROR"/>  
  170.   
  171. </logger>  
  172.   
  173. </configuration>  
 

执行以上程序，在控制台也会不断的输出以下日志信息：

Xml代码 复制代码  收藏代码
  1. 14:42:34.875 [Timer-0] INFO SystemOut - 测试Logback日志的使用   
  2.   
  3. 14:42:34.875 [Timer-0] ERROR SystemErr - 发生错误   
  4.   
  5. 14:42:34.937 [Timer-0] INFO SystemOut - 测试Logback日志的使用   
  6.   
  7. 14:42:34.937 [Timer-0] ERROR SystemErr - 发生错误   
  8.   
  9. 14:42:35.000 [Timer-0] INFO SystemOut - 测试Logback日志的使用   
  10.   
  11. 14:42:35.000 [Timer-0] ERROR SystemErr - 发生错误   
  12.   
  13. 14:42:35.062 [Timer-0] INFO SystemOut - 测试Logback日志的使用   
  14.   
  15. 14:42:35.062 [Timer-0] ERROR SystemErr - 发生错误  
 
生成的日志文件如下图：




FixedWindowRollingPolicy当发生滚动时，FixedWindowRollingPolicy 根据如下固定窗口（window）算法重命名文件。选项"fileNamePattern"代表归档（滚动）记录文件的文件名模式。该选项是必需的，且必需在模式的某处包含标志"%i"。如示例3中的MyApp3-RollingFixedWindow.xml 。

TimeBasedRollingPolicy或许是最受流行的滚动策略。它根据时间来制定滚动策略，例如根据日或月。TimeBasedRollingPolicy 既负责滚动也负责触发滚动。实际上，TimeBasedRollingPolicy 同时实现了 RollingPolicy 接口和 TriggeringPolicy 接口。和 FixedWindowRollingPolicy一样，TimeBasedRollingPolicy 也支持自动压缩文件。如果"fileNamePattern"选项以".gz"或".zip"结尾，就表示需要压缩。如示例3中的MyApp3-RollingTimeBased.xml 。

SizeAndTimeBasedFNATP按照日期进行归档的同时限制每个记录文件的大小，特别是当后处理工具对记录文件大小有限制时。Logback 为此提供了 SizeAndTimeBasedFNATP ，它是TimeBasedRollingPolicy 的子组件，FNATP 代表"FNATP stands for File Naming And Triggering Policy"。下面的例子MyApp3-sizeAndTime.xml演示了基于大小和时间的记录文件归档。



示例3

( com/ttpod/file/MyApp3.java)

Java代码 复制代码  收藏代码
  1. package com.ttpod.file;   
  2.   
  3.   
  4.   
  5. import org.slf4j.Logger;   
  6.   
  7. import org.slf4j.LoggerFactory;   
  8.   
  9. import org.slf4j.MDC;   
  10.   
  11.   
  12.   
  13. import ch.qos.logback.classic.LoggerContext;   
  14.   
  15. import ch.qos.logback.classic.joran.JoranConfigurator;   
  16.   
  17. import ch.qos.logback.core.joran.spi.JoranException;   
  18.   
  19. import ch.qos.logback.core.util.StatusPrinter;   
  20.   
  21. import com.ttpod.file.Foo;;   
  22.   
  23.   
  24.   
  25. publicclass MyApp3 {   
  26.   
  27. publicstaticvoid main(String[] args) throws InterruptedException {   
  28.   
  29. Logger logger = (Logger) LoggerFactory.getLogger(MyApp3.class);   
  30.   
  31. LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();   
  32.   
  33. try {   
  34.   
  35. JoranConfigurator configurator = new JoranConfigurator();   
  36.   
  37. configurator.setContext(lc);   
  38.   
  39. lc.reset();   
  40.   
  41. configurator.doConfigure(args[0]);   
  42.   
  43. } catch (JoranException je) {   
  44.   
  45. je.printStackTrace();   
  46.   
  47. }    //固定部分   
  48.   
  49.   
  50.   
  51. //打印logback的内部状态   
  52.   
  53. StatusPrinter.print(lc);   
  54.   
  55. logger.debug("**Hello {}", new Foo());   
  56.   
  57. //客户端的每个记录请求添加唯一戳（uniquely stamp）,运用MDC(Mapped Diagnostic Context)   
  58.   
  59. //在分布式应用程序中，可以区分并处理不同客户端的记录输出，而不增加logger的开销   
  60.   
  61. MDC.put("testKey", "testValueFromMDC");        //在appender中用%X{testKey}，可以输出MDC中test对应的值   
  62.   
  63. MDC.put("testKey2", "value2");   
  64.   
  65. for (int i = 0; i < 10; i++) {   
  66.   
  67. logger.debug("logging statement " + i);   
  68.   
  69. Thread.sleep(100);   
  70.   
  71. }   
  72.   
  73. Foo foo = new Foo();   
  74.   
  75. foo.createLoggingRequest();   
  76.   
  77. }   
  78.   
  79. }  
package com.ttpod.file;



import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.slf4j.MDC;



import ch.qos.logback.classic.LoggerContext;

import ch.qos.logback.classic.joran.JoranConfigurator;

import ch.qos.logback.core.joran.spi.JoranException;

import ch.qos.logback.core.util.StatusPrinter;

import com.ttpod.file.Foo;;



publicclass MyApp3 {

publicstaticvoid main(String[] args) throws InterruptedException {

Logger logger = (Logger) LoggerFactory.getLogger(MyApp3.class);

LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();

try {

JoranConfigurator configurator = new JoranConfigurator();

configurator.setContext(lc);

lc.reset();

configurator.doConfigure(args[0]);

} catch (JoranException je) {

je.printStackTrace();

}    //固定部分



//打印logback的内部状态

StatusPrinter.print(lc);

logger.debug("**Hello {}", new Foo());

//客户端的每个记录请求添加唯一戳（uniquely stamp）,运用MDC(Mapped Diagnostic Context)

//在分布式应用程序中，可以区分并处理不同客户端的记录输出，而不增加logger的开销

MDC.put("testKey", "testValueFromMDC");        //在appender中用%X{testKey}，可以输出MDC中test对应的值

MDC.put("testKey2", "value2");

for (int i = 0; i < 10; i++) {

logger.debug("logging statement " + i);

Thread.sleep(100);

}

Foo foo = new Foo();

foo.createLoggingRequest();

}

}
 

配置文件：

( com/ttpod/file/MyApp3-RollingFixedWindow.xml)

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3. <!-- 指定属性文件路径 -->  
  4.   
  5. <propertyfilepropertyfile="src/com/ttpod/file/variables.properties"/>  
  6.   
  7. <appendernameappendername="FILE"class="ch.qos.logback.core.rolling.RollingFileAppender">  
  8.   
  9. <file>${USER_HOME}/testFile.log</file>  
  10.   
  11. <!--滚动策略-->  
  12.   
  13. <rollingPolicyclassrollingPolicyclass="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">  
  14.   
  15. <!—自动压缩备份-->  
  16.   
  17. <fileNamePattern>${USER_HOME}/testFile.%i.log.zip</fileNamePattern>  
  18.   
  19. <minIndex>1</minIndex>  
  20.   
  21. <maxIndex>3</maxIndex><!--%i在1-3之间循环变化-->  
  22.   
  23. </rollingPolicy>  
  24.   
  25. <!—触发策略-->  
  26.   
  27. <triggeringPolicyclasstriggeringPolicyclass="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">  
  28.   
  29. <!--日志文件大小限制在5kB以内，否则就触发滚动-->  
  30.   
  31. <maxFileSize>5kB</maxFileSize>  
  32.   
  33. </triggeringPolicy>  
  34.   
  35. <encoder><!--格式化输出-->  
  36.   
  37. <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>  
  38.   
  39. </encoder>  
  40.   
  41. </appender>  
  42.   
  43. <rootlevelrootlevel="DEBUG">  
  44.   
  45. <appender-refrefappender-refref="FILE"/>  
  46.   
  47. </root>  
  48.   
  49. </configuration>  
 

多次运行MyApp3,logback配置参数传入MyApp3-RollingFixedWindow.xml，即可发现在当前应用的log目录下生成了如：testFile.1.log.zip、testFile.2.log.zip、testFile.3.log.zip，testFile.log文件。备份的压缩文件中的日志文件的文件名默认后缀跟了归档日期，如下图：




( com/ttpod/file/MyApp3-RollingTimeBased.xml)

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3. <!-- 指定属性文件路径 -->  
  4.   
  5. <propertyfilepropertyfile="src/com/ttpod/file/variables.properties"/>  
  6.   
  7.   
  8.   
  9. <!-- 基于时间的滚动策略 -->  
  10.   
  11. <appendernameappendername="FILE"class="ch.qos.logback.core.rolling.RollingFileAppender">  
  12.   
  13. <file>${USER_HOME}/logFile.log</file>  
  14.   
  15. <rollingPolicyclassrollingPolicyclass="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">  
  16.   
  17. <!-- 每天滚动   
  18.   
  19. <fileNamePattern>logFile.%d{yyyy-MM-dd}.log</fileNamePattern>  
  20.   
  21. -->  
  22.   
  23.   
  24.   
  25. <!-- 每分钟滚动 -->  
  26.   
  27. <fileNamePattern>${USER_HOME}/logFile.%d{yyyy-MM-dd_HH-mm}.log</fileNamePattern>  
  28.   
  29.   
  30.   
  31. <!-- 限制文件最大保存时间为30天-->  
  32.   
  33. <maxHistory>30</maxHistory>  
  34.   
  35. </rollingPolicy>  
  36.   
  37.   
  38.   
  39. <encoder>  
  40.   
  41. <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>  
  42.   
  43. </encoder>  
  44.   
  45. </appender>  
  46.   
  47.   
  48.   
  49. <rootlevelrootlevel="DEBUG">  
  50.   
  51. <appender-refrefappender-refref="FILE"/>  
  52.   
  53. </root>  
  54.   
  55. </configuration>  
 

<!--

运行：

java chapters.appenders.ConfigurationTester

src/com/ttpod/chapters/appenders/conf/logback-RollingTimeBased.xml

-->

多次运行MyApp3,logback配置参数传入MyApp3-RollingTimeBased.xml，若设置一个执行计谋，程序不停止，则每分钟可触发一次日志备份，即可发现在当前应用的log目录下生成了按配置的格式的文件，如：




( com/ttpod/file/MyApp3-sizeAndTime.xml)

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3. <!-- 基于时间与大小的归档 -->  
  4.   
  5. <statusListenerclassstatusListenerclass="ch.qos.logback.core.status.OnConsoleStatusListener"/>  
  6.   
  7.   
  8.   
  9. <!-- 指定属性文件路径 -->  
  10.   
  11. <propertyfilepropertyfile="src/com/ttpod/file/variables.properties"/>  
  12.   
  13.   
  14.   
  15. <!-- 基于时间与大小的归档 -->  
  16.   
  17. <appendernameappendername="ROLLING"class="ch.qos.logback.core.rolling.RollingFileAppender">  
  18.   
  19. <file>${USER_HOME}/mylog.txt</file>  
  20.   
  21. <rollingPolicyclassrollingPolicyclass="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">  
  22.   
  23. <!-- 每天滚动   
  24.   
  25. <fileNamePattern>${USER_HOME}/mylog-%d{yyyy-MM-dd}.%i.txt</fileNamePattern>  
  26.   
  27. -->  
  28.   
  29. <minIndex>1</minIndex>  
  30.   
  31. <maxIndex>3</maxIndex>  
  32.   
  33. <!-- 每分钟滚动 -->  
  34.   
  35. <fileNamePattern>${USER_HOME}/mylog-%d{yyyy-MM-dd_HH-mm}.%i.txt</fileNamePattern>  
  36.   
  37.   
  38.   
  39. <!-- 限制文件最大保存时间为30天-->  
  40.   
  41. <maxHistory>30</maxHistory>  
  42.   
  43. <timeBasedFileNamingAndTriggeringPolicyclasstimeBasedFileNamingAndTriggeringPolicyclass="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">  
  44.   
  45. <!-- 当文件大小超过5kB时触发滚动,这里设置5kb只是便于测试 -->  
  46.   
  47. <maxFileSize>5kB</maxFileSize>  
  48.   
  49. </timeBasedFileNamingAndTriggeringPolicy>  
  50.   
  51. </rollingPolicy>  
  52.   
  53. <encoder>  
  54.   
  55. <pattern>%msg%n</pattern>  
  56.   
  57. </encoder>  
  58.   
  59. </appender>  
  60.   
  61.   
  62.   
  63. <rootlevelrootlevel="debug">  
  64.   
  65. <appender-refrefappender-refref="ROLLING"/>  
  66.   
  67. </root>  
  68.   
  69. </configuration>  
 

运行时，logback配置参数传入src/com/ttpod/file/MyApp3-sizeAndTime.xml即可。当日志文件超过5kB时，或到另一天时，程序又被执行了，则会触发滚动，按照此前配置规则备原来的文件。输出的文件如下图所示：




以网页形式输出日志文件

HTMLLayout 与 logback-classic 里的 HTMLLayout 相似。默认情况下，PatternLayout 创建包含下列数据的表格：远程IP；日期；请求的URL；状态吗；Content Length 。

    以下有个示例，演示以HTMLLayout格式化后，以htm文件输出日志。如下：

示例4：

( com/ttpod/html/HTMLTest1.java)

Java代码 复制代码  收藏代码
  1. package com.ttpod.html;   
  2.   
  3.   
  4.   
  5. import org.slf4j.Logger;   
  6.   
  7. import org.slf4j.LoggerFactory;   
  8.   
  9.   
  10.   
  11. import ch.qos.logback.classic.LoggerContext;   
  12.   
  13. import ch.qos.logback.classic.joran.JoranConfigurator;   
  14.   
  15. import ch.qos.logback.core.joran.spi.JoranException;   
  16.   
  17. import ch.qos.logback.core.util.StatusPrinter;   
  18.   
  19.   
  20.   
  21. publicclass HtmlTest1 {   
  22.   
  23. publicstaticvoid main(String[] args) throws InterruptedException {   
  24.   
  25. Logger logger = LoggerFactory.getLogger(HtmlTest1.class);   
  26.   
  27. LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();   
  28.   
  29.   
  30.   
  31. try {   
  32.   
  33. JoranConfigurator configurator = new JoranConfigurator();   
  34.   
  35. configurator.setContext(lc);   
  36.   
  37. lc.reset();   
  38.   
  39. configurator.doConfigure(args[0]);   
  40.   
  41. //configurator.doConfigure("./src/com/ttpod/html/htmlLayoutConfig1.xml");   
  42.   
  43. } catch (JoranException je) {   
  44.   
  45.     je.printStackTrace();    //固定部分   
  46.   
  47. }   
  48.   
  49. StatusPrinter.printInCaseOfErrorsOrWarnings(lc);   
  50.   
  51. for (int i = 0; i < 6; i++) {   
  52.   
  53. if (i % 5 == 0) {   
  54.   
  55. logger.warn("a warning message " + i);    //声明一条warn级别的日志消息   
  56.   
  57.      //logger.info("a warning message " + i);   
  58.   
  59. } else {   
  60.   
  61. logger.debug("hello world number" + i);   
  62.   
  63. }   
  64.   
  65. }   
  66.   
  67. logger.error("Finish off with fireworks", new Exception("Just testing"));   
  68.   
  69. }   
  70.   
  71. }  
package com.ttpod.html;



import org.slf4j.Logger;

import org.slf4j.LoggerFactory;



import ch.qos.logback.classic.LoggerContext;

import ch.qos.logback.classic.joran.JoranConfigurator;

import ch.qos.logback.core.joran.spi.JoranException;

import ch.qos.logback.core.util.StatusPrinter;



publicclass HtmlTest1 {

publicstaticvoid main(String[] args) throws InterruptedException {

Logger logger = LoggerFactory.getLogger(HtmlTest1.class);

LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();



try {

JoranConfigurator configurator = new JoranConfigurator();

configurator.setContext(lc);

lc.reset();

configurator.doConfigure(args[0]);

//configurator.doConfigure("./src/com/ttpod/html/htmlLayoutConfig1.xml");

} catch (JoranException je) {

    je.printStackTrace();    //固定部分

}

StatusPrinter.printInCaseOfErrorsOrWarnings(lc);

for (int i = 0; i < 6; i++) {

if (i % 5 == 0) {

logger.warn("a warning message " + i);    //声明一条warn级别的日志消息

     //logger.info("a warning message " + i);

} else {

logger.debug("hello world number" + i);

}

}

logger.error("Finish off with fireworks", new Exception("Just testing"));

}

}
 



用以下配置文件格式化输出到properties文件指向的目的地。

( com/ttpod/html/htmlLayoutConfig1.xml)

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3. <!-- 指定属性文件路径 -->  
  4.   
  5. <propertyfilepropertyfile="src/com/ttpod/html/variables.properties"/>  
  6.   
  7.   
  8.   
  9. <!-- 指定日志输出到文件-->  
  10.   
  11. <appendernameappendername="FILE"class="ch.qos.logback.core.FileAppender">  
  12.   
  13. <encoderclassencoderclass="ch.qos.logback.core.encoder.LayoutWrappingEncoder">  
  14.   
  15. <layoutclasslayoutclass="ch.qos.logback.classic.html.HTMLLayout">  
  16.   
  17. <pattern>%relative%thread%mdc%level%logger%msg</pattern>  
  18.   
  19. </layout>  
  20.   
  21. </encoder>  
  22.   
  23. <file>${destination}</file>  
  24.   
  25. </appender>  
  26.   
  27.   
  28.   
  29. <rootlevelrootlevel="DEBUG">  
  30.   
  31. <appender-refrefappender-refref="FILE"/>  
  32.   
  33. </root>  
  34.   
  35. </configuration>  
 
<!-- 以以下方式运行

java com.ttpod.html.HtmlTest1 src/com/ttpod/html/htmlLayoutConfig1.xml

-->

属性文件内容如下：

( com/ttpod/html/ variables.properties)

Xml代码 复制代码  收藏代码
  1. #指定USER_HOME目录   
  2.   
  3. USER_HOME=./log   
  4.   
  5.   
  6.   
  7. #指定日志文件名   
  8.   
  9. fileName=htmlTest.htm   
  10.   
  11.   
  12.   
  13. #生成日志文件的目的地   
  14.   
  15. destination=${USER_HOME}/${fileName}  
 

运行html/HTMLTest1，并传入配置参数：src/com/ttpod/html/htmlLayoutConfig1.xml,可以发现在在当前应用的/log目录下生成一个htmlTest.htm日志文件。输出日志结果如下图：




以邮件形式输出日志

    以邮件形式输出日志，依赖于SMTPAppender ，SMTPAppender在固定大小的缓冲里积累记录时间，当用户指定的事件发生后，就通过email发出这些事件。默认情况下，email发送是由级别为 ERROR 或更高级别的记录事件触发的。

    下面的演示程序 chapters.appenders.mail.EMail，生成大量记录消息，然后生成一个错误消息。该程序有两个参数，第一个是需要生成的记录消息的数量，第二个是 logback 配置文件。该程序生成的最后一条记录事件，即 ERROR 级别的事件，将触发 email的发送。

示例5

( com/ttpod/mail/Email.java)

Java代码 复制代码  收藏代码
  1. package com.ttpod.mail;   
  2.   
  3. import org.slf4j.Logger;   
  4.   
  5. import org.slf4j.LoggerFactory;   
  6.   
  7. import ch.qos.logback.classic.LoggerContext;   
  8.   
  9. import ch.qos.logback.classic.joran.JoranConfigurator;   
  10.   
  11. import ch.qos.logback.core.util.StatusPrinter;   
  12.   
  13. publicclass EMail {   
  14.   
  15. staticpublicvoid main(String[] args) throws Exception {   
  16.   
  17. if (args.length != 2) {   
  18.   
  19. usage("Wrong number of arguments.");   
  20.   
  21. }   
  22.   
  23. int runLength = Integer.parseInt(args[0]);   
  24.   
  25. String configFile = args[1];   
  26.   
  27. //int runLength = Integer.parseInt("300");   
  28.   
  29. //String configFile="src/com/ttpod/mail/gmailSSL.xml";   
  30.   
  31. //String configFile = "src/com/ttpod/mail/gmailSTARTTLS.xml";   
  32.   
  33. //自定义配置文件，得到日志固定格式   
  34.   
  35. LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();   
  36.   
  37. JoranConfigurator configurator = new JoranConfigurator();   
  38.   
  39. lc.reset();   
  40.   
  41. configurator.setContext(lc);   
  42.   
  43. configurator.doConfigure(configFile);   
  44.   
  45. Logger logger = LoggerFactory.getLogger(EMail.class);   
  46.   
  47. for (int i = 1; i <= runLength; i++) {   
  48.   
  49. if ((i % 10) < 9) {   
  50.   
  51. logger.debug("This is a debug message. Message number: " + i);   
  52.   
  53. } else {   
  54.   
  55. logger.warn("This is a warning message. Message number: " + i);   
  56.   
  57. }   
  58.   
  59. }   
  60.   
  61. //定义一条error级别的日志输出   
  62.   
  63. logger.error("At last an error.", new Exception("Just testing"));   
  64.   
  65. //打印logger内部状态   
  66.   
  67. StatusPrinter.printInCaseOfErrorsOrWarnings(lc);   
  68.   
  69. }   
  70.   
  71. staticvoid usage(String msg) {    //当参数传入错误时，提供的处理惯例   
  72.   
  73. System.err.println(msg);   
  74.   
  75. System.err.println("Usage: java " + EMail.class.getName() +   
  76.   
  77. " runLength configFile\n" +   
  78.   
  79. " runLength (integer) the number of logs to generate\n" +   
  80.   
  81. " configFile a logback configuration file in XML format." +   
  82.   
  83. " XML files must have a '.xml' extension.");   
  84.   
  85. System.exit(1);    //退出程序   
  86.   
  87. }   
  88.   
  89. }  
package com.ttpod.mail;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import ch.qos.logback.classic.LoggerContext;

import ch.qos.logback.classic.joran.JoranConfigurator;

import ch.qos.logback.core.util.StatusPrinter;

publicclass EMail {

staticpublicvoid main(String[] args) throws Exception {

if (args.length != 2) {

usage("Wrong number of arguments.");

}

int runLength = Integer.parseInt(args[0]);

String configFile = args[1];

//int runLength = Integer.parseInt("300");

//String configFile="src/com/ttpod/mail/gmailSSL.xml";

//String configFile = "src/com/ttpod/mail/gmailSTARTTLS.xml";

//自定义配置文件，得到日志固定格式

LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();

JoranConfigurator configurator = new JoranConfigurator();

lc.reset();

configurator.setContext(lc);

configurator.doConfigure(configFile);

Logger logger = LoggerFactory.getLogger(EMail.class);

for (int i = 1; i <= runLength; i++) {

if ((i % 10) < 9) {

logger.debug("This is a debug message. Message number: " + i);

} else {

logger.warn("This is a warning message. Message number: " + i);

}

}

//定义一条error级别的日志输出

logger.error("At last an error.", new Exception("Just testing"));

//打印logger内部状态

StatusPrinter.printInCaseOfErrorsOrWarnings(lc);

}

staticvoid usage(String msg) {    //当参数传入错误时，提供的处理惯例

System.err.println(msg);

System.err.println("Usage: java " + EMail.class.getName() +

" runLength configFile\n" +

" runLength (integer) the number of logs to generate\n" +

" configFile a logback configuration file in XML format." +

" XML files must have a '.xml' extension.");

System.exit(1);    //退出程序

}

}
 



如下配置文件从属性文件中读取发送邮件定义的属性，配置由邮件输出日志，如下：

Xml代码 复制代码  收藏代码
  1. <configuration>  
  2.   
  3. <!-- 指定属性文件的位置 -->  
  4.   
  5. <propertyfilepropertyfile="src/com/ttpod/mail/gmailSSL.properties"/>  
  6.   
  7.   
  8.   
  9. <!-- 目的指定向email的appender -->  
  10.   
  11. <appendernameappendername="EMAIL"class="ch.qos.logback.classic.net.SMTPAppender">  
  12.   
  13. <SMTPHost>${SMTPHOST}</SMTPHost><!-- 邮件服务器地址 -->  
  14.   
  15. <SMTPPort>${SMTPPORT}</SMTPPort><!--SMTPPORT端口-->  
  16.   
  17. <SSL>true</SSL>  
  18.   
  19. <Username>${EMAIL_USERNAME}</Username><!-- 用户名 -->  
  20.   
  21. <Password>${EMAIL_PASSWORD}</Password><!-- 密码 -->  
  22.   
  23.   
  24.   
  25. <To>${EMAIL-DESTINATION}</To><!-- 目标接收人 -->  
  26.   
  27. <To>${ANOTHER_EMAIL_DESTINATION}</To><!-- additional destinations are possible -->  
  28.   
  29. <From>${EMAIL_USERNAME}</From><!-- 发件人 -->  
  30.   
  31. <Subject>TESTING: %logger{20} - %m</Subject><!-- 主题 -->  
  32.   
  33. <encoder><!-- 一般采用这种方式格式化输出 -->  
  34.   
  35.     <layoutclasslayoutclass="ch.qos.logback.classic.html.HTMLLayout">  
  36.   
  37.         <!-- 采用什么渲染方式，这采取的是HTML方式 -->  
  38.   
  39.         <Pattern>%date %-5level %logger - %message%n</Pattern>  
  40.   
  41.     </layout>  
  42.   
  43. </encoder>  
  44.   
  45. <!--   
  46.   
  47. <layout class="ch.qos.logback.classic.PatternLayout">  
  48.   
  49. <Pattern>%date %-5level %logger - %message%n</Pattern>  
  50.   
  51. </layout>  
  52.   
  53. -->  
  54.   
  55. </appender>  
  56.   
  57.   
  58.   
  59. <!-- 输出到控制台，以便将日志也打印到控制台-->  
  60.   
  61. <appendernameappendername="STDOUT"class="ch.qos.logback.core.ConsoleAppender">  
  62.   
  63.     <encoder>  
  64.   
  65. <pattern>  
  66.   
  67. %d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n   
  68.   
  69.      </pattern>  
  70.   
  71. </encoder>  
  72.   
  73. </appender>  
  74.   
  75.   
  76.   
  77. <!-- 输出到文件，将日志记录到本地文件-->  
  78.   
  79. <appendernameappendername="FILE"class="ch.qos.logback.core.FileAppender">  
  80.   
  81. <file>./log/mailtest.log</file>  
  82.   
  83. <encoder>  
  84.   
  85. <!-- %msg表示日志信息，%n表示换行 -->  
  86.   
  87. <pattern>%msg%n</pattern>  
  88.   
  89. </encoder>  
  90.   
  91. </appender>  
  92.   
  93.   
  94.   
  95. <rootlevelrootlevel="debug">  
  96.   
  97. <appender-refrefappender-refref="EMAIL"/>  
  98.   
  99. <appender-refrefappender-refref="STDOUT"/>  
  100.   
  101. <appender-refrefappender-refref="FILE"></appender-ref>  
  102.   
  103. </root>  
  104.   
  105. </configuration>  
 

属性文件如下设置，以供自定的logback配置文件读取。

Xml代码 复制代码  收藏代码
  1. SMTPHOST=smtp.gmail.com   
  2.   
  3. SMTPPORT=465  
  4.   
  5. EMAIL_USERNAME = someone123@gmail.com   
  6.   
  7. EMAIL_PASSWORD = password123  
  8.   
  9. EMAIL-DESTINATION = someone456@ttpod.com   
  10.   
  11. ANOTHER_EMAIL_DESTINATION = some456@126.com  
 

传入配置文件参数，运行，当出现也error级别以及以上级别的日志时，就会触发日志发送到邮件，但目前此测试例子，可能由于本地tomcat服务器缓存邮件，以致邮件无法发送到外网服务器，所以在这里没给出具体发送成功的结果。但可以通过它生成对应的HTML文件，可以看到邮件内容，如下图：


    如果未指定选项"Evaluator"，则 SMTPAppender 被默认分配一个 OnErrorEveluator（ch.qos.logback.classic.boolex.OnErrorEvaluator）实例，当遇到级别为 ERROR 或更高级别

的事件后，触发 email 传输。此处最后一条消息是一个error级别的记录，触发了邮件的发送。

另外，还可以将日志写入数据库要把记录事件写入数据库，依赖于DBAppender ，DBAppender把记录事件写入数据库的三张表。三张表分别是 logging_event、logging_event_property 和 logging_event_exception。在使用 DBAppender 之前，这三张表必须已经被创建。关于将日志记录写入到数据库中，更多可参考logback手册中的DBAppender。

 

 

barrier9591
关注
专栏目录
logback学习（一）日志打印格式
小白求学进阶
05-21 1501
官网文档学习：http://logback.qos.ch/manual/layouts.html 往下一拉，来到Conversion Word这个表格，里面就是配置参数的选择了，重点挑几个学习学习 c{length}、lo{length}、logger{length} 在记录事件的起点输出记录器的名称。 这个日志的起点，就是在哪个文件下打印的，会将所属包名和文件名都列出来，加了长度，就会缩写。 如有个mainPackage.sub.sample.Bard的日志名，我将格式写在左手边，结果打印写在右手边 %l
logback核心包
10-29
logback使用过程中必须包含logback-core-1.2.3和slf4j-api-1.7.25包联合才能正常打印日志。
logback-classic Jar
09-15
logback-classic：它是log4j的一个改良版本，同时它完整实现了slf4j API使你可以很方便地更换成其它日志系统如log4j或JDK14 Logging
Logback介绍
yingrenzhe68的专栏
05-18 174
Logback 分为三个模块：Core、Classic 和 Access。Core模块是其他两个模块的基础。 Classic模块扩展了core模块。 Classic模块相当于log4j的显著改进版。Logback-classic 直接实现了 SLF4J API。 要引入logback，由于Logback-classic依赖slf4j-api.jar和logback-core.jar，所以要把...
logback使用学习
dark
06-11 249
引用： https://www.cnblogs.com/warking/p/5710303.html 参考官方使用文档：https://logback.qos.ch/manual/index.html Logback官方网站： http://logback.qos.ch。它当前分为下面下个模块 logback-core：其它两个模块的基础模块 logback-classic：logback-...
日志组件logback的介绍及配置使用方法(二)
sunney
03-05 1万+
四、Logback的默认配置       如果配置文件 logback-test.xml 和 logback.xml 都不存在，那么 logback 默认地会调用BasicConfigurator ，创建一个最小化配置。最小化配置由一个关联到根 logger 的ConsoleAppender 组成。输出用模式为%d{HH:mm:ss.SSS} [%thread] %-5level %lo
logback的使用和logback.xml详解
weixin_34227447的博客
02-19 191
一、logback的介绍 　　Logback是由log4j创始人设计的另一个开源日志组件,官方网站： http://logback.qos.ch。它当前分为下面下个模块： 　　logback-core：其它两个模块的基础模块 　　logback-classic：它是log4j的一个改良版本，同时它完整实现了slf4j API使你可以很方便地更换成其它日志系统...
logback学习
08-07
### Logback 学习 #### 一、Logback 简介 Logback 是一个用于 Java 的日志框架，由 Ceki Gülcü 开发，是 Log4j 的一个升级版。Logback 提供了更好的性能和更小的内存占用，并且在功能上也更加丰富。Logback 分为...
logback学习用到的jar包
11-21
logback学习用到的jar包，分别有logback-access-1.3.0-alpha10.jar、logback-classic-1.2.3.jar、logback-core-1.2.3.jar、logback-core-1.3.0-alpha10.jar
ssm +shiro+slf4j+logback 学习记录
12-01
这个"ssm +shiro+slf4j+logback 学习记录"的压缩包可能包含了一系列教程、示例代码和配置文件，帮助开发者学习如何在实际项目中整合这些技术，实现高效且安全的Web应用。通过学习和实践这些内容，你可以掌握现代Java...
logback学习的jar包免费分享，分别包括classic1.2.3、core1.2.3、slf4j-api 1.7.26
12-19
在学习和使用这些组件时，你需要理解以下关键概念： - **配置文件**：logback 使用 XML 文件（logback.xml）进行配置，定义日志级别、Appender 和 Layout。 - **日志级别**：包括 TRACE, DEBUG, INFO, WARN, ERROR ...
logback-classic-1.2.3-API文档-中文版.zip
04-23
赠送jar包：logback-classic-1.2.3.jar； 赠送原API文档：logback-classic-1.2.3-javadoc.jar； 赠送源代码：logback-classic-1.2.3-sources.jar； 赠送Maven依赖信息文件：logback-classic-1.2.3.pom； 包含翻译后的API文档：logback-classic-1.2.3-javadoc-API文档-中文(简体)版.zip； Maven坐标：ch.qos.logback:logback-classic:1.2.3； 标签：classic、qos、logback、jar包、java、API文档、中文版； 使用方法：解压翻译后的API文档，用浏览器打开“index.html”文件，即可纵览文档内容。 人性化翻译，文档中的代码和结构保持不变，注释和说明精准翻译，请放心使用。
logback-classic-1.1.2.jar
08-14
logback-classic-1.1.2.jar 资源共享，有需要其他jar包的可以在评论留言，看到后我会陆续上传。
logback-classic-1.2.3.jar
12-10
logback-classic-1.2.3.jar
logback-classic-0.9.24.jar
01-29
logback-classic-0.9.24.jar
阅读Logback文档笔记--Logback的Configuration配置
巫巫巫政霖
07-13 7093
要在项目中引入日志，需要一定的代价，据统计日志代码量将会占整个代码量的4%左右。因此我们需要一个工具管理这些日志声明。 对于Log4j.properties可以通过以下网址转化成logback.xml http://logback.qos.ch/translator/ Logback如何查找配置文件： 在classpath中查找logback.groovy如果不存在，则在cla
第三章 Logback configuration
weixin_43511928的博客
08-25 772
我们首先介绍配置logback的方法，并使用许多示例配置脚本。Joran, logback所依赖的配置框架将在后面的章节中介绍。 配置logback 将日志请求插入到应用程序代码中需要大量的计划和努力。观察表明，大约4%的代码专门用于日志记录。因此，即使是中等规模的应用程序也会在其代码中包含数千条日志语句。考虑到它们的数量，我们需要工具来管理这些日志语句。 Logback可以通过编程方式配置，也可以使用XML或Groovy格式的配置脚本进行配置。顺便说一下，现有的log4j用户可以使用PropertiesT
logback 入门教程系列-03-logback config 配置
热门推荐
11-21 2万+
配置 将日志请求插入应用程序代码需要相当多的计划和努力。 观察表明，大约4％的代码专门用于记录。 因此，即使是适度大小的应用程序也会在其代码中嵌入数千个日志记录语句。 鉴于它们的数量，我们需要工具来管理这些日志语句。 可以通过编程方式或使用以XML或Groovy格式表示的配置脚本来配置Logback。 顺便说一句，现有的log4j用户可以使用我们的PropertiesTranslator Web应...
【Logback】Logback 的配置文件
最新发布
swadian2008的博客
03-01 2085
首先，DefaultJoranConfigurator 会尝试查找“logback.configurationFile” 系统属性上指定的文件。如果可以找到该文件，则会读取并解释该文件，然后进行配置。如果没有找到上述文件，DefaultJoranConfigurator 将尝试在类路径上查找配置文件 “logback-test.xml” 。如果可以找到该文件，则会读取并解释该文件，然后进行配置。 如果没有找到上述文件，配置器将继续尝试在类路径中查找配置文件
Logback实战与logback.xml深度解析
Logback是一个由log4j创始人开发的高效开源日志组件，官方网站位于http://logback.qos.ch。...如果你正在寻找一个高效、易用且可扩展的日志解决方案，logback无疑是一个值得深入学习和使用的工具。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值