java日志设计&实践(3) - 开发篇 1.选择恰当的日志级别 2.输出明确的提示文字和充分的现场信息 3.输出内容一行搞定，不要换行 4.其他
1.选择恰当的日志级别 选择日志级别时需要遵循一些通用规范，不可随意定义
log4j的日志级别，由低到高排列：all trace debug info warn error fatal off 其中，all off仅用以log4j配置文件中开启或关闭所有日志，trace fatal一般也用不到 对于开发人员来说，只需要关注debug info warn error
debug 正常情况下不需要输出，只有当出问题时才需要输出的日志信息，由于生产环境无法单步调试，可以把debug级别的日志想象成你在生成环境中debug info 可能要关注或者只有比较重要的信息才需要输出，如：用户登录、退出、后台job执行时长等 warn 存在一些潜在的危险时输出的日志，比如：请求参数中包含攻击注入脚本 error 如：请求数据库时的SQL异常
当然，最好的方法还是参考优秀的开源代码
2.输出明确的提示文字和充分的现场信息 要点： 1）明确的提示文字，看到这段提示文本就可以知道发生了什么，不需要再去扒拉源码 2）充分的现场信息，如：用户信息、引发异常的参数值、异常栈信息等
举例： LOG.warn("Unknown value for includeParams parameter to URL tag: " + includeParams); LOG.warn("Unable to put request parameters (" + extractQueryString() + ") into parameter map.", e); LOG.warn("Could not find token mapped to token name " + tokenName);
3.一条日志一行搞定 这个是为了方便跟踪和分析日志，使用grep命令时不至于仅看到一条日志的部分内容
4.其他
4.1.尽量使用一套日志接口，强烈推荐slf4j 两大理由： 1）使用{}占位符，避免字符串拼接
以刚才三个log为例 LOG.warn("Unknown value for includeParams parameter to URL tag: " + includeParams); LOG.warn("Unable to put request parameters (" + extractQueryString() + ") into parameter map.", e); LOG.warn("Could not find token mapped to token name " + tokenName);
如果改用slf4j的话，写法如下： log.warn("Unknown value for includeParams parameter to URL tag: {}", includeParams); log.warn("Unable to put request parameters ({}) into parameter map.", extractQueryString(), e); log.warn("Could not find token mapped to token name {}", tokenName);
2）执行实际日志输出前强制检查log是否开启
组合使用log4j+slf4j时，执行的warn方法实际是这样的: public void warn(String format, Object arg) { if (logger.isEnabledFor(Level.WARN)) { FormattingTuple ft = MessageFormatter.format(format, arg); logger.log(FQCN, Level.WARN, ft.getMessage(), ft.getThrowable()); } }
4.2.不要使用System.out.PRintln() 这个就不多说了，日志中看到一句莫名其妙hello,world你会怎么想，怎么查？？？？
4.3.不要使用e.printStackTrace() 这种打印只能输出到catalina.out中，无法单独制定输出目的文件，还会导致日志输出混乱
4.4.slf4j打印异常堆栈信息 两个例子：
try { if (true) { throw new RuntimeException("i'm ok"); } } catch (Exception e) { log.error("Error. param:{}, param2:{}, param3:{}", param, param2, param3, e); }
将打印： ERROR 2015-01-17 15:11:51,426 Error. param:0, param2:2, param3:false [cn.xxt.log.test.Slf4jTest.main(Slf4jTest.java:36)] java.lang.RuntimeException: i'm ok at cn.xxt.log.test.Slf4jTest.main(Slf4jTest.java:33) try { if (true) { throw new RuntimeException("i'm sorry"); } } catch (Exception e) { log.error("Error. param:{}, param2:{}, param3:{}, {}", param, param2, param3, e); }
将打印： ERROR 2015-01-17 15:11:51,429 Error. param:0, param2:2, param3:false, java.lang.RuntimeException: i'm sorry [cn.xxt.log.test.Slf4jTest.main(Slf4jTest.java:44)]
差异：前者输出了异常栈信息，后者没有 原因：后者用{}占位符打印异常对象e，导致异常栈信息没有输出
参考文档 为什么要使用SLF4J而不是Log4J http://www.importnew.com/7450.html