模块 linlang.api

程序包 api.linlang.audit.event

类 AuditEvent

java.lang.Object

api.linlang.audit.event.AuditEvent

public final class AuditEvent
extends Object

一条结构化审计事件。

事件名称应当是稳定的机器可读标识，例如 config.reload。 展示文本和多语言内容不应作为事件名称。

嵌套类概要

嵌套类

修饰符和类型	类	说明
static final class	AuditEvent.Builder	审计事件构建器。

方法概要

修饰符和类型	方法	说明
String	action()	返回操作名称。
String	actor()	返回操作者标识。
static AuditEvent.Builder	builder(String event)	创建审计事件构建器。
String	correlationId()	返回关联标识。
String	event()	返回稳定的事件标识。
Map<String,Object>	fields()	返回扩展字段。
static AuditEvent	of(String event, Object... fields)	使用键值对快速创建审计事件。
AuditOutcome	outcome()	返回执行结果。
String	resource()	返回资源标识。
Instant	timestamp()	返回事件时间。

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

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

方法详细资料

builder

public static AuditEvent.Builder builder(String event)

创建审计事件构建器。

参数:

event - 稳定的事件名称

返回:

构建器

of

public static AuditEvent of(String event,
 Object... fields)

使用键值对快速创建审计事件。

参数:

event - 稳定的事件名称

fields - 事件字段，按照 key、value 顺序提供

返回:

审计事件

timestamp

public Instant timestamp()

返回事件时间。

返回:

事件时间

event

public String event()

返回稳定的事件标识。

返回:

事件标识

actor

public String actor()

返回操作者标识。

返回:

操作者标识；未设置时为 null

action

public String action()

返回操作名称。

返回:

操作名称；未设置时为 null

resource

public String resource()

返回资源标识。

返回:

资源标识；未设置时为 null

outcome

public AuditOutcome outcome()

返回执行结果。

返回:

执行结果，默认 AuditOutcome.UNKNOWN

correlationId

public String correlationId()

返回关联标识。

返回:

关联标识；未设置时为 null

fields

public Map<String,Object> fields()

返回扩展字段。

返回:

不可修改的扩展字段映射