细说log4j

Posted LanceToBigData

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了细说log4j相关的知识,希望对你有一定的参考价值。

可能做过java项目的基本上都是用过log4j,它是用来做java日志的。比如我们做一个项目分为很多的模块,那我们怎么想要知道它什么时候启动了,这时候我们可以使用log4j标记某某模块启动了。

努力的人绝对不会成为落后的标兵,加油!废话不多说,进入log4j。

一、log4j简介

1.1、log4j概述

  log for java(java日志)

  Log4j是Apache的一个开源项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件,甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等;
  我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。
  最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。  

  其他日志组件:JDK Logger、Monolog、JTraceDump、Commons Logging等

1.2、作用

  lg4j用来做java日志

1.3、log4j的特点和优点 

  1)可以控制日志信息输送的目的地是控制台、文件、GUI组件,甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等。
  2)可以控制每一条日志的输出格式
  3)可以更加细致地控制日志的级别
  4)以上三点通过一个配置文件来地进行配置
  5)Log4j其他语言接口,您可以在C、C++、.Net、PL/SQL程序中使用Log4j,其语法和用法与在Java程序中一样,使得多语言分布式系统得到一个统一一致的日志组件模块。
  6)通过使用各种第三方扩展,您可以很方便地将Log4j集成到J2EE、JINI甚至是SNMP应用中。

二、log4j的使用

环境:IntelliJ IDEA、log4j-1.2.17.jar

  1)在项目的根目录下创建一个conf用来存放配置文件,创建一个lib目录用来存放jar包

  log4j.properties:             

             #日志级别,appender的名字
log4j.rootLogger = DEBUG,stdout
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
#这里不配置的话,日志级别就是我们的rootLogger的日志级别
log4j.appender.stdout.Threshold = INFO
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%m%n

  2)创建一个类TestLog4j_0010,在main方法中写:

        PropertyConfigurator.configure("conf/log4j.properties");
        Logger logger = Logger.getRootLogger();
        logger.debug("debug message");
        logger.info("info message");
        logger.warn("warn message");
        logger.error("error message");     

  3)结果

    

    好奇的宝宝,想问为什么debug的打印没有输出呢?接下来我们就来研究研究。

三、日志级别 

  ALL   各级包括自定义级别
  TRACE   指定细粒度比DEBUG更低的信息事件
  DEBUG  指定细粒度信息事件是最有用的应用程序调试
  INFO   指定能够突出在粗粒度级别的应用程序运行情况的信息的消息
  WARN   指定具有潜在危害的情况
  ERROR    错误事件可能仍然允许应用程序继续运行
  FATAL   指定非常严重的错误事件,这可能导致应用程序中止
  OFF   这是最高等级,为了关闭日志记录

  级别大小顺序:ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF

四、配置文件详解

Log4J的配置文件(Configuration File)就是用来设置记录器的级别、存放器和布局的,它可接key=value格式的设置或xml格式的设置信息。通过配置,可以创建出Log4J的运行环境。

Log4j支持两种配置文件格式,一种是XML(标准通用标记语言下的一个应用)格式的文件,一种是Java特性文件log4j.properties(键=值)。

下面将介绍使用log4j.properties文件作为配置文件的方法:

4.1、配置根Logger

  Logger 负责处理日志记录的大部分操作
  其语法为:

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

  其中,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。
  Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。
  比如在这里定义了INFO级别,只有等于及高于这个级别的才进行处理,则应用程序中所有DEBUG级别的日志信息将不被打印出来。
  ALL:打印所有的日志,OFF:关闭所有的日志输出。 appenderName就是指定日志信息输出到哪个地方。可同时指定多个输出目的地。

4.2、配置日志信息输出目的地 Appender

  Appender 负责控制日志记录操作的输出
  其语法为:

log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.optionN = valueN

  这里的appenderName为Appender类的实例,可任意起名。

  4.2.1、Log4j提供的appender有以下几种

  1)org.apache.log4j.ConsoleAppender

     输出到控制台   继承WriterAppender

  2)org.apache.log4j.FileAppender

     输出到文件 继承WriterAppender

  3)org.apache.log4j.DailyRollingFileAppender

     输出到文件(每日一个日志文件) 继承FileAppender

  4)org.apache.log4j.RollingFileAppender

     输出到文件(日志文件达到指定大小后创建新的日志文件,默认10MB)  继承FileAppender

    可通过log4j.appender.R.MaxFileSize=100KB设置文件大小,还可通过log4j.appender.R.MaxBackupIndex=1设置为保存一个备份文件

  5)org.apache.log4j.WriterAppender

    将日志信息以流格式发送到任意指定的地方

  还有很多的Appender:   

  JDBCAppender 输出到数据库
  JMSAppender 输出到JMS服务器
  SMTPAppender 输出到SMTP服务器
  SocketAppender 输出到网络套接字
  SocketHubAppender   
  SyslogAppender
  TelnetAppender
  ............. 

 

  看它的set方法就知道怎么配置了,就可以给它设置相应的选项

  4.2.2、Appender的配置 

  1)输出端共同选项
    Threshold=WARN:指定日志消息的输出最低级别。(这是指定的是appender的日志级别)
    ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出
  2)ConsoleAppender选项

    Target=System.err:默认情况下是:System.out,指定输出控制台
  3)文件输出端共同选项
    File=mylog.txt:指定消息输出到mylog.txt文件。
    Append=false:默认值是true,
    即将消息增加到指定文件中,
    false指将消息覆盖指定的文件内容。
  4)DailyRollingFileAppender 选项
    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: 每分钟

  5)RollingFileAppender 选项
    MaxFileSize=100KB:
    后缀可以是KB, MB 或者是 GB.
    在日志文件到达该大小时,将会自动滚动,
    即将原来的内容移到mylog.log.1文件。
    MaxBackupIndex=2:
    指定可以产生的滚动文件的最大数。

