「入门学习Spring框架」Log4j使用详解-第四章

本篇教程继续基于以下两篇教程的基础上继续讲解。

「入门学习Spring框架」搭建简单的Spring框架-第二章

「入门学习Spring框架」手把手集成Spring MVC-第三章

在Java Web项目里面，日志记录是必不可少的东西，日志记录主要就是用来分析异常代码出现的位置，执行效率等，总之好处多多。

Log4j需要依赖两个jar包：commons-logging、log4j，在build.gradle配置文件引入这两个jar包，代码如下:

compile group: ‘commons-logging’, name: ‘commons-logging’, version: ‘1.2’

compile group: ‘log4j’, name: ‘log4j’, version: ‘1.2.17’

然后在resources文件夹下添加一个log4j.properties文件

log4j.properties文件内容如下:

以上就是我配置的log4信息，后面会讲解配置文件的各个属性及作用。

因为我这里集成的是Spring MVC 4.2.1版本的，不需要在web.xml配置log4j路径和监听类，spring已经帮把这事做了。

直接启动Tomcat可以看到打印的日志信息，在看看E盘的log日志文件

生成了两个文件日志记录，日志记录集成基本上已经完成。

现在来探讨一下Log4配置文件里面的属性配置信息。

Log4j配置是以key=value格式设置信息，配置文件的基本格式如下：

#配置根Logger

log4j.rootLogger = [level],appenderName1,appenderName2,appenderName3,…

#配置日志信息输出目的地Appender

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

log4j.appender.appenderName1.option1 = value1

…………………

log4j.appender.appenderName1.optionN = valueN

#配置日志信息的格式布局

log4j.appender.appenderName.layout = full.qualified.name.of.layout.class

log4j.appender.appenderName.layout.option1 = value1

…………………

log4j.appender.appenderName.layout.optionN = valueN

[level]是日志输出级别，一共有五个级别：FATAL、ERROR、WARN、INFO、DEBUG

Appender为日志输出目的地，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（将日志信息以流格式发送到任意指定的地方）

Layout日志输出格式，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函数的打印格式格式化日志信息，如下:

1. %m 输出代码中指定的消息

2. %p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL

3. %r 输出自应用启动到输出该log信息耗费的毫秒数

4. %c 输出所属的类目，通常就是所在类的全名

5. %t 输出产生该日志事件的线程名

6. %n 输出一个回车换行符，Windows平台为“\r\n”，Unix平台为“\n”

7. %d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss , SSS}，输出类似：2002年10月18日 22 ： 10 ： 28 ， 921

8. %l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java: 10 )

9. -X号: X信息输出时左对齐；

10. %x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。

11. %%: 输出一个”%”字符

12. %F: 输出日志消息产生时所在的文件名称

13. %L: 输出代码中的行号

14. %20c：指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，默认的情况下右对齐。

15. %-20c:指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，”-“号指定左对齐。

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

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

LOG4J其它选项属性如下:

1. Threshold=DEBUG:指定日志消息的输出最低层次

2. ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。

3. Target=System.err：默认情况下是：System.out,指定输出控制台

4. FileAppender 选项

5. File=log.txt:指定消息输出到log.txt文件。

6. Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。

7. MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时，将会自动滚动，即将原来的内容移到log.log.1文件。

8. MaxBackupIndex=2:指定可以产生的滚动文件的最大数。

9. log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n

例如一天产生一个日志文件:

LOG4J只需根据自己需要组合的方式配置即可。

如有问题可在下区评论，下一篇将进入Spring IOC。