log4j日志框架学习


初识Log4j:      log4j有三个部分:           1.loggers 负责捕获日志信息。           2.appenders  负责输出信息到不同的目的地           3.layouts 负责使用不同的样式输出日志   log4j框架中有两种对象:      核心对象:框架的支撑对象,是框架必不可少的组成部分。      支撑对象:这些都是框架可选的对象,用于提供额外重要的工作。 核心对象包括下面几种类型:      logger对象,是最高的层,负责通过不同的风格转化日志信息,他提供给appender对象发布前的信息。(这里的层是指所处的位置)      layout对象,用于提供格式化日志信息的风格,在发布日志信息前,使其变得可读,可重用。      appender对象,这个对象属于底层的对象,它负责发布信息到不同的目的地,比如数据库,文件,控制台,UNIXsyslog等等。 log4j的架构组成图:       支撑对象,它们在log4j中扮演了很关键的角色:      1.level对象:级别对象定义日志的粒度和优先级,有七种级别:OFF,DEBUG,INFO,ERROR,WARN,FATAL,ALL。      2.过滤器对象:用于分析日志信息并决定日志信息是否输出。每个appender对象可以有几个过滤器对象协同工作,当日志信息到达特定的appender时,所有的过滤器会帮助appender在其发布到目的地之前进行过滤操作。      3.对象渲染器:提供一段字符用于识别发送日志的不同对象,这个对象也用于layout对象准备常量信息。      4.日志管理器:用于管理日志框架,它负责从初始化配置中读取信息,这个配置可能是文件配置,也可能是类的配置。   log4j.properties是log4j的配置文件,它采用键值对的方式定义。 默认情况下,logManager对象会在CLASSPATH目录下寻找log4j.properties. 基本的配置如下:  
# Define the root logger with appender X
log4j.rootLogger = DEBUG, X
# Set the appender named X to be a File appender
log4j.appender.X=org.apache.log4j.FileAppender
# Define the layout for X appender
log4j.appender.X.layout=org.apache.log4j.PatternLayout
log4j.appender.X.layout.conversionPattern=%m%n
首先日志的级别为DEBUG,另外添加了一个appender,名字是X 设置appender的名字是X,并且定义该appender的实现为org.apache.log4j.FileAppender,即文件读写方式。 为X设置显示的方式--layout为PatternLayout   log4j提供了多种Appender对象,用输出日志消息到不同的目的地。比如控制台,文件,系统事件日志等等。每个appender对象都有不同的配置属性,这些属性来定义对象的行为。 layout, appender使用layout对象转换日志信息的格式。 target, 目标可能是控制台,文件,也可能是依赖于其他的appender。 level,用于设定过滤日志的级别。 threshhold  appender可以设置阈值,与日志的级别有关。日志会忽略掉所有低于该级别的日志。 filter  过滤器对象能够分析日志信息,然后决定日志请求由某个appender处理还是丢掉。   添加appender的格式如下:      properties格式:log4j.logger.[logger-name]=level,appender1,...appendern      xml格式:
<logger name="com.apress.logging.log4j" additivity="false">     <appender-ref ref="appender1"/>     <appender-ref ref="appender2"/> logger>
 

上面只展示来FileAppender的用法,log4j还有下面的appender以供使用:

  • AppenderSkeleton
  • AysncAppender
  • ConsoleAppender
  • DailyRollingFileAppender
  • ExternallyRolledFileAppender
  • FileAppender
  • JDBCAppender
  • JMSAppender
  • LF5Appender
  • NTEventLogAppender
  • NullAppender
  • RollingFileAppender
  • SMTPAppender
  • SocketAppender
  • SocketHubAppender
  • SyslogAppender
  • TelnetAppender
  • WriterAppender
  Layout:     layout有:
  • DateLayout
  • HTMLLayout
  • PatternLayout
  • SimpleLayout
  • XMLLayout
    第四部分:如何在java中输出日志消息 直接举一个例子: pom.xml:

    log4j
    log4j
    1.2.17
  properties文件:
# Define log file location
log=E:/

# Define the root logger with appender X
log4j.rootLogger = DEBUG, FILE
# Set the appender named X to be a File appender
log4j.appender.FILE=org.apache.log4j.FileAppender

# Define the output file
log4j.appender.FILE.file=${log}/log.out

# Define the layout for X appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n
  DemoTest:
package com.fxb.log;

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

/**
 * @author  方小白  2017-09-04 17:00
 */
public class DemoTest1 {

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

