一、log4j介绍

1 . 为什么要使用日志

答 : 开发阶段发现程序的问题 , 排除错误 , 产品阶段 , 可以记录系统运行的一些状态信息 , 程序运行的状态 ;

2 . System . out . println的局限性

答 : （1）不能在运行时打开或者关闭 ;

       （2）不能选择包或者类 , 在运行的时候打开或者关闭 ;

       （3）输出的信息没有分级 ;

       （4）只能输出文本信息 ;

       （5）不能改变输出位置 ;

3 . 什么是log4j ?

答 : log4j是目前最流行的java开源日志处理框架 , 是Apache的子项目 ;

4 . 关于配置文件

答 : log4j中的xml配置文件要优先于properties文件 ;

5 . log4j的特性

答 : (1)线程安全 ;

       (2)log4j是经过优化速度的 ;

       (3)log4j是基于一个名为记录器的层次结构 ;

       (4)log4j的支持每个记录器多输出追加器(appender) ;

       (5) log4j支持国际化 ;

       (6)log4j并不限于一组预定义的设备 ;

      (7)日志行为可以使用配置文件在运行时设置 ;

      (8)log4j设计从一开始就是处理java异常 ;

      (9)log4j有多个级别 , 通过控制这些级别可以实现将某些不想输出的信息过滤掉 ;

     (10) 日志输出的格式可以通过拓展Layout类容易的改变 ;

     (11)日志输出的目标 , 以及在写入策略可通过实现Appender程序接口改变 ;

     (12) log4j会故障停止 , 然而 , 尽管它肯定努力确保传递 , log4j不保证每个日志语句将被传递到目的地 ;

6 . log4j的主要组成部分

答 : (1)loggers : 负责捕获记录信息 ;

       (2)appenders : 负责发布日志信息 , 以不同的首选目的地 ;

       (3)layouts : 负责格式化不同风格的日志信息 ;

7 . log4j级别(从小到大)

答 : ALL : 各级包括自定义级别 ;

  TRACE : 指定细粒度比DEBUG更低的信息事件 ;

  DEBUG : 调试级别 ;

  INFO : 表明消息在粗粒度级别上突出强调应用程序是非常有帮助的 , 也就是输出一些提示信息 ;

  WARN : 输出潜在的有可能出错的情形 , 也就是输出警告信息 ;

  ERROR : 指出发生的不影响系统继续运行的错误信息 ;

  FATAL : 指出严重的错误 , 这些错误将会导致系统终止运行 ;

  OFF : 为最高级别 , 用于关闭所有日志信息的输出 ;

核心规则 : log4j只会输出级别大于或者等于指定级别的信息 ;

8 . properties文件配置

答 : 1 . 配置根Logger , 语法为 :

      log4j.rootLogger = [ level ] , appenderName , appenderName ……

  注意 : (1)第七条中虽然罗列了很多级别 , 但log4j推荐只使用四个级别 , 优先级从高到低分别是ERROR , WARN , INFO , DEBUG ;

            (2)appenderName指的是日志输出的地址 , 可以同时指定n个 ;

  2 . 配置日志输出的目的地Appender以及每个输出文件的各项属性 , 语法为 :

        log4j.appender.appenderName = fully.qualified.name.of.appender.class

        log4j.appender.appenderName.option1 = value1

  注意 : log4j中提供的appender有以下几种 :

            1 . org.apache.log4j.ConsoleAppender(控制台) ;

            2 . org.apache.log4j.FileAppender(文件) ;

            3 . org.apache.log4j.DailyRollingFileAppender(按照一定的频度滚动产生日志记录文件 , 默认每天产生一个文件) ;

            4 . org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件) ;

            5 . org.apache.log4j.WriterAppender(将日志信息以流格式发送到指定的位置) ;

  3 . 配置日志信息的格式或者布局layout以及布局的各项属性 , 语法为 :

        log4j.appender.appenderName.layout = fully.qualified.name.of.appender.class

        log4j.appender.appenderName.layout.option1 = value

  注意 : log4j中提供的layout有以下几种 :

          1 . org.apache.log4j.HTMLLayout(以HTML表格形式布局) ;

          2 . org.apache.log4j.PatternLayout(可以灵活的指定布局模式 , 需要配置layout.ConversionPattern属性) ;

          3 . org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串) ;

          4 . org.apache.log4j.TTCCLayout(包含日志产生的时间 , 线程 , 类别等等信息) ;

