Log4J 快速参考

Log4J 快速参考

1.属性
级别 描述

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

使用:

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

2.追加器
名称 写入

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

使用:

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

3.布局
名称 描述

• PatternLayout 转换模式
• SimpleLayout 级别和消息
• TTCCLayout = 时间, 线程, 类别, 上下文
• HTMLLayout HTML 表
• XMLLayout XML

使用:
log4j.appender.Appender.layout=org.apache.log4j.Name

4.模式布局

• %%: 输出一个"%"字符
• %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}

5.格式修饰符
修饰符 左对齐 最小   最大 说明

• %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，从开头截断.