模块 linlang.api

程序包 api.linlang.audit.problem

接口 LinProblemReporter

public interface LinProblemReporter

问题报告与内建代码查询成员。

Problem 用于记录需要定位和查询的运行时故障，也可以记录没有 Java 异常的 可恢复问题。它不替代方法参数校验，也不应作为正常业务分支或用户输入错误的 控制流。操作无法继续时，调用方仍应在问题上报后抛出合适的 Java 异常。

方法概要

修饰符和类型	方法	说明
default List<api.linlang.audit.problem.ProblemDefinition>	list()	列出运行时内建的全部问题代码。
Optional<api.linlang.audit.problem.ProblemDefinition>	lookup(String code)	查询运行时内建的问题代码。
void	report(LinProblem problem)	记录问题代码、上下文和原始 Java 异常。
default void	report(String code, Throwable cause, Object... context)	快速报告问题。

方法详细资料

report

void report(LinProblem problem)

记录问题代码、上下文和原始 Java 异常。

参数:

problem - 问题记录

report

default void report(String code,
 Throwable cause,
 Object... context)

快速报告问题。

参数:

code - 稳定的问题代码

cause - 原始 Java 异常，可以为 null

context - 上下文字段，按照 key、value 顺序提供

lookup

Optional<api.linlang.audit.problem.ProblemDefinition> lookup(String code)

查询运行时内建的问题代码。

参数:

code - 问题代码

返回:

找到的定义

list

default List<api.linlang.audit.problem.ProblemDefinition> list()

列出运行时内建的全部问题代码。

返回:

按代码排序的只读定义列表