java.lang.Object

cloud.opencode.base.rules.RuleContext

public final class RuleContext extends Object

Rule Context - Manages Facts and Variables During Rule Execution 规则上下文 - 管理规则执行期间的事实和变量

Provides storage for facts (domain objects) and variables used during rule evaluation and action execution. Also stores rule execution results.

提供在规则评估和动作执行期间使用的事实（领域对象）和变量的存储。同时存储规则执行结果。

Features | 主要功能:

Fact management (typed and named) - 事实管理（类型化和命名）
Variable storage - 变量存储
Result collection - 结果收集
Fluent API - 流式API

Usage Examples | 使用示例:

// Create context with facts
RuleContext context = RuleContext.create()
    .put("customerType", "VIP")
    .put("orderAmount", 5000.0)
    .addFact(customer)
    .addFact(order);

// Access values
String type = context.get("customerType");
Double amount = context.get("orderAmount");
Optional<Customer> cust = context.getFact(Customer.class);

// Set results
context.setResult("discount", 0.15);

Security | 安全性:

Thread-safe: No (create new instance per execution) - 线程安全: 否（每次执行创建新实例）

Since:

JDK 25, opencode-base-rules V1.0.0

Author:

Leon Soo www.LeonSoo.com

See Also:

Method Summary

Modifier and Type

Method

Description

RuleContext

addFact(Object fact)

Adds a fact object to the context 向上下文添加事实对象

RuleContext

addFact(String name, Object fact)

Adds a named fact object to the context 向上下文添加命名的事实对象

RuleContext

clearResults()

Clears all results 清除所有结果

RuleContext

clearVariables()

Clears all variables 清除所有变量

<T> boolean

contains(TypedKey<T> key)

Checks if a typed key exists in variables or facts 检查类型化键是否存在于变量或事实中

boolean

contains(String key)

Checks if a variable exists 检查变量是否存在

static RuleContext

create()

Creates an empty rule context 创建空的规则上下文

FactStore

facts()

Gets the fact store 获取事实存储

<T> T

get(TypedKey<T> key)

Gets a typed value by typed key (checks variables first, then facts) 通过类型化键获取类型化值（先检查变量，再检查事实）

<T> T

get(TypedKey<T> key, T defaultValue)

Gets a typed value by typed key with a default 通过类型化键获取类型化值，带默认值

<T> T

get(String key)

Gets a variable value from the context 从上下文获取变量值

<T> T

get(String key, T defaultValue)

Gets a variable value with a default 获取变量值，带默认值

<T> Optional<T>

getFact(Class<T> type)

Gets a fact by type 按类型获取事实

<T> List<T>

getFacts(Class<T> type)

Gets all facts of a specific type 获取特定类型的所有事实

<T> T

getResult(String key)

Gets a result value 获取结果值

<T> T

getResult(String key, T defaultValue)

Gets a result value with default 获取结果值，带默认值

Map<String,Object>

getResults()

Gets all results as an immutable map 获取所有结果作为不可变Map

Map<String,Object>

getVariables()

Gets all variables as an immutable map 获取所有变量作为不可变Map

static RuleContext

of(Object... keyValues)

Creates a context from alternating key-value pairs 从交替的键值对创建上下文

static RuleContext

of(Map<String,Object> values)

Creates a context from a map of values 从值的Map创建上下文

<T> RuleContext

put(TypedKey<T> key, T value)

Puts a typed value by typed key into variables 通过类型化键将类型化值放入变量中

RuleContext

put(String key, Object value)

Sets a variable value in the context 在上下文中设置变量值

RuleContext

setResult(String key, Object value)

Sets a result value 设置结果值

static RuleContext

withFacts(Object... facts)

Creates a context with fact objects 使用事实对象创建上下文

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details
- create
  
  public static RuleContext create()
  
  Creates an empty rule context 创建空的规则上下文
  
  Returns:
  
  new context instance | 新的上下文实例
- of
  
  public static RuleContext of(Map<String,Object> values)
  
  Creates a context from a map of values 从值的Map创建上下文
  
  Parameters:
  
  values - the initial values | 初始值
  
  Returns:
  
  new context instance | 新的上下文实例
- of
  
  public static RuleContext of(Object... keyValues)
  
  Creates a context from alternating key-value pairs 从交替的键值对创建上下文
  
  Parameters:
  
  keyValues - alternating key-value pairs | 交替的键值对
  
  Returns:
  
  new context instance | 新的上下文实例
  
  Throws:
  
  IllegalArgumentException - if odd number of arguments
- withFacts
  
  public static RuleContext withFacts(Object... facts)
  
  Creates a context with fact objects 使用事实对象创建上下文
  
  Parameters:
  
  facts - the fact objects | 事实对象
  
  Returns:
  
  new context instance | 新的上下文实例
- addFact
  
  public RuleContext addFact(Object fact)
  
  Adds a fact object to the context 向上下文添加事实对象
  
  Parameters:
  
  fact - the fact object | 事实对象
  
  Returns:
  
  this context for chaining | 此上下文用于链式调用
- addFact
  
  public RuleContext addFact(String name, Object fact)
  
  Adds a named fact object to the context 向上下文添加命名的事实对象
  
  Parameters:
  
  name - the fact name | 事实名称
  
  fact - the fact object | 事实对象
  
  Returns:
  
  this context for chaining | 此上下文用于链式调用
- put
  
  public RuleContext put(String key, Object value)
  
  Sets a variable value in the context 在上下文中设置变量值
  
  Parameters:
  
  key - the variable name | 变量名
  
  value - the variable value | 变量值
  
  Returns:
  
  this context for chaining | 此上下文用于链式调用
