国产av无码专区亚洲av桃花庵,亚洲精品无码不卡在线播HE,亚洲乱码无限2021芒果

Log4J学习(f��n)�W�记

Binary — Fri, 01 Sep 2006 05:25:00 GMT

一、简�?br />　　在程序中输出信息的目的有三：(x��)一是监视程序运行情况；一是将�E�序的运行情况记录到日志文�g中，以备��来查看�Q�一是做��试器。但信息输出的手�D�不仅限于System.out.println()或System.out.print()�Q�还有日志记录工具可以选择。与System.out.pringln()和System.out.print()相比�Q�日志记录工具可以控制输出��别，�q�且可以在配�|�文件中对输出��别进行设�|�，�q�样开发阶�D늚�信息在程序发布后��可以通过讄��输出�U�别来消除掉�Q�而无��d��代码�q�行修正�?ji��n)。现在流行的日志记录工具很多�Q?Log4J��是其中的佼��D��?br />　　Log4J是由著名开源组�l�Apache推出的一�ƾ日志记录工��P��供Java�~�码人员做日志输��Z��用，可以从网�?a >http://logging.apache.org/log4j上免费获得，最新版�?.2.11。获得logging-log4j-1.2.11.zip文�g后，解压�~�，需要的是其中的log4j-1.2.11.jar文�g�Q�将该文件放到特定的文�g夹中备用�Q�我攑ֈ��?ji��n)我机器的G:\YPJCCK\Log4J\lib文�g夹中�?br />　　�q�里选择的IDE是Eclipse和JBuilder。Eclipse用的�?.0.1加语�a�包，可以�?a >www.eclipse.org�|�站上下载；JBuilder用的是JBuilder 2005�?br />二、配�|�类�?br />　　下面打开Eclipse或JBuilder�?br />　　如果使用的是Eclipse�Q�那么在Eclipse打开后，点击菜单"文�g"->"新徏"->"��目"�Q�打开"新徏��目"对话框：(x��)

500)this.width=500" border="0" />

请选中"Java��目"�Q�点�?下一�?�Q�进�?新徏Java��目"对话框：(x��)

500)this.width=500" border="0" />

在这个对话框中需要设�|�项目的名称以及(qi��ng)��目所在目录，我�ؓ(f��)自己的项目�v名�ؓ(f��)Log4JTest�Q�目录�ؓ(f��)G:\YPJCCK\Log4J\Eclipse\ Log4JTest。设�|�好后点�?下一�?�Q�进入下一个窗口。在�q�个�H�口中选择名�ؓ(f��)"�?的选项卡，然后点击"��d��外部JAR"按钮�Q�将保存于特定文件夹中的log4j-1.2.11.jar文�g引用�q�来�?/p>

500)this.width=500" border="0" />

讄��好后�Q�点�?完成"�Q�至此，已经具备�?ji��n)在Eclipse下��用Log4J的环境�?br />　　如果使用的是JBuilder�Q�那么在JBuilder打开后，点击菜单"Tools"->"Configure" ->"Libraries"�Q�打开"Configure Libraries"对话框：(x��)

500)this.width=500" border="0" />

点击"New"按钮�Q�打开"New Library Wizard"对话框：(x��)

500)this.width=500" border="0" />

使用"Add"按钮��保存于特定文�g夹中的log4j-1.2.11.jar文�g引用�q�来�Q��ƈ讄��Name�Q�即该类库的名字�Q�我��Name讄��?Log4J。设�|�好后点�?OK"按钮�Q�回�?Configure Libraries"对话框，再点�?OK"按钮�Q�则JUnit�c�d��已经被添加到JBuilder当中�?br />　　下面�l�箋�Q�在JBuilder中创建项目。点击菜�?File"->"New Project"�Q�打开"Project Wizard"对话框：(x��)

500)this.width=500" border="0" />

在这个窗口中讄��目名称�?qi��ng)存攄��录，我的��目名称仍��?f��)Log4JTest�Q��\径�ؓ(f��)G:/YPJCCK/log4J/JBuilder/Log4JTest。点�?Next"�q�入下一个窗口：(x��)

500)this.width=500" border="0" />

在这个窗口中选择"Required Libraries"选项卡，点击"Add"按钮�Q�将刚才讄��的JUnit库引用进来。然后点�?Next"按钮�Q�进入下一个窗口：(x��)

500)this.width=500" border="0" />

在这个窗口中用鼠标点击Encoding下拉列表框，然后按一�?G"键，选中相应选项�Q�此时该��目的字�W�集��p��讄��成GBK�?ji��n)。如果做的是国内��目�Q�这�l�对是个好习(f��n)惯。最后点�?Finish"�Q�项目创建完成�?br />三、编写一个简单的�C�Z��
　　在了(ji��n)解Log4J的��用方法之前，先编写一个简单的�C�Z��Q�以对Log4J有个感性认识�?br />如果使用的是Eclipse�Q�请点击"文�g"->"新徏"->"�c?�Q�打开"新徏Java�c?对话框，讄��包�ؓ(f��) piv.zheng.log4j.test�Q�名�U�Cؓ(f��)Test�Q��ƈ��保"public static void main(String[] args)"选项选中�Q�如果��用的是JBuilder�Q�请点击"File"->"New Class"�Q�打开"Class Wizard"对话框，讄��Package为piv.zheng.log4j.test�Q�Class name为Test�Q��ƈ��保"Generate main method"选项选中。设�|�完成后�Q�点�?OK"。代码如下：(x��)
　　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("Here is DEBUG");
　　　　　　log.info("Here is INFO");
　　　　　　log.warn("Here is WARN");
　　　　　　log.error("Here is ERROR");
　　　　　　log.fatal("Here is FATAL");
　　　　}
　　}
��x��Q�示例编写完成。请点击�q�行按钮旁边的倒三角，选择"�q�行�?->"2 Java应用�E�序"�Q�Eclipse�Q�，或者在Test�cȝ��选项卡上点击鼠标右键�Q�在调出的快捯��单中点击"Run using defaults"�Q�JBuilder�Q�，�q�行�E�序�Q�观察从控制台输出的信息�?br />四、Log4J入门
　　看过�E�序的运行效果后可能�?x��)奇怪，��Z��控制台只输出�?FATAL - Here is FATAL"�q�样一条信息，而程序代码中的log.debug()、log.info()�{�方法也都设�|�了(ji��n)�c�M��的内容，却没有被输出�Q�其实答案很��单，但在公布之前�Q�先来了(ji��n)解一下Log4J的��用�?br />　　请先看前边的�C�Z��代码�Q�会(x��)发现�Q�示例中用到�?ji��n)Logger、Level�?ConsoleAppender、SimpleLayout�{�四个类。其中Logger�c�M��用最多，甚至输出的信息也是在其对象log的fatal�Ҏ(gu��)��中设�|�的�Q�那么Logger�I�竟是做什么的呢？其实Logger��是传说中的日志记录器（在Log4J中称为Category�Q�，创徏�Ҏ(gu��)��有三�Q?br />　　1�Q�根Category�Q�默认创建，获取�Ҏ(gu��)��Q?/p>

Logger log = Logger.getRootLogger();

　　2�Q�用户创建的Category�Q�方法：(x��)

Logger log = Logger.getLogger("test");

其中字符串test是�ؓ(f��)Category讑֮�的名�U�。Category的名�U�允�怋�用�Q何字�W�，但区分大��写�Q�例如：(x��)

Logger l1 = Logger.getLogger("x");
Logger l2 = Logger.getLogger("X");

l1和l2��是两个Category�Q�而如果名�U�完全相同，例如�Q?/p>

Logger l1 = Logger.getLogger("x");
Logger l2 = Logger.getLogger("x");

l1和l2��是同一个Category。此外，�W�号"."在Category的名�U�C��有特�D�作用，�q�一点将在后边介�l��?br />　　3�Q�与�Ҏ(gu��)��2�c�M��Q�只是参数由字符串换成了(ji��n)�c�d��象，其目的是通过�c�d��象获取类的全名。这个方法比较常用，�C�Z��中��用的��是�q�个�Ҏ(gu��)��?br />　　那么Category是如何输��Z��息的呢？其实�C�Z��中用到的debug、info、warn、error、fatal�{�五个方法都是用来输��Z��息的。什么，怎么�q�么多？原因很简单，Log4J支持分��输出。Log4J的输出��别有五个�Q�由低到高依�ơ是DEBUG�Q�调试）(j��)、INFO�Q�信息）(j��)、WARN�Q�警告）(j��)、ERROR�Q�错误）(j��)和FATAL�Q�致命）(j��)�Q�分别与以上�Ҏ(gu��)��对应。当输出�U�别讄��为DEBUG�Ӟ��以上�Ҏ(gu��)��都能够输��Z��息，当输出��别设�|��ؓ(f��)INFO �Ӟ��则只有debug�Ҏ(gu��)��不能再输出信息�Q�依此类推，当输出��别设�|��ؓ(f��)FATAL�Ӟ��只有fatal�Ҏ(gu��)��可以输出信息�?ji��n)。现在再回头看前边的问题�Q��ؓ(f��)何只有设�|�给fatal�Ҏ(gu��)��的信息被输出��׃��隄��解了(ji��n)�Q�示例中有这样一行代码：(x��)

log.setLevel(Level.FATAL);

正是�q�行代码��log对象的输出��别设成了(ji��n)FATAL。在为log对象讄��输出�U�别时用��C��(ji��n)Level�c�，该类中定义了(ji��n)DEBUG、INFO、WARN�?ERROR、FATAL�{�五个静(r��n)态对象，与五个输出��别相对应。此外，Level�q�有两个�Ҏ(gu��)��的静(r��n)态对象ALL和OFF�Q�前者允许所有的�Ҏ(gu��)��输出信息�Q�其�U�别其实比DEBUG�q�低�Q�后者则�?x��)禁止所有的�Ҏ(gu��)��输出信息�Q�其�U�别比FATAL要高。除前边�C�Z��中用到的五个�Ҏ(gu��)��Q�Logger�q�提供了(ji��n)�q�五个方法的重蝲�Q�以在输��Z��息的同时抛出异常�Q�以fatal�Ҏ(gu��)��Z��Q?/p>

log.fatal("Here is FATAL", new Exception("Exception"));

