知识卡片

普通读书笔记卡 · 1921.d.3.b

用装饰器把日志转JSON

理解等级:中级

需求:系统用阿里云日志服务(SLS)监控项目日志并按 JSON 解析,而现有日志基于 Log4j + Slf4j,打印的是无规则的字符串。

做法: - DecoratorLogger 实现 Logger 接口并持有原有 Logger; - JsonLogger 继承它,对 info、error 等方法先用 JSON 对象包装消息,最终仍调用原生 logger.error(string)——只是参数已被“装饰”;还可以增加 error(Exception e) 这类便捷方法; - 提供 JsonLoggerFactory 返回 JsonLogger 实例。

迁移成本极低:调用方唯一的改动是把 LoggerFactory 换成 JsonLoggerFactory,其他使用方式不变,新老交替时更容易被其他开发者接受。

作者的结论:装饰器最本质的特征是把原有类的附加功能抽离出来,简化原有类的逻辑;抽象装饰器可有可无,按业务模型选择。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 第13章 装饰器模式 · 查看原书依据

      对于客户端而言,唯一与原先不同的地方就是将LoggerFactory改为JsonLoggerFactory即可,这样的实现,也会更快更方便地被其他开发者接受和习惯。

    参考来源

    - 位置:《设计模式就该这样学:基于经典框架源码和真实业务场景》第13章《第13章 装饰器模式》13.2.2 使用装饰器模式扩展日志格式输出(源文件:extracted/设计模式就该这样学:基于经典框架源码和真实业务场景/_epub-src/OEBPS/Text/txt016.xhtml,来源项目 book-sources) - 结论依据:13.2.2节以日志需转为JSON供SLS解析为例,用DecoratorLogger持有原Logger、JsonLogger包装消息后仍调用原生接口,并提供JsonLoggerFactory使调用方只需替换工厂类,总结装饰器本质是抽离附加功能且抽象装饰器可有可无。 - 原始内容:对于客户端而言,唯一与原先不同的地方就是将LoggerFactory改为JsonLoggerFactory即可,这样的实现,也会更快更方便地被其他开发者接受和习惯。