让System.out.println回家种田,换句话说,就是该干嘛干嘛去。
您可能在想: System.out.println几乎在每个Java程序里都有那么几行,如何让他老人家回家种田呢? 我们怎么能少了这么重要的革命同志呢?
doodoofish这里要说的是"该干嘛干嘛去",不是System.out.println管的就别让他管。想想,我们用System.out.println (文中称SOP,不是Service Oriented Programming,是System.out.println) 主要在三种情况下:
一、输出文本到stdout,作为输出结果;
二、显示调试信息,用来Debug;
三、显示信息,让管理员观赏
第一种情况,没得说,是SOP的老本行,不服不行。让他就继续干吧。
第二、三种情况,就不该SOP管,让他管也管不好。如果我调试用SOP来显示信息,一旦哪天我决定不要显示这些烦人的东西了,怎么办? 好办啊,一个文件一个文件找,一行一行找,把SOP给Comment起来不就完了,多方便啊。可是哪天我又要显示这些调试信息了,又怎么办? 第二天我又不要了,下个月我又要了... ... 我们程序员闲得慌吗? 可有人就是认为我们很闲,你的老板可能就是一个。我的朋友5bug是个天才,他说有办法,就是每个SOP前加一个 if 来判断是否显示。天才啊!
我比较笨,比郭靖还笨。我就没想到这个法子,一直没想出来,直到上10个星期,看到一篇介绍Log4J的文章。一开始看不懂 (我比较笨) ,倒过来看一遍总算懂了。
说起来又是一个类库,在http://logging.apache.org/site/binindex.cgi这里下载。然后就把那个log4j1.2.8.jar从"dist/lib"目录下copy到我的项目LogTest的"lib"目录下 (真烦,copy文件是很烦人的操作,需要一定的技术)。然后,我就写了个简单的class (复杂的我不会写) 来调用log4j的东东。
import org.apache.log4j.*;
public class LogTest {
static Logger logger = Logger.getLogger(LogTest.class.getName());
public static void main(String[] args) {
logger.debug("Debug ...");
logger.info("Info ...");
logger.warn("Warn ...");
logger.error("Error ...");
}
}
没什么新鲜,就是个Logger。那"static Logger logger = Logger.getLogger(LogTest.class.getName());" 就是创建一个属於LogTest类的Logger对象,创建时要告知Logger你当前的Class是什么,所以就有了"LogTest.class.getName()"这奇怪的东东。
logger.debug就是输出debug的信息
logger.info就是输出提示信息
logger.warn就是显示警告信息
logger.error就是显示错误信息
log是什么? Log是个很深奥的古希腊名词,不贬义,也不褒义。说简单了,就是"日志",就是你要写什么就写什么,要写哪里就是哪里。不同与SOP,log4j可以让你把要写的东西分成4级 (其实有更多级,你可以自己定义,比如叫: 三级++),这些级别叫优先权 (Priority),这里四个优先权就是debug, info, warn, 和error,优先权从低到高,log4j能让你控制显示哪些优先权的信息。log4j也让你要写哪就哪,可以是屏幕,可以是一个文件,甚至是一个Email,一个XML,一个Socket,等等。这些控制都在一个小文件里,叫log4j.properties (其实你可以用其它名字,这里是默认名)。这个文件在工程目录下。以下是log4j.properties的内容:
#### Use one appender to log to console
log4j.rootCategory=DEBUG, stdout
#### Appender writes to console
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p (%F:%L) - %m%n
就是说我要显示所有优先权等於和高于Debug的信息,所以上面那个Class会显示Debug ...,Info ...,Warn ...,Error ...所有信息。
"stdout"表示我定义了一个输出端,叫stdout (随便什么名字都好)。
下面的三行说,这个stdout输出端其实是标准输出Console,也就是屏幕。输出的格式是Pattern。转换方式是%5p (%F:%L) - %m%n,即前五格用来显示优先权,再显示当前的文件名,加当前的行数。最后是logger.debug()或logger.info()或logger.warn()或logger.error()里的信息。%n表示回车空行。
运行程序,最后输出的是:
DEBUG (LogTest.java:9) - Debug ...
INFO (LogTest.java:10) - Info ...
WARN (LogTest.java:11) - Warn ...
ERROR (LogTest.java:12) - Error ...
搞了半天,最后就输出这么个东西? 对啊。有人就说了,"还不如System.out.println呢"。不过你看看,你做了些什么。
一、下载了log4j,copy类库到工程的lib目录
二、写一个log4j.properties文件 (4行)
三、在Class里加了"static Logger logger = Logger.getLogger(LogTest.class.getName());"一句话
四、用logger.xxx来输出信息。
完了。你得到的若干好处是:
一、在log4j.properties文件里把"log4j.rootCategory=DEBUG, stdout"改写成"log4j.rootCategory=OFF, stdout",这样所有的log信息都不会显示了;
二、在log4j.properties文件里把"log4j.rootCategory=DEBUG, stdout"改写成"log4j.rootCategory=INFO, stdout",这样只显示INFO, WARN, ERROR的log信息,而DEBUG信息不会被显示;
三、在log4j.properties文件里把"log4j.rootCategory=DEBUG, stdout"改写成"log4j.rootCategory=DEBUG, stdout, R",再加上下面三句话:
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=log.txt
log4j.appender.R.MaxFileSize=100KB
log4j.appender.R.MaxBackupIndex=1
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy MMM dd HH:mm:ss} %-5p %c - %m%n
这样,你的log信息不光显示在屏幕上,而且将被保存在一个叫"log.txt"的文件里,文件最大为100KB。如果文件大小超过100KB,文件会被备份成"log.txt.1",新的"log.txt"继续记录log信息。
你可以改变log4j.properties,而不需重新编译就可以控制log信息是否显示、log信息的输出端类型、输出方式、输出格式,等等。你上面的四步工作带来这么多好处,我还要System.out.println来显示log信息吗? 不需要了。
以下是我LogTest项目的目录结构:
build.xml文件的内容:
<project name="Log4j Test" default="build" basedir=".">
<property name="app.home" value="${basedir}" />
<property name="app.src" value="${app.home}/src" />
<property name="app.bin" value="${app.home}/bin" />
<property name="app.lib" value="${app.home}/lib" />
<path id="classpath">
<fileset dir="${app.lib}">
<include name="**/*.jar" />
</fileset>
<path location="${app.home}"/>
<path location="${app.bin}"/>
</path>
<target name="init">
<mkdir dir="${app.bin}"/>
</target>
<target name="build" depends="init" description="compile the source " >
<javac srcdir="${app.src}" destdir="${app.bin}">
<classpath refid="classpath"/>
</javac>
</target>
<target name="run" description="run">
<java classname="LogTest" dir="${app.bin}" fork="true">
<classpath refid="classpath"/>
</java>
</target>
<target name="clean" description="clean up" >
<delete dir="${app.bin}" />
</target>
</project>
总共四个文件,一个用来测试的LogTest类,一个build.xml ANT文件,一个log4j.properties配制文件,一个log4j-1.2.8.jar类库。
log4j的功能有很多,doodoofish这里就不详细介绍了,以下是参考文献:
Don't Use System.out.println! Use Log4j by Vipan Singla
Build Flexible Logs With log4j by Vikram Goyal
log4j by Ashley J.S Mills, University Of Birmingham
Add logging to your Java Applications by Kevin Brown
How does the Java logging API stack up against log4j? by Kevin Brown
log4j FAQ at jGuru