Wed, 05 Jul 2006 08:19:00 GMT

Log4j有三个主要的�l��g�Q�Loggers�Q�Appenders和Layouts�Q�这里可��单理解�ؓ日志�c�d��Q�日志要输出的地方和日志以何�U��Ş式输出。综合��用这三个�l��g可以��L��的记录信息的�c�d��和��别，�q�可以在�q�行时控制日志输出的样式和位�|�。下面对三个�l��g分别�q�行说明�Q?

1�?Loggers

Loggers�l��g在此�pȝ��中被分�ؓ五个�U�别�Q�DEBUG、INFO、WARN、ERROR和FATAL。这五个�U�别是有��序的，DEBUG < INFO < WARN < ERROR < FATAL�Q�明白这一点很重要�Q�这里Log4j有一个规则：假设Loggers�U�别为P�Q�如果在Loggers中发生了一个��别Q比P高，则可以启动，否则屏蔽掉�?/p>

Java�E�序举例来说�Q?/strong>

//建立Logger的一个实例，命名为“com.foo�?/p>
Logger logger = Logger.getLogger("com.foo");

//讄��logger的��别。通常不在�E�序中设�|�logger的��别。一般在配置文�g中设�|��?/p>
logger.setLevel(Level.INFO);

Logger barlogger = Logger.getLogger("com.foo.Bar");

//下面�q�个��h��可用�Q�因为WARN >= INFO

logger.warn("Low fuel level.");

//下面�q�个��h��不可用，因�ؓDEBUG < INFO

logger.debug("Starting search for nearest gas station.");

//命名为“com.foo.bar”的实例barlogger会��承实例“com.foo”的�U�别。因此，下面�q�个��h��可用�Q�因为INFO >= INFO

barlogger.info("Located nearest gas station.");

//下面�q�个��h��不可用，因�ؓDEBUG < INFO

barlogger.debug("Exiting gas station search");

�q�里“是否可用”的意思是能否输出Logger信息�?/strong>

    在对Logger实例�q�行命名�Ӟ��没有限制�Q�可以取��L��自己感兴��的名字。一般情况下��以类的所在位�|�来命名Logger实例�Q�这是目前来讲比较有效的Logger命名方式。这样可以��得每个类建立自己的日志信息，便于��理。比如：

static Logger logger = Logger.getLogger(ClientWithLog4j.class.getName());

