log4jproperties配置文件基本语法.docx
《log4jproperties配置文件基本语法.docx》由会员分享，可在线阅读，更多相关《log4jproperties配置文件基本语法.docx（13页珍藏版）》请在冰豆网上搜索。
log4jproperties配置文件基本语法
log4j.properties配置文件基本语法
以下是配置文件的语法。
1.配置日志级别及输出日志目的地
log4j.rootLogger=[level],appenderName,appenderName...
其中：
（1）level是日志记录的优先级，从高到低分别为FATAL，ERROR，WARN，INFO，DEBUG。
当你定义一个级别，只有等于或者高于这个基本的才进行处理。
可选的All打印所有日志，OFF关闭所有日志输出。
（2）appenderName用于指定日志信息输出目的地，可以指定多个
【例1】日志配置文件级别设置为debug，目的地有两个，分别是：
target01，tartet02。
log4j.rootLogger=debug,target01,target02
2.配置目的地appender
◆设置目的地类型
有以下几种：
（1）org.apache.log4j.jdbc.JDBCAppender------存入数据库；
（2）.SMTPAppender------发送到指定邮箱；
（3）net.cybercorlin.util.logger.appender.IMAppender------自定义类型；
（4）org.apache.log4j.ConsoleAppender------控制台；
（5）org.apache.log4j.FileAppender------文件；
（6）org.apache.log4j.DailyRollingFileAppender------每天产生一个日志文件；
（7）org.apache.log4j.RollingFileAppender------文件达到指定大小的时候产生一个新的文件；
（8）org.apache.log4j.WriterAppender------将日志信息以流格式发送到任意指定的地方。
【例2】将例1中的目的地target01配置成在文件中输出，且每天产生一个日志文件；target02配置成在控制台输出。
log4j.appender.target01=org.apache.log4j.DailyRollingFileAppender
log4j.appender.target02=org.apache.log4j.ConsoleAppender
◆各类型目的地相关属性说明
（1）ConsoleAppender类型目的地属性说明
Threshold=WARN：
指定日志消息的输出最低层次。
ImmediateFlush=true：
默认值是true，意谓着所有的消息都会被立即输出。
Target=System.err：
默认情况下是：
System.out,指定输出控制台
【例3】配置例2中目的地target02的Target属性值为System.err。
log4j.appender.target02.Target=System.err
（2）FileAppender类型目的地属性说明
Threshold=WARN：
指定日志消息的输出最低层次。
ImmediateFlush=true：
默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt：
指定消息输出到mylog.txt文件。
Append=false：
默认值是true，即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
【例4】配置例2中目的地target01的输出文件为D盘根目录下的log.txt。
log4j.appender.target01.File=d:
/log.txt
（3）DailyRollingFileAppender类型目的地属性说明
Threshold=WARN：
指定日志消息的输出最低层次。
ImmediateFlush=true：
默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt：
指定消息输出到mylog.txt文件。
Append=false：
默认值是true，即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
DatePattern='.'yyyy-ww：
每周滚动一次文件，即每周产生一个新的文件。
当然也可以指定按月、周、天、时和分。
即对应的格式如下：
①'.'yyyy-MM：
每月
②'.'yyyy-ww：
每周
③'.'yyyy-MM-dd：
每天
④'.'yyyy-MM-dd-a：
每天两次
⑤'.'yyyy-MM-dd-HH：
每小时
⑥'.'yyyy-MM-dd-HH-mm：
每分钟
（4）RollingFileAppender类型目的地属性说明
Threshold=WARN：
指定日志消息的输出最低层次。
ImmediateFlush=true：
默认值是true，意谓着所有的消息都会被立即输出。
File=mylog.txt：
指定消息输出到mylog.txt文件。
Append=false：
默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
MaxFileSize=100KB：
后缀可以是KB,MB或者是GB.在日志文件到达该大小时，将会自动滚动，即将原来的内容移到mylog.log.1文件。
MaxBackupIndex=2：
指定可以产生的滚动文件的最大数。
3.配置日志信息格式Layout
◆设置日志信息格式类型
有以下几种：
（1）org.apache.log4j.HTMLLayout------HTML表格形式；
（2）org.apache.log4j.PatternLayout------自定义的布局（下面将见到这么自定义配置）；
（3）org.apache.log4j.SimpleLayout------只包含日志信息基本和信息的字符信息；
（4）org.apache.log4j.TTCCLayout------包括日志产生时间、线程、类别等信息。
【例5】将例1中的目的地target01输出格式配置成自定义布局，target02输出格式配置成HTMLLayout格式。
log4j.appender.target01.layout=org.apache.log4j.PatternLayout
log4j.appender.target02.layout=org.apache.log4j.HTMLLayout
◆各格式类型相关属性说明
（1）HTMLLayout输出格式属性说明
LocationInfo=true：
默认值是false，输出java文件名称和行号。
Title=myappfile：
默认值是Log4JLogMessages。
（2）PatternLayout选项
ConversionPattern=%m%n:
指定怎样格式化指定的消息。
【例6】将例1中的目的地target01输出格式为显示输出信息的时间、所在的文件的行数。
log4j.appender.target01.layout.conversionPattern=%d{yyyy-MM-ddHH:
mm:
ss,SSS}%l%m%n
Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如表所示。
表1格式化信息参数含义说明表
符号
含义
-X
X信息输出时左对齐
%p
输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL，
%d
输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式。
例如，%d{yyyMMMddHH:
mm:
ss，SSS}，输出类似：
2002年10月18日22:
10:
28，921
%r
输出自应用启动到输出该log信息耗费的毫秒数
%c
输出日志信息所属的类目，配置文件中的名字，通常就是所在类的全名（若使用rootLogger）
%t
输出产生该日志事件的线程名
%l
输出日志事件的发生位置，相当于%C.%M（%F:
%L）的组合，包括类目名、发生的线程，以及行数。
举例：
Testlog4.main（TestLog4.java：
10）
%x
输出和当前线程相关联的NDC（嵌套诊断环境），尤其用到像javaservlets这样的多客户多线程的应用中
%%
输出一个"%"字符
%F
输出日志消息产生时所在的文件名称
%L
输出代码中的行号
%m
输出代码中指定的消息，产生的日志具体信息
%n
输出一个回车换行符，Windows平台为"\r\n"，Unix平台为"\n"输出日志信息换行
%M
输出日志信息所属的方法
可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。
如：
（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字符，就从左边交远销出的字符截掉。
4.在程序中使用log4j
（1）得到记录器
使用Log4j，第一步就是获取日志记录器，这个记录器将负责控制日志信息。
其语法为：
publicstaticLoggergetLogger（Stringname）
通过指定的名字获得记录器，如果必要的话，则为这个名字创建一个新的记录器。
Name一般取本类的名字。
【例7】创建一个记录器，名称为ServerWithLog4j类类名。
Loggerlogger=Logger.getLogger（ServerWithLog4j.class.getName（））
（2）读取配置文件
当获得了日志记录器之后，第二步将配置Log4j环境，其语法为：
BasicConfigurator.configure（）：
自动快速地使用缺省Log4j环境。
PropertyConfigurator.configure（StringconfigFilename）：
读取使用Java的特性文件编写的配置文件。
DOMConfigurator.configure（Stringfilename）：
读取XML形式的配置文件。
（3）记录信息（格式化日志信息）
当以上必要步骤执行完毕，您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方，其语法如下：
Logger.debug（Objectmessage）;
Logger.info（Objectmessage）;
Logger.warn（Objectmessage）;
Logger.error（Objectmessage）;
********************从网上摘抄的一些配置实例*********************
log4j.rootLogger=DEBUG,CONSOLE,A1,im
#DEBUG,CONSOLE,FILE,ROLLING_FILE,MAIL,DATABASE
log4j.addivity.org.apache=true
###################
#ConsoleAppender
###################
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=[framework]%d-%c-%-4r[%t]%-5p%c%x-%m%n
#log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]n%c[CATEGORY]%n%m[MESSAGE]%n%n
#####################
#FileAppender
#####################
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=file.log
log4j.appender.FILE.Append=false
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=[framework]%d-%c-%-4r[%t]%-5p%c%x-%m%n
#UsethislayoutforLogFactor5analysis
########################
#RollingFile
########################
log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log
log4j.appender.ROLLING_FILE.Append=true
log4j.appender.ROLLING_FILE.MaxFileSize=10KB
log4j.appender.ROLLING_FILE.MaxBackupIndex=1
log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework]%d-%c-%-4r[%t]%-5p%c%x-%m%n
####################
#SocketAppender
####################
log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
log4j.appender.SOCKET.RemoteHost=localhost
log4j.appender.SOCKET.Port=5001
log4j.appender.SOCKET.LocationInfo=true
#SetupforLogFacter5
log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n
########################
#LogFactor5Appender
########################
log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000
########################
#SMTPAppender
#######################
log4j.appender.MAIL=.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=chenyl@
log4j.appender.MAIL.SMTPHost=
log4j.appender.MAIL.Subject=Log4JMessage
log4j.appender.MAIL.To=chenyl@
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework]%d-%c-%-4r[%t]%-5p%c%x-%m%n
########################
#JDBCAppender
#######################
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:
mysql:
//localhost:
3306/test
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=
log4j.appender.DATABASE.sql=INSERTINTOLOG4J（Message）VALUES（'[framework]%d-%c-%-4r[%t]%-5p%c%x-%m%n'）
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework]%d-%c-%-4r[%t]%-5p%c%x-%m%n
log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=SampleMessages.log4j
log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
###################
#自定义Appender
###################
log4j.appender.im=net.cybercorlin.util.logger.appender.IMAppender
log4j.appender.im.host=
log4j.appender.im.username=username
log4j.appender.im.password=password
log4j.appender.im.recipient=corlin@
log4j.appender.im.layout=org.apache.log4j.PatternLayout
log4j.appender.im.layout.ConversionPattern=[framework]%d-%c-%-4r[%t]%-5p%c%x-%m%n
log4j.properties配置文件讲解如下：
#SetrootloggerleveltoDEBUGanditsonlyappendertoA1
#log4j中有五级logger
#FATAL0
#ERROR3
#WARN4
#INFO6
#DEBUG7
配置根Logger，其语法为：
#log4j.rootLogger=[level],appenderName,appenderName,…
log4j.rootLogger=INFO,A1,R
#这一句设置以为着所有的log都输出
#如果为log4j.rootLogger=WARN,则意味着只有WARN,ERROR,FATAL
#被输出，DEBUG,INFO将被屏蔽掉.
#A1issettobeaConsoleAppender.
#log4j中Appender有几层如控制台、文件、GUI组件、甚至是套接口服务器、NT的事件记录器、UNIXSyslog守护进程等
#ConsoleAppender输出到控制台
log4j.appender.A1=org.apache.log4j.ConsoleAppender
#A1使用的输出布局，其中log4j提供4种布局.
#org.apache.log4j.HTMLLayout（以HTML表格形式布局）
#org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
#org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
#org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）
log4j.appender.A1
升级会员 