处理日志是任何一个产品级的程序都需要仔细处理的模块。在Java中，我们经常使用的是log4j就是一个日志框架。在clojure里，同样有一套日志框架——clojure.tools.logging，它不仅提供了常用的日志输出功能，还屏蔽了Java各种日志框架之间的差异，如slf4j,commons-logging,log4j,java.util.logging等，让你可以透明地使用这些框架来处理日志。
名称：clojure.tools.logging
主页：
https://github.com/clojure/tools.logging
依赖：
[org.clojure/tools.logging "0.2.3"]
<
dependency
>
<
groupId
>
org.clojure
</
groupId
>
<
artifactId
>
tools.logging
</
artifactId
>
<
version
>
0.2.3
</
version
>
</
dependency
>
使用：
(ns example.core (:use [clojure.tools.logging :only (info error)])) (defn divide [x y] (try (info "dividing" x "by" y) (/ x y) (catch Exception ex (error ex "There was an error in calculation"))))
常用宏和方法：
1.除了上面例子的info和error宏，还可以包括warn,trace,debug,fatal等常用宏，分别对应相应的日志级别。这些方法会自动判断当前logger的级别是否有效，有效的前提下才会输出日志。也就是说在Java里，你经常需要这样：
if
(logger.isDebugEnabled()) { logger.debug(x
+
"
plus
"
+
y
+
"
is
"
+
(x
+
y)); }
在使用 tools.logging的时候是不需要的，因为这些宏帮你做了这个判断。另外，我们在使用log4j的时候需要指定log的namespace，在tools.logging里不需要，默认会取当前的namespace也就是*ns*。
最后，info还有个infof的方法，用于输出格式化日志：
(infof
"
%s is %d years old
"
"
kid
"
3
)
日志输出：
2012
-
02
-
12
20
:
23
:
07
,
394
INFO log: kid is
3
years old
其他方法也有类似的如warnf,debugf等。
2.spy宏，同时输出表达式的form和结果，例如
（spy (
+
1
2
))
输出日志
2012
-
02
-
12
20
:
11
:
47
,
415
DEBUG log: (
+
1
2
)
=>
3
3.with-logs宏可以在将*out*和*err*流重定向到日志的情况下求值表达式，例如：
(with
-
logs
*
ns
*
(prn
"
hello world
"
))
输出日志：
2012
-
02
-
12
20
:
17
:
32
,
592
INFO log:
"
hello world
"
with-logs需要明确指定log-ns，默认out的输出级别是info，而err的级别是error，可以指定输出级别(with-logs [*ns* :info :error] ......)
4.事务中（dosync中）的日志输出，tools.logging做了特殊处理，默认情况下当且仅当事务成功提交的时候并且日志级别是warn或者info会通过agent异步写入日志。tools.logging定义了一个全局的agent——*logging-agent*。当判断当前是在事务中调用log宏，并且日志级别在集合*tx-agent-levels*内，就会在事务提交成功的时候将日志发送给*logging-agent*异步处理。可以通过*tx-agent-levels*改变使用agent输出日志的级别范围，默认是#{:info :warn}。还可以通过改变*force*变量来强制使用direct或者agent的方式输出日志,*force*可以为:agent或者:direct。
(binding [
*
force
*
:agent] (log :info
"
hello world
"
))
这里特别使用了log宏，需要明确指定日志级别为info。
5.默认日志框架的是从classpath查找的，查找的顺序是sl4j,commons-logging,log4j,java.util.logging，找到哪个可用就用哪个。如果你的classpath里存在多个日志框架，如同时存在sl4j和commons-logging，那么如果你希望强制使用commons-logging，可以通过改变*logger-factory*变量来使用：
(ns example (:use [clojure.tools.logging.impl :only [cl
-
factory]])) (binding [
*
logger
-
factory
*
(cl
-
factory)] (info
"
hello world
"
))
*logger-factory*是dynamic变量，可以通过binding改变（前面提到的*force*等变量也一样），如果不希望每次都用binding，而是全局改变，则需要特殊处理：
(alter
-
var
-
root (var
*
logger
-
factory
*
) (constantly (cl
-
factory)))
其他logger factory还包括slf4j-factory,log4j-factory,jul-factory。 6.每个日志框架的配置跟使用java没有什么两样，比如你用log4j，就需要在classpath下放置一个log4j.properties等。如果你希望用编程的方式配置，可以使用clj-logging-config。
文章转自庄周梦蝶 ，原文发布时间2012-02-12
相关资源：datasplash：Clojure API，可提供更动态的Google Dataflow-源码
