1. 技术文章
  2. Log4j 学习笔记

Log4j 学习笔记

由 流过昼夜 提交于 2019-11-27 08:18:31

Log4j 学习笔记


  

1 Log4j 概述

  一个完整的软件，日志是必不可少的。程序从开发，测试，维护，运行等环节，都需要向控制台或文件等位置输出大量的信息。这些信息的输出，在很多时间是使用System.out.println()是无法实现的。日志信息根据用途与记录内容不同，分为调试日志、运行日志、异常日志等。用于记录的日志技术很多，如jdk的logger技术，apache的log4j、log4j2、logback技术等。Log4j的全称为Log for Java，即，专门用于java语言的日志记录工具。

1.1 Log4j基础

1.1.1 Log4j的下载

Log4j下载地址：http://logging.apache.org
在这里插入图片描述

1.1.2 Log4j2与Log4j区别

  a、Log4j需要添加一个依赖，而log4j2需要添加两个依赖
  b、Log4j 1.x已经不再更新
  c、Log4j:org.apache.log4j log4j2:org.apache.loggin.log4j
  d、性能上log4j2优于log4je、Logj4j是以.properties，log4j2是以*.xml,.json,.jsn

1.1.2 日志级别

  为了方便对于日志信息的输出显示，对日志内容进了分级管理。日志级别由高到低共分为6个级别：fatal(致命的)、error、warn、info、debug、trace(堆栈)。为什么要对日志进行分级呢？
  无论是将日志输出到控制台，还是文件，其输出都会降低程序的运行效率。但由于调试、运行维护的需要，客户的要求等等原因，需要进行必要的日志输出。这时就必须要在代码中加入日志的输出语句。这些输出语句若在程序运行时全部输出，则势必会降低程序运行效率。例如，使用System.out.println()将信息输出到控制台，则所有的该输出语句均将执行。就会大大降低程序的执行效率。而要使其不输出，唯一的办法就是将这些语句只能一个一个的全部删除。这是个费时费力的过程。

  将日志信息进行分级管理，便可方便的控制信息输出内容及输出的位置：哪些信息需要输出，哪些信息不需要输出，只需要在一个日志输出控制文件中稍加修改即可。而代码中的输出语句不用做任何的修改。从这个角度来说，代码中的日志编写，其实就是写大量的输出语句。只不过这些输出语句比较特殊，它们具有级别，在程序运行期间不一定被执行。它们的执行是需要由另外一个文件来控制。

1.1.3 日志输出控制文件

Log4j的日志输出控制文件，主要由三个部分构成：
1)日志信息的输出位置：控制日志信息将要输出的位置，是控制台还是文件等。
2)日志信息的输出格式：控制日志信息的显示格式，即以怎样的字符串形式显示。
3)日志信息的输出级别：控制日志信息的显示内容，即显示哪些级别的日志信息。有了日志输出控制文件，代码中只要设置好日志信息内容及其级别即可，通过控制文件便可控制这些日志信息的输出了

2 创建第一个项目

2.1 添加依赖

    <dependencies>
        <!--log4j的依赖-->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <!-- 编译插件 -->
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <!-- 插件的版本 -->
                <version>3.5.1</version>
                <!-- 编译级别 -->
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <!-- 编码格式 -->
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>

2.2 放入日志输出控制文件

##define an appender named console
log4j.appender.console=org.apache.log4j.ConsoleAppender
#The Target value is System.out or System.err
log4j.appender.console.Target=System.out
#set the layout type of the apperder
log4j.appender.console.layout=org.apache.log4j.PatternLayout
#set the layout format pattern
log4j.appender.console.layout.ConversionPattern=[log4j-demo] %-5d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] %c:%l - %m%n


##define an appender named file
log4j.appender.file=org.apache.log4j.FileAppender
#define the file path and name
log4j.appender.file.File=c:/logger/logfile.txt
#set the layout type of the apperder
log4j.appender.file.layout=org.apache.log4j.PatternLayout
#set the layout format pattern
log4j.appender.file.layout.ConversionPattern=[log4j-demo] %-5d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] %c:%l - %m%n


##define an appender named rollfile
log4j.appender.rollfile=org.apache.log4j.RollingFileAppender
#define the file path and name
log4j.appender.rollfile.File=c:/logger/logRollFile.txt
#set the log's size
log4j.appender.rollfile.MaxFileSize=10KB
#set the layout type of the apperder
log4j.appender.rollfile.layout=org.apache.log4j.PatternLayout
#set the layout format pattern
log4j.appender.rollfile.layout.ConversionPattern=[log4j-demo] %-5d{yyyy-MM-dd HH:mm:ss,SSS} [%-5p] %c:%l - %m%n


