Log4J 快速参考

Log4J 快速参考

1.属性
级别 描述
[list]
[*]ALL 输出所有信息
[*]TRACE 调试细节
[*]DEBUG 调试 (方法 xy 以参数 abc 调用…)
[*]INFO 一般信息 (程序启动/停止, 连接到主机 foo, 计算耗费了 n 秒)
[*]WARN 未预期的情况
[*]ERROR 错误 (捕获异常)
[*]FATAL 严重错误，程序停止
[*]OFF 日志程序不工作

[/list]
使用:

log4j.rootLogger=Level, Appender, Appender, ...
log4j.logger.Package.Package.Class=Level

2.追加器
名称 写入
[list]
[*]ConsoleAppender 标准输出 (控制台)
[*]FileAppender 文件
[*]RollingFileAppender 根据规定的文件大小创建一个新日志文件
[*]DailyRollingFileAppender 根据规定的时间创建一个新日志文件
[*]SyslogAppender UNIX Syslog
[*]NTEventLogAppender Windows 事件日志
[*]SMTPAppender e-mail
[*]net.SocketAppender Socket (客户模式)
[*]net.SocketHubAppender Socket (服务器模式)

[/list]
使用:

log4j.appender.Appender=org.apache.log4j.Name

3.布局
名称 描述
[list]
[*]PatternLayout 转换模式
[*]SimpleLayout 级别和消息
[*]TTCCLayout = 时间, 线程, 类别, 上下文
[*]HTMLLayout HTML 表
[*]XMLLayout XML

[/list]
使用:
log4j.appender.Appender.layout=org.apache.log4j.Name

4.模式布局
[list]
[*]%%: 输出一个"%"字符
[*] %c: 输出日志信息所在的类名，%c(2)将输出带1个前缀的类名， 如： a.b.c -> %c{2} = a.b
[*] %C: 完全限定类别 (慢); org.apache.xyz.SomeClass -> %C{1} = SomeClass
[*] %d: 输出日志时间，默认格式为ISO8601，也可指定格式，比如：%d{yyy-MMM-dd HH:mm:ss,SSS},%d{ABSOLUTE}, %d{DATE}, %d{ISO8601}
[*] %F: 输出日志消息产生时所在的文件名称(相当慢)
[*] %l: 输出日志发生的位置(相当慢) ，相当于%C.%M(%F:%L)的组合,包括类名、发生的线程，在代码中的行数。 如：Test.main(Test.java:10)
[*] %L: 输出代码中的行号(相当慢)
[*] %m: 输出代码中指定的消息，如info(“message”),输出message
[*] %M: 方法名 (相当慢)
[*] %n: 输出一个回车换行符，Windows平台为"\r\n"，Unix平台为"\n"输出日志信息换行
[*] %p: 输出日志信息优先级，即DEBUG，INFO，WARN，ERROR，FATAL,
[*] %r: 输出自应用启动到显示该log信息耗费的毫秒数
[*] %t: 输出产生该日志事件的线程名
[*] %x: 输出和当前线程相关联的NDC(嵌套诊断环境),多用于java servlets这样的多线程应用。
[*] %X: 映射诊断线程上下文; %X{clientNumber}

[/list]
5.格式修饰符
修饰符 左对齐 最小 最大 说明
[list]
[*]%20c false 20 none 如果名称小于20，左填充空格.
[*]%-20c true 20 none 如果名称小于20，右填充空格.
[*]%.30c NA none 30 如果名称大于30，从开头截断.
[*]%20.30c false 20 30 如果名称小于20，左填充空格.但，如果类别名大于30，从开头截断.
[*]%-20.30c true 20 30 如果名称小于20，右填充空格.但，如果类别名大于30，从开头截断.
[/list]