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

类 LinLog

java.lang.Object
api.linlang.audit.LinLog
public final class LinLog extends Object
日志、审计与问题报告的静态兼容门面。

插件业务代码优先通过 lin.linAudit() 取得绑定当前插件的统一入口。 本类供运行时内部代码和无法直接取得插件门面的基础设施使用。

  • 方法详细资料

    • getAudit

      public static LinAudit getAudit(Class<?> ownerHint)
      为指定业务类创建统一审计入口。
      参数:
      ownerHint - 插件主类或业务类
      返回:
      绑定该 owner 的统一入口

    • getLogger

      public static LinLogger getLogger(Class<?> ownerHint)
      为指定业务类创建普通日志成员。
      参数:
      ownerHint - 插件主类或业务类
      返回:
      绑定该 owner 的日志成员

    • debug

      public static void debug(String message, Object... values)
      记录调试日志。
      参数:
      message - 日志模板
      values - 模板参数

    • debug

      public static void debug(LogTemplate template, Object... values)
      使用结构化模板记录调试日志。
      参数:
      template - 日志模板
      values - 模板参数

    • info

      public static void info(String message, Object... values)
      记录普通信息日志。
      参数:
      message - 日志模板
      values - 模板参数

    • info

      public static void info(LogTemplate template, Object... values)
      使用结构化模板记录普通信息日志。
      参数:
      template - 日志模板
      values - 模板参数

    • file

      public static void file(String message, Object... values)
      仅向普通日志文件输出 INFO 级别日志。
      参数:
      message - 日志消息
      values - 占位参数或扩展字段

    • file

      public static void file(LogTemplate template, Object... values)
      使用结构化模板只向普通日志文件记录信息。
      参数:
      template - 日志模板
      values - 模板参数

    • warn

      public static void warn(String message, Object... values)
      记录警告日志。
      参数:
      message - 日志模板
      values - 模板参数

    • warn

      public static void warn(LogTemplate template, Object... values)
      使用结构化模板记录警告日志。
      参数:
      template - 日志模板
      values - 模板参数

    • warn

      public static void warn(String message, Throwable cause, Object... values)
      记录带原因的警告日志。
      参数:
      message - 日志模板
      cause - 关联异常
      values - 模板参数

    • warn

      public static void warn(LogTemplate template, Throwable cause, Object... values)
      使用结构化模板记录带原因的警告日志。
      参数:
      template - 日志模板
      cause - 关联异常
      values - 模板参数

    • error

      public static void error(String message, Throwable cause, Object... values)
      记录带原因的错误日志。
      参数:
      message - 日志模板
      cause - 关联异常
      values - 模板参数

    • error

      public static void error(LogTemplate template, Throwable cause, Object... values)
      使用结构化模板记录带原因的错误日志。
      参数:
      template - 日志模板
      cause - 关联异常
      values - 模板参数

    • error

      public static void error(String message, Object... values)
      记录错误日志。
      参数:
      message - 日志模板
      values - 模板参数

    • error

      public static void error(LogTemplate template, Object... values)
      使用结构化模板记录错误日志。
      参数:
      template - 日志模板
      values - 模板参数

    • init

      public static void init(String message, Object... values)
      记录初始化阶段日志。
      参数:
      message - 日志模板
      values - 模板参数

    • init

      public static void init(LogTemplate template, Object... values)
      使用结构化模板记录初始化阶段日志。
      参数:
      template - 日志模板
      values - 模板参数

    • op

      public static void op(String message, Object... values)
      记录面向在线管理员的提示。
      参数:
      message - 消息模板
      values - 模板参数

    • op

      public static void op(LogTemplate template, Object... values)
      使用结构化模板记录面向在线管理员的提示。
      参数:
      template - 消息模板
      values - 模板参数

    • op

      public static void op(Object owner, String message, Object... values)
      为指定插件记录面向在线管理员的提示。
      参数:
      owner - 插件或业务 owner
      message - 消息模板
      values - 模板参数

    • startup

      public static void startup(String message, Object... values)
      记录启动阶段日志。
      参数:
      message - 日志模板
      values - 模板参数

    • startup

      public static void startup(LogTemplate template, Object... values)
      使用结构化模板记录启动阶段日志。
      参数:
      template - 日志模板
      values - 模板参数

    • startup

      public static void startup(Object owner, String message, Object... values)
      为指定插件记录启动阶段日志。
      参数:
      owner - 插件或业务 owner
      message - 日志模板
      values - 模板参数

    • init

      public static void init(Object owner, String message, Object... values)
      为指定插件记录初始化阶段日志。
      参数:
      owner - 插件或业务 owner
      message - 日志模板
      values - 模板参数

    • banner

      public static void banner(String message)
      记录启动横幅消息。
      参数:
      message - 横幅内容

    • audit

      public static void audit(String event, Object... fields)
      记录结构化审计事件。
      参数:
      event - 稳定的事件标识
      fields - 扩展字段，按名称和值交替排列

    • audit

      public static void audit(Object owner, String event, Object... fields)
      为指定插件记录结构化审计事件。
      参数:
      owner - 插件或业务 owner
      event - 稳定的事件标识
      fields - 扩展字段，按名称和值交替排列

    • problem

      public static void problem(LinProblem problem)
      报告一个结构化问题。
      参数:
      problem - 问题对象

    • flush

      public static void flush()
      刷新默认 owner 的待写记录。

    • flushStartupToConsole

      public static void flushStartupToConsole()
      将默认 owner 的启动消息输出到控制台。

    • flushOpToOnlineOps

      public static void flushOpToOnlineOps()
      将默认 owner 的管理员消息发送给在线管理员。

    • flushOpTo

      public static void flushOpTo(Object op)
      将默认 owner 的管理员消息发送给指定目标。
      参数:
      op - 接收目标