一、简介
在程序中输出信息的目的有三：一是监视程序运行情况；一是将程序的运行情况记录到日志文件中，以备将来查看；一是做为调试器。但信息输出的手段不仅限于System.out.println()或System.out.print()，还有日志记录工具可以选择。与System.out.pringln()和System.out.print()相比，日志记录工具可以控制输出级别，并且可以在配置文件中对输出级别进行设置，这样开发阶段的信息在程序发布后就可以通过设置输出级别来消除掉，而无须对代码进行修正了。现在流行的日志记录工具很多，Log4J就是其中的佼佼者。
Log4J是由著名开源组织Apache推出的一款日志记录工具，供Java编码人员做日志输出之用，可以从网站http://logging.apache.org/log4j上免费获得，最新版本1.2.11。获得logging-log4j-1.2.11.zip文件后，解压缩，需要的是其中的log4j- 1.2.11.jar文件，将该文件放到特定的文件夹中备用，我放到了我机器的G:\\YPJCCK\\Log4J\\lib文件夹中。
这里选择的 IDE是Eclipse和JBuilder。Eclipse用的是3.0.1加语言包，可以到www.eclipse.org网站上下载；JBuilder用的是 JBuilder 2005。 二、配置类库
下面打开Eclipse或JBuilder。
如果使用的是Eclipse，那么在Eclipse打开后，点击菜单\文件\新建\项目\，打开\新建项目\对话框：
请选中\项目\，点击\下一步\，进入\新建Java项目\对话框：
在这个对话框中需要设置项目的名称以及项目所在目录，我为自己的项目起名为Log4JTest，目录为 G:\\YPJCCK\\Log4J\\Eclipse\\Log4JTest。设置好后点击\下一步\，进入下一个窗口。在这个窗口中选择名为\库\的选项卡，然后点击\添加外部JAR\按钮，将保存于特定文件夹中的log4j-1.2.11.jar文件引用进来。
设置好后，点击\完成\，至此，已经具备了在Eclipse下使用Log4J的环境。
如果使用的是 JBuilder，那么在JBuilder打开后，点击菜单\ools\->\，打开\对话框：
点击\按钮，打开\对话框：
使用\按钮将保存于特定文件夹中的log4j-1.2.11.jar文件引用进来，并设置Name，即该类库的名字，我将Name设置为Log4J。设置好后点击\按钮，回到\Libraries\对话框，再点击\按钮，则JUnit类库已经被添加到JBuilder当中。
下面继续，在JBuilder中创建项目。点击菜单\Project\，打开\Wizard\对话框：
在这个窗口中设置项目名称及存放目录，我的项目名称仍为Log4JTest，路径为G:/YPJCCK/log4J /JBuilder/Log4JTest。点击\进入下一个窗口：
在这个窗口中选择\Libraries\选项卡，点击\按钮，将刚才设置的JUnit库引用进来。然后点击\按钮，进入下一个窗口：
在这个窗口中用鼠标点击Encoding下拉列表框，然后按一下\键，选中相应选项，此时该项目的字符集就被设置成 GBK了。如果做的是国内项目，这绝对是个好习惯。最后点击\，项目创建完成。 三、编写一个简单的示例
在了解 Log4J的使用方法之前，先编写一个简单的示例，以对Log4J有个感性认识。 如果使用的是Eclipse，请点击\文件\新建\类\，打开\新建Java类\对话框，设置包为piv.zheng.log4j.test，名称为Test，并确保\选项选中；如果使用的是JBuilder，请点击\Class\，打开\Wizard\对话框，设置Package为piv.zheng.log4j.test，Class name为Test，并确保\选项选中。设置完成后，点击\。代码如下： package piv.zheng.log4j.test;
import org.apache.log4j.Logger; import org.apache.log4j.Level;
import org.apache.log4j.SimpleLayout; import org.apache.log4j.ConsoleAppender;
public class Test {
public static void main(String[] args) {
SimpleLayout layout = new SimpleLayout();
ConsoleAppender appender = new ConsoleAppender(layout);
Logger log = Logger.getLogger(Test.class); log.addAppender(appender); log.setLevel(Level.FATAL);
log.debug(\ log.info(\ log.warn(\ log.error(\ log.fatal(\ } }
至此，示例编写完成。请点击运行按钮旁边的倒三角，选择\运行为\Java应用程序\（Eclipse），或者在Test类的选项卡上点击鼠标右键，在调出的快捷菜单中点击\defaults\（JBuilder），运行程序，观察从控制台输出的信息。 四、Log4J入门
看过程序的运行效果后可能会奇怪，为何控制台只输出了\这样一条信息，而程序代码中的log.debug()、log.info()等方法也都设置了类似的内容，却没有被输出？其实答案很简单，但在公布之前，先来了解一下Log4J的使用。
请先看前边的示例代码，会发现，示例中用到了Logger、Level、 ConsoleAppender、SimpleLayout等四个类。其中Logger类使用最多，甚至输出的信息也是在其对象log的fatal
方法中设置的，那么Logger究竟是做什么的呢？其实Logger就是传说中的日志记录器（在Log4J中称为Category），创建方法有三： 1．根Category，默认创建，获取方法：
Logger log = Logger.getRootLogger();
2．用户创建的Category，方法：
Logger log = Logger.getLogger(\
其中字符串test是为Category设定的名称。Category的名称允许使用任何字符，但区分大小写，例如：
Logger l1 = Logger.getLogger(\ Logger l2 = Logger.getLogger(\
l1和l2就是两个Category；而如果名称完全相同，例如：
Logger l1 = Logger.getLogger(\ Logger l2 = Logger.getLogger(\
l1和l2就是同一个Category。此外，符号\在Category的名称中有特殊作用，这一点将在后边介绍。
3．与方法2类似，只是参数由字符串换成了类对象，其目的是通过类对象获取类的全名。这个方法比较常用，示例中使用的就是这个方法。
那么Category是如何输出信息的呢？其实示例中用到的debug、info、warn、error、fatal等五个方法都是用来输出信息的。什么，怎么这么多？原因很简单，Log4J支持分级输出。Log4J的输出级别有五个，由低到高依次是DEBUG（调试）、INFO（信息）、WARN（警告）、ERROR（错误）和FATAL（致命），分别与以上方法对应。当输出级别设置为DEBUG时，以上方法都能够输出信息，当输出级别设置为INFO时，则只有debug方法将不能再输出信息，依此类推，当输出级别设置为FATAL时，就只有fatal方法可以输出信息了。现在再回头看前边的问题，为何只有设置给fatal方法的信息被输出就不难理解了，示例中有这样一行代码：
log.setLevel(Level.FATAL);
正是这行代码将log对象的输出级别设成了FATAL。在为log对象设置输出级别时用到了Level类，该类中定义了DEBUG、INFO、 WARN、ERROR、FATAL等五个静态对象，与五个输出级别相对应。此外，Level还有两个特殊的静态对象ALL和OFF，前者允许所有的方法输出信息，其级别其实比DEBUG还低；后者则会禁止所有的方法输出信息，其级别比FATAL要高。除前边示例中用到的五个方法，Logger还提供了这五个方法的重载，以在输出信息的同时抛出异常，以fatal方法为例：
log.fatal(\
执行后输出信息：
FATAL - Here is FATAL
java.lang.Exception: Exception
at piv.zheng.log4j.test.Test.main(Test.java:24)
其他方法类似。此外，Logger还提供了log方法，该方法不针对任何输出级别，需要在调用时设置，例如：
log.log(Level.FATAL, \
log.log(Level.FATAL, \
虽然一般情况下log方法不如其它方法方便，但由于允许设置级别，因此log方法在很多时候反而比其它方法更灵活，甚至可以在输出级别为OFF时输出信息。不过log方法主要是给用户自定义的输出级别用的，而且设立OFF输出级别的目的也为了不输出任何信息，因此请不要在log方法中使用OFF来输出信息。 此外，Category的输出级别并非必须，若未设置，子Category会默认使用其父Category的输出级别，若父 Category也没设置，就使用再上一级Category的设置，直到根Category为止。根Category默认输出级别为DEBUG，因此在示例中，若将\一行注释掉，则所有方法都会输出信息。 下面简单介绍一下Log4J中 Category的继承关系。其实在Log4J中Category之间是存在继承关系的，根Category默认创建，是级别最高的Category，用户创建的Category均继承自它。而用户创建的Category之间也存在继承关系，例如：
Logger lx = Logger.getLogger(\ Logger lxy = Logger.getLogger(\ Logger lx_y = Logger.getLogger(\ Logger lx_z = Logger.getLogger(\ Logger lx_y_z = Logger.getLogger(\
其中的lx_y、lx_z就是lx的子Category，而lx_y_z是lx_y的子Category。但lxy并不是lx的子 Category。也许有点乱，下面来一个一个看。首先看与lx_y、lx_z对应的Category的名称\和\，\前边的是什么，\，这说明与名称为\的Category对应lx就是它们的父Category；而与lx_y_z对应的Category的名称\，最后一个\前边的是什么，\，这说明lx_y是lx_y_z的父Category；至于lxy，由于与之对应的 Category名称\之间没有\，因此它是一个与lx同级的Category，其父Category就是根Category器。此外还有一种情况，例如有一个名称为\的Category，如果没有名称为\的Category，那么它的父Category也是根Category。前边说过，\在Category名称中有特殊作用，其实它的作用就是继承。至此，为何使用类对象来创建Category也就不难理解了。
可是，仅有Category是无法完成信息输出的，还需要为Category添加Appender，即Category的输出源。前边的例子使用的是 ConsoleAppender，即指定Category将信息输出到控制台。其实Log4J提供的Appender有很多，这里选择几常用的进行介绍。
1．org.apache.log4j.WriterAppender，可以根据用户选择将信息输出到Writer或OutputStream。 示例代码：
SimpleLayout layout = new SimpleLayout ();
//向文件中输出信息，OutputStream示例 WriterAppender appender1 = null; try {
appender1 = new WriterAppender(layout, new FileOutputStream(\ }
catch(Exception ex) {}
//向控制台输出信息，Writer示例 WriterAppender appender2 = null; try { appender2 = OutputStreamWriter(System.out)); }
catch(Exception ex) {}
new WriterAppender(layout, new
//Category支持同时向多个目标输出信息 Logger log = Logger.getLogger(Test.class); log.addAppender(appender1); log.addAppender(appender2);
log.debug(\
这个示例由第一个示例修改而来，没有设置输出级别，而且向Category中添加了两个输出源，运行后会在控制台中输出\，并在工程目录下生成test.txt文件，该文件中也记录着\。若要将test.txt文件放到其它路径下，例如f:，则将\改为\，又如e:下的temp 文件夹，就改为\。后边FileAppender、RollingFileAppender以及 DailyRollingFileAppender设置目标文件时也都可以这样来写。 2．org.apache.log4j.ConsoleAppender，向控制台输出信息，继承了WriterAppender，前边的示例使用的就是它。
3．org.apache.log4j.FileAppender，向文件输出信息，也继承了WriterAppender。 示例代码：
SimpleLayout layout = new SimpleLayout();
//若文件不存在则创建文件，若文件已存在则向文件中追加信息 FileAppender appender = null; try {
appender = new FileAppender(layout, \ } catch(Exception e) {}
Logger log = Logger.getLogger(Test.class); log.addAppender(appender); log.debug(\
这个示例也由第一个示例修改而来，运行后会在工程目录下生成test.txt文件，该文件中记