模块 linlang.api
程序包 api.linlang.audit

接口 LinLogger

public interface LinLogger
绑定到平台的具体琳琅日志服务实现

琳琅日志服务提供多种常用的占位符使用办法

  • 空占位符：按 {}顺序填入参数值
  • 准确占位符：用于格式化字符串中的精准替换
  • 尾部追加：在消息末尾直接附加键值对信息

  • 方法概要

    修饰符和类型
    方法
    说明
    void
    audit(String event, Object... kv)
    记录一条审计事件
    void
    debug(String msg, Object... kv)
    输出 DEBUG 级别日志。
    default void
    error(String msg, Object... kv)
    方便重载：没有 Throwable 时可以只传消息和 kv
    void
    error(String msg, Throwable t, Object... kv)
    输出 ERROR 级日志，可选附带异常
    default void
    flushOpTo(Object op)
    向指定 OP 刷新 OP 队列（平台自定义 op 类型）
    default void
    flushOpToOnlineOps()
    刷新 OP 队列到在线 OP
    default void
    flushStartupToConsole()
    刷新 STARTUP 队列到控制台或广播
    void
    info(String msg, Object... kv)
    输出 INFO 级别日志。
    void
    init(String msg, Object... kv)
    输出 INIT 通道日志：通常用于模块/插件初始化阶段
    void
    op(String msg, Object... kv)
    输出 OP 通道日志：发送给在线 OP 或进入 OP 队列
    void
    startup(String msg, Object... kv)
    输出启动通道日志：服务器尚未完全启动时进入 STARTUP 队列
    void
    warn(String msg, Object... kv)
    输出 WARN 级别日志

  • 方法详细资料

    • debug

      void debug(String msg, Object... kv)
      输出 DEBUG 级别日志。
      参数:
      msg - 日志消息，支持占位符格式
      kv - 键值对参数，用于填充消息中的占位符

    • info

      void info(String msg, Object... kv)
      输出 INFO 级别日志。
      参数:
      msg - 日志消息，支持占位符格式
      kv - 键值对参数，用于填充消息中的占位符

    • warn

      void warn(String msg, Object... kv)
      输出 WARN 级别日志
      参数:
      msg - 日志消息，支持占位符格式
      kv - 键值对参数，用于填充消息中的占位符

    • error

      void error(String msg, Throwable t, Object... kv)
      输出 ERROR 级日志，可选附带异常
      参数:
      msg - 日志消息，支持占位符格式
      t - 异常对象，可为 null
      kv - 键值对参数，用于填充消息中的占位符

    • error

      default void error(String msg, Object... kv)
      方便重载：没有 Throwable 时可以只传消息和 kv
      参数:
      msg - 日志消息，支持占位符格式
      kv - 键值对参数，用于填充消息中的占位符

    • op

      void op(String msg, Object... kv)
      输出 OP 通道日志：发送给在线 OP 或进入 OP 队列
      参数:
      msg - 日志消息，支持占位符格式
      kv - 键值对参数，用于填充消息中的占位符

    • startup

      void startup(String msg, Object... kv)
      输出启动通道日志：服务器尚未完全启动时进入 STARTUP 队列
      参数:
      msg - 日志消息，支持占位符格式
      kv - 键值对参数，用于填充消息中的占位符

    • init

      void init(String msg, Object... kv)
      输出 INIT 通道日志：通常用于模块/插件初始化阶段
      参数:
      msg - 日志消息，支持占位符格式
      kv - 键值对参数，用于填充消息中的占位符

    • audit

      void audit(String event, Object... kv)
      记录一条审计事件
      参数:
      event - 审计事件名称
      kv - 审计事件相关的键值对数据

    • flushStartupToConsole

      default void flushStartupToConsole()
      刷新 STARTUP 队列到控制台或广播

    • flushOpToOnlineOps

      default void flushOpToOnlineOps()
      刷新 OP 队列到在线 OP

    • flushOpTo

      default void flushOpTo(Object op)
      向指定 OP 刷新 OP 队列（平台自定义 op 类型）
      参数:
      op - 目标 OP 对象