执行后输��Z��息：(x��)
　　FATAL - Here is FATAL
　　java.lang.Exception: Exception
　　　　at piv.zheng.log4j.test.Test.main(Test.java:24)
其他�Ҏ(gu��)��c�M��。此外，Logger�q�提供了(ji��n)log�Ҏ(gu��)��Q�该�Ҏ(gu��)��不针对�Q何输出��别，需要在调用时设�|�，例如�Q?/p>

log.log(Level.FATAL, "Here is FATAL");
log.log(Level.FATAL, "Here is FATAL", new Exception("Exception"));

虽然一般情况下log�Ҏ(gu��)��不如其它�Ҏ(gu��)��方便�Q�但�׃��允许讄��U�别�Q�因此log�Ҏ(gu��)��在很多时候反而比其它�Ҏ(gu��)��更灵�z�，甚至可以在输出��别�ؓ(f��)OFF时输��Z��息。不�q�log�Ҏ(gu��)��主要是给用户自定义的输出�U�别用的�Q�而且讄��OFF输出�U�别的目的也��Z��(ji��n)不输��Z�Q何信息，因此请不要在log�Ҏ(gu��)��中��用OFF来输��Z��息�?br />　　此外�Q�Category的输出��别�ƈ非必��，若未讄��Q�子Category�?x��)默认��用其父Category的输出��别，若父Category也没讄��Q�就使用再上一�U�Category的设�|�，直到根Category为止。根Category默认输出�U�别为DEBUG�Q�因此在�C�Z��中，若将 "log.setLevel(Level.FATAL);"一行注释掉�Q�则所有方法都�?x��)输��Z��息�?br />　　下面��单介�l�一下Log4J�?Category的��承关�p�R��其实在Log4J中Category之间是存在��承关�pȝ��Q�根Category默认创徏�Q�是�U�别最高的Category�Q�用户创建的Category均��承自它。而用户创建的Category之间也存在��承关�p�，例如�Q?/p>

Logger lx = Logger.getLogger("x");
Logger lxy = Logger.getLogger("xy");
Logger lx_y = Logger.getLogger("x.y");
Logger lx_z = Logger.getLogger("x.z");
Logger lx_y_z = Logger.getLogger("x.y.z");

其中的lx_y、lx_z��是lx的子Category�Q�而lx_y_z是lx_y的子Category。但lxy�q�不是lx的子Category。也许有点�ؕ�Q�下面来一个一个看。首先看与lx_y、lx_z对应的Category的名�U?x.y"�?x.z"�Q?."前边的是什么，"x"�Q�这说明与名�U�Cؓ(f��) "x"的Category对应lx��是它们的父Category�Q�而与lx_y_z对应的Category的名�U?x.y.z"�Q�最后一�?."前边的是什么，"x.y"�Q�这说明lx_y是lx_y_z的父Category�Q�至于lxy�Q�由于与之对应的Category名称"xy"之间没有"."�Q�因此它是一个与lx同��的Category�Q�其父Category��是根Category器。此外还有一�U�情况，例如有一个名�U�Cؓ(f��)"a.b"�?Category�Q�如果没有名�U�Cؓ(f��)"a"的Category�Q�那么它的父Category也是根Category。前边说�q�，"."在Category名称中有�Ҏ(gu��)��作用�Q�其实它的作用就是��ѝ��至此，��Z��使用�c�d��象来创徏Category也就不难理解�?ji��n)�?br />　　可是�Q�仅有Category是无法完成信息输出的�Q�还需要�ؓ(f��)Category��d��Appender�Q�即Category的输出源。前边的例子使用的是ConsoleAppender�Q�即指定 Category��信息输出到控制台。其实Log4J提供的Appender有很多，�q�里选择几常用的�q�行介绍�?br />　　1�Q�org.apache.log4j.WriterAppender�Q�可以根据用户选择��信息输出到Writer或OutputStream�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout ();
　　　　
　　　　//向文件中输出信息�Q�OutputStream�C�Z��
　　　　WriterAppender appender1 = null;
　　　　try {
　　　　　　appender1 = new WriterAppender(layout, new FileOutputStream("test.txt"));
　　　　}
　　　　catch(Exception ex) {}
　　　　
　　　　//向控制台输出信息�Q�W(xu��)riter�C�Z��
　　　　WriterAppender appender2 = null;
　　　　try {
　　　　　　appender2 = new WriterAppender(layout, new OutputStreamWriter(System.out));
　　　　}
　　　　catch(Exception ex) {}
　　　　
　　　　//Category支持同时向多个目标输��Z��?br />　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender1);
　　　　log.addAppender(appender2);
　　　　
　　　　log.debug("output");
�q�个�C�Z��q��一个示例修改而来�Q�没有设�|�输出��别，而且向Category中添加了(ji��n)两个输出源，�q�行后会(x��)在控制台中输�?DEBUG - output"�Q��ƈ在工�E�目录下生成test.txt文�g�Q�该文�g中也记录着"DEBUG - output"。若要将test.txt文�g攑ֈ�其它路径下，例如f:�Q�则��?test.txt"改�ؓ(f��)"f:/test.txt"�Q�又如e:下的temp 文�g夹，��改�?e:/temp/test.txt"。后边FileAppender、RollingFileAppender以及(qi��ng) DailyRollingFileAppender讄��目标文�g时也都可以这��h��写�?br />　　2�Q�org.apache.log4j.ConsoleAppender�Q�向控制台输��Z��息，�l�承�?ji��n)WriterAppender�Q�前边的�C�Z��使用的就是它�?br />　　3�Q�org.apache.log4j.FileAppender�Q�向文�g输出信息�Q�也�l�承�?ji��n)WriterAppender�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　//若文件不存在则创建文�Ӟ��若文件已存在则向文�g中追加信�?br />　　　　FileAppender appender = null;
　　　　try {
　　　　　　appender = new FileAppender(layout, "test.txt");
　　　　} catch(Exception e) {}
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
�q�个�C�Z��也由�W�一个示例修改而来�Q�运行后�?x��)在工程目录下生成test.txt文�g�Q�该文�g中记录着"DEBUG - output"。再�ơ运行程序，查看文�g�Q�则"DEBUG - output"有两行�?br />　　另外�Q�FileAppender�q�有一个构造：(x��)

FileAppender(Layout layout, String filename, boolean append)

