在Ant中使用Log4j

断断续续的用Ant已经有不短的时间，以前只是关注它在build过程中所产生的log的内容，例如build是否成功和错误信息等。而今天需要把具体的一条log对应到其输出的代码行上，所以想到如果可以使用log4j则非常的方便。

Google了一下，发现Ant确实具有这一功能，详见：http://ant.apache.org/manual/listeners.html

先把Log4j的jar包丢到$ANT_HOME/lib/中，然后配置了一下log4j.properties，果然就可以用log4j的各种格式输出日志了

使用命令行：ant -listener org.apache.tools.ant.listener.Log4jListener -lib .

不过由于本人学艺不精，在上述网页的Log4jListener一节中，没太明白category具体是个什么概念。天色已晚，准备之后再来补充补充

评论

3 楼 jamaica1982 2011-03-18  

在2楼中，忘记加上参考文献信息了
[1] Ceki Gulcu, The complete log4j Manual, 2002

2 楼 jamaica1982 2011-03-18  

如下摘抄（翻译）一下Log4j手册[1]中描述的PatternLayout的转换字符(conversion character):

字符	作用
c	打印Category；可使用精度描述符；默认是完整打印
C	打印log所在类的全限定名；可使用精度描述符，默认是完整打印
d	打印log的时间；具体格式参见[1]
F	打印log所在文件的文件名
l	打印log调用者的位置信息；通常包含调用者（方法）的全限定名，所在源文件以及行号。生成这些信息通常会产生巨大的运行时开销，慎用
L	打印log在调用者中的行号
m	打印log消息
M	打印log发出者的方法名
n	打印平台相关的换行符
p	打印优先级(priority)
r	打印从程序启动到log发生之间的时间间隔(单位为毫秒）
t	打印log对应的线程名
x	打印与对应线程关联的NDC信息（NDC参见[1]的第7章
X	打印与对应线程关联的MDC信息（MDC参见[1]的第7章
%	使用%%打印单独一个百分号

1 楼 jamaica1982 2011-03-18  

刚才刨了篇00年的文章[1]并对照着Log4j官网的简介[2]看了看，关于Category和Logger的概念可以简略的概括为：
1) 用于使得程序中一部分不打印log，而另一部分照常打印log，即将所有可能输出log的位置（称作logging space）分类(categorize)，所以之前取名为Category。
2) 默认总是存在一个顶层的root Category/Logger，其具有2个特点：
    a. 总是存在
    b. 不能通过名称获取
3）各个Category/Logger自身的log级别可以分别设置，以完成1)中所说的功能。
4）根据其名称，不同的Category/Logger之间可能存在层次关系。在层次之间，log级别默认会发生继承行为。具体细节可参见[2]中的例子，一目了然。

参考文献：
[1] http://www.javaworld.com/javaworld/jw-11-2000/jw-1122-log4j.html
[2] http://logging.apache.org/log4j/1.2/manual.html