[log4j]org.apache.log4j.Logger用法

最新推荐文章于 2024-09-28 03:23:04 发布

_YOLO_

最新推荐文章于 2024-09-28 03:23:04 发布

阅读量1.2w

点赞数 7

分类专栏： Log4j 文章标签： log4j 日志

本文链接：https://blog.csdn.net/Azi_mi/article/details/69053957

版权

Log4j 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

apache.log4j参考资料

在应用程序中添加日志记录总的来说基于三个目的：

(1) 监视代码中变量的变化情况，周期性的记录到文件中供其他应用进行统计分析工作；
(2) 跟踪代码运行时轨迹，作为日后审计的依据；

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

（一）Log4j简介
Log4j是Apache的一个开放源代码项目，通过使用Log4j ，可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务器、 NT 的事件记录器、 UNIX Syslog 守护进程等；也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。　　
　　此外，通过 Log4j其他语言接口，可以在C、C++、.Net 、PL/SQL程序中使用 Log4j，其语法和用法与在 Java 程序中一样，使得多语言分布式系统得到一个统一一致的日志组件模块。

（二）Log4j 基本使用方法
　　 Log4j 由三个重要的组件构成：日志信息的优先级，日志信息的输出目的地，日志信息的输出格式。
日志信息的优先级从高到低有 ERROR > WARN > INFO > DEBUG ，分别用来指定这条日志信息的重要程度；日志信息的输出目的地指定了日志将打印到控制台还是文件中；而输出格式则控制了日志信息的显示内容。

（三）Log4j 的配置文件
　　 Log4j支持两种配置文件格式：
一种是 XML 格式的文件，
一种是 Java 特性文件（键=值 properties 文件）。

下面是使用 Java 特性文件做为配置文件的方法：
1）配置根 Logger ，其语法为：
log4j.rootLogger = [ level ] , appenderName, appenderName, …
　　其中， level 是日志记录的优先级，分为 OFF 、 FATAL 、 ERROR 、 WARN 、 INFO 、 DEBUG 、 ALL 七个不同级别。
Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG 。
通过在这里定义的级别，可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了 INFO 级别，则应用程序中所有 DEBUG 级别的日志信息将不被打印出来。
appenderName 就是指 B 日志信息输出到哪个地方,可以同时指定多个输出目的地。

2）配置日志信息输出目的地 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 （将日志信息以流格式发送到任意指定的地方）
3）配置日志信息的格式（布局），其语法为：
　　 log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
　　其中， Log4j 提供的 layout 有以下几种：
　　 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）得到记录器
使用Log4j,第一步就是获取日志记录器，这个记录器将负责控制日志信息。其语法为：
　　 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 )

example:

import org.apache.log4j.Logger;
import org.apache.log4j.BasicConfigurator;
import org.apache.log4j.Level;

public class Log4jTest {
    public static void main(String argv[]) {    
        // Create a logger by the name of class Log4jTest.
        Logger logger = Logger.getLogger(Log4jTest.class);

        // Use the default configuration.
        BasicConfigurator.configure();

        // Set the logger level to Level.INFO
        logger.setLevel(Level.INFO);

        // This request will be disabled since Level.DEBUG < Level.INFO.
        logger.debug("This is debug.");

        // These requests will be enabled.
        logger.info("This is an info.");
        logger.warn("This is a warning.");
        logger.error("This is an error.");
        logger.fatal("This is a fatal error.");
        
        return;
    }

以下是log4j.properties的参考范本:

# Set root category priority to INFO and its only appender to CONSOLE.
#log4j.rootCategory=INFO, CONSOLE             
log4j.rootCategory=info, CONSOLE, LOGFILE

# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE

# CONSOLE is set to be a ConsoleAppender using a PatternLayout.
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n

# LOGFILE is set to be a File appender using a PatternLayout.
log4j.appender.LOGFILE=org.apache.log4j.FileAppender
log4j.appender.LOGFILE.File=d:\record.log
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n