模块 linlang.api

程序包 api.linlang.audit

类 LinLog

java.lang.Object

api.linlang.audit.LinLog

public final class LinLog
extends Object

审计与日志静态门面

初始化琳琅运行时后，通过此类安装为具体平台实现 LinLogger

方法概要

修饰符和类型	方法	说明
static void	audit(Object owner, String event, Object... kv)	记录一条审计事件
static void	banr(String s)
static void	flushOpTo(Object op)	将 OP 队列发送到指定对象（具体类型由 Provider 实现约定）
static void	flushOpToOnlineOps()	刷新 OP 队列到所有在线 OP
static void	flushStartupToConsole()	刷新 STARTUP 队列到控制台
static LinLogger	getLogger(Class<?> ownerHint)	为指定业务类创建一个绑定 owner 的 LinLogger。
static void	init(Object owner, String m, Object... kv)	针对指定 owner 输出 INIT 日志。
static void	install(api.linlang.audit.LinLog.Provider p)	安装日志提供者。
static void	op(Object owner, String m, Object... kv)	针对指定 owner 输出 OP 日志。
static void	startup(Object owner, String m, Object... kv)	针对指定 owner 输出 STARTUP 日志。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

install

public static void install(api.linlang.audit.LinLog.Provider p)

安装日志提供者。

运行时在启动阶段调用本方法，将平台相关实现注入。 若传入 null，则回退为不做任何输出的空实现。

参数:

p - 要安装的 Provider 实例

getLogger

public static LinLogger getLogger(Class<?> ownerHint)

为指定业务类创建一个绑定 owner 的 LinLogger。

Provider 可通过 ownerHint 反推出插件归属

参数:

ownerHint - 作为 owner 线索的类，通常是插件主类或业务类自身

返回:

绑定到该 owner 的日志接口

banr

public static void banr(String s)

op

public static void op(Object owner,
 String m,
 Object... kv)

针对指定 owner 输出 OP 日志。

参数:

owner - owner 线索

m - 消息内容

kv - 扩展键值对

startup

public static void startup(Object owner,
 String m,
 Object... kv)

针对指定 owner 输出 STARTUP 日志。

参数:

owner - owner 线索

m - 消息内容

kv - 扩展键值对

init

public static void init(Object owner,
 String m,
 Object... kv)

针对指定 owner 输出 INIT 日志。

参数:

owner - owner 线索

m - 消息内容

kv - 扩展键值对

audit

public static void audit(Object owner,
 String event,
 Object... kv)

记录一条审计事件

参数:

owner - owner 线索

event - 事件名称

kv - 扩展键值对

flushStartupToConsole

public static void flushStartupToConsole()

刷新 STARTUP 队列到控制台

flushOpToOnlineOps

public static void flushOpToOnlineOps()

刷新 OP 队列到所有在线 OP

flushOpTo

public static void flushOpTo(Object op)

将 OP 队列发送到指定对象（具体类型由 Provider 实现约定）

参数:

op - 目标对象，例如 Bukkit 的 Player