JAVA中输出日志比较常用的是log4j,这里讲下log4j的配置和使用方法,以及slf4j的使用方法。

一、下载log4j的架包,并导入项目中,如下:

如何将javamail中的debug日志输出到应用的日志框架中_apache

二、创建log4j.properties配置文件
1、log4j配置文件的位置:

(1)如果是java project项目,则在项目的根目录下创建log4j.properties而不是在src目录下。

(2)如果是java web项目,则在src目录下创建log4j.properties配置文件,因为这个时候tomcat会去默认的加载这个配置文件,而不需要我们手动的加载log4j的配置文件。

log4j.properties配置内容如下:

1 log4j.rootLogger=info,logTest
 2 log4j.appender.logTest=org.apache.log4j.DailyRollingFileAppender
 3 log4j.appender.logTest.File=/logs/LogTest/logTest.log
 4 log4j.appender.logTest.DatePattern='.'yyyy-MM-dd'.log'
 5 log4j.appender.logTest.layout=org.apache.log4j.PatternLayout
 6 log4j.appender.logTest.layout.ConversionPattern=[LogTestInfo] [%d][%c][%-5p]%m%n
2、log4j配置项的说明:
  • 第一行中
  • rootLogger配置的是整个项目的日志输出,也可以只针对某一个模块进行日志输出,比如第一行配置成log4j.logger.com.logTest.project=info,logTest,则日志只输出项目路径com/logTest/project下的。
  • info为日志级别,可分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL。配置为info这样只显示INFO, WARN, ERROR的日志信息。
  • logTest为日志配置的名称,对应的详细配置在下面。
  • 第二行是指定日志输出的类型。可选参数如下:
  • org.apache.log4j.ConsoleAppender(控制台)
  • org.apache.log4j.FileAppender(文件)
  • org.apache.log4j.DailyRollingFileAppender(每隔一段时间产生一个日志文件)
  • org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
  • org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
  • 第三行是指定日志文件输出的路径及文件名。
  • 如果输出到指定位置:log4j.appender.logTest.File=D:\logTest.log
  • 如果输出到当前tomcat工作目录下:log4j.appender.logTest.File=${catalina.home}/logTest/logTest.log
  • 第四行是配合第二行设置,对日志产生的时间间隔进行格式化设置,格式化后的文本会作为日志文件的后缀。以上面第四行的设置为例,即每天产生一个新的logTest.log日志文件,并将前一天的日志命名为logTest.log.2017-07-07.log。注意:DatePattern中不用处理的文字要放到单引号(')中,如上面的(.)和(.log)。
  • 可选参数如下:
  • '.'yyyy-MM:每月
  • '.'yyyy-ww:每周
  • '.'yyyy-MM-dd:每天
  • '.'yyyy-MM-dd-a:每半天
  • '.'yyyy-MM-dd-HH:每小时
  • '.'yyyy-MM-dd-HH-mm:每分钟
  • 第五行是指定日志输出的格式。可选参数如下:
  • org.apache.log4j.HTMLLayout(以HTML表格形式布局)
  • org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
  • org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
  • org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
  • 第六行是配合第五行设置,对日志输出进行格式化设置。以第六行设置为例,[LogTestInfo] %d[%-5p]%m%n 的输出结果为:

如何将javamail中的debug日志输出到应用的日志框架中_apache_02

  • 格式化参数说明如下:
  • %m 输出代码中指定的消息。
  • %p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL。
  • %r 输出自应用启动到输出该log信息耗费的毫秒数。
  • %c 输出所属的类目,通常就是所在类的全名。
  • %t 输出产生该日志事件的线程名。
  • %n 输出一个回车换行符,Windows平台为“rn”,Unix平台为“n”。
  • %d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyyy MM dd HH:mm:ss,SSS}。
  • %l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。
  • %%: 输出一个"%"字符。
  • %F: 输出日志消息产生时所在的文件名称。
  • %L: 输出代码中的行号。

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

1)%20c:指定输出类目的名称,最小的宽度是20,如果类目的名称小于20的话,默认的情况下右对齐。

2)%-20c:指定输出类目的名称,最小的宽度是20,如果类目的名称小于20的话,"-"号指定左对齐。

3)%.30c:指定输出类目的名称,最大的宽度是30,如果类目的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。

4)%20.30c:如果类目的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边较远输出的字符截掉。

三、日志输出代码例子
  • 在类中创建一个logger对象。
private Logger logger = Logger.getLogger(this.getClass());
 
• 使用logger输出日志。
logger.info("TestInfo 1");


输出效果:

如何将javamail中的debug日志输出到应用的日志框架中_log4j_03

到这里,log4j的配置及使用就讲完了。下面顺便讲下slf4j的使用。

四、slf4j配合log4j的使用

SLF4J:即简单日志门面(Simple Logging Facade for Java),不是具体的日志解决方案,它只服务于各种各样的日志系统。按照官方的说法,SLF4J是一个用于日志系统的简单Facade,允许最终用户在部署其应用时使用其所希望的日志系统。

在使用SLF4J的时候,不需要在代码中或配置文件中指定你打算使用那个具体的日志系统,SLF4J提供了统一的记录日志的接口,只要按照其提供的方法记录即可,最终日志的格式、记录级别、输出方式等通过具体日志系统的配置来实现,因此可以在应用中灵活切换日志系统。

(1)下载slf4j的架包,并导入项目中,如下:

如何将javamail中的debug日志输出到应用的日志框架中_apache_04

(2)直接使用上面第二点中log4j的配置即可,不用另外配置slf4j。

(3)在类中创建logger对象。


private Logger logger = LoggerFactory.getLogger(this.getClass());


这里注意要使用slf4j架包中的Logger,而不是log4j架包中的Logger。

(3)使用logger输出日志。

1 logger.info("TestInfo 1");
 2 logger.info("TestInfo {}","1");

slf4j有两种输出方式,除了像log4j那样拼接字符串输出外,还提供参数化的方式输出,即上面第二行的方式,用一对大括号来表示参数位,后面的1即为参数值。