log4j整理

<meta http-equiv="refresh" content="1"/>

# log4j日志组件 #
- SLF4J，一个**通用日志接口**
    log4j、logback、log4j2等日志系统都可以无缝对接
- log4j的配置详解
- 如何实现自定义过滤输出

### SLF4J ###
> + SLF4J，即简单日志门面（Simple Logging Facade for Java），不是具体的日志解决方案，它只服务于各种各样的日志系统。
> + 实际上，SLF4J所提供的核心API是一些接口以及一个LoggerFactory的工厂类。从某种程度上，SLF4J有点类似JDBC，不过比JDBC更简单，在JDBC中，你需要指定驱动程序，而在使用SLF4J的时候，不需要在代码中或配置文件中指定你打算使用那个具体的日志系统。如同使用JDBC基本不用考虑具体数据库一样，SLF4J提供了统一的记录日志的接口，只要按照其提供的方法记录即可，最终日志的格式、记录级别、输出方式等通过具体日志系统的配置来实现，因此可以在应用中灵活切换日志系统。
> + log4j是Apache的一个开源项目，log4j2和log4j是一个作者，只不过log4j2是重新架构的一款日志组件，他抛弃了之前log4j的不足，以及吸取了优秀的logback的设计重新推出的一款新组件，性能较之log4j有了近10倍的提升，社区活跃度很高。

### log4j配置 ###
> ```
> # log4j有三大组件：logger appender layout
> # logger     日志级别相关
> # appender     日志输出相关
> # layout    输出格式相关
>
> # log4j的根配置
> # -第一个位置表示输出日志的级别[level]，  debug --> info --> warn --> error
> # -之后的表示自定义输出的logger，用来分别按需求进行处理
> # level参数：表示默认情况下的输出级别，如果一个包或者类没有指定输出级别，那么就会按照这个默认的来
> log4j.rootLogger = INFO, stdout, fileout
> # 如果指定了某个包的输出级别，他会与默认的rootLogger进行merge操作(level会覆盖掉)
> #log4j.logger.logtest=ERROR
> # logger 不仅可以指定输出级别，还可以指定输出器输出
> log4j.logger.logtest=DEBUG, logtestout
>
> # Appender 为日志输出目的地，Log4j提供的appender有以下几种：
> # org.apache.log4j.ConsoleAppender（控制台），
> # org.apache.log4j.FileAppender（文件），
> # org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
> # org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
> # org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）
> #
> # 1.ConsoleAppender选项
> #     Threshold=WARN:指定日志消息的输出最低层次。
> #     ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
> #     Target=System.err：默认情况下是：System.out,指定输出控制台
> # 2.FileAppender 选项
> #     Threshold=WARN:指定日志消息的输出最低层次。
> #     ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
> #     File=mylog.txt:指定消息输出到mylog.txt文件。
> #     Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
> # 3.DailyRollingFileAppender 选项
> #     Threshold=WARN:指定日志消息的输出最低层次。
> #     ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
> #     File=mylog.txt:指定消息输出到mylog.txt文件。
> #     Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
> #     DatePattern='.'yyyy-ww:每周滚动一次文件，即每周产生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如下：
> #     1)'.'yyyy-MM: 每月
> #     2)'.'yyyy-ww: 每周
> #     3)'.'yyyy-MM-dd: 每天
> #     4)'.'yyyy-MM-dd-a: 每天两次
> #     5)'.'yyyy-MM-dd-HH: 每小时
> #     6)'.'yyyy-MM-dd-HH-mm: 每分钟
> # 4.RollingFileAppender 选项
> #     Threshold=WARN:指定日志消息的输出最低层次。
> #     ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
> #     File=mylog.txt:指定消息输出到mylog.txt文件。
> #     Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
> #     MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时，将会自动滚动，即将原来的内容移到mylog.log.1文件。
> #     MaxBackupIndex=2:指定可以产生的滚动文件的最大数。
>
> # Layout：日志输出格式，Log4j提供的layout有以下几种：
> # org.apache.log4j.HTMLLayout（以HTML表格形式布局），
> # org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
> # org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
> # org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）
>
> # 打印参数: Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，如下:
> # %p: 输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL,
> # %d: 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2002年10月18日 22：10：28，921
> # %r: 输出自应用启动到输出该log信息耗费的毫秒数
> # %c: 输出日志信息所属的类目，通常就是所在类的全名
> # %t: 输出产生该日志事件的线程名
> # %l: 输出日志事件的发生位置，相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:10)
> # %x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
> # %%: 输出一个"%"字符
> # %F: 输出日志消息产生时所在的文件名称
> # %L: 输出代码中的行号
> # %m: 输出代码中指定的消息,产生的日志具体信息
> # %n: 输出一个回车换行符，Windows平台为" "，Unix平台为" "输出日志信息换行
> #
> #  可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如：
> #    类似于 C语言的格式化输出printf 和 Java中的StringFormat中的占位符
> #      1)%20c：指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，默认的情况下右对齐。
> #      2)%-20c:指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，"-"号指定左对齐。
> #      3)%.30c:指定输出category的名称，最大的宽度是30，如果category的名称大于30的话，就会将左边多出的字符截掉，但小于30的话也不会有空格。
> #      4)%20.30c:如果category的名称小于20就补空格，并且右对齐，如果其名称长于30字符，就从左边交远销出的字符截掉。
>
> log4j.appender.stdout=org.apache.log4j.ConsoleAppender
> # Threshold=level 只是显示当前定义的logger中≥level的才会显示
> # 如果定义了 DEBUG、WARN和ERROR级别的信息，但是Threshold设置的是WARN，那么只会显示WARN和ERROR的信息
> log4j.appender.stdout.Threshold=DEBUG
> log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
> log4j.appender.stdout.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss},%6.6r]%-5p[%t]%x(%F:%L) - %m%n   
>
> log4j.appender.fileout=org.apache.log4j.DailyRollingFileAppender
> log4j.appender.fileout.Threshold=WARN
> log4j.appender.fileout.File=d:/fileout-WARN.log
> log4j.appender.fileout.DatePattern='.'yyyy-MM-dd
> log4j.appender.fileout.layout=org.apache.log4j.PatternLayout
> log4j.appender.fileout.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss},%6.6r]%-5p[%t]%x(%F:%L) - %m%n
>
> log4j.appender.logtestout=org.apache.log4j.DailyRollingFileAppender
> log4j.appender.logtestout.Threshold=WARN
> log4j.appender.logtestout.File=d:/logtestout-WARN.log
> log4j.appender.logtestout.DatePattern='.'yyyy-MM-dd
> log4j.appender.logtestout.layout=org.apache.log4j.PatternLayout
> log4j.appender.logtestout.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss},%6.6r]%-5p[%t]%x(%F:%L) - %m%n
> ```

