第 154 章 Ignite Cache 组件
作为 Camel 2.17 版提供
Ignite Cache 端点是 camel-ignite 端点之一,可让您与 Ignite 缓存 交互。这既提供了 Producer (用于在 Ignite 缓存上调用缓存操作)和消费者(消耗来自持续查询的更改)。
			缓存值始终是消息的正文,而 cache 键总是存储在 IgniteConstants.IGNITE_CACHE_KEY 消息标头中。
		
			即使在端点 URI 中配置固定操作,您可以通过设置 IgniteConstants.IGNITE_CACHE_OPERATION 消息标头来为每个交换不同。
		
154.1. 选项 复制链接链接已复制到粘贴板!
Ignite Cache 组件支持如下所列的 4 个选项。
| 名称 | 描述 | 默认 | 类型 | 
|---|---|---|---|
|   ignite (common)  |   设置 Ignite 实例。  |   Ignite  | |
|   configurationResource (common)  |   设置从中加载配置的资源。它可以是: URI、String (URI)或 InputStream。  |   对象  | |
|   igniteConfiguration (common)  |   允许用户设置程序化 IgniteConfiguration。  |   IgniteConfiguration  | |
|   resolveProperty Placeholders (advanced)  |   启动时,组件是否应自行解析属性占位符。只有 String 类型的属性才能使用属性占位符。  |   true  |   布尔值  | 
Ignite Cache 端点使用 URI 语法配置:
ignite-cache:cacheName
ignite-cache:cacheName
使用以下路径和查询参数:
154.1.1. 路径名(1 参数): 复制链接链接已复制到粘贴板!
| 名称 | 描述 | 默认 | 类型 | 
|---|---|---|---|
|   cacheName  |   所需的 缓存名称。  |   字符串  | 
154.1.2. 查询参数(16 参数): 复制链接链接已复制到粘贴板!
| 名称 | 描述 | 默认 | 类型 | 
|---|---|---|---|
|   propagateIncomingBodyIfNo ReturnValue (common)  |   如果底层 Ignite 操作的返回类型为 void,则设置是否传播传入的正文。  |   true  |   布尔值  | 
|   treatCollectionsAsCache Objects (common)  |   设置是否将集合视为缓存对象,还是作为项目集合来插入/更新/计算等。  |   false  |   布尔值  | 
|   autoUnsubscribe (consumer)  |   是否在持续查询消费者中启用自动取消订阅。  |   true  |   布尔值  | 
|   bridgeErrorHandler (consumer)  |   允许将消费者桥接到 Camel 路由 Error Handler,这意味着使用者试图获取传入消息或类似信息时出现任何异常,现在将作为一个消息进行处理,并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.Exception 处理程序处理异常,该处理程序将记录在 WARN 或 ERROR 级别,并忽略。  |   false  |   布尔值  | 
|   fireExistingQueryResults (consumer)  |   是否处理与查询匹配的现有结果。用于初始化持续查询使用者。  |   false  |   布尔值  | 
|   oneExchangePerUpdate (consumer)  |   是否要在单独交换中打包每个更新,即使在一个批内收到多个更新。仅限持续查询使用者使用。  |   true  |   布尔值  | 
|   pageSize (consumer)  |   页面大小。仅限持续查询使用者使用。  |   1  |   int  | 
|   query (consumer)  |   要执行的查询,仅需要它的操作,以及持续查询消费者的操作。  |   Object>>  | |
|   remoteFilter (consumer)  |   远程过滤器,仅由 Continuous Query Consumer 使用。  |   Object>  | |
|   timeInterval (consumer)  |   持续查询使用者的时间间隔。  |   0  |   long  | 
|   exceptionHandler (consumer)  |   要让使用者使用自定义 ExceptionHandler。请注意,如果启用了选项 bridgeErrorHandler,则不使用这个选项。默认情况下,消费者处理异常,这将在 WARN 或 ERROR 级别记录,并忽略。  |   ExceptionHandler  | |
|   exchangePattern (consumer)  |   在使用者创建交换时设置交换模式。  |   ExchangePattern  | |
|   cachePeekMode (producer)  |   CachePeekMode,只适用于需要它的操作(链接 IgniteCacheOperationSIZE)。  |   ALL  |   CachePeekMode  | 
|   failIfInexistentCache (producer)  |   如果缓存不存在,是否会导致初始化失败。  |   false  |   布尔值  | 
|   operation (producer)  |   要调用的缓存操作。可能的值有:GET、PUT、REMOVE、SIZE、REBALANCE、QUERY、CLEAR.  |   IgniteCacheOperation  | |
|   同步 (高级)  |   设置同步处理是否应当严格使用,还是允许 Camel 使用异步处理(如果受支持)。  |   false  |   布尔值  | 
154.1.3. 使用的标头 复制链接链接已复制到粘贴板!
此端点使用以下标头:
| 标头名称 | 常数 | 预期类型 | 描述 | 
|---|---|---|---|
|   CamelIgniteCacheKey  |   IgniteConstants.IGNITE_CACHE_KEY  |   字符串  |   消息正文中条目值的 cache 键。  | 
|   CamelIgniteCacheQuery  |   IgniteConstants.IGNITE_CACHE_QUERY  |   查询  |   调用 QUERY 操作时要运行的查询(生成器)。  | 
|   CamelIgniteCacheOperation  |   IgniteConstants.IGNITE_CACHE_OPERATION  |   IgniteCacheOperation enum  |   允许您将缓存操作动态更改为执行(生成程序)。  | 
|   CamelIgniteCachePeekMode  |   IgniteConstants.IGNITE_CACHE_PEEK_MODE  |   CachePeekMode enum  |   允许您在运行 SIZE 操作时动态更改 cache peek 模式。  | 
|   CamelIgniteCacheEventType  |   IgniteConstants.IGNITE_CACHE_EVENT_TYPE  |   int (EventType constants)  |   当使用持续查询消费者时,此标头会传输接收的事件类型。  | 
|   CamelIgniteCacheName  |   IgniteConstants.IGNITE_CACHE_NAME  |   字符串  |   此标头传输接收持续查询事件(消费者)的缓存名称。它不允许您动态更改执行制作者操作的缓存。将 EIP 用于该 (如接收者列表、动态路由器)。  | 
|   CamelIgniteCacheOldValue  |   IgniteConstants.IGNITE_CACHE_OLD_VALUE  |   对象  |   当传递传入缓存事件(consumer)时,此标头会传输旧的缓存值。  |