    public static void main(String[] args){

//        PropertyConfigurator.configure("classpath:/log4j.properties");

        logger.error("DemoTest1 -----error");
        logger.info("DemoTest1 -----info");
        logger.debug("DemoTest1 -----debug");
        logger.warn("Demotest1 -----warn");
        logger.trace("DemoTest1 ----trace");
        logger.fatal("DemoTest1 -----fatal");


    }
}
  第五部分:日志输出的方法。 看第四部分中的代码。 日志类提供了很多方法处理日志活动,它不允许我们自己实例化一个logger,但是提供给我们两种静态方法,获得logger对象。 public static Logger getRootLogger(); public static Logger getLogger(String name); d第一种方法返回应用实例的根Logger,它没有名字。 第二种方法通过名字获得日志对象Logger,类的名字是你传递的class的名字,通常是一个class的类名或者包名。 例如:static Logger logger = Logger.getLogger(XX.class.getName());   Logger类拥有下面几种打印日志的方法: public void debug(Object message); 输出debug级别的错误。 public void error(Object message); 输出error级别的错误。 public void fatal(Object message); 输出fatal级别的错误。 public void info(Object message); 输出info级别的错误 public void warn(Object message); 输出warn级别的错误 public void trace(Object message); 输出trace级别的错误。   第六部分,日志的级别:      ALL 所有日志的级别都包括。      DEBUG  指定的信息事件的粒度是DEBUG,在调试应用的时候会有帮助。      ERROR  指定错误事件,并且这些事件还会保证应用继续运行。      FATAL  指定严重的错误事件,该事件会导致应用暂停。      INFO  指定信息消息,强调应用粗粒度的运行情况。      OFF  最高等级,相当于关闭了日志。      TRACE  指定比DEBUG更粗粒度的调试日志。      WARN  输出具有潜在风险的信息。 日志标准的排序是:      ALL   第七部分:日志格式化      log4j 提供了各种的layout对象,然后根据自己指定的Layout对象,转化日志信息。通常来说都是应用量身定制的layout对象转换信息格式。      所有的layout对象从Appender对象中接收一个LoggingEvent对象,然后通过loggingEvent对象解析信息,在通过合适的ObjectRenderer获得相应的字符串。      org.apache.log4j.Layout是log4jAPI中layout的抽象基类。log4j提供了其实现类DateLayout,HTMLLayout,PatternLayout,SimpleLayout,XMLLayout。      Layout中的方法:      这个类为所有的一般操作提提供了基本的框架,以及两个抽象方法。 public abstract boolean ingnoresThrowable(),它声明是否把java.lang.Throwable.object当做日志输出的一部分,如果layout处理这个异常对象,那么久不会忽略这个消息,反之就会忽略。 public abstract String format(LoggingEvent event) 个人自定义的layout装换格式: 除了,抽象方法,layout类也提供了一系列的接口: public String getContentType(); 返回layout的类型,基类返回的是text/plain默认的文本类型。 public String getFooter(); 获取日志信息的尾部 public String getHeader();  获取日志信息的头部   第八部分,文件输出 在第四部分中,展示了文件输出,接下来详细的说一个文件输出。 使用org.apache.log4j.FileAppender可以把日志写入文件中。 FileAppender配置:      immediateFlush 这个标志默认为true,是否每次有消息都自动flush文件中。      encoding 字符编码      threshold  appender的阈值threshold      fileName 日志的名称      fileAppend 默认设置为true,所有的日志都输出到相同的文件。      bufferedIO  是否启动缓冲区,默认为false      bufferedSize 如果启用了缓冲区,设置缓冲区的大小,默认是8k   多文件输出--日志轮转      在第四部分的properites设置的基础上。添加:      maxFileSize  设置日志大小的阈值,默认是10MB      maxBackupIndex   设置的文件会被备份的数目,默认为1 多文件输出---日期轮转      在第四部分properties设置的基础上添加:      DatePattern,声明命名规则,默认是每天的半夜24点更新一次。      其他格式:           '.'yyyy-MM 每个月的开始时候更新一次。           '.'yyyy-MM-dd 每天半夜24点的时候更新           '.'yyyy-MM-dd-a 每天半夜24点的时候更新           '.'yyyy-MM-dd-HH  每个小时更新一次           '.'yyyy-MM-dd-HH-mm  每分钟更新一次           '.'yyyy-ww 每周的第一天更新   第九部分:输出到数据库中:      log4j提供了org.apache.log4j.JDBCAppender对象,可以把日志输出到特定的数据库中       常用的属性:      bufferSize 设置buffer的大小,默认是1      driver  设置数据库的驱动字符串,比如:com.mysql.jdbc.Driver      layout  设置使用的layout,默认是org.apache.log4j.PatternLayout      password 设置数据库的密码      sql  设置每次日志产生的时候执行的sql语句,可以是insert,update,detele      url   是指数据库的url      user 设置数据库的用户名   示例:

log4j.appender.DB=org.apache.log4j.jdbc.JDBCAppender

log4j.appender.DB.URL=jdbc:mysql://localhost/DBNAME

log4j.appender.DB.driver=com.mysql.jdbc.Driver

log4j.appender.DB.user=user_name

log4j.appender.DB.password=password

log4j.appender.DB.sql=INSERT INTO LOGS VALUES('%x','%d','%C','%p','%m')

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