与示例的�c�M��Q�只是多�?ji��n)一个boolean型的参数append。append参数是个开养I��用来讄��当程序重启，而目标文件已存在�Ӟ��是向目标文�g�q�加信息�q�是覆盖原来的信息，当��gؓ(f��)true时就�q�加�Q�这是FileAppender默认的，当��gؓ(f��)false时则覆盖。此外，FileAppender�q�提供了(ji��n)setAppend�Ҏ(gu��)��来设�|�a(ch��n)ppend开兟�?br />　　4�Q�org.apache.log4j.RollingFileAppender�Q��承了(ji��n) FileAppender�Q�也是向文�g输出信息�Q�但文�g大小可以限制。当文�g大小��过限制�Ӟ��该文件会(x��)被�{为备份文件或删除�Q�然后重新生成。文件的转换或删除与讄��的备份文件最大数量有养I��当数量大�?时就转�ؓ(f��)备䆾文�g�Q�否则（��于�{�于0�Q�删除，默认的备份文件数量是1。�{换备份文仉��常简单，��是修改文�g名，在原文�g名之后加�?.1"�Q�例如文件test.txt�Q��{为备份文件后文�g名�ؓ(f��)"test.txt.1"。但若同名的备䆾文�g已存在，则会(x��)先将该备份文件删除或更名�Q�这也与讄��的备份文件最大数量有养I��若达到最大数量就删除�Q�否则更名。若备䆾文�g更名时也遇到同样情况�Q�则使用同样的处理方法，依此�c�L��Q�直到达到设�|�的备䆾文�g最大数量。备份文件更名也很简单，��是��扩展名�?�Q�例如test.txt.1文�g更名后变为test.txt.2�Q?test.txt.2文�g更名后变为test.txt.3�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　//若文件不存在则创建文�Ӟ��若文件已存在则向文�g中追加内�?br />　　　　RollingFileAppender appender = null;
　　　　try {
　　　　　　appender = new RollingFileAppender(layout, "test.txt");
　　　　} catch(Exception e) {}
　　　　//限制备䆾文�g的数量，本例�?�?br />　　　　appender.setMaxBackupIndex(2);
　　　　//限制目标文�g的大��，单位字节�Q�本例�ؓ(f��)10字节
　　　　appender.setMaximumFileSize(10);
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　
　　　　log.debug("output0");
　　　　log.debug("output1");
　　　　log.debug("output2");
�E�序�q�行后，�?x��)在工程目录下生成test.txt、test.txt.1和test.txt.2三个文�g�Q�其中test.txt内容为空�Q�而后两个文�g则分别记录着"DEBUG - output2"�?DEBUG - output1"�Q�这是怎么回事�Q�原来由于目标文件大��被限制�?0字节�Q�而三�ơ��用log.debug�Ҏ(gu��)��输出的信息都��过�?0字节�Q�这样就��D��?ji��n)三�ơ备份文件�{换，所以test.txt内容为空。而备份文件最大数量被设�ؓ(f��)2�Q�因此第一�ơ�{换的备䆾文�g��p��删掉�?ji��n)，而后两次的则保存下来。此外，�׃�� test.txt转换备䆾文�g时是先�{为test.txt.1�Q�再转�ؓ(f��)test.txt.2�Q�因此最后test.txt.2的内�Ҏ(gu��)��"DEBUG - output1"�Q�而test.txt.1�?DEBUG - output2"�Q�这点千万别弄�؜�?ji��n)�?br />　　另外�Q�RollingFileAppender�q�提供了(ji��n)两个�Ҏ(gu��)��Q?br />　　�Q?�Q�setMaxFileSize�Q�功能与setMaximumFileSize一��P��但参数是字符�Ԍ��有两�U�情况：(x��)一是仅由数字组成，默认单位为字节，例如"100"�Q�即表示限制文�g大小�?00字节�Q�一是由数字�?qi��ng)存储单位组成，例�?1KB"�?1MB"�?1GB"�Q�其中单位不区分大小写，分别表示限制文�g大小�?K�?M�?G�?br />　　�Q?�Q�rollOver�Q�手动将目标文�g转换为备份文�Ӟ��使用��h��较灵�z�，适用于复杂情��c(di��n)�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　RollingFileAppender appender = null;
　　　　try {
　　　　　　appender = new RollingFileAppender(layout, "test.txt");
　　　　} catch(Exception e) {}
　　　　appender.setMaxBackupIndex(2);

　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　
　　　　log.debug("output0");
　　　　appender.rollOver();
　　　　log.debug("output1");
　　　　appender.rollOver();
　　　　log.debug("output2");
　　　　appender.rollOver();
�q�里没限制目标文件大��，但程序运行后�Q�效果与上例相同�?br />　　5�Q�org.apache.log4j.DailyRollingFileAppender�Q�也�l�承�?ji��n)FileAppender�Q��ƈ且也是向文�g输出信息�Q�但�?x��)根据设定的旉��频率生成备䆾文�g�?br />　　旉��频率格式��介：(x��)
　　'.'yyyy-MM�Q�按月生成，生成旉��为每月最后一天午夜过后，例如test.txt�?005�q?�?1日午夜过后会(x��)被更名�ؓ(f��)test.txt.2005-07�Q�然后重新生成�?br />　　'.'yyyy-ww�Q�按周生成，生成旉��为每周六午夜�q�后�Q�例如test.txt�?005�q?�?3日午夜过后会(x��)被更名�ؓ(f��)test.txt.2005-33�Q?3表示当年�W?3周�?br />　　'.'yyyy-MM-dd�Q�按天生成，生成旉��为每天午夜过后，例如2005�q?�?6日午夜过后，test.txt�?x��)被更名为test.txt.2005-08-16�?br />　　'.'yyyy-MM-dd-a�Q�也是按天生成，但每天会(x��)生成两次�Q�中�?2:00�q�后一�ơ，午夜�q�后一�ơ，例如test.txt�?005�q?�?6 �?2:00�q�后�?x��)被更名为test.txt.2005-8-16-上午�Q�午夜过后会(x��)被更名�ؓ(f��)test.txt.2005-8-16-下午�?br />　　'.'yyyy-MM-dd-HH�Q�按��时生成�Q�例如test.txt�?005�q?�?6�?2:00�q�后�?x��)被更名为test.txt.2005-8-16-11�?br />　　'.'yyyy-MM-dd-HH-mm�Q�按分钟生成�Q�例如test.txt�?005�q?�?6�?2:00�q�后�?x��)被更名为test.txt.2005-8-16-11-59�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　DailyRollingFileAppender appender = null;
　　　　try {
　　　　　　appender = new DailyRollingFileAppender(layout, "test.txt", "'.'yyyy-MM-dd-HH-mm");
　　　　} catch(Exception e) {}
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
�~�码完成后运行程序，�{�一分钟后再�ơ运行，�׃��我是�?005�q?�?7�?5:42分第一�ơ运行程序的�Q�因此工�E�目录下最�l�有两个文�gtest.txt和test.txt.2005-08-17-15-42�?br />　　6�Q�org.apache.log4j.AsyncAppender�Q�用于管理不同类型的Appender�Q�也能实现同时向多个源输��Z��息，但其执行是异步的�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　//向控制台输出
　　　　ConsoleAppender appender1 = null;
　　　　try {
　　　　　　appender1 = new ConsoleAppender(layout);
　　　　} catch(Exception e) {}
　　　　
　　　　//向文件输�?br />　　　　FileAppender appender2 = null;
　　　　try {
　　　　　　appender2 = new FileAppender(layout, "test.txt");
　　　　} catch(Exception e) {}
　　　　
　　　　//使用AsyncAppender实现同时向多个目标输��Z��?br />　　　　AsyncAppender appender = new AsyncAppender();
　　　　appender.addAppender(appender1);
　　　　appender.addAppender(appender2);
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
此外�Q�AsyncAppender和Logger都提供了(ji��n)更多的方法来��理Appender�Q�例如getAppender�?getAllAppenders、removeAppender和removeAllAppenders�Q�分别用来获取指定的Appender、获取全�?Appender、移除指定的Appender以及(qi��ng)�U�除全部Appender�?br />　　7�Q�org.apache.log4j.jdbc.JDBCAppender�Q�将信息输出到数据库�?br />　　�C�Z��代码�Q?br />　　　　JDBCAppender appender = new JDBCAppender();
　　　　appender.setDriver("com.mysql.jdbc.Driver");
　　　　appender.setURL("jdbc:mysql://localhost:3306/zheng");
　　　　appender.setUser("root");
　　　　appender.setPassword("11111111");
　　　　appender.setSql("insert into log4j (msg) values ('%m')");
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
�q�里使用的数据库是MySQL 5.0.4beta�Q�用户名root�Q�密�?1111111�Q�我在其中徏�?ji��n)一个库zheng�Q�包含表log4j�Q�该表只有一个字�D�msg�Q�类型�ؓ(f��)varchar(300)。此外，本例用到的JDBC驱动可以�?a >http://dev.mysql.com/downloads/connector/j/3.1.html下蝲�Q�版�?.1.8a�Q�下载mysql-connector-java-3.1.8a.zip文�g后解压羃�Q�需要其中的mysql-connector- java-3.1.8-bin.jar文�g。下面再来看代码。由于JDBCAppender内部默认使用PatternLayout格式化输��Z��息，因此�q�里没用到SimpleLayout�Q�而appender.setSql所讄��的SQL语句��是PatternLayout所需的格式化字符�Ԍ��故此其中才有"%m"�q�样的字�W�，有关PatternLayout的具体内容后边介�l�。执行后�Q�表log4j增加一条记录，内容�?output"�?br />　　8�Q�org.apache.log4j.nt.NTEventLogAppender�Q�向Windows NT�pȝ��日志输出信息�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　NTEventLogAppender appender = new NTEventLogAppender("Java", layout);

　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
注意�Q�要完成此示例，�q�需向C:\WINNT\system32文�g夹（我的操作�pȝ��装在�?ji��n)C:\�Q�中复制一个名�?NTEventLogAppender.dll的文件。如果跟我一��L(f��ng)��的是Log4J 1.2.11�Q�实在对不住�Q�Log4J 1.2.11�q�未提供该文件。虽然logging-log4j-1.2.11.zip文�g解压�~�后�Q�其下的src\java\org\apache\ log4j\nt文�g夹中有一个make.bat文�g执行后可以编译出该文�Ӟ��但还需要配�|�，很麻�?ch��)。还好，条条大道通罗马，1.2.11不行�Q�就�?1.2.9�Q�可以从http://apache.justdn.org/logging/log4j/1.2.9下蝲�Q�下载后解压�~�logging-log4j-1.2.9.zip文�g�Q�在其下的src\java\org\apache\log4j\nt文�g夹中扑ֈ� NTEventLogAppender.dll�Q�复制过��d��可以�?ji��n)。程序执行后�Q�打开"事�g查看�?�Q�选择"应用�E�序日志"�Q�其中有一条来源�ؓ(f��)Java的记录，�q�条记录��是刚才输出的信息了(ji��n)�?br />　　9�Q�org.apache.log4j.lf5.LF5Appender�Q�执行时�?x��)弹��Z��个窗口，信息在该�H�口中以表格的�Ş式显�C��?br />　　�C�Z��代码�Q?br />　　　　LF5Appender appender = new LF5Appender();
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
�׃��LF5Appender不需要Layout格式化输��Z��息，因此�q�里没有讄��。此外LF5Appender�q�提供了(ji��n)一个setMaxNumberOfRecords�Ҏ(gu��)��Q�用来限制信息在表格中显�C�的行数�?br />　　10�Q�org.apache.log4j.net.SocketAppender�Q�以套接字方式向服务器发送日志，然后由服务器��信息输出�?br />　　�C�Z��代码�Q?br />　　//指定要连接的服务器地址�?qi��ng)端口，�q�里使用的是本机9090端口
　　SocketAppender appender = new SocketAppender("localhost", 9090);
　　Logger log = Logger.getLogger(Test.class);
　　log.addAppender(appender);
　　log.debug("output");
SocketAppender不需要设�|�Layout�Q�因为SocketAppender不负责输��Z��息。那么如何看��C��息输出的效果呢？�q�就需要SocketServer和SimpleSocketServer�?ji��n)�?br />　　�C�Z��代码1�Q?br />　　　　package piv.zheng.log4j.test;
　　　　
　　　　import org.apache.log4j.net.SocketServer;
　　　　
　　　　public class TestServer {
　　　　　　public static void main(String[] args) {
　　　　　　　　SocketServer.main(new String[]{"9090", "test.properties", "G:/YPJCCK/Log4J"});
　　　　　　}
　　　　}
�q�是SocketServer的示例。SocketServer只有一个静(r��n)态方法main�Q�该�Ҏ(gu��)��意味着SocketServer不仅可以在代码中被调用，也可以用java命��o(h��)执行。main�Ҏ(gu��)��只有一个参敎ͼ�是个字符串数�l�，但要求必��L��三个元素�Q�元素一用来指定端口�Q�本例�ؓ(f��)9090�Q�元素二用来指定输出信息旉��要的配置文�g�Q�该文�g攑֜�工程目录下，本例使用的test.properties内容如下�Q?br />　　log4j.rootLogger=, console
　　log4j.appender.console =org.apache.log4j.ConsoleAppender
　　log4j.appender.console.layout=org.apache.log4j.SimpleLayout
该配�|�指定SocketServer使用ConsoleAppender以SimpleLayout格式输出信息�Q�元素三用来指定一个�\径，以存�?lcf 文�g�Q�我指定的是本机的G:/YPJCCK/Log4J文�g夏V�?lcf文�g也是输出信息时��用的配置文�g�Q�格式与元素二所指定的配�|�文件一��P��?test.properties是默认配�|�文�Ӟ��卛_��.lcf文�g找不到时才��用。那�?lcf文�g如何命名呢？其实.lcf文�g的名�U��ƈ不是随意��L(f��ng)��Q�当SocketAppender与SocketServer建立�q�接�Ӟ��SocketServer��׃��(x��)获得SocketAppender所在计��机的IP 地址与网�l�ID�Q��ƈ��其格式化成"�|�络ID/IP地址"�q�样的字�W�串�Q�然后获取其中的�|�络ID作�ؓ(f��).lcf文�g的主名，例如 "zhengyp/127.0.0.1"�Q�其中的"zhengyp"��是��L��件名�Q�而后再根据这个文件名来调用相应的.lcf文�g。这意味着对不同的计算机可以提供不同的配置文�g�Q��信息输出时有不同的效果。此外，SocketServer�q�默认了(ji��n)一个名为generic.lcf的文�Ӟ��用于处理�|�络ID 获取不到或其他情况，本例是用的就是这个文�Ӟ��内容如下�Q?br />　　log4j.rootLogger=, console
　　log4j.appender.console =org.apache.log4j.ConsoleAppender
　　log4j.appender.console.layout=org.apache.log4j.PatternLayout
　　log4j.appender.console.layout.ConversionPattern=%m%n
该配�|�指定SocketServer使用ConsoleAppender以PatternLayout格式输出信息。运行程序时请先�q�行 SocketServer�Q�再�q�行SocketAppender。SocketAppender�q�行�l�束后，��可以从SocketServer的控制台看到输出的信息了(ji��n)�?br />　　�C�Z��代码2�Q?br />　　　　package piv.zheng.log4j.test;
　　　　
　　　　import org.apache.log4j.net.SimpleSocketServer;

