cacheGet组件：从缓存中获取指定key列表的值。缓存实例使用config.Cache 。

配置

字段	类型	说明	默认值
keys	[]LevelKey	缓存键名列表	无
outputMode	int	输出模式	2

• outputMode: 输出模式
  • 0:查询结果，合并到当前消息元数据
  • 1:合并到当前消息负荷。要求输入消息负荷DataType必须是JSON类型，并且消息负荷Data可以解析为map结构
  • 2:查询结果，转成JSON，覆盖原消息负荷输出

LevelKey

字段	类型	说明	默认值
level	string	缓存级别	chain
key	string	键，可以使用组件配置变量	无

• level: 缓存级别
  • chain: 当前规则链级别缓存，在当前规则链命名空间下操作，用于规则链实例内不同执行上下文之间的数据共享。如果规则链实例被销毁，会自动删除该规则链命名空间下所有缓存。
  • global: 全局级别缓存，在全局命名空间下操作，用于跨规则链间的数据共享
• key: 缓存键
  • 可以使用 ${metadata.key} 读取元数据中的变量或者使用 ${msg.key} 读取消息负荷中的变量进行替换
  • 支持 * 通配符查找，例如：test:* 表示以test: 开头的所有key

缓存实现配置

默认情况下，RuleGo 使用内置的本地内存缓存（utils/cache.MemoryCache），并提供了一个全局默认实例 cache.DefaultCache（默认GC清理周期为5分钟）。如果未通过 types.WithCache 选项指定自定义缓存实现，则系统将自动使用此默认内存缓存。

如需使用其他缓存类型（例如 Redis、Memcached 等），您需要自行实现 types.Cache 接口，并通过 types.WithCache 选项在创建 Config 时将其注入。

types.Cache 接口定义如下：

type Cache interface {  
	// Set 在缓存中存储一个键值对，可选设置过期时间  
	// 参数：  
	//   - key：缓存键（字符串）  
	//   - value：要存储的值（interface{}）  
	//   - ttl：存活时间字符串（例如“10m”，“1h”）  
	// 返回：  
	//   - error：如果 ttl 格式无效，则返回错误  
	// 注意：如果 ttl 为 0 或空字符串，则该项永不过期  
	Set(key string, value interface{}, ttl string) error  
	// Get 通过键从缓存中检索值  
	// 参数：  
	//   - key：要查找的缓存键（字符串）  
	// 返回：  
	//   - interface{}：存储的值，如果不存在或已过期则返回 nil  
	Get(key string) interface{}  
	// Has 检查键是否存在于缓存中  
	// 参数：  
	//   - key：要检查的缓存键（字符串）  
	// 返回：  
	//   - bool：如果键存在且未过期，则返回 true，否则返回 false  
	Has(key string) bool  
	// Delete 通过键删除缓存项  
	// 参数：  
	//   - key：要删除的缓存键（字符串）  
	// 返回：  
	//   - error：当前实现始终返回 nil  
	Delete(key string) error  
	// DeleteByPrefix 删除所有具有指定前缀的缓存项  
	// 参数：  
	//   - prefix：要匹配的键前缀（字符串）  
	// 返回：  
	//   - error：当前实现始终返回 nil  
	DeleteByPrefix(prefix string) error  

	// GetByPrefix 检索所有键与指定前缀匹配的值  
	// 参数：  
	//   - prefix：要匹配的键前缀（字符串）  
	// 返回：  
	//   - map[string]interface{}：匹配的键值对映射  
	GetByPrefix(prefix string) map[string]interface{}  
}

配置示例：

// 使用自定义缓存实现
config := rulego.NewConfig(types.WithCache(&myCacheImpl{}))

// 如果使用默认内存的实现，则不需要显式配置，RuleGo会自动使用 cache.DefaultCache
// config := rulego.NewConfig()

Relation Type

• Success: 获取成功，把消息发送到Success链
• Failure: 获取失败，把消息发送到Failure链

执行结果

根据outputMode参数合并查询结果，发送Success链。

• outputMode: 输出模式
  • 0:查询结果，合并到当前消息元数据
  • 1:合并到当前消息负荷。要求输入消息负荷DataType必须是JSON类型，并且消息负荷Data可以解析为map结构
  • 2:查询结果，转成JSON，覆盖原消息负荷输出

配置示例

{
  "id": "s1",
  "type": "cacheGet",
  "name": "获取缓存",
  "configuration": {
    "keys": [
      {"level": "chain","key":"${metadata.userId}"},
      {"level": "chain","key":"key1"}
    ],
    "outputMode": 2
  }
}