<返回更多

java简单日志打印规范小记

2020-05-29    
加入收藏

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

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数组中。

声明:本站部分内容来自互联网,如有版权侵犯或其他问题请与我们联系,我们将立即删除或处理。
▍相关推荐
更多资讯 >>>