　　　　public class TestServer {
　　　　　　public static void main(String[] args) {
　　　　　　　　SimpleSocketServer.main(new String[]{"9090", "test.properties"});
　　　　　　}
　　　　}
�q�是SimpleSocketServer的示例，与SocketServer相比�Q�只允许指定一个默认的配置文�g�Q�而无法对不同计算��Z��用不同的配置文�g�?br />　　11�Q�org.apache.log4j.net.SocketHubAppender�Q�也是以套接字方式发送日志，但与SocketAppender相反�Q�SocketHubAppender是服务器端，而不是客��L(f��ng)��?br />　　�C�Z��代码�Q?br />　　　　//指定服务器端口，�q�里使用的是本机9090端口
　　　　SocketHubAppender appender = new SocketHubAppender(9090);
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　while (true) {
　　　　　　Thread.sleep(1000);
　　　　　　log.debug("output"); //输出信息
　　　　}
�׃��SocketHubAppender一旦运行就开始发送消息，而无论有无接收者，因此�q�里使用�?ji��n)while语句�q�将条�g设�ؓ(f��)true以保证程序持�l�运行。不�q��ؓ(f��)�?ji��n)保证性能�Q�这里还使用�?ji��n)Thread.sleep(1000)�Q�这��L(f��ng)��序每循环一�ơ都休眠1�U�，如果机器性能不好�Q�还可以��D��的再大些。此外，�׃��SocketHubAppender也不负责输出信息�Q�因此同样不需要设�|�Layout。那么如何看��C��息输出的效果呢？�q�里我自己写�?ji��n)个客户端程序，代码如下�Q?br />　　package piv.zheng.log4j.test;
　　
　　import java.net.Socket;
　　import java.lang.Thread;
　　import org.apache.log4j.LogManager;
　　import org.apache.log4j.PropertyConfigurator;
　　import org.apache.log4j.net.SocketNode;
　　
　　public class TestClient {
　　　　public static void main(String[] args) throws Exception {
　　　　　　//创徏客户端套接字对象
　　　　　　Socket s = new Socket("localhost", 9090);
　　　　　　//调用配置文�g
　　　　　　PropertyConfigurator.configure("test.properties");
　　　　　　//从套接字中恢复Logger�Q��ƈ输出信息
　　　　　　new Thread(new SocketNode(s, LogManager.getLoggerRepository())).start();
　　　　}
　　}
�׃��SocketHubAppender与SocketAppender一��P��发送的也是SocketNode对象�Q�因此编写该�E�序时参考了(ji��n) SocketServer的源码。此外，�q�里的配�|�文件直接��用了(ji��n)上例的test.properties文�g。运行程序时请先�q�行 SocketHubAppender�Q�再�q�行客户端程序，然后从客��L(f��ng)��的控制台��可以看到效果了(ji��n)�?br />　　13�Q�org.apache.log4j.net.TelnetAppender�Q�与SocketHubAppender有些�c�M��Q�也是作为服务器发送信息，但TelnetAppender发送的不是SocketNode对象�Q�而是Category输出的结果�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　TelnetAppender appender = new TelnetAppender();
　　　　appender.setLayout(layout); //讄��Layout
　　　　appender.setPort(9090); //讄��端口�?br />　　　　appender.activateOptions(); //应用讄��
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　
　　　　while (true) {
　　　　　　java.lang.Thread.sleep(1000);
　　　　　　log.debug("output"); //输出信息
　　　　}
　　　　//appender.close();
注意最后一行被注释掉的代码�Q�若该行代码执行�Q�则TelnetAppender的资源会(x��)被清理，从而导致TelnetAppender无法�l�箋�q�行。那么如何看��C��息输出的效果呢？�q�里提供两种�Ҏ(gu��)��Q�方法一�Q��用Telnet工具�Q�我使用的就是Windows自带的Telnet。运�?TelnetAppender�E�序后，点击[开始]菜单->[�q�行]�Q�在"�q�行"框中输入"telnet"�Q�回车，telnet客户端弹出，�q�是一个命令行�E�序�Q�输入命�?open localhost 9090"�Q�回车，然后��可以看到效果了(ji��n)。方法二�Q�自己写�E�序�Q�代码如下：(x��)
　　package piv.zheng.log4j.test;
　　
　　import java.net.*;
　　import java.io.*;
　　
　　public class TestClient {
　　　　public static void main(String[] args) throws Exception {
　　　　　　//创徏客户端套接字对象
　　　　　　Socket s = new Socket("localhost", 9090);
　　　　　　//��BufferedReader与Socket�l�定�Q�以输出Socket获得的信�?br />　　　　　　BufferedReader in = new BufferedReader(new InputStreamReader(s.getInputStream()));
　　　　　　//获得信息�q�输�?br />　　　　　　String line = in.readLine();
　　　　　　while (line != null) {
　　　　　　　　System.out.println(line);
　　　　　　　　line = in.readLine();
　　　　　　}
　　　　}
　　}
　　13�Q�org.apache.log4j.net.SMTPAppender�Q�向指定的电(sh��)子邮件发送信息，但只能发送ERROR和FATAL�U�别的信息，而且�q�没提供�w�䆾验证功能�?br />　　�C�Z��代码�Q?br />　　SimpleLayout loyout = new SimpleLayout();
　　
　　SMTPAppender appender = new SMTPAppender();
　　appender.setLayout(loyout); //讄��Layout
　　appender.setFrom("zhengyp@126.com"); //讄��发�g�?br />　　appender.setSMTPHost("smtp.126.com"); //讄��发送邮件服务器
　　appender.setTo("zhengyp@126.com"); //讄��收�g�?br />　　appender.setSubject("Log4J Test"); //讄��邮�g标题
　　appender.activateOptions(); //应用讄��
　　
　　Logger log = Logger.getLogger(Test.class);
　　log.addAppender(appender);
　　log.debug("Here is DEBUG");
　　log.info("Here is INFO");
　　log.warn("Here is WARN");
　　log.error("Here is ERROR");
　　log.fatal("Here is FATAL");
要运行此�C�Z��Q�还需要JavaMail 和JAF�Q�前者是Sun推出的电(sh��)子邮件类库，可以�?a >http://java.sun.com/products/javamail/downloads/index.html下蝲�Q�最新版�?.3.3�Q�下载j(lu��)avamail-1_3_3-ea.zip压羃包后需要其中的mail.jar文�g�Q�后者全�U�是JavaBeans Activation Framework�Q�提供了(ji��n)对输入�Q意数据块的支持，�q�能相应地对其进行处理，可以�?a >http://www.sun.com/download中找刎ͼ�最新版�?.1�Q�下载j(lu��)af-1_1-ea.zip压羃包后需要其中的activation.jar文�g。不�q�，�E�序�q�行后会(x��)抛出两次异常�Q�分别是log.error和log.fatal�Ҏ(gu��)��D��的，��p�|的原因很��单，我用的邮件服务器需要��n份验证�?br />　　14�Q�piv.zheng.log4j.test.SMTPAppender�Q�自定义的，依照Log4J提供的SMTPAppender修改而来�Q�增加了(ji��n)�w�䆾验证功能�Q��ƈ��L��?ji��n)对�U�别的限制。由于代码太长，所以放��C��(ji��n)另一��文章《自定义SMTPAppender的源码》中�Q�有兴趣的请自行��L��看�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout = new SimpleLayout();
　　　　
　　　　SMTPAppender appender = new SMTPAppender(layout);
　　　　appender.setFrom("zhengyp@126.com"); //发�g�?br />　　　　appender.setSMTPHost("smtp.126.com"); //发送邮件服务器
　　　　appender.setTo("zhengyp@126.com"); //收�g�?br />　　　　appender.setSubject("Log4J Test"); //邮�g标题
　　　　appender.setAuth("true"); //�w�䆾验证标识
　　　　appender.setUsername("zhengyp"); //用户�?br />　　　　appender.setPassword("1111111"); //密码
　　　　appender.activateOptions(); //应用讄��
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
同样需要JavaMail 和JAF。程序运行后�?x��)发送一��邮�Ӟ��快去查看一下自��q��邮箱吧^_^
　　此外�Q�Log4J�q�提供了(ji��n)SyslogAppender、JMSAppender�Q�均在org.apache.log4j.net包下�Q�以�?qi��ng)更多�?Appender�Q�或者用来向Unix操作�pȝ��的syslogd服务发送信息，或者通过JMS方式发送信息，或者以其他方式发送信息。由于条件有玎ͼ��׃��再介�l�了(ji��n)�?br />　　不过�Q�在前边的示例中�q��用了(ji��n)SimpleLayout和PatternLayout来格式化输出的信息，�q�里也简单介�l�一下�?br />　　1�Q�org.apache.log4j.SimpleLayout�Q�一直用的就是它�Q�输出的格式比较��单，��是"�U�别 - 信息"�?br />　　2�Q�org.apache.log4j.HTMLLayout�Q�以HTML格式输出信息�?br />　　�C�Z��代码�Q?br />　　　　HTMLLayout layout = new HTMLLayout();
　　　　layout.setTitle("Log4J Test"); //HTML��|��?br />　　　　
　　　　FileAppender appender = null;
　　　　try {
　　　　　　appender = new FileAppender(layout, "test.html");
　　　　} catch(Exception e) {}
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
�E�序�q�行后会(x��)在工�E�目录下生成一个HTML��，可以用浏览器来查看�?br />　　3�Q�org.apache.log4j.xml.XMLLayout�Q�以XML格式输出信息�?br />　　�C�Z��代码�Q?br />　　　　XMLLayout layout = new XMLLayout();
　　　　
　　　　FileAppender appender = null;
　　　　try {
　　　　　　appender = new FileAppender(layout, "test.xml");
　　　　} catch(Exception e) {}
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
�E�序�q�行后会(x��)在工�E�目录下生成一个test.xml文�g�?br />　　4�Q�org.apache.log4j.TTCCLayout�Q�输��Z��息的同时输出日志产生旉��、相关线�E�及(qi��ng)Category�{�信息�?br />　　�C�Z��代码�Q?br />　　　　TTCCLayout layout = new TTCCLayout();
　　　　//是否打印与TTCCLayout兌��的Category的名�U�ͼ�默认为true�Q�表�C�打�?br />　　　　layout.setCategoryPrefixing(true);
　　　　//是否打印当前�U�程�Q�默认�ؓ(f��)true�Q�表�C�打�?br />　　　　layout.setThreadPrinting(true);
　　　　//是否打印输出和当前线�E�相关的NDC信息�Q�默认�ؓ(f��)true�Q�表�C�打�?br />　　　　layout.setContextPrinting(true);
　　　　//讄��日期旉��格式
　　　　layout.setDateFormat("iso8601");
　　　　//讄��时区
　　　　layout.setTimeZone("GMT+8:00");
　　　　//讄��时区后需要调用此�Ҏ(gu��)��应用讄��
　　　　layout.activateOptions();
　　　　
　　　　ConsoleAppender appender = new ConsoleAppender(layout);
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
注意�Q�TTCCLayout输出的时间格式及(qi��ng)时区是可以设�|�的�Q?br />　　�Q?�Q�setDateFormat�Q�设�|�日期时间格式，有五个常用��|��(x��)"NULL"�Q�表�C�Z��输出�Q?RELATIVE"�Q�输��Z��息所用的旉��Q�以毫秒为单位，默认使用该��|��"ABSOLUTE"�Q�仅输出旉��部分�Q?DATE"�Q�按当前所在地区显�C�日期和旉��Q?ISO8601"�Q�按ISO8601标准昄��日期和时间。这些字�W�串不区分大��写。此外，�q�可以��用时间模式字�W�来格式化日期时��_(d��)��详细内容请参考J2SE文档中的 java.text.SimpleDateFormat�c�R�?br />　　�Q?�Q�setTimeZone�Q�设�|�时区，详细内容请参考J2SE文档中的java.util.TimeZone�c�d��java.util.SimpleTimeZone�c�R��但��h��意，当日期格式�ؓ(f��)"RELATIVE"�Ӟ��讄��时区�?x��)造成冲突�?br />　　5�Q�org.apache.log4j.PatternLayout�Q�用模式字符灉|��指定信息输出的格式�?br />　　�C�Z��代码�Q?br />　　　　String pattern = "Logger: %c %n"
　　　　　　　　+ "Date: %d{DATE} %n"
　　　　　　　　+ "Message: %m %n";
　　　　PatternLayout layout = new PatternLayout(pattern);
　　　　
　　　　ConsoleAppender appender = new ConsoleAppender(layout);
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　log.debug("output");
模式字符串简介：(x��)
　　%c�Q�Category名称。还可以使用%c{n}的格式输出Category的部分名�U�ͼ�其中n为正整数�Q�输出时�?x��)从Category名称的右侧�v�?n�?."�Q�然后截取第n�?."右侧的部分输出，例如Category的名�U�Cؓ(f��)"x.y.z"�Q�指定格式�ؓ(f��)"%c{2}"�Q�则输出"y.z"�?br />　　%C�Q�输��Z��息时Category所在类的名�U�ͼ�也可以��?C{n}的格式输出�?br />　　%d�Q�输��Z��息的旉��Q�也可以�?d{FormatString}的格式输出，其中FormatString的��D��参考TTCCLayout的setDateFormat�Ҏ(gu��)��Q�但NULL和RELATIVE�?d中无法��用�?br />　　%F�Q�输��Z��息时Category所在类文�g的名�U��?br />　　%l�Q�输��Z��息时Category所在的位置�Q��?%C.%M(%F:%L)"可以产生同样的效果�?br />　　%L�Q�输��Z��息时Category在类文�g中的行号�?br />　　%m�Q�信息本�w��?br />　　%M�Q�输��Z��息时Category所在的�Ҏ(gu��)��?br />　　%n�Q�换行符�Q�可以理解成回�R�?br />　　%p�Q�日志��别�?br />　　%r�Q�输��Z��息所用的旉��Q�以毫秒为单位�?br />　　%t�Q�当前线�E��?br />　　%x�Q�输出和当前�U�程相关的NDC信息�?br />　　%X�Q�输��Z��当前现成相关的MDC信息�?br />　　%%�Q�输�?�?br />此外�Q�还可以�?与模式字�W�之间加上修饰符来设�|�输出时的最��宽度、最大宽度及(qi��ng)文本寚w��方式�Q�例如：(x��)
　　%30d{DATE}�Q�按当前所在地区显�C�日期和旉��Q��ƈ指定最��宽度�ؓ(f��)30�Q�当输出信息��于30个字�W�时�?x��)补以空格�ƈ叛_��齐�?br />　　%-30d{DATE}�Q�也是按当前所在地区显�C�日期和旉��Q�指定最��宽度�ؓ(f��)30�Q��ƈ在字�W�少�?0时补以空��|��但由于��用了(ji��n)"-"�Q�因此对齐方式�ؓ(f��)左对齐，与默认情况一栗��?br />　　%.40d{DATE}�Q�也是按当前所在地区显�C�日期和旉��Q�但指定最大宽度�ؓ(f��)40�Q�当输出信息多于40个字�W�时�?x��)将左边多出的字�W�截掉。此外，最大宽度只支持默认的左寚w��方式�Q�而不支持叛_��齐�?br />　　%30.40d{DATE}�Q�如果输��Z��息少�?0个字�W�就补空格�ƈ叛_��齐，如果多于40个字�W�，��将左边多出的字�W�截掉�?br />　　%-30.40d{DATE}�Q�如果输��Z��息少�?0个字�W�就补空格�ƈ左对齐，如果多于40个字�W�，��将左边多出的字�W�截掉�?br />五、Log4J�q�阶
　　�?ji��n)解以上内容后，��已�l�初步掌握Log4J�?ji��n)，但要想灵�z�M��用Log4J�Q�则�q�需要了(ji��n)解其配置功能。这里简单介�l�一下�?br />　　1�Q�org.apache.log4j.BasicConfigurator�Q�默认��用ConsoleAppender以PatternLayout �Q��用PatternLayout.TTCC_CONVERSION_PATTERN�Q�即"%r [%t] %p %c %x - %m%n"格式�Q�输��Z��息�?br />　　�C�Z��代码�Q?br />　　　　BasicConfigurator.configure();
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.debug("output");
注意�Q�BasicConfigurator�?qi��ng)其它Configurator其实都只�Ҏ(gu��)��Category�q�行配置�Q�但�׃��用户创徏的Category�?x��)��承根Category的特性（声明�Q�许多资料介�l�Category�l�承关系旉��主要在讨��出��别，而事实上�Q�Category间��承的不仅是输出��别，所有特性都可以�l�承�Q�，因此输出时仍�?x��)显�C�BasicConfigurator配置的效果。此外，�q�可以��用configure�Ҏ(gu��)��指定Appender�Q�以自定义输出。BasicConfigurator允许同时指定多个Appender�?br />　　�C�Z��代码�Q?br />　　　　SimpleLayout layout1 = new SimpleLayout();
　　　　ConsoleAppender appender1 = new ConsoleAppender(layout1);
　　　　BasicConfigurator.configure(appender1);
　　　　
　　　　String pattern = "Logger: %c %n"
　　　　　　　　+ "Date: %d{DATE} %n"
　　　　　　　　+ "Message: %m %n";
　　　　PatternLayout layout2 = new PatternLayout(pattern);
　　　　FileAppender appender2 = null;
　　　　try {
　　　　　　appender2 = new FileAppender(layout2, "test.log", false);
　　　　}
　　　　catch(Exception e){}
　　　　BasicConfigurator.configure(appender2);
　　　　
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.debug("output");
�q�里用BasicConfigurator指定�?ji��n)两个Appender�Q�即ConsoleAppender和FileAppender�Q�程序运行后信息�?x��)在以SimpleLayout输出到控制台的同时以PatternLayout输出到test.log文�g。若要清除这些Appender�Q�可以调�?BasicConfigurator的resetConfiguration�Ҏ(gu��)��?br />　　2�Q?org.apache.log4j.PropertyConfigurator�Q�调用文本配�|�文件输��Z��息，通常使用.properties文�g。配�|�文件以"�?�?的�Ş式保存数据，注释�?#"开头。PropertyConfigurator和配�|�文件在介绍SocketAppender�?SocketHubAppender时曾提到�q�。��用PropertyConfigurator可以避免��编码�?br />　　�C�Z��代码�Q?br />　　　　PropertyConfigurator.configure("test.properties");
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.debug("output");
要完成该�C�Z��Q�还需要在工程目录下创��Z��个test.properties文�g�Q�内容如下：(x��)
　　##讄��根Category�Q�其值由输出�U�别和指定的Appender两部分组�?br />　　#�q�里讄��输出�U�别为DEBUG
　　log4j.rootLogger=DEBUG,appender
　　##输出信息到控制台
　　#创徏一个名为appender的Appender�Q�类型�ؓ(f��)ConsoleAppender
　　log4j.appender.appender=org.apache.log4j.ConsoleAppender
　　#讄��a(ch��n)ppender以SimpleLayout输出
　　log4j.appender.appender.layout=org.apache.log4j.SimpleLayout
此外�Q�PropertyConfigurator也允许同时指定多个Appender�Q�例如：(x��)
　　#�q�里没有讄��输出�U�别�Q�但指定�?ji��n)两个Appender
　　log4j.rootLogger=,appender1,appender2
　　#输出信息到控制台
　　log4j.appender.appender1=org.apache.log4j.ConsoleAppender
　　log4j.appender.appender1.layout=org.apache.log4j.SimpleLayout
　　#输出信息到文�?br />　　log4j.appender.appender2=org.apache.log4j.FileAppender
　　log4j.appender.appender2.File=test.log
　　log4j.appender.appender2.Append=false
　　log4j.appender.appender2.layout=org.apache.log4j.PatternLayout
　　log4j.appender.appender2.layout.ConversionPattern=Logger: %c %nDate: %d{DATE} %nMessage: %m %n
关于更多配置�Q�网上示例很多，�q�里不再赘述。但要说明一件事�Q�就是配�|�文件中的键是怎么来的。参照后一个示例，查看 PropertyConfigurator源码�Q�会(x��)发现"log4j.rootLogger"是定义好的，只能照写�Q��?log4j.appender" 字样也可以找刎ͼ�与指定的Appender名称appender1、appender2联系��h��Q�log4j.appender.appender1�?log4j.appender.appender2也就不难理解�?ji��n)；再看下去�Q�还能找�?prefix + ".layout""�Q�这样log4j.appender.appender1.layout也有�?ji��n)；可�?log4j.appender.appender2.File 和log4j.appender.appender2.Append呢？�q�记得前边介�l�FileAppender时曾提到的setAppend�Ҏ(gu��)��吗？其实FileAppender�q�有个getAppend�Ҏ(gu��)��Q�这说明FileAppender��h��Append属性。那么F(tu��n)ile呢？当然也是 FileAppender的属性了(ji��n)。至于log4j.appender.appender2.layout.ConversionPattern也一��P��只不�q�FileAppender换成�?ji��n)PatternLayout。其实别的Appender和Layout的属性也都是�q�样定义成键来进行设�|�的。此外，定义键时�Q�属性的首字母不区分大小写，例如"File"�Q�也可以写成"file"�?br />　　3�Q?org.apache.log4j.xml.DOMConfigurator�Q�调用XML配置文�g输出信息。其定义文档是log4j- 1.2.11.jar中org\apache\log4j\xml包下的log4j.dtd文�g。与PropertyConfigurator相比�Q?DOMConfigurator��g��是趋�ѝ�?br />　　�C�Z��代码�Q?br />　　　　DOMConfigurator.configure("test.xml");
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.debug("output");
要完成该�C�Z��Q�也需要在工程目录下创��Z��个test.xml文�g�Q�内容如下：(x��)
　　
　　
　　
　　　　
　　　　
　　　　　　
　　　　　　
　　　　
　　　　
　　　　
　　　　　　
　　　　　　
　　　　
　　
此外�Q�DOMConfigurator也允许同时指定多个Appender�Q�例如：(x��)
　　
　　
　　
　　　　
　　　　
　　　　　　
　　　　
　　　　
　　　　
　　　　　　
　　　　　　
　　　　　　
　　　　　　　　
　　　　　　
　　　　
　　　　
　　　　
　　　　　　
　　　　　　
　　　　
　　
�׃��以上两个�C�Z��是在PropertyConfigurator的两个示例基��上改的，而且也写�?ji��n)注释，因此�q�里只简单介�l�一�?lt;param> 标记�?lt;param>标记有两个属性，name和value�Q�前者的��g��是Appender或Layout的属性名�Q�作用与 log4j.appender.appender2.File�q�样的键一栗��设�|�时�Q�首字母同样不区分大��写�Q�例�?File"也可以写�?file"。此外还��h��意，使用�q�两�D�XML代码时应��中文注释去掉，或者把中的UTF-8�Ҏ(gu��)��GBK或GB2312�Q�否则会(x��)��D��错误。这里��用的UTF-8是XML默认的字�W�集�?br />　　4�Q?org.apache.log4j.lf5.DefaultLF5Configurator�Q�默认��用LF5Appender来输��Z��息，需要调�?log4j-1.2.11.jar中org\apache\log4j\lf5\config包下的defaultconfig.properties文�g�?br />　　�C�Z��代码�Q?br />　　　　try {
　　　　　　DefaultLF5Configurator.configure();
　　　　}
　　　　catch(Exception e){}
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.debug("output");
　　下面讨论另外一个话题：(x��)Diagnostic Context。Diagnostic Context意�ؓ(f��)诊断环境�Q�针对于多用户�ƈ发环境，在这�U�环境下�Q�通常需要对每个客户端提供独立的�U�程以处理其��h��Q�此时若要在日志信息中对客户端加以区分，为每个线�E�分别创建Category是个办法。但�q�样做�ƈ不高效，反而会(x��)��D��大量资源被占用。Diagnostic Context所要解决的��是�q�个问题。Diagnostic Context�?x��)��?f��)当前�U�程提供一定空��_(d��)��然后��信息保存到该空间供Category调用。与创徏一个Category相比�Q�这点信息所占的资源自然要少得多�?br />　　1�Q�org.apache.log4j.NDC。NDC是Nested Diagnostic Context的简写，意�ؓ(f��)嵌套诊断环境�Q��用时提供一个堆栈对象来保存信息。堆栈的特点是数据后�q�先出、先�q�后出，��x��理堆栈时�Q�后保存的数据会(x��)被先清掉�Q�而先保存的数据则被后清掉�?br />　　�C�Z��代码�Q?br />　　　　PatternLayout layout = new PatternLayout("%m %x%n");
　　　　ConsoleAppender appender = new ConsoleAppender(layout);
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　
　　　　String tmp = "zhengyp"; //模拟从客��L(f��ng)��获取的信�?br />　　　　log.debug("Start");
　　　　NDC.push(tmp); //��d��信息到堆栈中
　　　　log.debug("Before");
　　　　NDC.pop(); //��信息从堆栈中移�?br />　　　　log.debug("After");
　　　　NDC.remove(); //��当前线�E�移除，退出NDC环境
　　　　log.debug("End");
�q�里使用�?ji��n)PatternLayout来格式化信息�Q�其模式字符%x��是用来输出NDC信息的。程序运行后�?x��)输出如下内容�?x��)
　　Start
　　Before zhengyp
　　After
　　End
可以看到�Q�第二行输出时由于已向堆栈中��d��?ji��n)信息，因�?zhengyp"也会(x��)同时输出�Q�而第三行输出时由于信息已被移除，因此��没再输�?zhengyp"。不�q�这个示例仅��单演�C�Z��(ji��n)NDC的用法，而没有显�C�出NDC的堆栈特性，所以下面再提供一个示例，代码如下�Q?br />　　TTCCLayout layout = new TTCCLayout();
　　ConsoleAppender appender = new ConsoleAppender(layout);
　　Logger log = Logger.getLogger(Test.class);
　　log.addAppender(appender);
　　
　　log.debug("Start");
　　NDC.push("zhengyp"); //��d��信息到堆栈中
　　log.debug("Test1");
　　NDC.push("192.168.0.1"); //向堆栈中�q�加信息
　　log.debug("Test2");
　　NDC.pop(); //从堆栈中�U�除信息�Q�但�U�除的只是最后的信息
　　log.debug("Test3");
　　NDC.pop(); //再次从堆栈中�U�除信息
　　log.debug("Test4");
　　log.debug("End");
�q�里格式化输��Z��息��用的是TTCCLayout�Q�还记得其setContextPrinting�Ҏ(gu��)��吗？�E�序�q�行后，从输出的信息��可以看到效果了(ji��n)。此外，NDC�q�提供了(ji��n)其他�Ҏ(gu��)��Q?br />　　�Q?�Q�get�Q�获取堆栈中的全部信息。以上例��Z��Q�当输出Test2�Ӟ��使用该方法会(x��)获得"zhengyp 192.168.0.1"�?br />　　�Q?�Q�peek�Q�获取堆栈中最后的信息。仍以上例�ؓ(f��)例，当输出Test1时会(x��)获得"zhengyp"�Q�Test2时�ؓ(f��)"192.168.0.1"�Q�而当输出Test3时由�?192.168.0.1"已被�U�除�Q?zhengyp"又成�?ji��n)最后的信息�Q�因此获得的仍是"zhengyp"�?br />　　�Q?�Q�clear�Q�清�I�堆栈中的全部信息�?br />　　�Q?�Q�setMaxDepth�Q�设�|�堆栈的最大深度，卛_��前的信息可以保留多少�Q�对之后�q�加的信息没有媄(ji��ng)响。当需要一�ơ清掉多条信息时�Q��用setMaxDepth�?x��)比多次调用pop方便�?br />　　2�Q�org.apache.log4j.MDC。MDC是Mapped Diagnostic Context的简写，意�ؓ(f��)映射诊断环境�Q�提供了(ji��n)一个Map对象来保存信息。Map对象使用Key、Value的�Ş式保存倹{�?br />　　�C�Z��代码�Q?br />　　　　PatternLayout layout = new PatternLayout("%m %X{name} %X{ip}%n");
　　　　ConsoleAppender appender = new ConsoleAppender(layout);
　　　　Logger log = Logger.getLogger(Test.class);
　　　　log.addAppender(appender);
　　　　
　　　　log.debug("Start");
　　　　//��d��信息到Map�?br />　　　　MDC.put("name", "zhengyp1");
　　　　MDC.put("ip", "192.168.1.1");
　　　　log.debug("Test1");
　　　　
　　　　//��d��信息到Map中，若Key重复�Q�则覆盖之前的�?br />　　　　MDC.put("name", "zhengyp2");
　　　　MDC.put("ip", "192.168.1.2");
　　　　log.debug("Test2");
　　　　
　　　　//��信息从Map中移除，此时信息不再输出
　　　　MDC.remove("name");
　　　　MDC.remove("ip");
　　　　log.debug("End");
�q�个�C�Z��演示�?ji��n)MDC的基本用法，格式化信息用的也是PatternLayout�Q�模式字�W��ؓ(f��)"%X"�Q�其格式必须�?%X{Key}"。其中Key��是�?Map对象��d��信息时put�Ҏ(gu��)��所用的Key�Q�这里�ؓ(f��)name和ip。由于可以��?%X{Key}"输出信息�Q�因此MDC使用��h��?x��)比NDC更灵�z�R��此外，MDC�q�提供了(ji��n)get�Ҏ(gu��)��来获取指定Key的信息�?br />六、小�l?br />　　用了(ji��n)�q�半个月�Q�终于大概掌握了(ji��n)Log4J。由于本文是边学边写的，目的是将Log4J的用法记录下来，而非提供一份中文参考，因此内容�q�不�l�致�Q�但��量提供�?ji��n)示例。不�q�到最后才发现�Q�示例存在问题，其实Logger做�ؓ(f��)�cȝ��static成员比较恰当�Q�而我��Z��(ji��n)图方便，竟直接写��C��(ji��n)main�Ҏ(gu��)��中，�q�一点还��h��意�?br />　　此外�Q�这里再推荐一下《The Complete log4j Manual》，是对Log4J较详�l�的介绍�Q�在�|�上可以扑ֈ��Q�只不过是英文的�?/p>

