在日常的开发中经常需要通过输出一些信息进行程序的调试,如果到处都用system.out.println()则在项目发布之后要逐一删除,而log4j提供了一种新的调试输出机制以解决输出的问题。log4j的原理是使用一个配置文件log4j.properties进行管理,在调试的时候可以把输出级别调低,项目正式发布之后把级别调高,这样以前的一些输出就可以屏蔽了,不用到程序当中再进行逐一删除。我们可以结合了commons-logging和log4j来进行日常的输出调试信息和记录系统运行的信息日志
在spring的项目中,spring为我们提供了管理log4j的类,
如果项目中使用了spring我一般都会通过spring提供的类来管理日志信息
一,首先我们来看看非spring环境中使用log4j
使用步骤。
1.添加必须jar包
a。commons-logging.jar
b. log4j-1.2.14.jar
2.在web目录的src目录下面添加两个文件:commons-logging.properties和 log4j.properties
a.commons-logging.properties(文件名必须是此指定文件名),通用日志接口从此属性文件中获取实现日志添加内容如下:
#通过Log4J日志器来实现日志记录功能
org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger
b.log4j.properties ,为log4j指定相应的属性
#指定日志的级别为DEBUG,log4j共有OFF(关闭),FATAL(严重的错误),ERROR(一般性错误),WARN(警告),INFO(信息),DEBUG(调试信息),TRACE(追踪)和ALL等8个基本
#并配置了两个输出目的地为e1(输出在控制台上),e2(输出在日志文件中)
log4j.rootLogger=DEBUG,e1,e2
#指定e1日志信息输出在控制台
log4j.appender.e1=org.apache.log4j.ConsoleAppender
#指定e1日志信息输出格式为简单格式,它打印级别 Level,然后跟着一个破折号“-“ ,最后是日志消息。也可以自己定义格式
log4j.appender.e1.layout=org.apache.log4j.SimpleLayout
#指定e2日志信息输出在指定文件中
log4j.appender.e2=org.apache.log4j.FileAppender
log4j.appender.e2.layout=org.apache.log4j.SimpleLayout
#指定e2日志信息输出在logging.txt文件中,默认生成的logging.txt文件在tomcat的bin目录下
log4j.appender.e2.File=logging.txt
如果自己定义输出的日志,如下
log4j.rootLogger=DEBUG,e1,e2
log4j.appender.e1=org.apache.log4j.ConsoleAppender
#log4j.appender.e1.layout=org.apache.log4j.SimpleLayout
#指定布局模式格式
log4j.appender.e1.layout=org.apache.log4j.PatternLayout
#定义自己的输出格式
log4j.appender.e1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%-5p][%c] - %m%n
log4j.appender.e2=org.apache.log4j.FileAppender
log4j.appender.e2.layout=org.apache.log4j.PatternLayout
log4j.appender.e2.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%-5p][%c] - %m%n
log4j.appender.e2.File=logging.txt
详细配置信息
配置Appender组件
配置日志消息输出目的地Appender,有以下几种
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小达到指定尺寸的时候产生一个新文件)
org.apache.log4j.WriterAppender(将日志信息以流个格式发送到任意指定的地方)
例如以下代码定义了一个名了file的Appender,它把日志信息输出到log.txt文件
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=log.txt
配置Layout组件
Log4j提供下面几种Layout
org.apache.log4j.HTMLLayout(以html表格形式布局)
org.apache.log4j.PatterLayout(可以灵活的指定布局模式)
org.apache.log4j.SimpleLayout(包含日志消息的级别和信息字符串)
org.apache.log4j.TTCCLayout(包含日志产生的时间线程和类别)
Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下: %m 输出代码中指定的消息
Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下:
%m 输出代码中指定的消息
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出所属的类目,通常就是所在类的全名
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符,Windows平台为“\r\n”,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)
二、在spring的项目中使用log4j
首先需要在web.xml进行声明:
<!--如果不定义webAppRootKey参数,那么webAppRootKey就是缺省的"webapp.root"-->
<context-param>
<param-name>webAppRootKey</param-name>
<param-value>ssh.root</param-value>
</context-param>
这里的ssh是http://localhost:8080/ssh/
而root是系统开发目录中ssh/root
这样配置文件以及日志文件可以在spring的帮助下,放到开发环境中的任意位置
<!--由Sprng载入的Log4j配置文件位置-->
<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>/WEB-INF/log4j.properties</param-value>
</context-param>
在这里定位配置文件,需要的是从root开始的绝对路径
<!--Spring默认刷新Log4j配置文件的间隔,单位为millisecond-->
<context-param>
<param-name>log4jRefreshInterval</param-name>
<param-value>60000</param-value>
</context-param>
设置监听器
<!--Spring log4j Config loader-->
<listener>
<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
</listener>
之后我们就可以配置log4j配置文件了,内容如上的log4j.properties
我找了一个格式,copy如下
#先设置级别
log4j.rootLogger=INFO, file
log4j.appender.file=org.apache.log4j.RollingFileAppender
#在这里设置日志需要存放的位置,这里的变量就是我们在web.xml里设置的
log4j.appender.file.File=${ssh.root}/WEB-INF/logs/subject.log
log4j.appender.file.MaxFileSize=100KB
log4j.appender.file.MaxBackupIndex=0
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[ssh] %p %t %c - %m%n