logback的简单学习一

时间 2020-01-08

标签 logback 简单学习繁體版

原文原文链接

package com.book.web.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * logback的测试
 * @author liweihan
 *
 */
public class TestLogback {

	/**
	 1.引入jar包
	 	<dependency>
		  <groupId>ch.qos.logback</groupId>
		  <artifactId>logback-core</artifactId>
		  <version>1.2.3</version>
		</dependency>
		<dependency>
		  <groupId>ch.qos.logback</groupId>
		  <artifactId>logback-classic</artifactId>
		  <version>1.2.3</version>
		</dependency>
		<dependency>
		  <groupId>org.slf4j</groupId>
		  <artifactId>slf4j-api</artifactId>
		  <version>1.7.7</version>
		</dependency>
		
	2.logback 官方使用方式，其实就和slf4j集成了起来
	     下面Logger、LoggerFactory都是slf4j本身的接口与类
	    没有配置文件的状况下，使用的是默认配置。搜寻配置文件的过程以下：
		  寻找logback.configurationFile的系统属性 →
		  寻找 logback.groovy → 
		  寻找 logback-test.xml → 
		  寻找 logback.xml 
	  
	   目前路径都是定死的(放在类路径下)，只有logback.configurationFile的系统属性是能够更改的，
	   因此若是咱们想更改配置文件的位置（不想放在类路径下），则须要设置这个系统属性：
	   System.setProperty("logback.configurationFile","/path/to/config.xml");
	   解析完配置文件后，返回的ILoggerFactory实例的类型是LoggerContext（它包含了配置信息）
	   根据返回的ILoggerFactory实例，来获取Logger
	   就是根据上述的LoggerContext来建立一个Logger，
	   每一个logger与LoggerContext创建了关系，并放到LoggerContext的缓存中
	   
	3.若是logback-和commons-logging集成，还须要加入jar包
		<dependency>
		  <groupId>org.slf4j</groupId>
		  <artifactId>jcl-over-slf4j</artifactId>
		  <version>1.7.7</version>
		</dependency>   
	   
	   private static Log logger = LogFactory.getLog(TestLogback.class);
	   
	   logback自己的使用其实就和slf4j绑定了起来，如今要想指定commons-logging的底层log实现是logback，则须要2步走
		第一步： 先将commons-logging底层的log实现转向slf4j (jcl-over-slf4j干的事)
		第二步： 再根据slf4j的选择底层日志原理，咱们使之选择上logback
		这样就能够完成commons-logging与logback的集成。即写着commons-logging的API，底层倒是logback来进行输出
	 */
	
	private static final Logger logger = LoggerFactory.getLogger(TestLogback.class);
	
	public static void main(String[] args) {
		if (logger.isDebugEnabled()) {
			logger.debug(" ====== slf4j-logback debug message");
		}
		if (logger.isInfoEnabled()) {
			logger.info(" ====== slf4j-logback info message");
		}
		if (logger.isTraceEnabled()) {
			logger.trace(" ====== slf4j-logback trace message");
		}
		if (logger.isWarnEnabled()) {
			logger.error(" ====== slf4j-logback error message");
		}
		
	}
}

若是咱们不配置logback-test.xml或logback.xml，那么将要调用logback.configurationFile的系统属性。html

logback.xml的配置:html5

<?xml version="1.0" encoding="UTF-8"?>
<!-- if debug set to true, context info always print otherwise the contex
   info will print when error occour -->
<configuration scan="true" scanPeriod="20 seconds" debug="false">
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36}
                [%file:%line] - %msg%n
            </pattern>
        </encoder>
    </appender>

    <!-- 全部日志文件 -->
    <appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${html5.log.path}html5.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${html5.log.path}html5.%d{yyyy-MM-dd}.log
            </fileNamePattern>
            <maxHistory>15</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36}
                [%file:%line] - %msg%n
            </pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>
    <!--2016-07-13-han-add : just for scan error log clearly!-->
    <appender name="ERROR-OUT" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${html5.log.path}error.log</file>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36}
                [%file:%line] - %msg%n
            </pattern>
            <charset>UTF-8</charset>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${html5.log.path}error.%d{yyyy-MM-dd}.log
            </fileNamePattern>
            <maxHistory>15</maxHistory>
        </rollingPolicy>
    </appender>
    <!--2016-07-13-add-han-just for test some Class or package
    <logger name="com.vis.servlet.PhonePlayServlet" level="DEBUG" additivity="false">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="ROLLING"/>
    </logger>
      <logger name="com.vis.servlet.PhoneUGCPlayListServlet" level="DEBUG" additivity="false">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="ROLLING"/>
    </logger>
      <logger name="com.vis.servlet.PhoneUGCWxServlet" level="DEBUG" additivity="false">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="ROLLING"/>
    </logger>
      <logger name="com.vis.servlet.PhoneUGCServlet" level="DEBUG" additivity="false">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="ROLLING"/>
    </logger>
      <logger name="com.vis.servlet.PhoneUGCPlayListWxServlet" level="DEBUG" additivity="false">
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="ROLLING"/>
    </logger>