Binary 2006-09-01 13:25 发表评论

使用Jakarta Commons Pool处理对象池化

Binary — Thu, 24 Aug 2006 09:49:00 GMT

摘要: 恰当��C��用对象池化技术，可以有效地减��对象生成和初始化时的消耗，提高�pȝ��的运行效率。Jakarta Commons Pool�l��g提供�?ji��n)一整套用于实现对象池化的框�Ӟ��以及(qi��ng)若干�U�各��L(f��ng)��色的对象池实玎ͼ�可以有效地减��处理对象池化时的工作量�Q��ؓ(f��)其它重要的工作留下更多的�_�֊�和时间�? 创徏新的对象�q�初始化的操作，可能�?x��)消耗很多的旉��。在�q�种对象的初始化工作包含�?ji��n)一些费时的操作�Q�例... 阅读全文

Binary 2006-08-24 17:49 发表评论

Binary — Tue, 22 Aug 2006 02:47:00 GMT

摘要: 基本对象 1�Q? Command 接口。它�? Commons Chain �?.. 阅读全文

Binary 2006-08-22 10:47 发表评论

Binary — Tue, 22 Aug 2006 02:40:00 GMT

作�ؓ(f��)�E�序开发�h员，我们�l�常需要对一个实际上�E�序性的�pȝ��应用面向对象的方法。商业分析家和管理�h员描�q�这��L(f��ng)��pȝ��旉��常不��用类层次和序列图�Q�而是使用��程囑֒�工作��图表。但是不论如何，使用面向对象的方法解册��些问题时�?x��)带来更多的灉|��性。面向对象的设计模式提供�?ji��n)有用的�l�构和行为来描述�q�种��序的处理，比如模版�Ҏ(gu��)��Q�Template Method�Q�[GoF]和责任链�Q�Chain of Responsibility�Q�[GoF]�?br />
Jakarta Commons的子��目Chain��上�q�C��个模式组合成一个可复用的Java框架用于描述��序的处理流�E�。这个在Jakarta Commons project�C�֌�中开发的框架�Q�已�l�被�q�泛的接受�ƈ且��用于许多有趣的应用中�Q�特别的是他被Struts和Shale应用框架作�ؓ(f��)处理HTTP��h��处理的基��机制。你可以在需要定义和执行一�l�连�l�的步骤时��用Commons Chain�?br />
至于�l�典设计模式�Q�开发者和架构师普遍��用模版方法（Template Method�Q�造型��序处理。模版方法（Template Method�Q�中使用一个抽象的父类定义使用的算法：(x��)处理的步骤，具体实现交给子类。当�?d��ng)��父类也可以��?f��)��法所使用的方法提供一个缺省实现�?br />
�׃��模版�Ҏ(gu��)��Q�Template Method�Q�依赖��扎�(k��)��—子�c�d��ȝ��承定义了(ji��n)��法的父�c�Z��—因此��用这个模式的软�g表现出紧耦合而且�~�少灉|��性。又�׃��实现�c�L��加自��q��行�ؓ(f��)前必��L��展父�c�，沟每⑷嗽北�q�拗朴诶嗖愦沃校䄦拗屏顺�l�蛏杓频牧榛钚�ʎommons Chain使用配置文�g定义��法�Q�在�E�序�q�行时解析配�|�文�Ӟ��从而很好的解决�?ji��n)这个问题�?br />
现在来看一下Commons Chain是怎样工作的，我们从一个�h造的例子开始：(x��)二手车销售员的商业流�E�。下面是销售流�E�的步骤�Q?br />1.        得到用户信息
2.        试�R
3.        谈判销�?br />4.        安排财务
5.        �l�束销�?br />
现在假设使用模版�Ҏ(gu��)��Q�Template Method�Q�造型�q�个��程。首先徏立一个定义了(ji��n)��法的抽象类�Q?br />
清单1

