java中Log4J使用配置参数的总结

一般使用Log4J时除了应用对应的jar包外还需要配置相应的log4j.properties属性文件，下面将对该文件的配置做一个总结，方便以后回忆。
----------
一、首先配置根，格式为：
log4j.rootLogger=[level],appendername1,appendername2...
1、其中level为级别，日志级别从高到低分为：
A：off      最高等级，用于关闭所有日志记录。
B：fatal    指出每个严重的错误事件将会导致应用程序的退出。
C：error    指出虽然发生错误事件，但仍然不影响系统的继续运行。
D：warm     表明会出现潜在的错误情形。
E：info     一般和在粗粒度级别上，强调应用程序的运行全程。
F：debug    一般用于细粒度级别上，对调试应用程序非常有帮助。
G：all      最低等级，用于打开所有日志记录。
上面这些级别是定义在org.apache.log4j.Level类中。Log4j只建议使用4个级别，优先级从高到低分别是error,warn,info和debug。通过使用日志级别，可以控制应用程序中相应级别日志信息的输出。例如，如果使用b了info级别，则应用程序中所有低于info级别的日志信息(如debug)将不会被打印出来。
2、appendername为输出端的名称，可以任意命名，建议输出到控制台可以用syso，调试信息可以为D，错误信息为E这类。
----------
二、输出端设置
1、输出目的地配置，格式如下：
log4j.appender.appenderName = 输出的目的地
目的地有一下6种
a：org.apache.log4j.ConsoleAppender：将日志信息输出到控制台。
b：org.apache.log4j.FileAppender：将日志信息输出到一个文件。
c：org.apache.log4j.DailyRollingFileAppender：将日志信息输出到一个日志文件，并且按设置的时间输出到一个新的日志文件。
d：org.apache.log4j.RollingFileAppender：将日志信息输出到一个日志文件，并且指定文件的尺寸，当文件大小达到指定尺寸时，会自动把文件改名，同时产生一个新的文件。
e：org.apache.log4j.WriteAppender：将日志信息以流格式发送到任意指定地方。
f:：org.apache.log4j.jdbc.JDBCAppender：通过JDBC把日志信息输出到数据库中。
2、配置日志信息的格式
        log4j.appender.appenderName.layout = 格式
  输出格式有一下四种
  a：org.apache.log4j.HTMLLayout（以HTML表格形式布局），
  b：org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
  c：org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
  d：org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）
三、一般常用输出端包含的常用属性：
控制台选项
    -Threshold=DEBUG:指定日志消息的输出最低层次。
    -ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
    -Target=System.err（红色）：默认情况下是：System.out（黑色）,指定输出控制台。
FileAppender 选项
    -Threshold=DEBUG:指定日志消息的输出最低层次。
    -ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
    -File=mylog.txt:指定消息输出到mylog.txt文件。
    -Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。
    -Encoding = UTF-8:可以指定文件编码格式  
DailyRollingFileAppender 选项
    -Threshold = WARN:指定日志消息的输出最低层次
    -ImmediateFlush = TRUE:默认值是true,所有的消息都会被立即输出
    -File = C:\log4j.log:指定消息输出到C:\log4j.log文件
    -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:每分钟
    -Encoding = UTF-8:可以指定文件编码格式
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:指定可以产生的滚动文件的最大数。
    Encoding = UTF-8:可以指定文件编码格式  
以下公用的输出格式
    log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ss} %c %m%n

日志信息格式中几个符号所代表的含义：
     -X号: X信息输出时左对齐；
     %p: 输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL；
     %d: 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyyy-MM-dd HH:mm:ss,SSS}；
     %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.rootLogger = debug,stdout,E,I,D

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} method:%l%n%m%n

log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File = log/error.log
log4j.appender.E.DatePattern=yyyyMMddHHmmss’.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.I = org.apache.log4j.RollingFileAppender
log4j.appender.I.File = log/info.log
log4j.appender.I.Append = true
log4j.appender.I.Threshold = INFO
log4j.appender.I.layout = org.apache.log4j.PatternLayout
log4j.appender.I.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
log4j.appender.I.MaxFileSize = 1MB
log4j.appender.I.MaxBackupIndex=20

log4j.appender.D = org.apache.log4j.RollingFileAppender
log4j.appender.D.File = log/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
log4j.appender.D.MaxFileSize = 1MB
log4j.appender.D.MaxBackupIndex=20