JAVA中输出日志比较常用的是log4j,这里讲下log4j的配置和使用方法,以及slf4j的使用方法。
一、下载log4j的架包,并导入项目中,如下:
二、创建log4j.properties配置文件
1、log4j配置文件的位置:
(1)如果是java project项目,则在项目的根目录下创建log4j.properties而不是在src目录下。
(2)如果是java web项目,则在src目录下创建log4j.properties配置文件,因为这个时候tomcat会去默认的加载这个配置文件,而不需要我们手动的加载log4j的配置文件。
log4j.properties配置内容如下:
log4j.rootLogger=info,logTest
log4j.appender.logTest=org.apache.log4j.DailyRollingFileAppender
log4j.appender.logTest.File=/logs/LogTest/logTest.log
log4j.appender.logTest.DatePattern='.'yyyy-MM-dd'.log'
log4j.appender.logTest.layout=org.apache.log4j.PatternLayout
log4j.appender.logTest.layout.ConversionPattern=[LogTestInfo] [%d][%c][%-5p]%m%n
2、log4j配置项的说明:
(1)第一行中rootLogger配置的是整个项目的日志输出,也可以只针对某一个模块进行日志输出,比如第一行配置成log4j.logger.com.logTest.project=info,logTest,则日志只输出项目路径com/logTest/project下的。
info为日志级别,可分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL。配置为info这样只显示INFO, WARN, ERROR的日志信息。
logTest为日志配置的名称,对应的详细配置在下面。
(2)第二行是指定日志输出的类型。
可选参数如下:
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每隔一段时间产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
(3)第三行是指定日志文件输出的路径及文件名。
1)如果输出到指定位置:log4j.appender.logTest.File=D:\\logTest.log
2)如果输出到当前tomcat工作目录下:log4j.appender.logTest.File=${catalina.home}/logTest/logTest.log
(4)第四行是配合第二行设置,对日志产生的时间间隔进行格式化设置,格式化后的文本会作为日志文件的后缀。
以上面第四行的设置为例,即每天产生一个新的logTest.log日志文件,并将前一天的日志命名为logTest.log.2017-07-07.log。注意:DatePattern中不用处理的文字要放到单引号(')中,如上面的(.)和(.log)。
可选参数如下:
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:每分钟
(5)第五行是指定日志输出的格式。
可选参数如下:
1)org.apache.log4j.HTMLLayout(以HTML表格形式布局)
2)org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
3)org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
4)org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
(6)第六行是配合第五行设置,对日志输出进行格式化设置。
以第六行设置为例,[LogTestInfo] [%d][%c][%-5p]%m%n 的输出结果为:
格式化参数说明如下:
%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字符,就从左边较远输出的字符截掉。
三、日志输出代码例子
(1)在类中创建一个logger对象。
private Logger logger = Logger.getLogger(this.getClass());
(2)使用logger输出日志。
logger.info("TestInfo 1");
输出效果:
到这里,log4j的配置及使用就讲完了。下面顺便讲下slf4j的使用。
四、slf4j配合log4j的使用
SLF4J:即简单日志门面(Simple Logging Facade for Java),不是具体的日志解决方案,它只服务于各种各样的日志系统。按照官方的说法,SLF4J是一个用于日志系统的简单Facade,允许最终用户在部署其应用时使用其所希望的日志系统。
在使用SLF4J的时候,不需要在代码中或配置文件中指定你打算使用那个具体的日志系统,SLF4J提供了统一的记录日志的接口,只要按照其提供的方法记录即可,最终日志的格式、记录级别、输出方式等通过具体日志系统的配置来实现,因此可以在应用中灵活切换日志系统。
(1)下载slf4j的架包,并导入项目中,如下:
(2)直接使用上面第二点中log4j的配置即可,不用另外配置slf4j。
(3)在类中创建logger对象。
private Logger logger = LoggerFactory.getLogger(this.getClass());
这里注意要使用slf4j架包中的Logger,而不是log4j架包中的Logger。
(3)使用logger输出日志。
logger.info("TestInfo 1");
logger.info("TestInfo {}","1");
slf4j有两种输出方式,除了像log4j那样拼接字符串输出外,还提供参数化的方式输出,即上面第二行的方式,用一对大括号来表示参数位,后面的1即为参数值。