9 . 控制台选项

答 : 1 . log4j.appender.appenderName.Threshold = error

      用法 : rootLogger里配置debug , 然后某个文件专门存储error以及更高级别的错误信息 , 那么就在这个配置这个文件的时候指定Threshold属性为error ;

  2 . log4j.appender.appenderName.ImmediateFlush=true

      用法 : 默认值是true , 意味着所有的消息都会被立即输出 , false则是不输出 ;

  3 . log4j.appender.appenderName.target=System.out

      用法 : 默认值为System.out , 输出到控制台 , 还可以取值System.err , 当做错误信息输出 , 输出的信息全部为红色 ;

  4 . log4j.appender.appenderName.File=../../../../logs/log.appenderName.txt

      用法 : 指定日志输出到指定位置 , 用的是相对于配置文件根目录的相对路径 ;

  5 . log4j.appender.appenderName.File.Append=true

      用法 : 默认值是true , 即将消息追加到指定文件中 , 如果取值为false , 则会覆盖之前的日志内容 ;

  6 . log4j.appender.appenderName.MaxFileSize=20MB

      用法 : 后缀可以是KB , MB , GB , 当日志文件的大小到达指定大小后 , 将会自动滚动 , 即将原来的内容移到fileName.1文件中 , 用记事本打开该文件即可看到原来的内容 , 改属性只能在 appender=org.apache.log4j.RollingFileAppender 时使用 ;

  7 . log4j.appender.appenderName.MaxBackupIndex=10

      用法 : 指定可以产生滚动文件的最大数量 , 与RollingFileAppender和MaxFileSize属性一起使用 , 当MaxBackupIndex=n的时候 , 最大日志存在数量为n+1 , 即log.txt , log.txt.1 , ... , log.txt.n , 当在服务器上运行的时候 , 如果对日志数量没有限制 , 那么随之时间的推移 , 日志文件会越来越多 , 占用的内存也将越来越多 , 直到占满整个盘 ;

  8 . log4j.appender.appenderName.DatePattern='.'yyyy-MM-dd

      用法 : 该属性在 log4j.appender.appenderName=org.apache.log4j.DailyRollingFileAppender 时使用 , DailyRollingFileAppender默认的频度是每天产生一个日志记录文件 , 可以在DatePattern属性值中指定其他的频度 , 常用的几个频度如下 :

        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 : 每分钟产生一个日志记录文件 ;

        注意 : 该属性指定值之后 , 将会按照指定的频度来生成日志记录文件 , 假设指定生成一个名为 log.txt 的文件 , 频度指定为每分钟产生一个日志记录文件 , 当达到指定频度后 , 会将log.txt文件中记录的之前的日志记录 , 重新写入一个名为 log.txt.yyyy-MM-dd-HH-mm的文件中 , 而此时 log.txt 文件中存放的是新生成的日志信息 , 该过程循环往复 ;

10 . ConversionPattern参数