-->

    <root level="info">
        <appender-ref ref="ROLLING"/>
        <appender-ref ref="STDOUT"/>
        <appender-ref ref="ERROR-OUT"/>
    </root>
</configuration>

配置说明:java

1、根节点<configuration>包含的属性：web

scan:正则表达式

当此属性设置为true时，配置文件若是发生改变，将会被从新加载，默认值为true。算法

scanPeriod:数据库

设置监测配置文件是否有修改的时间间隔，若是没有给出时间单位，默认单位是毫秒。api

当scan为true时，此属性生效。默认的时间间隔为1分钟。
debug:数组

当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。缓存

例子如上！

2、设置logger

<logger> : 用来设置某一个包或者具体的某一个类的日志打印级别、以及指定<appender>。<logger>仅有一个name属性，一个可选的level和一个可选的addtivity属性。

name : 用来指定受此logger约束的某一个包或者具体的某一个类。

level: 用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF，

还有一个特殊值INHERITED或者同义词NULL，表明强制执行上级的级别。

若是未设置此属性，那么当前loger将会继承上级的级别。

addtivity: 是否向上级loger传递打印信息。默认是true。

<logger>能够包含零个或多个<appender-ref>元素，

标识这个appender将会添加到这个loger。

	<!-- 该包全部类的日志的打印，可是并没用设置打印级别，
	   因此继承他的上级<root>的日志级别。
	   没有设置addtivity，默认为true，将此loger的打印信息向上级传递；
	   没有设置appender，此loger自己不打印任何信息。
	-->
	<logger name="com.book.web.controller"/>
	<!-- TestLogback类 ,此时该类的日志就不会输入到文件中,日志级别为INFO
	additivity设置为true时，将打印两第二天志！
	-->
	<logger name="com.book.web.controller.TestLogback" level="INFO" additivity="false">
		<appender-ref ref="STDOUT"/>
	</logger>

3、设置root

其实,他也是<logger>元素，可是它是根loger。只有一个level属性

level:

用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF，不能设置为INHERITED或者同义词NULL。默认是DEBUG

<root>能够包含零个或多个<appender-ref>元素，标识这个appender将会添加到这个logger。

4、设置appender

<appender>：

<appender>是<configuration>的子节点，是负责写日志的组件。

<appender>有两个必要属性name和class。name指定appender名称，class指定appender的全限定名。

1.ConsoleAppender:

把日志添加到控制台，有如下子节点：

<encoder>：对日志进行格式化。

<target>：字符串 System.out 或者 System.err ，默认 System.out ；

2.FileAppender:

把日志添加到文件，有如下子节点：

<file>：被写入的文件名，能够是相对目录，也能够是绝对目录，若是上级目录不存在会自动建立，没有默认值。<append>：若是是 true，日志被追加到文件结尾，若是是 false，清空现存文件，默认是true。

<encoder>：对记录事件进行格式化。（具体参数稍后讲解）

<prudent>：若是是 true，日志会被安全的写入文件，即便其余的FileAppender也在向此文件作写入操做，效率低，默认是 false。

<configuration>  
  <appender name="FILE" class="ch.qos.logback.core.FileAppender">  
    <file>testFile.log</file>  
    <append>true</append>  
    <encoder>  
      <pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>  
    </encoder>  
  </appender>  
          
  <root level="DEBUG">  
    <appender-ref ref="FILE" />  
  </root>  
</configuration>

3.RollingFileAppender:

滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其余文件。有如下子节点：

