(五)Logback中的Layout

清疚 2022-02-05 11:15 237阅读 0赞

一、什么是Layout?

Layout是logback中负责把日志事件转换成成字符串的组件，接口如下：

public interface Layout<E> extends ContextAware, LifeCycle {
 
 String doLayout(E event);
 String getFileHeader();
 String getPresentationHeader();
 String getFileFooter();
 String getPresentationFooter();
 String getContentType();
 }

二、自定义Layout

1、继承自LayoutBase接口即可，如下：

package chapters.layouts;
 
 import ch.qos.logback.classic.spi.ILoggingEvent;
 import ch.qos.logback.core.LayoutBase;
 
 public class MySampleLayout extends LayoutBase<ILoggingEvent> {
 
 public String doLayout(ILoggingEvent event) {
 StringBuffer sbuf = new StringBuffer(128);
 sbuf.append(event.getTimeStamp() - event.getLoggingContextVO.getBirthTime());
 sbuf.append(" ");
 sbuf.append(event.getLevel());
 sbuf.append(" [");
 sbuf.append(event.getThreadName());
 sbuf.append("] ");
 sbuf.append(event.getLoggerName();
 sbuf.append(" - ");
 sbuf.append(event.getFormattedMessage());
 sbuf.append(CoreConstants.LINE_SEP);
 return sbuf.toString();
 }
 }

日志输出如下：

10489 DEBUG [main] com.marsupial.Pouch - Hello world.

在配置文件中配置layout

2、包含自定义属性的layout，自定义实现如下：

package chapters.layouts;
 
 import ch.qos.logback.classic.spi.ILoggingEvent;
 import ch.qos.logback.core.LayoutBase;
 
 public class MySampleLayout2 extends LayoutBase<ILoggingEvent> {
 
 String prefix = null;
 boolean printThreadName = true;
 
 public void setPrefix(String prefix) {
 this.prefix = prefix;
 }
 
 public void setPrintThreadName(boolean printThreadName) {
 this.printThreadName = printThreadName;
 }
 
 public String doLayout(ILoggingEvent event) {
 StringBuffer sbuf = new StringBuffer(128);
 if (prefix != null) {
 sbuf.append(prefix + ": ");
 }
 sbuf.append(event.getTimeStamp() - event.getLoggerContextVO().getBirthTime());
 sbuf.append(" ");
 sbuf.append(event.getLevel());
 if (printThreadName) {
 sbuf.append(" [");
 sbuf.append(event.getThreadName());
 sbuf.append("] ");
 } else {
 sbuf.append(" ");
 }
 sbuf.append(event.getLoggerName());
 sbuf.append(" - ");
 sbuf.append(event.getFormattedMessage());
 sbuf.append(LINE_SEP);
 return sbuf.toString();
 }
 }

配置文件如下：

<configuration>
 
 <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
 <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
 <layout class="chapters.layouts.MySampleLayout2"> 
 <prefix>MyPrefix</prefix>
 <printThreadName>false</printThreadName>
 </layout>
 </encoder>
 </appender>
 
 <root level="DEBUG">
 <appender-ref ref="STDOUT" />
 </root>
 </configuration>

三、转换词

有效转换词以及相关选项如下表：

<table> 
 <tbody> 
 <tr> 
 <th style="width:125px;">转换词</th> 
 <th>备注</th> 
 </tr> 
 <tr> 
 <td style="width:125px;">c{ length} lo{ length} logger{ length}</td> 
 <td> 输出日志记录器的名字，该类转换词带有一个可选整形参数，转换器省略算法会缩短日志记录器的名字。 &nbsp; 
 <table> 
 <tbody> 
 <tr> 
 <th>转换符</th> 
 <th>日志记录器名</th> 
 <th>结果</th> 
 </tr> 
 <tr> 
 <td>%logger</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 </tr> 
 <tr> 
 <td>%logger{0}</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 <td>Bar</td> 
 </tr> 
 <tr> 
 <td>%logger{5}</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 <td>m.s.s.Bar</td> 
 </tr> 
 <tr> 
 <td>%logger{10}</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 <td>m.s.s.Bar</td> 
 </tr> 
 <tr> 
 <td>%logger{15}</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 <td>m.s.sample.Bar</td> 
 </tr> 
 <tr> 
 <td>%logger{16}</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 <td>m.sub.sample.Bar</td> 
 </tr> 
 <tr> 
 <td>%logger{26}</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 <td>mainPackage.sub.sample.Bar</td> 
 </tr> 
 </tbody> 
 </table>注意：日志记录器名最右边部分不会被省略，即使长度超出了设定的length选项。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">C{ length} class{ length}</td> 
 <td> 输出发出日志请求调用者的完整类名。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">contextName cn</td> 
 <td>输出日志记录器上下文的名字。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;">d{ pattern} date{ pattern} d{ pattern, timezone} date{ pattern,&nbsp;timezone}</td> 
 <td> 用来输出日志事件日期，日期转换词需要一个格式化字符串作为参数，格式化字符串语义与<a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html" rel="nofollow"><code>java.text.SimpleDateFormat</code></a>相同。 
 <table> 
 <tbody> 
 <tr> 
 <th>转换格式</th> 
 <th>结果</th> 
 </tr> 
 <tr> 
 <td>%d</td> 
 <td>2006-10-20 14:06:49,812</td> 
 </tr> 
 <tr> 
 <td>%date</td> 
 <td>2006-10-20 14:06:49,812</td> 
 </tr> 
 <tr> 
 <td>%date{ISO8601}</td> 
 <td>2006-10-20 14:06:49,812</td> 
 </tr> 
 <tr> 
 <td>%date{HH:mm:ss.SSS}</td> 
 <td>14:06:49.812</td> 
 </tr> 
 <tr> 
 <td>%date{dd&nbsp;MMM&nbsp;yyyy;HH:mm:ss.SSS}</td> 
 <td>20 oct. 2006;14:06:49.812</td> 
 </tr> 
 </tbody> 
 </table>第二个参数可以指定时区，例如：%date{HH:mm:ss.SSS,&nbsp;Australia/Perth}。','作为参数分割符，HH:mm:ss,SSS会被翻译成HH:mm:ss和时区SSS。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">F / file</td> 
 <td> 输出发出日志请求的Java源文件文件名，一般生成文件信息比较慢，因此一般不使用这个转换词。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">caller{depth} caller{depthStart..depthEnd} caller{depth, evaluator-1, ... evaluator-n} caller{depthStart..depthEnd, evaluator-1, ... evaluator-n}</td> 
 <td> 输出生成日志事件的调用者位置信息，例如,%caller{2}&nbsp;会打印如下信息： <pre><code>0 [main] DEBUG - logging statement 
Caller+0 at mainPackage.sub.sample.Bar.sampleMethodName(Bar.java:22)
Caller+1 at mainPackage.sub.sample.Bar.createLoggingRequest(Bar.java:17)</code></pre> %caller{3}&nbsp;会打印如下信息： <pre><code>16 [main] DEBUG - logging statement 
Caller+0 at mainPackage.sub.sample.Bar.sampleMethodName(Bar.java:22)
Caller+1 at mainPackage.sub.sample.Bar.createLoggingRequest(Bar.java:17)
Caller+2 at mainPackage.ConfigTester.main(ConfigTester.java:38)</code></pre> 同样可以使用范围指定符，例如，&nbsp;%caller{1..2}&nbsp;会打印如下信息： <pre><code>0 [main] DEBUG - logging statement
Caller+0 at mainPackage.sub.sample.Bar.createLoggingRequest(Bar.java:17)</code>
</pre> </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">L / line</td> 
 <td> 输出发出日志请求的行号，由于生成行号信息比较慢，因此一般不使用这个转换词。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">m / msg / message</td> 
 <td> 输出与日志事件相关的应用提供的信息。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">M / method</td> 
 <td> 输出发出日志请求的方法名，由于生成方法名的比较慢，因此一般不使用这个转换词。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">n</td> 
 <td> 输出与平台独立的行分隔符，等价于"\n"或者"\r\n"。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">p / le / level</td> 
 <td>输出日志对象的级别。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;">r / relative</td> 
 <td>输出应用程序启动到日志事件产生所用到的时间(毫秒)。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;">t / thread</td> 
 <td>输出产生日志事件的线程名。</td> 
 </tr> 
 <tr> 
 <td style="width:125px;">X{ key:-defaultVal} mdc{ key:-defaultVal}</td> 
 <td> 输出与产生日志事件线程相关的MDC(mapped diagnostic context)。如果mdc转换词后面花括号中有key，例如：%mdc{transactionId},那么与key 'transactionId'的值将会被输出，如果值为空，那么:-后的默认值将会被输出，如果没有默认值，则输出空字符串。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">ex{ depth} exception{ depth} throwable{ depth} ex{depth, evaluator-1, ..., evaluator-n} exception{depth, evaluator-1, ..., evaluator-n} throwable{depth, evaluator-1, ..., evaluator-n}</td> 
 <td> 输出与日志事件相关的异常栈，默认所有异常栈都会被输出。throwable转换词支持如下选项： 
 <ul> 
 <li>short: 打印异常栈第一行。</li> 
 <li>full: 打印所有异常栈。</li> 
 <li>Any integer: 打印指定行数异常栈。</li> 
 </ul>下面是一些示例： 
 <table> 
 <tbody> 
 <tr> 
 <th>转换格式</th> 
 <th>结果</th> 
 </tr> 
 <tr> 
 <td>%ex</td> 
 <td> <pre><code>mainPackage.foo.bar.TestException: Houston we have a problem
 at mainPackage.foo.bar.TestThrower.fire(TestThrower.java:22)
 at mainPackage.foo.bar.TestThrower.readyToLaunch(TestThrower.java:17)
 at mainPackage.ExceptionLauncher.main(ExceptionLauncher.java:38)</code></pre> </td> 
 </tr> 
 <tr> 
 <td>%ex{short}</td> 
 <td> <pre><code>mainPackage.foo.bar.TestException: Houston we have a problem
 at mainPackage.foo.bar.TestThrower.fire(TestThrower.java:22)</code></pre> </td> 
 </tr> 
 <tr> 
 <td>%ex{full}</td> 
 <td> <pre><code>mainPackage.foo.bar.TestException: Houston we have a problem
 at mainPackage.foo.bar.TestThrower.fire(TestThrower.java:22)
 at mainPackage.foo.bar.TestThrower.readyToLaunch(TestThrower.java:17)
 at mainPackage.ExceptionLauncher.main(ExceptionLauncher.java:38)</code></pre> </td> 
 </tr> 
 <tr> 
 <td>%ex{2}</td> 
 <td> <pre><code>mainPackage.foo.bar.TestException: Houston we have a problem
 at mainPackage.foo.bar.TestThrower.fire(TestThrower.java:22)
 at mainPackage.foo.bar.TestThrower.readyToLaunch(TestThrower.java:17)</code></pre> </td> 
 </tr> 
 </tbody> 
 </table></td> 
 </tr> 
 <tr> 
 <td style="width:125px;">xEx{ depth} xException{ depth} xThrowable{ depth} xEx{depth, evaluator-1, ..., evaluator-n} xException{depth, evaluator-1, ..., evaluator-n} xThrowable{depth, evaluator-1, ..., evaluator-n}</td> 
 <td> 与转换词%throwable相同，只不过会额外添加类所属包的信息。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">nopex nopexception</td> 
 <td> Although it pretends to handle stack trace data, this conversion word does not output any data, thus, effectively ignoring exceptions. The %nopex conversion word allows the user to override <code>PatternLayout</code>'s internal safety mechanism which silently adds the %xThrowable conversion keyword in the absence of another conversion word handling exceptions. </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">marker</td> 
 <td> Outputs the marker associated with the logger request. In case the marker contains children markers, the converter displays the parent as well as childrens' names according to the format shown below. parentName [ child1, child2 ] </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">property{key}</td> 
 <td> 输出与属性名key相关的值，如何定义锚点以及变量作用域请参考：<a href="https://logback.qos.ch/manual/configuration.html#scopes" rel="nofollow">https://logback.qos.ch/manual/configuration.html#scopes</a> </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">replace(p){r, t}</td> 
 <td> 用't'替代p中匹配正则表达式r的内容，例如，&nbsp;"%replace(%msg){'\s', ''}" 会去除事件消息中包含的所有空格。 模式'p'可以是任意多个转换词，例如，"%replace(%logger %msg){'\.', '/'}"会替换日志事件日志记录器或者消息中所有的点为斜杠。 </td> 
 </tr> 
 <tr> 
 <td style="width:125px;">rEx{ depth} rootException{ depth} rEx{depth, evaluator-1, ..., evaluator-n} rootException{depth, evaluator-1, ..., evaluator-n}</td> 
 <td> 输出与日志事件香瓜的异常栈，示例如下： <pre><code>java.lang.NullPointerException
 at com.xyz.Wombat(Wombat.java:57) ~[wombat-1.3.jar:1.3]
 at com.xyz.Wombat(Wombat.java:76) ~[wombat-1.3.jar:1.3]
Wrapped by: org.springframework.BeanCreationException: Error creating bean with name 'wombat': 
 at org.springframework.AbstractBeanFactory.getBean(AbstractBeanFactory.java:248) [spring-2.0.jar:2.0]
 at org.springframework.AbstractBeanFactory.getBean(AbstractBeanFactory.java:170) [spring-2.0.jar:2.0]
 at org.apache.catalina.StandardContext.listenerStart(StandardContext.java:3934) [tomcat-6.0.26.jar:6.0.26]</code></pre> </td> 
 </tr> 
 </tbody> 
</table>

四、格式修饰符

通过格式修饰符可以改变数据域最小和最大宽度，格式修饰符位于百分号和转换词之间，默认格式是右调整，左调整可以使用（-）减号，下面是一些示例：

<table> 
 <tbody> 
 <tr> 
 <th style="width:90px;">格式修饰符</th> 
 <th style="width:72px;">左调整</th> 
 <th style="width:79px;">最小宽度</th> 
 <th style="width:84px;">最大宽度</th> 
 <th style="width:520px;">备注</th> 
 </tr> 
 <tr> 
 <td style="width:90px;">%20logger</td> 
 <td style="width:72px;">false</td> 
 <td style="width:79px;">20</td> 
 <td style="width:84px;">none</td> 
 <td style="width:520px;">如果日志记录器名字长度小于20个字符，左边会添加空格补全。</td> 
 </tr> 
 <tr> 
 <td style="width:90px;">%-20logger</td> 
 <td style="width:72px;">true</td> 
 <td style="width:79px;">20</td> 
 <td style="width:84px;">none</td> 
 <td style="width:520px;">如果日志记录器名字长度小于20个字符，右边会添加空格补全。</td> 
 </tr> 
 <tr> 
 <td style="width:90px;">%.30logger</td> 
 <td style="width:72px;">NA</td> 
 <td style="width:79px;">none</td> 
 <td style="width:84px;">30</td> 
 <td style="width:520px;">如果日志记录器名字长度大于30个字符，从头开始截取。</td> 
 </tr> 
 <tr> 
 <td style="width:90px;">%20.30logger</td> 
 <td style="width:72px;">false</td> 
 <td style="width:79px;">20</td> 
 <td style="width:84px;">30</td> 
 <td style="width:520px;">如果日志记录器名字长度小于20个字符，左边会添加空格补全。如果日志记录器名字长度大于30个字符，从头开始截取。</td> 
 </tr> 
 <tr> 
 <td style="width:90px;">%-20.30logger</td> 
 <td style="width:72px;">true</td> 
 <td style="width:79px;">20</td> 
 <td style="width:84px;">30</td> 
 <td style="width:520px;">如果日志记录器名字长度小于20个字符，右边会添加空格补全。如果日志记录器名字长度大于30个字符，从头开始截取。</td> 
 </tr> 
 <tr> 
 <td style="width:90px;">%.-30logger</td> 
 <td style="width:72px;">NA</td> 
 <td style="width:79px;">none</td> 
 <td style="width:84px;">30</td> 
 <td style="width:520px;">如果日志记录器名字长度大于30个字符，从右边开始截取。</td> 
 </tr> 
 </tbody> 
</table>

下面这张表是格式修饰符截取的例子，注意方括号不是日志输出的一部分，只用来分割日志输出的宽度。

<table> 
 <tbody> 
 <tr> 
 <th>格式修饰符</th> 
 <th>日志记录器名</th> 
 <th>结果</th> 
 </tr> 
 <tr> 
 <td>[%20.20logger]</td> 
 <td>main.Name</td> 
 <td> <pre><code>[ main.Name]</code></pre> </td> 
 </tr> 
 <tr> 
 <td>[%-20.20logger]</td> 
 <td>main.Name</td> 
 <td> <pre><code>[main.Name ]</code></pre> </td> 
 </tr> 
 <tr> 
 <td>[%10.10logger]</td> 
 <td>main.foo.foo.bar.Name</td> 
 <td> <pre><code>[o.bar.Name]</code></pre> </td> 
 </tr> 
 <tr> 
 <td>[%10.-10logger]</td> 
 <td>main.foo.foo.bar.Name</td> 
 <td> <pre><code>[main.foo.f]</code></pre> </td> 
 </tr> 
 </tbody> 
</table>