- get
  
  public <T> T get(String key)
  
  Gets a variable value from the context 从上下文获取变量值
  
  Type Parameters:
  
  T - the value type | 值类型
  
  Parameters:
  
  key - the variable name | 变量名
  
  Returns:
  
  the value, or null if not found | 值，如果未找到则为null
- get
  
  public <T> T get(String key, T defaultValue)
  
  Gets a variable value with a default 获取变量值，带默认值
  
  Type Parameters:
  
  T - the value type | 值类型
  
  Parameters:
  
  key - the variable name | 变量名
  
  defaultValue - the default value | 默认值
  
  Returns:
  
  the value, or default if not found | 值，如果未找到则为默认值
- getFact
  
  public <T> Optional<T> getFact(Class<T> type)
  
  Gets a fact by type 按类型获取事实
  
  Type Parameters:
  
  T - the fact type | 事实类型
  
  Parameters:
  
  type - the fact type | 事实类型
  
  Returns:
  
  optional containing the fact | 包含事实的Optional
- getFacts
  
  public <T> List<T> getFacts(Class<T> type)
  
  Gets all facts of a specific type 获取特定类型的所有事实
  
  Type Parameters:
  
  T - the fact type | 事实类型
  
  Parameters:
  
  type - the fact type | 事实类型
  
  Returns:
  
  list of facts | 事实列表
- contains
  
  public boolean contains(String key)
  
  Checks if a variable exists 检查变量是否存在
  
  Parameters:
  
  key - the variable name | 变量名
  
  Returns:
  
  true if exists | 如果存在返回true
- setResult
  
  public RuleContext setResult(String key, Object value)
  
  Sets a result value 设置结果值
  
  Parameters:
  
  key - the result key | 结果键
  
  value - the result value | 结果值
  
  Returns:
  
  this context for chaining | 此上下文用于链式调用
- getResult
  
  public <T> T getResult(String key)
  
  Gets a result value 获取结果值
  
  Type Parameters:
  
  T - the result type | 结果类型
  
  Parameters:
  
  key - the result key | 结果键
  
  Returns:
  
  the result value | 结果值
- getResult
  
  public <T> T getResult(String key, T defaultValue)
  
  Gets a result value with default 获取结果值，带默认值
  
  Type Parameters:
  
  T - the result type | 结果类型
  
  Parameters:
  
  key - the result key | 结果键
  
  defaultValue - the default value | 默认值
  
  Returns:
  
  the result value or default | 结果值或默认值
- getResults
  
  public Map<String,Object> getResults()
  
  Gets all results as an immutable map 获取所有结果作为不可变Map
  
  Returns:
  
  immutable map of results | 结果的不可变Map
- getVariables
  
  public Map<String,Object> getVariables()
  
  Gets all variables as an immutable map 获取所有变量作为不可变Map
  
  Returns:
  
  immutable map of variables | 变量的不可变Map
- facts
  
  public FactStore facts()
  
  Gets the fact store 获取事实存储
  
  Returns:
  
  the fact store | 事实存储
- get
  
  public <T> T get(TypedKey<T> key)
  
  Gets a typed value by typed key (checks variables first, then facts) 通过类型化键获取类型化值（先检查变量，再检查事实）
  
  Type Parameters:
  
  T - the value type | 值类型
  
  Parameters:
  
  key - the typed key | 类型化键
  
  Returns:
  
  the typed value, or null if not found | 类型化值，如果未找到则为null
  
  Since:
  
  JDK 25, opencode-base-rules V1.0.3
- get
  
  public <T> T get(TypedKey<T> key, T defaultValue)
  
  Gets a typed value by typed key with a default 通过类型化键获取类型化值，带默认值
  
  Type Parameters:
  
  T - the value type | 值类型
  
  Parameters:
  
  key - the typed key | 类型化键
  
  defaultValue - the default value | 默认值
  
  Returns:
  
  the typed value, or default if not found | 类型化值，如果未找到则为默认值
  
  Since:
  
  JDK 25, opencode-base-rules V1.0.3
- put
  
  public <T> RuleContext put(TypedKey<T> key, T value)
  
  Puts a typed value by typed key into variables 通过类型化键将类型化值放入变量中
  
  Type Parameters:
  
  T - the value type | 值类型
  
  Parameters:
  
  key - the typed key | 类型化键
  
  value - the value | 值
  
  Returns:
  
  this context for chaining | 此上下文用于链式调用
  
  Since:
  
  JDK 25, opencode-base-rules V1.0.3
- contains
  
  public <T> boolean contains(TypedKey<T> key)
  
  Checks if a typed key exists in variables or facts 检查类型化键是否存在于变量或事实中
  
  Type Parameters:
  
  T - the value type | 值类型
  
  Parameters:
  
  key - the typed key | 类型化键
  
  Returns:
  
  true if exists | 如果存在返回true
  
  Since:
  
  JDK 25, opencode-base-rules V1.0.3
- clearResults
  
  public RuleContext clearResults()
  
  Clears all results 清除所有结果
  
  Returns:
  
  this context for chaining | 此上下文用于链式调用
- clearVariables
  
  public RuleContext clearVariables()
  
  Clears all variables 清除所有变量
  
  Returns:
  
  this context for chaining | 此上下文用于链式调用

Class RuleContext

Method Summary

Methods inherited from class Object

Method Details

create

of

of

withFacts

addFact

addFact

put

get

get

getFact

getFacts

contains

setResult

getResult

getResult

getResults

getVariables

facts

get

get

put

contains

clearResults

clearVariables