<encoder>：对记录事件进行格式化。（具体参数稍后讲解）

<rollingPolicy>:当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名。

<triggeringPolicy >: 告知 RollingFileAppender 合适激活滚动。

<prudent>：当为true时，不支持FixedWindowRollingPolicy。支持TimeBasedRollingPolicy，可是有两个限制，1不支持也不容许文件压缩，2不能设置file属性，必须留空。

3.1 rollingPolicy：

3.1.1 TimeBasedRollingPolicy： 最经常使用的滚动策略，它根据时间来制定滚动策略，

既负责滚动也负责出发滚动。有如下子节点：

<fileNamePattern>:

必要节点，包含文件名及“%d”转换符， “%d”能够包含一个java.text.SimpleDateFormat指定的时间格式，如：%d{yyyy-MM}。若是直接使用 %d，默认格式是 yyyy-MM-dd。RollingFileAppender 的file字节点无关紧要，经过设置file，能够为活动文件和归档文件指定不一样位置，当前日志老是记录到file指定的文件（活动文件），活动文件的名字不会改变；若是没设置file，活动文件的名字会根据fileNamePattern 的值，每隔一段时间改变一次。“/”或者“\”会被当作目录分隔符。

<maxHistory>:

可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件。假设设置每月滚动，且<maxHistory>是6，则只保存最近6个月的文件，删除以前的旧文件。注意，删除旧文件是，那些为了归档而建立的目录也会被删除。

3.1.2 FixedWindowRollingPolicy： 根据固定窗口算法重命名文件的滚动策略。有如下子节点：

<minIndex>:窗口索引最小值

<maxIndex>:窗口索引最大值，当用户指定的窗口过大时，会自动将窗口设置为12。

<fileNamePattern >:

必须包含“%i”例如，假设最小值和最大值分别为1和2，命名模式为 mylog%i.log,会产生归档文件mylog1.log和mylog2.log。还能够指定文件压缩选项，例如，mylog%i.log.gz 或者没有log%i.log.zip

3.2 triggeringPolicy:

SizeBasedTriggeringPolicy： 查看当前活动文件的大小，若是超过指定大小会告知RollingFileAppender 触发当前活动文件滚动。只有一个节点:

<maxFileSize>:这是活动文件的大小，默认值是10MB。

<!-- 天天生成一个文件,保留15天 -->
<appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">
   <file>log/test.log</file>
   <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>log/test.%d{yyyy-MM-dd}.log</fileNamePattern>
        <maxHistory>15</maxHistory>
   </rollingPolicy>
   <encoder>
       <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5level] %logger{50}.%M[%line] - %msg%n</pattern>
       <charset>UTF-8</charset>
   </encoder>
</appender>
    
   <!-- 按照固定窗口模式生成日志文件，当文件大于20MB时，生成新的日志文件。
       窗口大小是1到3，当保存了3个归档文件后，将覆盖最先的日志。 -->
  <appender name="ROLLING2" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>log/html5.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
          <fileNamePattern>log/html5.%i.log</fileNamePattern>
         <minIndex>1</minIndex>
         <maxIndex>3</maxIndex>
    </rollingPolicy>
    <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
       <maxFileSize>20MB</maxFileSize>
    </triggeringPolicy>
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} [%file:%line] - %msg%n</pattern>
      <charset>UTF-8</charset>
    </encoder>
  </appender>

5、设置encoder

负责两件事，一是把日志信息转换成字节数组，二是把字节数组写入到输出流。

目前PatternLayoutEncoder 是惟一有用的且默认的encoder ，有一个<pattern>节点，用来设置日志的输入格式。使用“%”加“转换符”方式，若是要输出“%”，则必须用“\”对“\%”进行转义。

<pattern>里面的转换符说明：

