org.apache.log4j.Logger详解

本文转载自查看原文 2018-08-12 21:28 1049 Java

1、简介

应用程序中添加日志记录有三个作用：

1、监视代码中变量的变化情况，周期性的记录到文件中供其他应用进行统计分析工作；

2、跟踪代码运行时轨迹，作为日后审计的依据；

3、担当集成开发环境中的调试器的作用，向文件或控制台打印代码的调试信息。　　

　　比较好的做法就是构造一个日志操作类来封装此类操作，而不是让一系列的打印语句充斥了代码的主体。

使用 Log4j ：

可以控制日志信息输送的目的地是控制台、文件、 GUI 组件、甚至是套接口服务器、 NT 的事件记录器、 UNIX Syslog 守护进程等；

可以控制每一条日志的输出格式；

可以通过定义每一条日志信息的级别，能够更加细致地控制日志的生成过程。

2、简单例子

#debug ：显示 debug 、 info 、 error  

#info ：显示 info 、 error  

#error ：只 error

# 也就是说只显示比大于等于当前级别的信息

log4j.rootLogger=debug,appender1  

#log4j.rootLogger=info,appender1  

#log4j.rootLogger=error,appender1    

# 输出到控制台   

log4j.appender.appender1=org.apache.log4j.ConsoleAppender  

# 样式为 TTCCLayout  

log4j.appender.appender1.layout=org.apache.log4j.TTCCLayout

　　通过配置文件可知，我们需要配置 3 个方面的内容：

　　1 、优先级：日志信息的重要程度，日志将打印到控制台还是文件中

　　2 、目的地（控制台、文件等等）：日志将打印到控制台还是文件中

　　3 、输出样式：控制了日志信息的显示内容

Logger        日志写出器 ，供程序员输出日志信息 
Appender    日志目的地 ，把格式化好的日志信息输出到指定的地方去 
Layout         日志格式化器 ，用来把程序员的 logging request 格式化成字符串

3、Log4j基本用法

日志信息的优先级从高到低有 ERROR 、 WARN 、 INFO 、 DEBUG ，

配置日志信息输出目的地 Appender ，其语法为：
　　 log4j.appender.appenderName = fully.qualified.name.of.appender.class. 其中， 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 提供的 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)

在代码中使用 Log4j
　　 1. 得到记录器
　　第一步就是获取日志记录器，记录器将负责控制日志信息。其语法为：
　　 public static Logger getLogger( String name)
　　通过指定的名字获得记录器，如果必要的话，则为这个名字创建一个新的记录器。 Name 一般取本类的名字，比如：
　　 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 ) ;

输出HTML文件

# 设置级别：   
log4j.rootLogger=debug,appender1    
log4j.appender.appender1=org.apache.log4j.FileAppender  
# 设置文件输出路径   
log4j.appender.appender1.File=c:/Log4JDemo02.html  
# 设置文件输出样式   
log4j.appender.appender1.layout=org.apac he.log4j.HTMLLayout

　输出文本与HTML文件

# 设置级别和多个目的地   
log4j.rootLogger=debug,appender1,appender2    
# 输出到控制台   
log4j.appender.appender1=org.apache.log4j.ConsoleAppender  
log4j.appender.appender1.layout=org.apache.log4j.TTCCLayout    
# 输出到文件 ( 这里默认为追加方式 )  
log4j.appender.appender2=org.apache.log4j.FileAppender  
log4j.appender.appender2.File=c:/Log4JDemo02.html  
log4j.appender.appender2.layout=org.apache.log4j.HTMLLayout

　自定义样式

# 设置级别和目的地   
log4j.rootLogger=debug,appender1    
# 输出到控制台   
log4j.appender.appender1=org.apache.log4j.ConsoleAppender  
# 设置输出样式   
log4j.appender.appender1.layout=org.apache.log4j.PatternLayout  
# 自定义样式   
log4j.appender.appender1.layout.ConversionPattern =%r [%t] [%p] - %c -%l -%m%n

# 自定义样式
# %r 时间 0
# %t 方法名 main
# %p 优先级 DEBUG/INFO/ERROR
# %c 所属类的全名 ( 包括包名 )
# %l 发生的位置，在某个类的某行
# %m 输出代码中指定的讯息，如 log(message) 中的 message
# %n 输出一个换行
log4j.appender.appender1.layout.ConversionPattern =%r [%t] [%p] - %c -%l -%m%n

输出结果：

0 [main] [DEBUG] - com.smart.test.HelloLog4j -com.smart.test.HelloLog4j.main(HelloLog4j.java:10) -This is debug message
 4 [main] [INFO] - com.smart.test.HelloLog4j -com.smart.test.HelloLog4j.main(HelloLog4j.java:12) -This is info message
 4 [main] [ERROR] - com.smart.test.HelloLog4j -com.smart.test.HelloLog4j.main(HelloLog4j.java:14) -This is error message

企业应用】设置 特定包的级别和目的地

新增一个包与类

package com.smart.test.Log4jDao;

import com.smart.test.HelloLog4j;
import org.apache.log4j.Logger;

public class Log4jDao {
    private static Logger logger= Logger.getLogger(Log4jDao.class);

    public static void main(String[] args){
        logger.debug("This is debug message");

        logger.info("This is info message");

        logger.error("This is error message");
    }
}