答 : 假设当前java文件名为Test , 所在包名为log4j :

  1 . %c : 显示当前logger空间全称 , 例如 : log4j.Test ;

        %c{层数} : 最内层的java文件为第一层 , 例如 : %c{1} , 显示为Test , 当层数大于实际存在的最大层数时 , 显示最大实际存在层数 ;

  2 . %10c : 若名字空间长度小于10 , 则在左边将欠缺的长度用空格补齐 , 该种情况为默认的右对齐方式 ;

        %-10c : 若名字空间长度小于10 , 则在右边将欠缺的长度用空格补齐 , 该种情况为默认的左对齐方式 ;

  3 . %.3c : 从空间名最右边开始显示指定的长度 , 超出该长度的部分将被截取 ;

  4 . %10.15c : 若空间名长度小于10 , 则左边将欠缺的长度用空格补齐 , 若长度超过15 , 则将多余部分截取 ;

  7 . %-10.15c : 若空间名长度小于10 , 则右边将欠缺的长度用空格补齐 , 若长度超过15 , 则将多余部分截取 ;

  8 . %d : 显示日志记录时间 , 默认时间格式为ISO8601定义的日期格式 ;

        %d{yyyy-MM-dd HH:mm:ss} : 按照指定的时间格式显示日期 ;

  9 . %d{ABSOLUTE} : 22:15:30,076 ;

        %d{DATE} : 12 Oct 2018 22:15:30,076 ;

        %d{ISO8601} : 2018-07-20 22:23:30,076 ;

  10 . %F : 显示调用logger的源文件名 , 例如 : Test.java ;

  11 . %l : 输出日志事件的发生位置 , 包括类目名 , 发生的线程 , 以及在代码中的行数 , 例如 : log4j.log4jTest.main(log4jTest.java:40) ;

  12 : %m : 显示输出消息 ;

  13 . %M : 显示调用logger的方法名 ;

  14 . %n : 换行符 ;

  15 : %p : 显示该条目的优先级 ;

  16 . %r : 显示从程序启动时到记录该条日志时已经经过的时间 , 单位毫秒 ;

  17 . %t : 显示产生该日志条目的线程名 ;

  18 . %x : 按NDC(Nested Diagnostic Context , 线程堆栈) : 顺序输出日志 ;

          %X : 按MDC(Mapped Diagnostic Context , 线程映射表)输出日志 , 通常用于多个客户端连接同一个服务器 , 方便服务器区分是哪个客户端访问留下来的日志 ;

  19 . %% : 显示一个百分号 ;

11 . LevelRangeFilter(分级过滤器)

答 : 如果想要实现不同级别的日志分别输出到不同的位置 , 可以在properties配置文件中加入如下语句进行限制 , 例如 :

  log4j.appender.appenderName.Threshold=debug

  log4j.appender.appenderName.filter.filterName=org.apache.log4j.varia.LevelRangeFilter

  log4j.appender.appenderName.filter.filterName.LevelMin=debug

  log4j.appender.appenderName.filter.filterName.LevelMax=debug

  解释 : 将最低输出级别LevelMin和最高输出级别LevelMax都设置为debug , 那么就只能输出debug级别的日志信息了 ;

（2）log4j使用

将log4j-1.2.17.jar进行buildpath，原来使用过maven配置依赖，但是在使用时候报错所以就直接导入jar包。

log4j.properties文件

#设置log4j日志输出路径

log = D:/logs

#设置输出日志级别和输入模式

log4j.rootLogger=debug,appender1,FILE

#设置控制台输出信息

log4j.appender.appender1=org.apache.log4j.ConsoleAppender

log4j.appender.appender1.layout=org.apache.log4j.PatternLayout

log4j.appender.appender1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %m%n

#设置日志输出路径

log4j.appender.FILE=org.apache.log4j.RollingFileAppender

log4j.appender.FILE.MaxFileSize=10MB

log4j.appender.FILE.MaxBackupIndex=3

log4j.appender.FILE.File=${log}/testLog.log

log4j.appender.FILE.layout=org.apache.log4j.PatternLayout

log4j.appender.FILE.layout.conversionPattern=%m%n

测试demo 类：

package com.suning.SuningInterfaceAutotest.log4j;

import org.apache.log4j.Logger;

public class demo {

private static Logger logger = Logger.getLogger(demo.class);

public static void main(String[] args) {

logger.debug("This is debug message.");

logger.info("This is info message.");

logger.error("This is error message.");

}

}