public abstract class SellVehicleTemplate {
        public void sellVehicle() {
        getCustomerInfo();
        testDriveVehicle();
        negotiateSale();
        arrangeFinancing();
        closeSale();
        }

        public abstract void getCustomerInfo();
        public abstract void testDriveVehicle();
        public abstract void negotiateSale();
        public abstract void arrangeFinancing();
        public abstract void closeSale();        
}

现在来看一下怎样用Commons Chain实现�q�个��程。首先，下蝲Commons Chain。你可以直接下蝲最新的zip或tar文�g�Q�也可以从CVS或者SubVersion源码库检出Commons Chain模块得到最新的代码。解压羃打包文�g�Q�将commons-chain.jar攑օ�你的classpath中�?br />
使用Commons Chain实现�q�个商业��程�Q�必��d��程中的每一步写成一个类�Q�这个类需要有一个public的方法execute()。这和传�l�的命��o(h��)模式�Q�Command pattern�Q�实现相同。下面简单实��C��(ji��n)“得到用户信息”：(x��)

清单2

package com.jadecove.chain.sample;

import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;

public class GetCustomerInfo implements Command {
        public boolean execute(Context ctx) throws Exception {
                System.out.println("Get customer info");
                ctx.put("customerName","George Burdell");
                return false;
        }
}

