程序包 dev.tinyflow.core.chain

类 NodeValidResult

java.lang.Object

dev.tinyflow.core.chain.NodeValidResult

所有已实现的接口:

Serializable

public class NodeValidResult
extends Object
implements Serializable

表示一个链式节点校验结果。 包含校验是否成功、消息说明以及附加的详细信息（如失败字段、原因等）。

实例是不可变的（immutable），线程安全。

另请参阅:

• 序列化表格

字段概要

字段

修饰符和类型	字段	说明
private final Map<String,Object>	details
static final NodeValidResult	FAILURE
private final String	message
private static final long	serialVersionUID
private final boolean	success
static final NodeValidResult	SUCCESS

构造器概要

构造器

限定符	构造器	说明
private	NodeValidResult(boolean success, String message, Map<String,Object> details)	私有构造器，确保通过工厂方法创建实例。

方法概要

修饰符和类型	方法	说明
boolean	equals(Object o)
static NodeValidResult	fail()	创建一个失败的校验结果（无消息、无详情）。
static NodeValidResult	fail(String message)	创建一个失败的校验结果，仅包含消息。
static NodeValidResult	fail(String message, Object... kvPairs)	创建一个失败的校验结果，支持键值对形式传入 details。
static NodeValidResult	fail(String message, Map<String,Object> details)	创建一个失败的校验结果，包含消息和详情。
static NodeValidResult	failOnField(String field, String reason)	快捷方法：创建包含字段错误的失败结果。
Map<String,Object>	getDetails()	获取详细信息（如校验失败的字段、原因等），不可变 Map。
String	getMessage()	获取结果消息（可为 null）。
int	hashCode()
boolean	isSuccess()	获取校验是否成功。
static NodeValidResult	ok()	创建一个成功的校验结果（无消息、无详情）。
static NodeValidResult	ok(String message)	创建一个成功的校验结果，附带消息。
static NodeValidResult	ok(String message, Object... kvPairs)	创建一个成功的校验结果，支持键值对形式传入 details。
static NodeValidResult	ok(String message, Map<String,Object> details)	创建一个成功的校验结果，附带消息和详情。
static NodeValidResult	require(boolean condition, String messageIfFail)	快捷方法：基于布尔值返回成功或失败结果。
private static Map<String,Object>	toMapFromPairs(Object... kvPairs)
String	toString()

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细资料

serialVersionUID

private static final long serialVersionUID

另请参阅:

• 常量字段值

SUCCESS

public static final NodeValidResult SUCCESS

FAILURE

public static final NodeValidResult FAILURE

success

private final boolean success

message

private final String message

details

private final Map<String,Object> details

构造器详细资料

NodeValidResult

private NodeValidResult(boolean success,
 String message,
 Map<String,Object> details)

私有构造器，确保通过工厂方法创建实例。

方法详细资料

isSuccess

public boolean isSuccess()

获取校验是否成功。

getMessage

public String getMessage()

获取结果消息（可为 null）。

getDetails

public Map<String,Object> getDetails()

获取详细信息（如校验失败的字段、原因等），不可变 Map。 如果无详情，则返回 null。

ok

public static NodeValidResult ok()

创建一个成功的校验结果（无消息、无详情）。

ok

public static NodeValidResult ok(String message)

创建一个成功的校验结果，附带消息。

ok

public static NodeValidResult ok(String message,
 Map<String,Object> details)

创建一个成功的校验结果，附带消息和详情。

ok

public static NodeValidResult ok(String message,
 Object... kvPairs)

创建一个成功的校验结果，支持键值对形式传入 details。

示例：success("验证通过", "userId", 123, "role", "admin")

参数:

message - 消息

kvPairs - 键值对（必须成对：key1, value1, key2, value2...）

返回:

ChainNodeValidResult

抛出:

IllegalArgumentException - 如果 kvPairs 数量为奇数

fail

public static NodeValidResult fail()

创建一个失败的校验结果（无消息、无详情）。

fail

public static NodeValidResult fail(String message)

创建一个失败的校验结果，仅包含消息。

fail

public static NodeValidResult fail(String message,
 Map<String,Object> details)

创建一个失败的校验结果，包含消息和详情。

fail

public static NodeValidResult fail(String message,
 Object... kvPairs)

创建一个失败的校验结果，支持键值对形式传入 details。

示例：fail("验证失败", "field", "email", "reason", "格式错误")

failOnField

public static NodeValidResult failOnField(String field,
 String reason)

快捷方法：创建包含字段错误的失败结果。 适用于表单/参数校验场景。

参数:

field - 错误字段名

reason - 错误原因

返回:

失败结果

require

public static NodeValidResult require(boolean condition,
 String messageIfFail)

快捷方法：基于布尔值返回成功或失败结果。

参数:

condition - 条件

messageIfFail - 条件不满足时的消息

返回:

根据条件返回对应结果

toMapFromPairs

private static Map<String,Object> toMapFromPairs(Object... kvPairs)

equals

public boolean equals(Object o)

覆盖:

equals 在类中 Object

hashCode

public int hashCode()

覆盖:

hashCode 在类中 Object

toString

public String toString()

覆盖:

toString 在类中 Object