4.3、配置日志信息的格式(布局)Layout

  Layout 负责格式化Appender的输出

  其语法为:  

log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.optionN = valueN

 

  4.3.1、log4j提供的layout有以下几种 

    org.apache.log4j.htmlLayout(以HTML表格形式布局),
    org.apache.log4j.PatternLayout(可以灵活地指定布局模式),   
    org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),   
    org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)

  4.3.2、org.apache.log4j.PatternLayout

  log4j.appender.stdout.layout.ConversionPattern= [%p] %d{yyyy年M月dd日 HH:mm:ss,SSS} method:%l%m%n
  如果使用pattern布局就要指定的打印信息的具体格式ConversionPattern,具体参数:
    %m 输出代码中指定的消息
    %p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
    %r 输出自应用启动到输出该log信息耗费的毫秒数
    %c 输出所属的类目,通常就是所在类的全名
    %t 输出产生该日志事件的线程名
    %n 输出一个回车换行符,Windows平台为"\\r\\n”,Unix平台为"\\n”
    %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyyy MM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921   %l 输出日志事件的发生位置,
      包括类目名、发生的线程,以及在代码中的行数。
    %x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
    %%: 输出一个”%”字符
    %F: 输出日志消息产生时所在的文件名称
    %M: 输出执行方法
    %L: 输出代码中的行号
  可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
    1) c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
    2)%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,”-”号指定左对齐。
    3)%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
    4) .30c:如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边交远销出的字符截掉。
      [APPName]是log信息的开头,可以为任意字符,一般为项目简称。

五、程序中使用log4j

5.1、加载配置文件 

DOMConfigurator.configure("conf/log4j.xml");
PropertyConfigurator.configure("conf/log4j.properties");

 

  加载顺序:  

    1)加载本工程中src下的配置文件(xml,properties)。名字不能改变,不然就不能自动加载了
    2)加载jar 包中的配置文件(jar包中一般没有配置文件)
    3)加载系统类路径的配置文件

5.2、获取Logger

获取根logger
Logger logger = Logger.getRootLogger();

Logger logger = Logger.getLogger()
Logger logger = LogManager.getLogger()

 

  我们在配置文件中加上,可以自定义logger

#自定义logger可以是一个类名,也可以是一个字符串
#log4j.logger.com.zyh.log4j.TestLog4_0010=INFO,stdout

#这个我们的自定义logger的消息要不要发送给rootLogger
log4j.additivity.definelogger=false

 

5.3、日志信息 

      logger.trace("This is trace message.");// 记录trace级别的信息     
        logger.debug("This is debug message.");   // 记录debug级别的信息        
        logger.info("This is info message."); // 记录info级别的信息        
        logger.warn("This is warn message."); // 记录warn级别的信息  
        logger.error("This is error message.");// 记录error级别的信息         
        logger.fatal("This is fatal message."); // 记录fatal级别的信息      

 

5.4、获取message的详细过程 

  1)logger.info(message);
  2)logger对象会把message封装成loggingEvent(封装了很多东西)
  3)按照配置(logger的日志级别)进行过滤
  4)把剩下的日志信息交给appender
  5)按照配置(appender的日志级别)进行过滤
  6)如果需要layout的话,把日志交给layout进行格式化
  7)输出到相应的位置

六、log4j进阶之自定义appender

6.1、步骤详解

  1)扩展 AppenderSkeleton 抽象类。如果是通过流方式实现读写数据的话,自定义appender可以从WriterAppender继承,
    这样只需要把我们自己的OutputStream连接到WriterAppender.qw上就可以了。更方便快捷。
  2)指定您的 appender 是否需要 layout。这个由requiresLayout()方法确定。
  3)如果某些属性必须同时激活,则应该在 activateOptions() 方法内完成。该方法上在Appender的构造函数之后被调用的。
  4)实现 close() 方法。它必须把 closed 字段的值设置为 true 。记得释放所有资源。
  5)可选地指定要使用的默认 ErrorHandler 对象。系统默认为OnlyOnceErrorHandler,
    它发送出第一个错误的消息并忽略其余的所有错误,错误消息将输出到 System.err。
  6)编写 append() 方法的代码。这个方法负责附加日志记录事件,并在错误发生时负责调用错误处理程序。
    我们主要的日志记录等处理任务实际上是在该append()方法内完成的。

