log4j的使用真是越来越难了。。。
我们今天来记录一下如何优雅的使用log4j
环境是idea,idea相比较于其他环境有更高的编写和搭建速度。而且界面也更实用。
创建的是maven环境,在创建maven之后自动回生成一份pom.xml
在这里只要将pom写上对应的引用(坐标),idea即会自动去下载并引用所依赖的包。
我先行配置了log4j的pom,关于pom文件的坐标,好多网站都有,可以搜一下,这里提供一份。
其他的配置也同理。
但是应用之后发现,现在的log不能直接使用,还要配合slf4j,至于这其中的原因我们先不管。
先配置上,所以得到最后的能够使用的配置是:
<!--log
配置:
Log4j2 + Slf4j-->
<
dependency
>
<
groupId
>
org.slf4j
</
groupId
>
<
artifactId
>
slf4j-api
</
artifactId
>
<
version
>
1.7.5
</
version
>
</
dependency
>
<
dependency
>
<
groupId
>
org.slf4j
</
groupId
>
<
artifactId
>
slf4j-log4j12
</
artifactId
>
<
version
>
1.7.5
</
version
>
</
dependency
>
<
dependency
>
<
groupId
>
log4j
</
groupId
>
<
artifactId
>
log4j
</
artifactId
>
<
version
>
1.2.16
</
version
>
</
dependency
>
这里要注意,这里面版本是有差别的,最初我用的是2.2的版本,结果就会报错
ERROR StatusLogger No log4j2 configuration file found. Using default configuration: logging only errors to the console.
但是其实,prop文件我是写了的,怎么改都不行,后来加上了log4j2.xml
竟然好用了。
原因是一般情况下log4会先去找xml,找不到再找prop可是我用的版本没有再去找prop的逻辑,所以完全找不到。这是看了部分代码发现的。
之后改了版本,使用了一份prop文件。对于大家建议也只使用prop简单易配置易懂
prop文件或者xml文件都应放在java-resources 文件夹下,如果是eclipse则应放在source根目录
到这一步,再clean-install再启动之后,应该能够正常打印所有级别日志了。
日志的内容全部是可以定义的,这里给一份配置和prop
###
设置
###
log4j.rootLogger
=
debug,stdout,D,E
###
输出信息到控制抬
###
log4j.appender.stdout
=
org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target
=
System.out
log4j.appender.stdout.layout
=
org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern
=
[%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} %l : %m%n
###
输出
DEBUG
级别以上的日志到文件
F://logs/debug.log ###
log4j.appender.D
=
org.apache.log4j.FileAppender
log4j.appender.D.File
=
F:/logs/debug.log
log4j.appender.D.Append
=
true
log4j.appender.D.Threshold
=
DEBUG
log4j.appender.D.layout
=
org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern
=
%d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
###
输出
ERROR
级别以上的日志到文件
F://logs/error.log ###
log4j.appender.E
=
org.apache.log4j.FileAppender
log4j.appender.E.File
=
F://logs/error.log
log4j.appender.E.Append
=
true
log4j.appender.E.Threshold
=
ERROR
log4j.appender.E.layout
=
org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern
=
%d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
#
在配置文件中可以通过
log4j.appender.A1.layout.ConversionPattern
设置日志输出格式。
#
参数:
#%p:
输出日志信息优先级,即
DEBUG
,
INFO
,
WARN
,
ERROR
,
FATAL,
#%d:
输出日志时间点的日期或时间,默认格式为
ISO8601
,也可以在其后指定格式,比如:
%d{yyy MMM dd HH:mm:ss,SSS}
,输出类似:
2002
年
10
月
18
日
22
:
10
:
28
,
921
#%r:
输出自应用启动到输出该
log
信息耗费的毫秒数
#%c:
输出日志信息所属的类目,通常就是所在类的全名
#%t:
输出产生该日志事件的线程名
#%l:
输出日志事件的发生位置,相当于
%C.%M(%F:%L)
的组合
,
包括类目名、发生的线程,以及在代码中的行数。举例:
Testlog4.main(TestLog4.java:10)
#%x:
输出和当前线程相关联的
NDC(
嵌套诊断环境
),
尤其用到像
java servlets
这样的多客户多线程的应用中。
#%%:
输出一个
”%”
字符
#%F:
输出日志消息产生时所在的文件名称
#%L:
输出代码中的行号
#%m:
输出代码中指定的消息
,
产生的日志具体信息
#%n:
输出一个回车换行符,
Windows
平台为
”\r\n”
,
Unix
平台为
”\n”
输出日志信息换行
#
#
可以在
%
与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
#1)%20c
:指定输出
category
的名称,最小的宽度是
20
,如果
category
的名称小于
20
的话,默认的情况下右对齐。
#2)%-20c:
指定输出
category
的名称,最小的宽度是
20
,如果
category
的名称小于
20
的话,
”-”
号指定左对齐。
#3)%.30c:
指定输出
category
的名称,最大的宽度是
30
,如果
category
的名称大于
30
的话,就会将左边多出的字符截掉,但小于
30
的话也不会有空格。
#4)%20.30c:
如果
category
的名称小于
20
就补空格,并且右对齐,如果其名称长于
30
字符,就从左边交远销出的字符截掉。
#
一、
log4j.properties
的使用详解
#1.
输出级别的种类
#ERROR
、
WARN
、
INFO
、
DEBUG
#ERROR
为严重错误 主要是程序的错误
#WARN
为一般警告,比如
session
丢失
#INFO
为一般要显示的信息,比如登录登出
#DEBUG
为程序的调试信息
#
#2.
配置日志信息输出目的地
#log4j.appender.appenderName = fully.qualified.name.of.appender.class
#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
#1.org.apache.log4j.HTMLLayout
(以
HTML
表格形式布局),
#2.org.apache.log4j.PatternLayout
(可以灵活地指定布局模式),
#3.org.apache.log4j.SimpleLayout
(包含日志信息的级别和信息字符串),
#4.org.apache.log4j.TTCCLayout
(包含日志产生的时间、线程、类别等等信息)
#
#4.
控制台选项
#Threshold=DEBUG:
指定日志消息的输出最低层次。
#ImmediateFlush=true:
默认值是
true,
意谓着所有的消息都会被立即输出。
#Target=System.err
:默认情况下是:
System.out,
指定输出控制台
#FileAppender
选项
#Threshold=DEBUF:
指定日志消息的输出最低层次。
#ImmediateFlush=true:
默认值是
true,
意谓着所有的消息都会被立即输出。
#File=mylog.txt:
指定消息输出到
mylog.txt
文件。
#Append=false:
默认值是
true,
即将消息增加到指定文件中,
false
指将消息覆盖指定的文件内容。
#RollingFileAppender
选项
#Threshold=DEBUG:
指定日志消息的输出最低层次。
#ImmediateFlush=true:
默认值是
true,
意谓着所有的消息都会被立即输出。
#File=mylog.txt:
指定消息输出到
mylog.txt
文件。
#Append=false:
默认值是
true,
即将消息增加到指定文件中,
false
指将消息覆盖指定的文件内容。
#MaxFileSize=100KB:
后缀可以是
KB, MB
或者是
GB.
在日志文件到达该大小时,将会自动滚动,即将原来的内容移到
mylog.log.1
文件。
#MaxBackupIndex=2:
指定可以产生的滚动文件的最大数。
#log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
#
#5.
日志信息格式中几个符号所代表的含义:
# -X
号
: X
信息输出时左对齐;
# %p:
输出日志信息优先级,即
DEBUG
,
INFO
,
WARN
,
ERROR
,
FATAL,
# %d:
输出日志时间点的日期或时间,默认格式为
ISO8601
,也可以在其后指定格式,比如:
%d{yyy MMM dd HH:mm:ss,SSS}
,输出类似:
2002
年
10
月
18
日
22
:
10
:
28
,
921
# %r:
输出自应用启动到输出该
log
信息耗费的毫秒数
# %c:
输出日志信息所属的类目,通常就是所在类的全名
# %t:
输出产生该日志事件的线程名
# %l:
输出日志事件的发生位置,相当于
%C.%M(%F:%L)
的组合
,
包括类目名、发生的线程,以及在代码中的行数。举例:
Testlog4.main (TestLog4.java:10)
# %x:
输出和当前线程相关联的
NDC(
嵌套诊断环境
),
尤其用到像
java servlets
这样的多客户多线程的应用中。
# %%:
输出一个
"%"
字符
# %F:
输出日志消息产生时所在的文件名称
# %L:
输出代码中的行号
# %m:
输出代码中指定的消息
,
产生的日志具体信息
# %n:
输出一个回车换行符,
Windows
平台为
"/r/n"
,
Unix
平台为
"/n"
输出日志信息换行
#
#
可以在
%
与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。
#
如:
# 1) %20c
:指定输出
category
的名称,最小的宽度是
20
,如果
category
的名称小于
20
的话,默认的情况下右对齐。
# 2) %-20c:
指定输出
category
的名称,最小的宽度是
20
,如果
category
的名称小于
20
的话,
"-"
号指定左对齐。
# 3) %.30c:
指定输出
category
的名称,最大的宽度是
30
,如果
category
的名称大于
30
的话,就会将左边多出的字符截掉,但小于
30
的话也不会有空格。
# 4) %20.30c:
如果
category
的名称小于
20
就补空格,并且右对齐,如果其名称长于
30
字符,就从左边较远输出的字符截掉。
#
#
二、
log4j.properties
的配置
#1
、配置步骤
#
#
1
) 在应用程序中使用
log4j
#
2)
把
log4j-*.*jar
放入
CLASSPATH
变量中
#
3)
新建一个配置文件
log4j.properties
,放于
bin
文件下
#
#
#2.
新建一个配置文件
log4j.properties
,如:
#
#
log4j.rootLogger=WARN, stdout, R
#
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
#
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
#
# Pattern to output the caller's file name and line number.
#
#log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n
#
# Print the date in ISO 8601 format
#
log4j.appender.stdout.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
#
log4j.appender.R=org.apache.log4j.RollingFileAppender
#
log4j.appender.R.File=example.log
#
log4j.appender.R.MaxFileSize=100KB
#
# Keep one backup file
#
log4j.appender.R.MaxBackupIndex=1
#
log4j.appender.R.layout=org.apache.log4j.PatternLayout
#
log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
#
# Print only messages of level WARN or above in the package com.foo.
#
log4j.logger.com.foo=WARN
#
编译并运行
TestLog4j
会在目录下生成一个
example.log
的文件,屏幕也会输出信息,这证明已经你已经成功了第一步。