�׃��只是演示�Q�这个类�q�没有做很多工作。这里将用户名放入了(ji��n)Context对象ctx中。这个Context对象�q�接�?ji��n)各个命令。暂时先��这个对象想象成�Ҏ(gu��)��关键字存取值的哈希表。所有后来的命��o(h��)可以通过它访问刚才放入的用户名。TestDriveVehicle�Q�NegotiateSale�?ArrangeFinancing命��o(h��)的实现只是简单的打印�?ji��n)将执行什么操作�?br />
清单3

package com.jadecove.chain.sample;

import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;

public class TestDriveVehicle implements Command {
        public boolean execute(Context ctx) throws Exception {
                System.out.println("Test drive the vehicle");
                return false;
        }
}

public class NegotiateSale implements Command {
        public boolean execute(Context ctx) throws Exception {
                System.out.println("Negotiate sale");
                return false;
        }
}

public class ArrangeFinancing implements Command {
        public boolean execute(Context ctx) throws Exception {
                System.out.println("Arrange financing");
                return false;
        }
}

CloseSale从Context对象中取出GetCustomerInfo攑օ�的用户名�Q��ƈ��其打印�?br />清单4

package com.jadecove.chain.sample;

import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;

public class CloseSale implements Command {
        public boolean execute(Context ctx) throws Exception {
                System.out.println("Congratulations "
                  +ctx.get("customerName")
                        +", you bought a new car!");
                return false;
        }
}

现在你可以将�q�个��程定义成一个序列（或者说“命令链”）(j��)�?br />清单5

package com.jadecove.chain.sample;

import org.apache.commons.chain.impl.ChainBase;
import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;
import org.apache.commons.chain.impl.ContextBase;

public class SellVehicleChain extends ChainBase {
        public SellVehicleChain() {
                super();
                addCommand(new GetCustomerInfo());
                addCommand(new TestDriveVehicle());
                addCommand(new NegotiateSale());
                addCommand(new ArrangeFinancing());
                addCommand(new CloseSale());
        }
        public static void main(String[] args) throws Exception {
                Command process = new SellVehicleChain();
                Context ctx = new ContextBase();
                process.execute(ctx);
        }
}

�q�行�q�个�c�d��?x��)输��Z��下结果：(x��)
Get customer info
Test drive the vehicle
Negotiate sale
Arrange financing
Congratulations George Burdell, you bought a new car!

在进一步深入之前，让我们来看一下我们��用了(ji��n)的Commons Chain的类和接口�?br />

Command �c�d��Chain�cȝ��关系��是�l�合模式�Q�Composite pattern�Q�[GoF]的例子：(x��)Chain不仅由多个Command�l�成�Q�而且自己也是Command。这使你可以非常��单得��单个命令（Command�Q�替换成由多个命令（Command�Q�组成的链（Chain�Q�。这个由Command对象唯一操作定义的方法代表了(ji��n)一个直接的命��o(h��)�Q?br />
public boolean execute(Context context);

参数context仅仅是一个存放了(ji��n)名称-值对的集合。接口Context在这里作��Z��个标记接口：(x��)它扩展了(ji��n)java.util.Map但是没有��d��M��Ҏ(gu��)��的行为。于此相反，�c�ContextBase不仅提供�?ji��n)对Map的实现而且增加�?ji��n)一个特性：(x��)属�?域透明。这个特性可以通过使用Map的put和get �Ҏ(gu��)��操作JavaBean的域�Q�当然这些域必须使用标准的getFoo和setFoo�Ҏ(gu��)��定义。那些通过JavaBean的“setter”方法设�|�的��|��可以通过对应的域名称�Q�用Map的get�Ҏ(gu��)��得到。同��P��那些用Map的put�Ҏ(gu��)��讄��的值可以通过JavaBean的“getter”方法得到�?br />
例如�Q�我们可以创��Z��个专门的context提供昑ּ�的customerName属性支持�?br />清单6

package com.jadecove.chain.sample;

import org.apache.commons.chain.impl.ContextBase;

public class SellVehicleContext extends ContextBase {

        
        private String customerName;