##define a logger
#log4j.logger.\u5168\u9650\u5B9A\u6027\u7C7B\u540D\u6216\u63A5\u53E3\u540D=INFO,console,file,rollfile
log4j.rootLogger=INFO,console,file,rollfile

2.3 代码中实现日志记录

  在要输出日志的类中创建日志对象Logger，并通过Logger的方法在代码中加入日志输出语句。在Java代码中进行日志输出，需要用到Logger类的静态方法getLogger().注意，Logger为org.apache.log4j包中的类

public class Demo {

    public static void main(String[] args) {
        //创建日志记录工具
        Logger logger = LogManager.getLogger(Demo.class);

        logger.debug("This is debug message!");
        logger.info("This is info message");
        logger.warn("This is warn message!");
        logger.error("This is error message!");
    }
}

2.4 结果

  将来这些日志输出语句，会根据log4j.properties文件中日志级别的设置进行输出，会输出到指定位置。其输出结果是：输出指定级别及其更高级别的信息。如指定info级别，则会输出fatal、error、warn、info级别信息。就本例而言，会执行以下三个语句，而不会输出debug语句。

在这里插入图片描述
在这里插入图片描述

3 日志输出控制文件分析

3.1 日志输出控制文件组成

日志属性文件log4j.properties是专门用于控制日志输出的。其主要进行三方面控制：
1、输出位置：控制日志将要输出的位置，是控制台还是文件等。
2、输出布局：控制日志信息的显示形式。
3、输出级别：控制要输出的日志级别。

日志属性文件由两个对象组成：日志附加器与根日志。
根日志：即为java代码中的日志记录器，其主要由两个属性构成：日志输出级别与日志附加器。
日志附加器，则由日志输出位置定义，由其它很多属性进行修饰，如输出布局、文件位置、文件大小等。配置模式：
appenderName是用户自定义
log4j.appender.appenderName=ClassName
log4j.appender.appenderName.Option1=value1
log4j.appender.appenderName.Option2=value2
…
log4j.appender.appenderName.OptionN=valueN
在这里插入图片描述
1、org.apache.log4j.ConsoleAppender:日志输出到控制台
2、org.apache.log4j.FileAppender:日志输出到文件
3、org.apache.log4.RollingFileAppender:当日志文件大小达到指定大小的时候将产生一个新的日志文件。
4、org.apache.log4j.DailyRollingFileAppender:每天产生一个日志文件

3.2 修饰日志附加器

  所谓修饰日志附加器，就是为定义好的附加器添加一些属性，以控制到指定位置的输出。不同的附加器，其修饰属性不同。

3.3 控制台附加器

在这里插入图片描述
Target：控制输出到控制台的使用目标。其值为System.out或System.err。它们的区别是:System.out是以黑色字体显示到控制台，而System.err是以红色字体显示。

3.4 文件附加器File

在这里插入图片描述
File:日志要输出的文件位置及文件名称

3.5 滚动文件附加器

在这里插入图片描述
MaxFileSize:用于指定日志文件的最大值。如果输出的日志文件大小超过了指定的文件大小，将自动产生另一个日志文件

3.6 Log4j常见布局类型

1、org.apache.log4j.HTMLLayout:网页布局，以HTML表格形式布局
2、borg.apache.log4j.SimpleLayout:简单布局，包含日志信息的级别和信息字符串
3、org.apache.log4j.PatternLayout:匹配器布局，可以灵活地指定布局模式。其主要是通过设置PatternLayout的ConversionPattern属性值来控制日志具体输出的格式。

3.7 配置根Logger

配置rootLogger，以便于代码加载来控制日志的输出。其语法为：

log4j.rootLogger=[level],appenderName1,appenderName2,...

其中，level是日志记录的优先级别，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、TRACE、ALL。
Log4j只建议使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。OFF为关闭日志功能。低级别的可以显示打印出高级别的日志信息，但高级别打印不出低级别的日志信息。所以，级别越高显示的日志信息就越少。

标签
log4j
log4j日志级别
log4j配置
控制台
易学教程内所有资源均来自网络或用户发布的内容，如有违反法律规定的内容欢迎反馈！
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!