Log4j 随笔

时间:2023-11-10 09:28:02

对于一个Java开发者而言,Log4j是我们的好朋友了。话说到这里,需要自我检讨一下,这么久以来,凡是用到Log4j的地方,相关的配置文件都是直接拷贝过去,从来都没仔细看过。But thanks God,在刚刚的项目中,因为一些特殊的需求,有机会好好看了一下log4j,说来惭愧。

目录

1、Appenders

2、Layouts

3、Odds and ends

一、Appenders

Appenders是指log4j中所有继承自Appender接口的类。他们一起定义了log4j需要把日志写到哪些地方,控制台?数据库或者是文件系统。他们的家族挺简单:

Log4j 随笔

与其他大型开源项目相比,Log4j的Appender可谓简洁明了。有一个抽象类AppenderSkeleton实现了Appender的大致骨架,然后众多的具体的Appender都继承自这个AppenderSkeleton. 目前为止,笔者用过的Appender也就ConsoleAppender/RollingFileAppender/SMTPAppender.

需要用到的Appender都可以配置在log4j.properties中,e.g.

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

注意,Appender的配置需要以log4j.appender开头,后面紧接着的是这个Appender的对象的名称,在上面的配置中,名称为stdout. 然后就是配置实现类,配置相关参数等等。

Log4j的这样的Appender架构,也很方便我们来扩展log4j,比如我们需要把log写入到solr或者其他nosql中去,扩展Appender会是一个很好的方法。

package com.mzule.log.solr.appender;

import org.apache.log4j.AppenderSkeleton;
import org.apache.log4j.spi.LoggingEvent; public class SolrAppender extends AppenderSkeleton { @Override
public void close() { } @Override
public boolean requiresLayout() {
return false;
} @Override
protected void append(LoggingEvent event) { } }

上面是一个自定义的Appender,可以看见,实现Appender也就三个方法:

①close方法,close方法可以用来释放资源,像SolrAppender这样不需要善后的可以直接留空。

②requiresLayout方法,requiresLayout方法标注该Appender是否需要设置layout属性,如果返回true的话,在log4j.properties中配置该appender时,就必须要提供一种layout的实现(见下文)。

③appender方法,appender方法就是进行log的核心代码了,在这儿new一个SolrServer然后add日志记录,最后commit就ok.

是不是so easy?

在coding Appender的时候,肯定会希望能够读取log4j.properties的一些参数。就像SMTPAppender需要在log4j.properties中配置to,from,smtphost等等一样。

其实很简单,对于简单的字符串数据,可以直接在Appender中定义,然后提供setters方法。再用相同的名称在log4j.properties中配置相应的值即可。

比如说在SolrAppender中,我需要一个host地址,可以这样做:

public class SolrAppender extends AppenderSkeleton {

	protected String host;

	...

	public void setHost(String host) {
this.host = host;
} }

然后在log4j.properties配置host的值:

# Direct log messages to Solr
log4j.appender.solr=package.to.SolrAppender
log4j.appender.solr.host=http://localhost:8080/everylog/core

这样,在SolrAppender中就可以直接使用host变量了。

二、Layouts

Layout就是log4j.properties中的log4j.appender.stdout.layout=org.apache.log4j.PatternLayout配置,此处为PatternLayout,

Log4j 随笔

此外,并不是所有的Appender都需要layout的,比如SocketAppender就不需要layout.

三、Odds and ends

Q: 在配置Appender的时候,我怎么知道它有哪些属性可以配置的?

A: 谷歌之,或者看相应Appender的源码,源码里面的setters方法都是可以作为属性设置的。Log4j会调用PropertySetter进行赋值。