转换符	做用
c {length } lo {length } logger {length }	输出日志的logger名，可有一个×××参数，功能是缩短logger名，设置为0表示只输入logger最右边点符号以后的字符串。Conversion specifierLogger nameResult%loggermainPackage.sub.sample.BarmainPackage.sub.sample.Bar%logger{0}mainPackage.sub.sample.BarBar%logger{5}mainPackage.sub.sample.Barm.s.s.Bar%logger{10}mainPackage.sub.sample.Barm.s.s.Bar%logger{15}mainPackage.sub.sample.Barm.s.sample.Bar%logger{16}mainPackage.sub.sample.Barm.sub.sample.Bar%logger{26}mainPackage.sub.sample.BarmainPackage.sub.sample.Bar
C {length } class {length }	输出执行记录请求的调用者的全限定名。参数与上面的同样。尽可能避免使用，除非执行速度不形成任何问题。
contextName cn	输出上下文名称。
d {pattern } date {pattern }	输出日志的打印日志，模式语法与`java.text.SimpleDateFormat` 兼容。Conversion PatternResult%d2006-10-20 14:06:49,812%date2006-10-20 14:06:49,812%date{ISO8601}2006-10-20 14:06:49,812%date{HH:mm:ss.SSS}14:06:49.812%date{dd MMM yyyy ;HH:mm:ss.SSS}20 oct. 2006;14:06:49.812
F / file	输出执行记录请求的java源文件名。尽可能避免使用，除非执行速度不形成任何问题。
caller{depth}caller{depth, evaluator-1, ... evaluator-n}	输出生成日志的调用者的位置信息，整数选项表示输出信息深度。例如， %caller{2} 输出为： 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) 例如， %caller{3} 输出为： 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)
L / line	输出执行日志请求的行号。尽可能避免使用，除非执行速度不形成任何问题。
m / msg / message	输出应用程序提供的信息。
M / method	输出执行日志请求的方法名。尽可能避免使用，除非执行速度不形成任何问题。
n	输出平台先关的分行符“\n”或者“\r\n”。
p / le / level	输出日志级别。
r / relative	输出从程序启动到建立日志记录的时间，单位是毫秒
t / thread	输出产生日志的线程名。
replace(p ){r, t}	p 为日志内容，r 是正则表达式，将p 中符合r 的内容替换为t 。例如， "%replace(%msg){'\s', ''}"

我本身用的几个

<encoder>
	<!--  -->
    <pattern>%d{HH:mm:ss.SSS} [%thread] [%-5level] %logger{50}.%M[%line] - %msg%n</pattern>
	<!-- 本地调试用  
	<pattern>%d{yyyy/MM/dd-HH:mm:ss} [%level] [%thread] %caller{1}-%msg%n</pattern>
	 -->
	<!-- 
	<Pattern>%date{yyyy-MM-dd HH:mm:ss.SSS} [ %-5level ][ %thread ] %logger{56}.%method[%L] - %msg%n</Pattern> --> 
	
	<pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern>   
</encoder>

格式修饰符，与转换符共同使用：

可选的格式修饰符位于“%”和转换符之间。

第一个可选修饰符是左对齐 标志，符号是减号“-”；接着是可选的最小宽度 修饰符，用十进制数表示。若是字符小于最小宽度，则左填充或右填充，默认是左填充（即右对齐），填充符为空格。若是字符大于最小宽度，字符永远不会被截断。最大宽度 修饰符，符号是点号"."后面加十进制数。若是字符大于最大宽度，则从前面截断。点符号“.”后面加减号“-”在加数字，表示从尾部截断。

例如：%-4relative 表示，将输出从程序启动到建立日志记录的时间进行左对齐且最小宽度为4。

6、设置Filter

<filter>:过滤器，执行一个过滤器会有返回1个枚举值，即DENY，NEUTRAL，ACCEPT其中之一。

返回DENY，日志将当即被抛弃再也不通过其余过滤器；

返回NEUTRAL，有序列表里的下个过滤器过接着处理日志；

返回ACCEPT，日志会被当即处理，再也不通过剩余过滤器。

过滤器被添加到<Appender> 中，为<Appender> 添加一个或多个过滤器后，能够用任意条件对日志进行过滤。<Appender> 有多个过滤器时，按照配置顺序执行。

LevelFilter： 级别过滤器，根据日志级别进行过滤。若是日志级别等于配置级别，过滤器会根据onMath 和 onMismatch接收或拒绝日志。有如下子节点：

<level>:设置过滤级别

<onMatch>:用于配置符合过滤条件的操做

<onMismatch>:用于配置不符合过滤条件的操做

例如：将过滤器的日志级别配置为INFO，全部INFO级别的日志交给appender处理，非INFO级别的日志，被过滤掉。

