log4j学习之道:Log4j自定义Appender介绍

原创 2013年12月02日 15:50:32
最初想要在执行一段业务逻辑的时候调用一个外部接口记录审计信息,一直找不到一个比较优雅的方式,经过讨论觉得log4j自定义的appender或许可以实现此功能。后来就了解了一下log4j的这部分。

Apache Log4j 架构

Apache Log4j是当前在J2EE和J2SE开发中用得最多的日志框架(几乎所有项目都用它),因为它具有出色的性能、灵活的配置以及丰富的功能,并且在业务有特殊的要求时,可以使用自定义组件来代替框架中已有的组件来满足要求。

log4j组件介绍
Log4j主要有三个组件:
     
  • Logger:负责供客户端代码调用,执行debug(Object msg)、info(Object msg)、warn(Object msg)、error(Object msg)等方法。
  • Appender:负责日志的输出,Log4j已经实现了多种不同目标的输出方式,可以向文件输出日志、向控制台输出日志、向Socket输出日志等。
  • Layout:负责日志信息的格式化。


Logger 层级介绍
Logger的层级是logger名字指定的,如x.y 表示两层,x层和y层,x是y的父层级,x.y所在层级是y层级

log4j.additivity.* = false : 表示当前logger不需要打到父层级所指定的appender,只打到当前的appender;
      默认true:表示当前logger将打印日志到当前的appender及所有的父层级所指定的appender



Layout有多种
最常用且最灵活的输出格式是: org.apache.log4j.PatternLayout
可以用以下的各项进行组合配置:
  • %c   logger名字空间的全称,如果加上{<层数>}表示列出从最内层算起的指定层数的名字空间。
  • %C  调用logger的类的全名(包含包路径)。
  • %d  日志记录时间,{<日期格式>}使用ISO8601定义的日期格式。
  • %F  调用logger的源文件名。
  • %l    日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。
  • %L   调用logger的代码行 %m   输出消息。
  • %M   调用logger的方法名。
  • %n   当前平台下的换行符。
  • %p   该条日志的优先级。
  • %r   从程序启动时到记录该条日志时已经经过的毫秒数。
  • %t  产生该日志事件的线程名。
  • %x   按NDC(Nested Diagnostic Context,线程堆栈)顺序输出日志。
  • %X   按MDC(Mapped Diagnostic Context,线程映射表)输出日志。通常用于多个客户端连接同一台服务器,方便服务器区分是那个客户端访问留下来的日志。
  • %%   显示一个百分号。)


执行顺序及关系
调用Log4j输出日志时,调用各个组件的顺序:
  • 1、日志信息传入 Logger。
  • 2、将日志信息封装成 LoggingEvent 对象并传入 Appender。
  • 3、在 Appender 中调用 Filter 对日志信息进行过滤,调用 Layout 对日志信息进行格式化,然后输出。


图示:



实现自定义log4j Appender
明白了log4j的结构关系实现自定义的log4j appender就迎刃而解了
继承log4j公共的基类:AppenderSkeleton
打印日志核心方法:abstract protected void append(LoggingEvent event);
初始化加载资源:public void activateOptions(),默认实现为空
释放资源:public void close()
是否需要按格式输出文本:public boolean requiresLayout()
正常情况下我们只需要覆盖append方法即可。然后就可以在log4j中使用了

demo代码:

Java代码  收藏代码
  1. import org.apache.log4j.AppenderSkeleton;  
  2. import org.apache.log4j.spi.LoggingEvent;  
  3.   
  4. public class HelloAppender extends AppenderSkeleton {  
  5.   
  6.     private String account ;  
  7.       
  8.     @Override  
  9.     protected void append(LoggingEvent event) {  
  10.         System.out.println("Hello, " + account + " : "+ event.getMessage());  
  11.     }  
  12.   
  13.     @Override  
  14.     public void close() {  
  15.         // TODO Auto-generated method stub  
  16.   
  17.     }  
  18.   
  19.     @Override  
  20.     public boolean requiresLayout() {  
  21.         // TODO Auto-generated method stub  
  22.         return false;  
  23.     }  
  24.   
  25.     public String getAccount() {  
  26.         return account;  
  27.     }  
  28.   
  29.     public void setAccount(String account) {  
  30.         this.account = account;  
  31.     }  
  32. }  


Java代码  收藏代码
  1. public static void main(String[] args) {  
  2.     Log log = LogFactory.getLog("helloLog") ;  
  3.     log.info("I am ready.") ;  
  4. }  



引用
log4j.properties 配置
log4j.logger.helloLog=INFO, hello

log4j.appender.hello=HelloAppender
log4j.appender.hello.account=World


执行main函数,输出结果
Hello, World : I am ready.

相关文章推荐

Log4j的进阶使用-自定义类和+自定义输出日志类型+输出文件

自定义java类 package com.sitech.nbc.util; import java.io.ByteArrayOutputStream; import java.io.PrintWr...

java应用程序自定义log4j配置文件位置

使用log4j很方便:1、添加依赖的log4j-1.2.8.jar包;2、增加log4j.properties配置文件,但这个配置文件应该放在哪个目录下比较合适,今天来讨论下:如何自定义配置文件的存放...

用java编程方式实现logback和log4j的自定义格式日志

近期有个项目需求打印"yyyyMMdd.log"的日志,以方便flume进行日志收集,查看了官方文档http://logback.qos.ch/manual/layouts.html,下面是简单的实现...

Log4j自定义Appender

1.    概述     在强调可重用组件开发的今天,除了自己从头到尾开发一个可重用的日志操作类外,Apache为我们提供了一个强有力的日志操作包-Log4j。      Log4j是Apache...

Log4j2 自定义 Appender

虽然log4j2 自带了很多种Appender 但是有时候避免不了不是自己想要的,这时候我们就需要自定义Appender,使日志输出到我们指定的位置,废话少说,上菜!   package com.hb...

Log4j2自定义Appender注意事项

虽然log4j2自带了很多种Appender,但是有时候需要自定义Appender来满足业务需求。例如log4j2就没有为Scribe添加appender。        Appender的自定义其...

log4j2自定义Appender(输出到文件/RPC服务中)

声明:原创文章,转载请注明出处。http://www.jianshu.com/u/e02df63eaa87 1、背景 虽然log4j很强大,可以将日志输出到文件、DB、ES等。但是有时候确难免完全...

Log4j自定义Appender介绍

最初想要在执行一段业务逻辑的时候调用一个外部接口记录审计信息,一直找不到一个比较优雅的方式,经过讨论觉得log4j自定义的appender或许可以实现此功能。后来就了解了一下log4j的这部分。  ...

Log4j之自定义Appender

log4j.properties log4j.rootLogger=debug,myFileAppender ##自定义的appender log4j.appender.myFileAp...

史上最详细的Log4j配置

Log4J的配置文件(Configuration File)就是用来设置记录器的级别、存放器和布局的,它可接key=value格式的设置或xml格式的设置信息。通过配置,可以创建出Log4J的运行环境...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:log4j学习之道:Log4j自定义Appender介绍
举报原因:
原因补充:

(最多只允许输入30个字)