log4j.logger.com.smart.test.Log4jDao=debug,appender1,appender2
log4j.appender.appender1=org.apache.log4j.ConsoleAppender  
log4j.appender.appender1.layout=org.apache.log4j.PatternLayout  
log4j.appender.appender1.layout.ConversionPattern =[%d{yy/MM/dd HH:mm:ss:SSS}][%C-%M] %m%n  
# 输出到文件 ( 这里默认为追加方式 )
log4j.appender.appender2=org.apache.log4j.FileAppender  
log4j.appender.appender2.File=d:/Log4JDemo07_Dao.log  
log4j.appender.appender2.layout=org.apache.log4j.PatternLayout  
log4j.appender.appender2.layout.ConversionPattern=[%d{HH:mm:ss:SSS}][%C-%M] -%m%n

log4j.xml 的配置方式

<?xml version="1.0" encoding="GB2312" ?>
<!DOCTYPE log4j:configuration SYSTEM "http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/doc-files/log4j.dtd">

<log4j:configuration debug="true">
    <appender name="appender1"
              class="org.apache.log4j.RollingFileAppender">
        <param name="File" value="d:/logfile08.html" />
        <param name="MaxFileSize" value="1MB" />
        <param name="MaxBackupIndex" value="5" />
        <layout class="org.apache.log4j.HTMLLayout">
        </layout>
    </appender>
    <root>
        <level value="debug" />
        <appender-ref ref="appender1" />
    </root>
</log4j:configuration>

　　为提高效率可以增加判断

//  记录 debug 级别的信息   
if (logger.isDebugEnabled ()) {  
    logger.debug("This is debug message from Dao.");  
}    
//  记录 info 级别的信息   
if (logger.isInfoEnabled ()) {  
    logger.info("This is info message from Dao.");  
}    
//  记录 error 级别的信息   
logger.error("This is error message from Dao.");

配置日志信息输出目的地，其语法为：

log4j.appender.appenderName = fully.qualified.name.of.appender.class

　　   "fully.qualified.name.of.appender.class" 可以指定下面五个目的地中的一个： 

          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 （将日志信息以流格式发送到任意指定的地方） 
          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: 指定可以产生的滚动文件的最大数。

　　Log4j 比较全面的配置

log4j.rootLogger=DEBUG,CONSOLE,A1,im 
 log4j.addivity.org.apache=true

 # 应用于控制台

 log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender 
 log4j.appender.Threshold=DEBUG 
 log4j.appender.CONSOLE.Target=System.out 
 log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout 
 log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
 #log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n

 # 应用于文件

 log4j.appender.FILE=org.apache.log4j.FileAppender 
 log4j.appender.FILE.File=file.log 
 log4j.appender.FILE.Append=false 
 log4j.appender.FILE.layout=org.apache.log4j.PatternLayout 
 log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
 # Use this layout for LogFactor 5 analysis

 # 应用于文件回滚

 log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender 
 log4j.appender.ROLLING_FILE.Threshold=ERROR 
 log4j.appender.ROLLING_FILE.File=rolling.log  // 文件位置 , 也可以用变量 ${java.home} 、 rolling.log
 log4j.appender.ROLLING_FILE.Append=true       //true: 添加   false: 覆盖 
 log4j.appender.ROLLING_FILE.MaxFileSize=10KB   // 文件最大尺寸 
 log4j.appender.ROLLING_FILE.MaxBackupIndex=1  // 备份数 
 log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout 
 log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
 # 应用于 socket 
 log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender 
 log4j.appender.SOCKET.RemoteHost=localhost 
 log4j.appender.SOCKET.Port=5001 
 log4j.appender.SOCKET.LocationInfo=true 
 # Set up for Log Facter 5 
 log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout 
 log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n 
 # Log Factor 5 Appender 
 log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender 
 log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000

 # 发送日志给邮件

 log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender 
 log4j.appender.MAIL.Threshold=FATAL 
 log4j.appender.MAIL.BufferSize=10 
 www.wuset.com ">log4j.appender.MAIL.From=web@www.wuset.com 
 log4j.appender.MAIL.SMTPHost=www.wusetu.com 
 log4j.appender.MAIL.Subject=Log4J Message 
 www.wusetu.com ">log4j.appender.MAIL.To=web@www.wusetu.com 
 log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout 
 log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

 # 用于数据库 
 log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender 
 log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test 
 log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver 
 log4j.appender.DATABASE.user=root 
 log4j.appender.DATABASE.password= 
 log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n') 
 log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout 
 log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n


 log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender 
 log4j.appender.A1.File=SampleMessages.log4j 
 log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j' 
 log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout

 # 自定义 Appender

 log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender

 log4j.appender.im.host = mail.cybercorlin.net 
 log4j.appender.im.username = username 
 log4j.appender.im.password = password 
 log4j.appender.im.recipient = corlin@cybercorlin.net

 log4j.appender.im.layout=org.apache.log4j.PatternLayout 
 log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

　　参考文档：https://www.cnblogs.com/liaojie970/p/7634838.html

免责声明！

本站转载的文章为个人学习借鉴使用，本站对版权不负任何法律责任。如果侵犯了您的隐私权益，请联系本站邮箱yoyou2525@163.com删除。