<configuration>   
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">   
    <filter class="ch.qos.logback.classic.filter.LevelFilter">   
      <level>INFO</level>   
      <onMatch>ACCEPT</onMatch>   
      <onMismatch>DENY</onMismatch>   
    </filter>   
    <encoder>   
      <pattern>   
        %-4relative [%thread] %-5level %logger{30} - %msg%n   
      </pattern>   
    </encoder>   
  </appender>   
  <root level="DEBUG">   
    <appender-ref ref="CONSOLE" />   
  </root>   
</configuration>

例子2：将错误日志单独到一个文件error.log中

<configuration>   
    <appender name="ERROR-OUT" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>log/error.log</file>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36}
                [%file:%line] - %msg%n
            </pattern>
            <charset>UTF-8</charset>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>log/error.%d{yyyy-MM-dd}.log
            </fileNamePattern>
            <maxHistory>15</maxHistory>
        </rollingPolicy>
    </appender>  
    <root level="DEBUG">   
       <appender-ref ref="ERROR-OUT"/>
    </root>   
</configuration>

例子3：当咱们须要按时间滚动日志，同时又须要按照大小滚动时：

<configuration>  
  <appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">  
    <file>mylog.txt</file>  
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">  
      <!-- rollover daily -->  
      <fileNamePattern>mylog-%d{yyyy-MM-dd}.%i.txt</fileNamePattern>  
       <!-- each file should be at most 100MB, keep 60 days worth of history, but at most 20GB -->  
       <maxFileSize>100MB</maxFileSize>      
       <maxHistory>60</maxHistory>  
       <totalSizeCap>20GB</totalSizeCap>  
    </rollingPolicy>  
  
    <encoder>  
      <pattern>%msg%n</pattern>  
    </encoder>  
  </appender>  
  
  <root level="DEBUG">  
    <appender-ref ref="ROLLING" />  
  </root>  
</configuration>

1、

Logback是由log4j创始人Ceki Gülcü设计的又一个开源日志组件。Logback，一个“可靠、通用、快速而又灵活的Java日志框架”。logback当前分红三个模块：logback-core，logback- classic和logback-access。

logback-core是其它两个模块的基础模块。

logback-classic是log4j的一个改良版本。

logback-classic完整实现SLF4J API使你能够很方便地更换成其它日志系统如log4j或JDK Logging。logback-access访问模块与Servlet容器集成提供经过Http来访问日志的功能。

2、

Logback主要创建于Logger、Appender 和 Layout 这三个类之上。

Logger:日志的记录器，把它关联到应用的对应的context上后，主要用于存放日志对象，也能够定义日志类型、级别。Logger对象通常多定义为静态常量.

Appender:用于指定日志输出的目的地，目的地能够是控制台、文件、远程套接字服务器、 MySQL、 PostreSQL、Oracle和其余数据库、 JMS和远程UNIX Syslog守护进程等。

Layout:负责把事件转换成字符串，格式化的日志信息的输出。

3、

Level 有效级别

Logger能够被分配级别。级别包括：TRACE、DEBUG、INFO、WARN和ERROR，定义于ch.qos.logback.classic.Level类。程序会打印高于或等于所设置级别的日志，设置的日志等级越高，打印出来的日志就越少。若是设置级别为INFO，则优先级高于等于INFO级别（如：INFO、 WARN、ERROR）的日志信息将能够被输出,小于该级别的如DEBUG将不会被输出。为确保全部logger都可以最终继承一个级别，根logger老是有级别，默认状况下，这个级别是DEBUG

4、

三值逻辑

Logback的过滤器基于三值逻辑（ternary logic），容许把它们组装或成链，从而组成任意的复合过滤策略。过滤器很大程度上受到Linux的iptables启发。这里的所谓三值逻辑是说，过滤器的返回值只能是ACCEPT、DENY和NEUTRAL的其中一个。

若是返回DENY，那么记录事件当即被抛弃，再也不通过剩余过滤器；

若是返回NEUTRAL，那么有序列表里的下一个过滤器会接着处理记录事件；

若是返回ACCEPT，那么记录事件被当即处理，再也不通过剩余过滤器。

5、

Filter 过滤器

Logback-classic提供两种类型的过滤器：常规过滤器和TuroboFilter过滤器。Logback总体流程：

Logger 产生日志信息；

Layout修饰这条msg的显示格式；

Filter过滤显示的内容；