處理日志是任何一個(gè)產(chǎn)品級(jí)的程序都需要仔細(xì)處理的模塊。在Java中,我們經(jīng)常使用的是log4j就是一個(gè)日志框架。在clojure里,同樣有一套日志框架——clojure.tools.logging,它不僅提供了常用的日志輸出功能,還屏蔽了Java各種日志框架之間的差異,如slf4j,commons-logging,log4j,java.util.logging等,讓你可以透明地使用這些框架來(lái)處理日志。
名稱:clojure.tools.logging
主頁(yè):
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等常用宏,分別對(duì)應(yīng)相應(yīng)的日志級(jí)別。這些方法會(huì)自動(dòng)判斷當(dāng)前l(fā)ogger的級(jí)別是否有效,有效的前提下才會(huì)輸出日志。也就是說(shuō)在Java里,你經(jīng)常需要這樣:
if (logger.isDebugEnabled()) {
logger.debug(x + " plus " + y + " is " + (x + y));
}
在使用 tools.logging的時(shí)候是不需要的,因?yàn)檫@些宏幫你做了這個(gè)判斷。另外,我們?cè)谑褂胠og4j的時(shí)候需要指定log的namespace,在tools.logging里不需要,默認(rèn)會(huì)取當(dāng)前的namespace也就是*ns*。
最后,info還有個(gè)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宏,同時(shí)輸出表達(dá)式的form和結(jié)果,例如
(spy (+1 2))
輸出日志
2012-02-12 20:11:47,415 DEBUG log: (+ 1 2)
=> 3
3.with-logs宏可以在將*out*和*err*流重定向到日志的情況下求值表達(dá)式,例如:
(with-logs *ns* (prn "hello world"))
輸出日志:
2012-02-12 20:17:32,592 INFO log: "hello world"
with-logs需要明確指定log-ns,默認(rèn)out的輸出級(jí)別是info,而err的級(jí)別是error,可以指定輸出級(jí)別(with-logs [*ns* :info :error] ......)
4.事務(wù)中(dosync中)的日志輸出,tools.logging做了特殊處理,默認(rèn)情況下當(dāng)且僅當(dāng)事務(wù)成功提交的時(shí)候并且日志級(jí)別是warn或者info會(huì)通過(guò)agent異步寫入日志。tools.logging定義了一個(gè)全局的agent——*logging-agent*。當(dāng)判斷當(dāng)前是在事務(wù)中調(diào)用log宏,并且日志級(jí)別在集合*tx-agent-levels*內(nèi),就會(huì)在事務(wù)提交成功的時(shí)候?qū)⑷罩景l(fā)送給*logging-agent*異步處理。可以通過(guò)*tx-agent-levels*改變使用agent輸出日志的級(jí)別范圍,默認(rèn)是#{:info :warn}。還可以通過(guò)改變*force*變量來(lái)強(qiáng)制使用direct或者agent的方式輸出日志,*force*可以為:agent或者:direct。
(binding [*force* :agent]
(log :info "hello world"))
這里特別使用了log宏,需要明確指定日志級(jí)別為info。
5.默認(rèn)日志框架的是從classpath查找的,查找的順序是sl4j,commons-logging,log4j,java.util.logging,找到哪個(gè)可用就用哪個(gè)。如果你的classpath里存在多個(gè)日志框架,如同時(shí)存在sl4j和commons-logging,那么如果你希望強(qiáng)制使用commons-logging,可以通過(guò)改變*logger-factory*變量來(lái)使用:
(ns example
(:use [clojure.tools.logging.impl :only [cl-factory]]))
(binding [*logger-factory* (cl-factory)]
(info "hello world"))
*logger-factory*是dynamic變量,可以通過(guò)binding改變(前面提到的*force*等變量也一樣),如果不希望每次都用binding,而是全局改變,則需要特殊處理:
(alter-var-root (var *logger-factory*) (constantly (cl-factory)))
其他logger factory還包括slf4j-factory,log4j-factory,jul-factory。
6.每個(gè)日志框架的配置跟使用java沒(méi)有什么兩樣,比如你用log4j,就需要在classpath下放置一個(gè)log4j.properties等。如果你希望用編程的方式配置,可以使用
clj-logging-config。
轉(zhuǎn)載請(qǐng)注明出處:
http://m.tkk7.com/killme2008/archive/2012/02/12/369822.html