`

Log4j的使用

    博客分类:
  • java
阅读更多

一,Log4j简介

       日志的三个目的:              

                      1. 监视代码中变量的变化情况,周期性的记录到文件中供其他应用进行统计分析工作
                      2.跟踪代码运行时轨迹,作为日后审计的依据
                      3.担当集成开发环境中的调试器的作用,向文件或控制台打印代码的调试信息

          最普通的做法就是在代码中嵌入许多的打印语句,这些打印语句可以输出到控制台或文件中,比较好的做法就是构造一个日志操作类来封装此类操作,而不是让一系列的打印语句充斥了代码的主体。

Apache为我们提供了一个强有力的日志操作包Log4j。通过使用 Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI 组件、甚至是套接口服务器、NT 的事件记录器、UNIX Syslog 守护进程等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。

 

二,Log4j的简单使用事例

       1.导入log4j.jar到项目中

       2.在项目 类路径下(src文件夹下)创建log4j.properties文件内容如下(后面解释配置的意思):

     

log4j.rootLogger=debug,appender1
log4j.appender.appender1=org.apache.log4j.ConsoleAppender
log4j.appender.appender1.layout=org.apache.log4j.TTCCLayout

 

 

     3.测试代码

 

package log4j;

import org.apache.log4j.Logger;

public class Log4jTest {
	private static Logger logger=Logger.getLogger(Log4jTest.class);
	public static void main(String[] args) {
		
		logger.debug("This is debug message.");
		logger.debug("This is info message.");
		logger.debug("This is error message.");
		
	}

}

 

 

   输出:

 

[main] DEBUG log4j.Log4jTest - This is debug message.
[main] DEBUG log4j.Log4jTest - This is info message.
[main] DEBUG log4j.Log4jTest - This is error message.

 

 

 三,Log4j的构成

     通过配置文件可以知道,主要有三个方面的内容:

  • 根目录
  • 目的地(控制台,文件等)
  • 输出样式

log4j的类图:


Logger -  日志写出器,供程序员输出日志信息 (这是程序中重要用的类)
Appender -  日志目的地,把格式化好的日志信息输出到指定的地方去 (看看配置文件log4j.properties就应该好理解了)
ConsoleAppender -  目的地为控制台的 Appender
FileAppender -  目的地为文件的 Appender
RollingFileAppender -  目的地为大小受限的文件的 Appender
Layout -  日志格式化器,用来把程序员的 logging request 格式化成字符串
PatternLayout -  用指定的 pattern 格式化 logging request 的 Layout

 

四,log4j的使用详解

     1. .properties配置文件详解(Log4j 支持两种配置文件格式,一种是 XML 格式的文件,一种是properties(key=value)文件。下面我们介绍使用 properties 文件做为配置文件的方法)

         (1)配置根 Logger,其语法为:

                 log4j.rootLogger = level,appenderName1,appenderName2,  „

                level  是日志记录的优先级,Log4j 建议只使用四个级别,优先级从高到低分别是 ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了 INFO 级别,则应用程序中所有DEBUG 级别的日志信息将不被打印出来。

          (2)配置日志信息输出目的地 Appender,其语法为:

              

log4j.appender.appenderNAME=org.apache.log4j.ConsoleAppender
log4j.appender.appenderNAME.属性名(比如layout属性)=属性值
log4j.appender.appenderNAME.属性名=属性值

 

               Log4j.提供的appender有以下几种:

 

  • org.apache.log4j.ConsoleAppender(控制台)
  • org.apache.log4j.FileAppender(文件)
  • org.apache.log4j.DailyRollingFileAppender(每天产生一个文件)
  • org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
  • org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方

    配置的具体参数:

       1)  ConsoleAppender 选项

         Threshold=WARN:指定日志消息的输出最低层次。

  •   ImmediateFlush=true:默认值是 true,意谓着所有的消息都会被立即输出。
    Target=System.err:默认情况下是:System.out,指定输出控制台
    2)  FileAppender  选项
    Threshold=WARN:指定日志消息的输出最低层次。
    ImmediateFlush=true:默认值是 true,意谓着所有的消息都会被立即输出。
    File=mylog.txt:指定消息输出到 mylog.txt 文件。
    Append=false:默认值是 true,即将消息增加到指定文件中,false 指将消息覆盖指定的文件内容。
    3)  DailyRollingFileAppender  选项
    Threshold=WARN:指定日志消息的输出最低层次。
    ImmediateFlush=true:默认值是 true,意谓着所有的消息都会被立即输出。
    File=mylog.txt:指定消息输出到 mylog.txt 文件。
    Append=false:默认值是 true,即将消息增加到指定文件中,false 指将消息覆盖指定的文件内容。
    DatePattern=''.''yyyy-ww:每周滚动一次文件,即每周产生一个新的文件。
    当然也可以指定按月、周、天、时和分。即对应的格式如下:
    1)''.''yyyy-MM:  每月
    2)''.''yyyy-ww:  每周
    3)''.''yyyy-MM-dd:  每天
    4)''.''yyyy-MM-dd-a:  每天两次
    5)''.''yyyy-MM-dd-HH:  每小时
    6)''.''yyyy-MM-dd-HH-mm:  每分钟
    4)  RollingFileAppender  选项
    Threshold=WARN:指定日志消息的输出最低层次。
    ImmediateFlush=true:默认值是 true,意谓着所有的消息都会被立即输出。
    File=mylog.txt:指定消息输出到 mylog.txt 文件。
    Append=false:默认值是 true,即将消息增加到指定文件中,false 指将消息覆盖指定的文件内容。
    MaxFileSize=100KB:  后缀可以是 KB, MB  或者是  GB.  在日志文件到达该大小时,将会自动滚动,
    即将原来的内容移到 mylog.log.1 文件。
    MaxBackupIndex=2:指定可以产生的滚动文件的最大数

 (3)配置日志信息的格式(布局),其语法为:

    log4j.appender.appenderName.layout=Log4j提供的layout类

    Log4j提供的layout有以下几种:

          org.apache.log4j.HTMLLayout(以 HTML 表格形式布局)

          org.apache.log4j.PatternLayout(可以灵活地指定布局模式)

          org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)

          org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)

     1)  HTMLLayout 选项
             LocationInfo=true:默认值是 false,输出 java 文件名称和行号
             Title=my app file:  默认值是  Log4J Log Messages.
     2)  PatternLayout 选项
             ConversionPattern=%m%n :指定怎样格式化指定的消息。
     3)  XMLLayout 选项
             LocationInfo=true:默认值是 false,输出 java 文件和行号
             Log4J 采用类似 C 语言中的 printf 函数的打印格式格式化日志信息,打印参数如下:

            

 og4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n 

 

 

    这里需要说明的就是日志信息格式中几个符号所代表的含义:

  • -X 号: X 信息输出时左对齐;
  • %p:  输出日志信息优先级,即 DEBUG,INFO,WARN,ERROR,FATAL,
  • %d:  输出日志时间点的日期或时间,默认格式为 ISO8601,也可以在其后指定格式,
  • 比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002 年 10 月 18 日  22:10:28,921
  • %r:  输出自应用启动到输出该 log 信息耗费的毫秒数
  • %c:  输出日志信息所属的类目,配置文件中的名字,通常就是所在类的全名(若使用 rootLogger)
  • %t:  输出产生该日志事件的线程名
  • %l:  输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及行数。
  • 举例:Testlog4.main(TestLog4.java:10)
  • %x:  输出和当前线程相关联的 NDC(嵌套诊断环境),尤其用到像 java servlets 这样的多客户多线程的应
  • 用中。
  • %%:  输出一个"%"字符
  • %F:  输出日志消息产生时所在的文件名称
  • %L:  输出代码中的行号
  • %m:  输出代码中指定的消息,产生的日志具体信息
  • %n:  输出一个回车换行符,Windows 平台为"\r\n",Unix 平台为"\n"输出日志信息换行
  • %M:  输出日志信息所属的方法

可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如

 

1)%20c:指定输出 category 的名称,最小的宽度是 20,如果 category 的名称小于 20 的话,默认的情况下右对齐。
2)%-20c:指定输出 category 的名称,最小的宽度是 20,如果 category 的名称小于 20 的话,"-"号指定左对齐。
3)%.30c:指定输出 category 的名称,最大的宽度是 30,如果 category 的名称大于 30 的话,就会将左边多出的字符截掉,但小于 30 的话也不会有空格。
4)%20.30c:如果 category 的名称小于 20 就补空格,并且右对齐,如果其名称长于 30 字符,就从左边交远销出的字符截掉

 

 2.代码中使用Log4j

          (1) 得到记录器

       

static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )

 

          (2)读取配置文件

               当获得了日志记录器之后,第二步将配置 Log4j 环境,其语法为:
              

BasicConfigurator.configure ():  自动快速地使用缺省 Log4j 环境。
PropertyConfigurator.configure ( String configFilename)  :读取使用 Java 的特性文件编写的配置文件。
DOMConfigurator.configure ( String filename )  :读取 XML 形式的配置文件。

 

 

           (3)插入记录信息(格式化日志信息)

              当上两个必要步骤执行完毕,您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方,其语法如下:

Logger.debug ( Object message ) ;
Logger.info ( Object message ) ;
Logger.warn ( Object message ) ;
Logger.error ( Object message ) ;

 

 

               

 五,Properties文件实例说明

 

log4j.rootCategory=INFO, stdout , R   

log4j.appender.stdout=org.apache.log4j.ConsoleAppender   
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout   
log4j.appender.stdout.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n   
   
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender   
log4j.appender.R.File=D:\\Tomcat 5.5\\logs\\qc.log   
log4j.appender.R.layout=org.apache.log4j.PatternLayout   
log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n   
   
log4j.logger.com.neusoft=DEBUG          //指定 com.neusoft 包下的所有类的等级为 DEBUG,可以把 com.neusoft 改为自己项目所用的包名。  
log4j.logger.com.opensymphony.oscache=ERROR   
log4j.logger.net.sf.navigator=ERROR   
log4j.logger.org.apache.commons=ERROR

 

 

 

 

 

  • 大小: 313.3 KB
3
1
分享到:
评论

相关推荐

    log4j使用教程(详解)

    Log4j是一款广泛使用的开源日志框架,由Apache软件基金会开发。本文将深入探讨Log4j的基本概念、配置与使用方法。 1. **什么是Log4j** Log4j是一个基于Java的日志记录工具,它提供了灵活的控制来记录日志信息,...

    log4j使用详解 j2EE

    #### 四、在代码中使用Log4j 要在代码中使用Log4j,首先需要获取一个Logger实例。 - **语法**:`public static Logger getLogger(String name)` - **示例**: ```java import org.apache.log4j.Logger; ...

    Log4j使用实例

    ### Log4j 使用实例详解 #### 一、Log4j简介 Log4j 是一个开源的日志记录框架,由 Apache 软件基金会提供。它允许开发者根据需求配置日志等级,并灵活选择日志信息的输出方式。Log4j 的核心组件包括 Logger、...

    log4j使用详细方法

    **日志框架Log4j详解** Log4j是Apache组织提供的一款开源的日志记录工具,广泛应用于Java开发中。...通过阅读提供的"log4j使用方法"文档,你将能更深入地了解Log4j的配置和使用技巧,为你的开发工作带来便利。

    log4j使用详解log4j使用详解

    ### Log4j 使用详解 #### 一、Log4j简介 Log4j 是 Apache 的一个开源项目,通过使用 Log4j,开发者能够控制日志信息的输出等级及去向,从而更加灵活地处理日志信息。它具有强大的功能,简单的配置,并且能够支持...

    log4j使用笔记

    #### 四、log4j 配置详解 1. **配置文件**: - `log4j.properties` 或 `log4j.xml` 文件用于定义 log4j 的配置规则。 - 配置文件通常放置在项目的根目录或者类路径下。 - 如果未指定配置文件的位置,则 log4j 会...

    log4j.rar log4j使用方法

    标题“log4j.rar log4j使用方法”暗示了我们要讨论的是一个关于log4j日志框架的压缩包文件,其中包含了如何使用log4j的指导资料。log4j是Java编程语言中广泛使用的开源日志记录工具,它允许开发者灵活地控制日志信息...

    log4j使用配置方法及项目中的应用

    ### log4j使用配置方法及项目中的应用 #### 概述与背景 在软件开发过程中,日志记录是一项至关重要的任务,它不仅帮助开发者监控代码执行状态,还为后续的故障排查、性能优化和安全审计提供了关键信息。传统的做法...

    log4j使用简介.txt

    ### log4j 使用简介 #### 一、Log4j 概述 Log4j 是一个由 Apache 提供的开源项目,专门用于实现日志记录功能。它为开发者提供了灵活的日志记录方式,允许通过多种不同的格式来记录每一条日志信息,并且能够将这些...

    Log4j使用手册

    以下是Log4j的核心组成部分、使用方法以及日志分级的详细解释。 1. **LOG4J组成**: - **Logger**:是Log4j的核心,负责决定哪些日志信息应该被记录和哪些应该被忽略。它根据预定义的级别来过滤日志,由`org....

    Log4j使用教程

    ### 四、使用Log4j 在Java代码中,我们可以使用以下方式调用Log4j记录日志: ```java import org.apache.log4j.Logger; public class MyClass { private static final Logger logger = Logger.getLogger(MyClass...

    apache log4j使用大全

    Apache Log4j 是一个广泛使用的开源日志框架,它为Java应用程序提供了强大的日志记录功能。Log4j 的主要优点在于它的灵活性和可配置性,允许开发者根据需要调整日志的输出目的地、格式以及级别。 **配置Log4j** ...

    log4j使用实例.zip

    这个"log4j使用实例.zip"压缩包包含了关于如何在Java项目中配置和使用Log4j的示例代码,非常适合Java后端初学者学习。 首先,Log4j的核心组件包括Logger、Appender和Layout。Logger是日志信息的生产者,负责生成...

    log4j使用手册和API chm格式

    "Log4j使用手册和API"则明确指出了文档的核心内容,Log4j是一个广泛使用的Java日志库,它的API提供了丰富的日志记录功能,包括不同级别的日志输出(如DEBUG, INFO, WARN, ERROR等)、自定义日志格式、日志分发等。...

    Java Log4j使用详解

    #### 四、使用Log4j ##### 4.1 概述 Log4j是另一个非常流行的Java日志框架,由Apache基金会维护。它比JCL更加强大,支持更多的特性,比如多级日志记录、动态日志文件配置等。Log4j的核心优势在于其灵活性和强大的...

    log4j使用总结

    Log4j 建议只使用四个级别,优先级从高到低分别是 ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。 在配置文件中,我们可以定义多个日志信息输出目的地,例如...

    log4j 使用介绍

    【log4j 使用介绍】 log4j 是一个广泛使用的 Java 日志框架,它提供了一种高效、灵活的方式来记录应用程序中的事件。这篇介绍旨在帮助初学者理解 log4j 的核心概念和使用方法。 **1. 简介** 日志记录在软件开发中...

    最详细的Log4j使用教程

    Log4j是一个广泛使用的Java日志框架,由ApacheJakarta项目开发。它为开发者提供了灵活且功能丰富的日志记录机制,使应用程序中的日志管理变得简单。本教程将深入介绍如何使用Log4j进行日志记录,包括配置、基本用法...

Global site tag (gtag.js) - Google Analytics