6.2、实战

  1)TestLog4_0011.java 

package com.zyh.log4j;

import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;

public class TestLog4_0011 {
    public static void main(String[] args) {
        PropertyConfigurator.configure("conf/log4jdefine.properties");
        Logger logger = Logger.getRootLogger();
        logger.info("meinv");
        logger.error("shuaige");
    }
}
TestLog4.java

 

  2)log4jdefine.properties或log4j.xml

log4j.rootLogger = DEBUG,stdout

log4j.appender.stdout = com.zyh.log4j.MyAppender
log4j.appender.stdout.Target = System.err
log4j.appender.stdout.File=logs/definelog.txt
log4j.appender.stdout.Threshold = DEBUG
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%m%n


#这里创建两个MyAppender会出现空指针异常原因在创建第一个的时候out对象并没有创建
#log4j.appender.stdfile = com.zyh.log4j.MyAppender
#log4j.appender.stdfile.File=logs/definelog.txt
#log4j.appender.stdfile.Threshold = DEBUG
#log4j.appender.stdfile.layout = org.apache.log4j.PatternLayout
#log4j.appender.stdfile.layout.ConversionPattern = [%p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%m%n
logLog4.properties

 

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration>
<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d{yyyy-MM-dd hh:mm:ss}:%p %t %c - %m%n"/>
</layout>
</appender>
<appender name="RollingFileAppender" class="org.apache.log4j.RollingFileAppender">
<param name="Append" value="true"/>
<param name="File" value="logs/xml.log"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d{yyyy-MM-dd hh:mm:ss}:%p %t %c - %m%n"/>
</layout>
</appender>
<!-- 
<appender name="JDBCAppender" class="org.apache.log4j.jdbc.JDBCAppender">
<param name="URL" value="jdbc:oracle:thin:@127.0.0.1:1521:mumu"/>
<param name="user" value="liulibo"/> 
<param name="password" value="liulibo"/> 
<param name="driver" value="oracle.jdbc.driver.OracleDriver"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="insert into log4j(createdate,thread,level_,class,message) values(\\\'%d\\\',\\\'%t\\\',\\\'%-5p\\\',\\\'%c\\\',\\\'%m\\\')"/>
</layout>
</appender>
 -->
<root>
<priority value ="debug" />
<appender-ref ref="ConsoleAppender"/>
<appender-ref ref="RollingFileAppender"/>
<!--   <appender-ref ref="JDBCAppender"/> -->
</root>
</log4j:configuration>
log4j.xml 

 3)MyAppender.java

package com.zyh.log4j;

import org.apache.log4j.AppenderSkeleton;
import org.apache.log4j.spi.LoggingEvent;

import java.io.*;

/**
 * Created by Shinelon on 2017-9-26.
 */
public class MyAppender extends AppenderSkeleton {
    private OutputStream target;
    private OutputStream out;


    @Override
    protected void append(LoggingEvent loggingEvent) {
        String log = "zyh----"+getLayout().format(loggingEvent);
        try {
            byte[] bytes = log.getBytes();
            target.write(bytes);
            out.write(bytes);
            target.flush();
            out.flush();
        } catch (IOException e) {
            e.printStackTrace();
        }

    }

    public void setTarget(String target) {
        if (target.equals("System.out")){
            this.target = System.out;
        }else if(target.equals("System.err")){
            this.target = System.err;
        }
    }

    public void setFile(String path) {
        System.out.println(path);
       /* File f = new File(path);
        if(f.exists()){
            if (f.isDirectory()){
                path=path+"/definelog.log";
            }else {
                int i = path.lastIndexOf("/");
                String dir = path.substring(i);
                File df = new File(dir);
                df.mkdirs();
            }
        }*/
        try {
            out = new FileOutputStream(path);
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        }
    }


    @Override
    public void close() {
        closed = true;
        //这里我们不能关闭流,因为这样只会输出一条日志
//        try {
//            target.close();
//        } catch (IOException e) {
//            e.printStackTrace();
//        }
    }

    @Override
    public boolean requiresLayout() {
        return true;
    }
}
MyAppender

 

七、log4j 与 log4j 2 的不同

依赖包:
log4j: log4j-1.2.17.jar
log4j 2: log4j-api-2.9.0.jar、log4j-core-2.9.0.jar

配置文件:
log4j: 采用properties的文件作为主配置文件,(xml也可以)
log4j 2: 采用xml,json或者jsn这种文件作为主配置文件

默认配置文件:
log4j的配置文件名是log4j.xml或者是log4j.properties,
log4j2的配置文件名是log4j2.xml

使用:
log4j:
import org.apache.log4j.Logger;
private final Logger LOGGER = Logger.getLogger(Test.class.getName());

import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
private static Logger logger = LogManager.getLogger(Test.class.getName());

     

 

以上是关于细说log4j的主要内容,如果未能解决你的问题,请参考以下文章

Spring Boot 之日志记录

细说JavaScript的函数

细说枚举

细说枚举

用代码来细说Csrf漏洞危害以及防御

细说冒泡排序及其五种优化算法