2�?Appenders

    ��用与��用日志请求只是Log4j其中的一个小��的地方�Q�Log4j日志�pȝ��允许把日志输出到不同的地方，如控制台�Q�Console�Q�、文�Ӟ��Files�Q�、根据天数或者文件大��生新的文件、以��的形式发送到其它地方�{�等�?/p>

其语法表�C�Zؓ�Q?/p>
org.apache.log4j.ConsoleAppender�Q�控制台�Q�，

org.apache.log4j.FileAppender�Q�文�Ӟ��Q?br />org.apache.log4j.DailyRollingFileAppender�Q�每天��生一个日志文�Ӟ��Q�org.apache.log4j.RollingFileAppender�Q�文件大��到达指定尺寸的时候��生一个新的文�Ӟ��Q?br />org.apache.log4j.WriterAppender�Q�将日志信息以流格式发送到��L��指定的地方）

配置时��用方式�ؓ�Q?/p>
log4j.appender.appenderName = fully.qualified.name.of.appender.class

log4j.appender.appenderName.option1 = value1

�?/p>
log4j.appender.appenderName.option = valueN

�q�样��׃ؓ日志的输出提供了相当大的便利�?/p>

3�?Layouts

    有时用户希望�Ҏ��自己的喜好格式化自己的日志输出。Log4j可以在Appenders的后面附加Layouts来完成这个功能。Layouts提供了四�U�日志输出样式，如根据HTML样式、自由指定样式、包含日志��别与信息的样式和包含日志旉��、线�E�、类别等信息的样式等�{��?/p>

其语法表�C�Zؓ�Q?/p>
org.apache.log4j.HTMLLayout�Q�以HTML表格形式布局�Q�，
org.apache.log4j.PatternLayout�Q�可以灵�z�d��指定布局模式�Q�，
org.apache.log4j.SimpleLayout�Q�包含日志信息的�U�别和信息字�W�串�Q�，
org.apache.log4j.TTCCLayout�Q�包含日志��生的旉��、线�E�、类别等�{�信息）

配置时��用方式�ؓ�Q?/p>

     log4j.appender.appenderName.layout =       fully.qualified.name.of.layout.class
     log4j.appender.appenderName.layout.option1 = value1
     �?br />     log4j.appender.appenderName.layout.option = valueN

    以上是从原理斚w��说明Log4j的��用方法，在具体Java�~�程使用Log4j可以参照以下�C�Z��Q?br />1�?建立Logger实例�Q?br />    语法表示�Q�public static Logger getLogger( String name)
    实际使用�Q�static Logger logger = Logger.getLogger   (ServerWithLog4j.class.getName ()) ;
2�?��d��配置文�g�Q?/strong>
    获得了Logger的实例之后，接下来将配置Log4j使用环境�Q?br />    语法表示�Q?br />    BasicConfigurator.configure()�Q�自动快速地使用�~�省Log4j环境�?br />    PropertyConfigurator.configure(String configFilename)�Q�读取��用Java的特性文件编写的配置文�g�?br />    DOMConfigurator.configure(String filename)�Q�读取XML形式的配�|�文件�?br />    实际使用�Q�PropertyConfigurator.configure("ServerWithLog4j.properties");
3�?插入日志信息
    完成了以上连个步骤以后，下面��可以按日志的不同��别插入到你要记录日志的�Q何地方了�?br />    语法表示�Q?br />    Logger.debug(Object message);
    Logger.info(Object message);
    Logger.warn(Object message);
    Logger.error(Object message);
    实际使用�Q�logger.info("ServerSocket before accept: " + server);

    在实际编�E�时�Q�要使Log4j真正在系�l�中�q�行事先�q�要寚w��|�文件进行定义。定义步骤就是对Logger、Appender及Layout的分别��用，具体如下�Q?br />1�?配置根Logger�Q�其语法为：
    log4j.rootLogger = [ level ] , appenderName, appenderName, �?br />�q�里level指Logger的优先��Q�appenderName是日志信息的输出圎ͼ�可以同时指定多个输出地。如�Q�log4j.rootLogger= INFO,A1,A2
2�?配置日志信息输出目的�?/strong>�Q�其语法为：
    log4j.appender.appenderName = fully.qualified.name.of.appender.class
    可以指定上面所�q�C��个目的地中的一个�?br />3�?配置日志信息的格�?/strong>�Q�其语法为：
    log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
    �q�里上面三个步骤是对前面Log4j�l��g说明的一个简化；下面�l�出一个具体配�|�例子，在程序中可以参照执行�Q?br />    log4j.rootLogger=INFO,A1
    log4j.appender.A1=org.apache.log4j.ConsoleAppender
    log4j.appender.A1.layout=org.apache.log4j.PatternLayout
    log4j.appender.A1.layout.ConversionPattern=
                                        %-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
    �q�里需要说明的��是日志信息格式中几个符��h��代表的含义：
    �Q�X�? X信息输出时左寚w��Q?br />    %p: 日志信息�U�别
    %d{}: 日志信息产生旉��
    %c: 日志信息所在地�Q�类名）
    %m: 产生的日志具体信�?br />    %n: 输出日志信息换行

�Ҏ��上面的日志格式，某一个程序的输出�l�果如下�Q?/strong>
0    INFO 2003-06-13 13:23:46968 ClientWithLog4j Client socket: Socket[addr=localhost/127.0.0.1,port=8002,localport=2014]
16   DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server says: 'Java server with log4j, Fri Jun 13 13:23:46 CST 2003'
16   DEBUG 2003-06-13 13:23:46984 ClientWithLog4j GOOD
16   DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Command 'HELLO' not understood.'
16   DEBUG 2003-06-13 13:23:46984 ClientWithLog4j HELP
16   DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Vocabulary: HELP QUIT'
16   DEBUG 2003-06-13 13:23:46984 ClientWithLog4j QUIT

杨林�?/a> 2006-07-05 16:19 发表评论

在线视频中文亚洲,亚洲va久久,亚洲激情网址