java►java log4j

java log4j

log4j 简介

1
Apache的开源项目log4j是一个功能强大的日志组件,提供方便的日志记录

  1. Log4j基本使用方法

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    Log4j由三个重要的组件构成:日志信息的优先级,日志信息的输出目的地,日志信息的输出格式
    1.日志信息的优先级从高到低有ERROR,WARN,INFO,DEBUG,分别用来指定这条日志信息的重要程度
    2.日志信息的输出目的地指定了日志将打印到控制台还是文件中
    3.输出格式则控制了日志信息的显示内容

    1.定义配置文件
    Log4j支持两种配置文件格式:一种是XML格式的文件;一种是Java特性文件(键=值)

    Java特性文件做为配置文件的方法:
    //配置根Logger
    log4j.rootLogger = [ level ] , appenderName, appenderName, …

    level是日志记录的优先级,分为OFF,FATAL,ERROR,WARN,INFO,DEBUG,ALL或者您定义的级别.Log4j建议只使用四个级别,优先级从高到低分别是ERROR,WARN,INFO,DEBUG.通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关.比如在这里定义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来.
    appenderName就是指B日志信息输出到哪个地方.您可以同时指定多个输出目的地.

    //配置日志信息输出目的地Appender
    log4j.appender.appenderName = fully.qualified.name.of.appender.class  
    log4j.appender.appenderName.option1 = value1
    ... ...
    log4j.appender.appenderName.option = valueN

    Log4j提供的appender有以下几种:
    1.org.apache.log4j.ConsoleAppender(控制台)  
    2.org.apache.log4j.FileAppender(文件)
    3.org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
    4.org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)  
    5.org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)

    //配置日志信息的格式(布局)
    log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class  
    log4j.appender.appenderName.layout.option1 = value1  
    …  
    log4j.appender.appenderName.layout.option = valueN

    Log4j提供的layout有以e几种:
    1.org.apache.log4j.HTMLLayout(以HTML表格形式布局)  
    2.org.apache.log4j.PatternLayout(可以灵活地指定布局模式)  
    3.org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)  
    4.org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)


    Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下:
    %m 输出代码中指定的消息
    %p 输出优先级,即DEBUG，INFO，WARN，ERROR，FATAL  
    %r 输出自应用启动到输出该log信息耗费的毫秒数  
    %c 输出所属的类目,通常就是所在类的全名  
    %t 输出产生该日志事件的线程名  
    %n 输出一个回车换行符,Windows平台为"rn",Unix平台为"n"  
    %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如: %d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921  
    %l 输出日志事件的发生位置,包括类目名,发生的线程,以及在代码中的行数.举例:Testlog4.main(TestLog4.java:10)

  2. 在代码中使用log4j

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    1.得到记录器,这个记录器将负责控制日志信息
    public static Logger getLogger( String name)

    Name一般取本类的名字,比如:
    static Logger logger = Logger.getLogger(ServerWithLog4j.class.getName())

    2.读取配置文件
    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 ) ;

    日志级别:
    每个Logger都被了一个日志级别(log level)用来控制日志信息的输出.
    日志级别从高到低分为：
    A：off   最高等级,用于关闭所有日志记录
    B：fatal 指出每个严重的错误事件将会导致应用程序的退出
    C：error 指出虽然发生错误事件,但仍然不影响系统的继续运行
    D：warm  表明会出现潜在的错误情形
    E：info  一般和在粗粒度级别上,强调应用程序的运行全程
    F：debug 一般用于细粒度级别上,对调试应用程序非常有帮助
    G：all   最低等级,用于打开所有日志记录

    上面这些级别是定义在org.apache.log4j.Level类中.
    Log4j只建议使用4个级别,优先级从高到低分别是error,warn,info和debug.
    通过使用日志级别,可以控制应用程序中相应级别日志信息的输出.例如:如果使用b了info级别,则应用程序中所有低于info级别的日志信息(如debug)将不会被打印出来