        public String getCustomerName() {
                return customerName;
        }
        
        public void setCustomerName(String name) {
                this.customerName = name;
        }
}

现在你既可以�q�行Map的一般属性存取操作同时也可以使用昑ּ�的JavaBean的访问和修改域的�Ҏ(gu��)��Q�这两个��生同��L(f��ng)��效果。但是首先你需要在�q�行SellVehicleChain时实例化SellVehiceContext而不是ContextBase�?br />清单7

public static void main(String[] args) throws Exception {
                Command process = new SellVehicleChain();
                Context ctx = new SellVehicleContext();
                process.execute(ctx);
        }

��管你不改变GetCustomerInfo中存攄��户名的方法——仍然��用ctx.put("customerName", "George Burdell")——你可以在CloseSale中��用getCustomerName()�Ҏ(gu��)��得到用户名�?br />清单8

        public boolean execute(Context ctx) throws Exception {
            SellVehicleContext myCtx = (SellVehicleContext) ctx;
            System.out.println("Congratulations "
                                   + myCtx.getCustomerName()
                                  + ", you bought a new car!");
            return false;
        }

那些依赖�c�d��安全和context的显式域的命令（Command�Q�可以利用标准的getter和setter�Ҏ(gu��)��。当一些新的命令（Command�Q�被��d��Ӟ��它们可以不用考虑context的具体实玎ͼ�直接通过Map的get和put操作属性。不论采用何�U�机�Ӟ��ContextBase�c�都可以保证命��o(h��)�Q�Command�Q�间可以通过context互操作�?br />
下面�q�个例子展示�?ji��n)如何��用Commons Chain的API建立�q�执行一�l�顺序的命��o(h��)。当�?d��ng)��和现在大多数Java软�g一��P��Commons Chain可以使用XML文�g作�ؓ(f��)配置文�g。你可以��“汽车销售”流�E�的步骤在XML文�g中定义。这个文件有个规范的命名chain- config.xml�?br />
清单9


  
            className="com.jadecove.chain.sample.GetCustomerInfo"/>
            className="com.jadecove.chain.sample.TestDriveVehicle"/>
            className="com.jadecove.chain.sample.NegotiateSale"/>
            className="com.jadecove.chain.sample.ArrangeFinancing"/>
            className="com.jadecove.chain.sample.CloseSale"/>

Chain的配�|�文件可以包含多个链定义�Q�这些链定义可以集合�q�不同的�~�目中。在�q�个例子中，铑֮�义在一个默认的�~�目中定义。事实上�Q�你可以在这个文件中定义多个名字的编目，每个�~�目可拥有自��q��铄��?br />
现在你可以��用Commons Chain提供的类载入�~�目�q�得到指定的链，而不用像SellVehicleChain中那栯��己在�E�序中定义一�l�命令：(x��)
清单10

package com.jadecove.chain.sample;

import org.apache.commons.chain.Catalog;
import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;
import org.apache.commons.chain.config.ConfigParser;
import org.apache.commons.chain.impl.CatalogFactoryBase;

public class CatalogLoader {
        private static final String CONFIG_FILE = 
                "/com/jadecove/chain/sample/chain-config.xml";
        private ConfigParser parser;
        private Catalog catalog;
        
        public CatalogLoader() {
                parser = new ConfigParser();
        }
        public Catalog getCatalog() throws Exception {
                if (catalog == null) {
                
        parser.parse(this.getClass().getResource(CONFIG_FILE));                
        
                }
                catalog = CatalogFactoryBase.getInstance().getCatalog();
                return catalog;
        }
        public static void main(String[] args) throws Exception {
                CatalogLoader loader = new CatalogLoader();
                Catalog sampleCatalog = loader.getCatalog();
                Command command = sampleCatalog.getCommand("sell-vehicle");
                Context ctx = new SellVehicleContext();
                command.execute(ctx);
        }
}

Chain 使用Commons Digester来读取和解析配置文�g。因此你需要将Commons Digester.jar加入classpath中。我使用�?.6版本�q�且工作得很好。Digester使用�?ji��n)Commons Collectios�Q�我使用的版本是3.1�Q�，Commons Logging�Q�版�?.0.4�Q�，Commons BeanUtils�Q?.7.0�Q�，因此你也需要将它们的jar文�g加入classpath中。在加入�q�些jar后，CatalogLoader��可以被�~�译和运行，它的输出和另外两个测试完全相同�?br />
现在你可以在XML文�g中定义链�Q��ƈ可以在程序中得到�q�个链（别忘�?ji��n)链也是命��o(h��)�Q�，�q�样扩展的可能性和�E�序的灵�z�L��可以说是无限的。假设过�E�“安排胦(ch��)务”实际上�׃��个完全分��ȝ��商业部门处理。这个部门希望�ؓ(f��)�q�种销售徏立自��q��工作��程�?Chain提供�?ji��n)嵌套链来实现这个要求。因为链本��n��是命��o(h��)�Q�因此你可以用指向另一个链的引用替换一个单一用途的命��o(h��)。下面是增加�?ji��n)新��程的链的定义�?x��)
清单11


   
                          className="com.jadecove.chain.sample.GetCustomerInfo"/>
                          className="com.jadecove.chain.sample.TestDriveVehicle"/>
                          className="com.jadecove.chain.sample.NegotiateSale"/>
                          className="org.apache.commons.chain.generic.LookupCommand"
             catalogName="auto-sales"
                      name="arrange-financing"
                  optional="true"/>
                          className="com.jadecove.chain.sample.CloseSale"/>
   
   
                          className="com.jadecove.chain.sample.ArrangeFinancing"/>

Commons Chain提供�?ji��n)一个常用的命��o(h��)LookupCommand来查扑֒�执行另一个链。属性optional用于控制当指定的嵌套链没有找到时如何处理�?optional=true�Ӟ��即��链没扑ֈ��Q�处理也�?x��)��l�。反之，LookupCommand��抛�?IllegalArgumentException�Q�告知指定的命��o(h��)未找到�?br />
在下面三�U�情况下�Q�命令链��结束：(x��)
1.        命��o(h��)的execute�Ҏ(gu��)��q�回true
2.        �q�行��C��(ji��n)铄��头
3.        命��o(h��)抛出异常

当链完全处理完一个过�E�后�Q�命令就�q�回true。这是责任链模式�Q�Chain of Responsibility�Q�的基本概念。处理从一个命令传递到另一个命令，直到某个命��o(h��)�Q�Command�Q�处理了(ji��n)�q�个命��o(h��)。如果在到达命��o(h��)序列��头时仍没有处理�q�回true�Q�也假设铑ַ��l�正常结束�?br />
当有命��o(h��)抛出错误旉��׃��(x��)非正常结束。在Commons Chain中，如果有命令抛出错误，铄��执行��׃��(x��)中断。不论是�q�行旉��误（runtime exception�Q�还是应用错误（application exception�Q�，都会(x��)抛出�l�链的调用者。但是许多应用都需要对在命令之外定义的错误做明��的处理。Commons Chain提供�?ji��n)Filter接口来满��个要求。Filter�l�承�?ji��n)Command�Q�添加了(ji��n)一个名为postprocess的方法�?br />
public boolean postprocess(Context context, Exception exception);
只要Filter的execute�Ҏ(gu��)��被调用，不论铄��执行�q�程中是否抛出错误，Commons Chain都将保证Filter的postprocess�Ҏ(gu��)��被调用。和servlet的过滤器�Q�filter�Q�相同，Commons Chain的Filter按它们在链中的顺序依�ơ执行。同��P��Filter的postprocess�Ҏ(gu��)��按倒序执行。你可以使用�q�个�Ҏ(gu��)��实现自��q��错误处理。下面是一个用于处理我们例子中的错误的Filter�Q?br />清单12

package com.jadecove.chain.sample;

import org.apache.commons.chain.Context;
import org.apache.commons.chain.Filter;

public class SellVehicleExceptionHandler implements Filter {

        public boolean execute(Context context) throws Exception {
                System.out.println("Filter.execute() called.");
                return false;
        }

        public boolean postprocess(Context context,
                                 Exception exception) {
                if (exception == null) return false;
                System.out.println("Exception "
                              + exception.getMessage()
                              + " occurred.");
                return true;
        }
}

Filter在配�|�文件中的定义就和普通的命��o(h��)�Q�Command�Q�定义相同：(x��)
清单13


       className =
           "com.jadecove.chain.sample.SellVehicleExceptionHandler"/>
        className="com.jadecove.chain.sample.GetCustomerInfo"/>

Filter 的execute�Ҏ(gu��)��按定义的序列调用。然而，它的postprocess�Ҏ(gu��)��在链执行完毕或抛出错误后执行。当一个错误被抛出�Ӟ�� postprocess�Ҏ(gu��)��处理完后�?x��)返回true�Q�表�C�错误处理已�l�完成。链的执行�ƈ不会(x��)��此�l�束�Q�但是本质上来说�q�个错误被捕捉而且不会(x��)再向外抛出。如果postprocess�Ҏ(gu��)��q�回false�Q�那错误�?x��)��l�向外抛出，然后铑ְ��?x��)非正常�l�束�?br />
让我们假设ArrangeFinancing因�ؓ(f��)用户信用卡损坏抛出错误。SellVehicleExceptionHandler��p��捕捉到这个错误，�E�序输出如下�Q?br />Filter.execute() called.
Get customer info
Test drive the vehicle
Negotiate sale
Exception Bad credit occurred.

�l�合�?ji��n)过滤器�Q�filter�Q�和子链技术后�Q�你��可以造型很复杂的工作��程�?br />
Commons Chain是一个很有前途的框架�Q�现在仍在开发，新的功能被频�J�地��d��到其中。在下一��关于Commons Chain的文章中�Q�我们将研究Struts 1.3中是如何使用Commons Chain的�?br />
Struts 1.3中用完全使用Commons Chain的类替换�?ji��n)原来的处理HTTP��h��的类。如果你以前自己定制�q�Struts的请求处理（request processor�Q�，你将发现处理�q�个问题时Commons Chain为程序带来了(ji��n)很好的灵�z�L��?img src ="http://www.tkk7.com/lijiajia418/aggbug/64990.html" width = "1" height = "1" />

Binary 2006-08-22 10:40 发表评论