### 测试阶段 ###
> ```
> 导入maven依赖，包含slf4j-api-xxx.jar、slf4j-log4j12-xxx.jar、log4j-xxx.jar
> <!-- 日志组件 -->
> <dependency>
>     <groupId>org.slf4j</groupId>
>     <artifactId>slf4j-log4j12</artifactId>
>     <version>1.7.19</version>
> </dependency>
>
> 将上面的log4j.properties拷贝到classpath中，SE程序在src根目录，WEB程序放在WEB-INF或者src根目录，MAVEN程序放在resources中
>
> 测试包的代码
> /**
>  * 日志配置，log4j.properties的测试
>  */
> public class LoggerTest {
>
>     Logger log = LoggerFactory.getLogger(this.getClass());
>     
>     public LoggerTest() {
>         log.debug("init the LoggerText...");
>     }
>     
>     public void test( ) {
>         log.info("initialize the variable of i...");
>         int i = 0;
>         log.warn("self add the variable of i...");
>         i++;
>         log.error("print the variable of i...");
>         System.err.println("i = " + i);
>     }
>     
>     // Run this program
>     public static void main(String[] args) {
>         new LoggerTest().test();
>     }
> }
>
> 输出结果：
> [2018-08-24 11:51:49,     0]DEBUG[main](LoggerTest.java:16) - init the LoggerText...
> [2018-08-24 11:51:49,     7]INFO [main](LoggerTest.java:20) - initialize the variable of i...
> [2018-08-24 11:51:49,     7]WARN [main](LoggerTest.java:22) - self add the variable of i...
> [2018-08-24 11:51:49,     8]ERROR[main](LoggerTest.java:24) - print the variable of i...
> i = 1
> 磁盘放置了两个文件夹，分别是上边配置的logtestout-WARN.log.yyyy-MM-dd和fileout-WARN.log.yyyy-MM-dd
> 输出内容与自己定义的级别一样
> ```