江苏龙网

  1. 主页 > 生活百科 > >

java简单日志打印规范小记

Java日志打印

个人认为，如果公司一些基础类库不做约束，很可能“埋坑”，形成技术债务，最终为此付出代价 。本文讲解一个最基本的日志打印规范 。

java简单日志打印规范小记

文章插图
 
1. 日志打印组件
日志组件有很多，日志门面的选择有：Slf4j、Apache Commons Logging等 。
日志的实现更多，有：log4j、logback、log4j2、JAVA util logging、jboss logging等等 。
目前，我们使用slf4j作为日志门面，log4j2作为日志实现 。
2. 日志级别
日志的级别有很多，我们一般只用四个 。日志级别由低到高debug-->info-->warn-->error
DEBUG(调试)
开发调试日志 。一般来说，在系统实际运行过程中，不会输出该级别的日志 。因此，开发人员可以打印任何自己觉得有利于开发查问题的任何log 。
INFO(通知)
INFO日志级别主要用于记录系统运行状态等关联信息 。该日志级别，常用于反馈系统当前状态给最终用户 。所以，在这里输出的信息，应该对最终用户具有实际意义，也就是最终用户要能够看得明白是什么意思才行 。
WARN(警告)
WARN日志常用来表示系统模块发生问题，但并不影响系统运行 。此时，进行一些修复性的工作，还能把系统恢复到正常的状态 。
ERROR(错误）
此信息输出后，主体系统核心模块正常工作，需要修复才能正常工作 。就是说可以进行一些修复性的工作，但无法确定系统会正常的工作下去，系统在以后的某个阶段，很可能会因为当前的这个问题，导致一个无法修复的错误（例如宕机），但也可能一直工作到停止也不出现严重问题 。
3. 日志打印场景
在我们的系统中，不同的日志级别的打印场景大致如下
DEBUG 调试日志 。目前管理相对宽松，我们暂时没有严格要求 。
INFO 业务日志 。我们用来记录业务的主流程的走向 。
WARN 警告日志 。一般来说，发生对整个系统没什么影响的异常时，可以打印该级别的日志 。
ERROR 错误日志 。级别比较高，如果发生一些异常，并且任何时候都需要打印时使用 。
4. 日志使用方式
示例代码
private static final Logger logger = LoggerFactory.getLogger(TestController.class);我们使用的日志门面是slf4j，使用时应面向接口编程，LOGGER/LoggerFactory应该都是slf4j的API 。
严禁直接使用日志实现包 。原因大致有两点
1、是面向接口编程更优雅，这点不必说明；
2、举个例子，因为log4j已经几年不更新，老的项目可能使用了log4j，现在想要换用logback或者log4j2，如直接使用log4j的API，不利于选型更换与API的统一 。
禁止字符串拼接
例如：
logger.debug("当前用户是:" + user + ",传入参数是:" + userId);严禁使用字符串拼接的方式打印日志，可读性、可维护性都比较差 。
建议的写法如下：
logger.debug("当前用户是:{},传入参数是:{},返回值是:{},用户信息:{}", a,b new Object[]{token, userId, userInfo, authcInfo});因为我们使用的是slf4j，slf4j有占位符填充的功能 。多个占位符可放在Object数组中 。

【java简单日志打印规范小记】


    推荐阅读


    上一篇：茶与古典文学精神内涵,龙润姓氏茶全新品牌形象温暖上线

    下一篇：吃叶酸可以喝茶吗,空腹可以吃大麦茶吗