第 156 章 Ignite Cache 组件
从 Camel 版本 2.17 开始提供
Ignite Cache 端点是 camel-ignite 端点之一，可让您与 Ignite Cache 交互。这同时提供了一个 Producer （在 Ignite 缓存上调用缓存操作），以及一个 Consumer （消耗来自连续查询的更改）。
缓存值始终是消息的正文，而 cache 键始终存储在 IgniteConstants.IGNITE_CACHE_KEY 消息标头中。
即使您在端点 URI 中配置固定操作，您可以通过设置 IgniteConstants.IGNITE_CACHE_OPERATION 消息标头来因每个交换而异。
156.1. 选项
Ignite Cache 组件支持 4 个选项，如下所列。
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| Ignite (common) | 设置 Ignite 实例。 | Ignite | |
| configurationResource (common) | 设置从中加载配置的资源。它可以是：URI、String (URI)或 InputStream。 | 对象 | |
| igniteConfiguration (common) | 允许用户设置 programmatic IgniteConfiguration。 | IgniteConfiguration | |
| resolveProperty Placeholders (advanced) | 启动时组件是否应解析自身上的属性占位符。只有属于 String 类型的属性才能使用属性占位符。 | true | 布尔值 |
Ignite Cache 端点使用 URI 语法进行配置：
ignite-cache:cacheName
使用以下路径和查询参数：
156.1.1. 路径参数(1 参数)：
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| cacheName | 必需 缓存名称。 | 字符串 |
156.1.2. 查询参数(16 参数)：
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| propagateIncomingBodyIfNo ReturnValue (common) | 如果底层 Ignite 操作的返回类型为 void，则设置是否传播传入的正文。 | true | 布尔值 |
| treatCollectionsAsCache Objects (common) | 设置是否将集合视为缓存对象或项目集合来插入/更新/计算等。 | false | 布尔值 |
| autoUnsubscribe (consumer) | 是否在 continuous Query Consumer 中启用自动取消订阅。 | true | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由错误处理程序，这意味着当消费者试图选择传入消息或类似信息时发生异常，现在将作为消息处理并由路由 Error Handler 处理。默认情况下，使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况，该处理程序将被记录在 WARN 或 ERROR 级别，并忽略。 | false | 布尔值 |
| fireExistingQueryResults (consumer) | 是否处理与查询匹配的现有结果。用于初始化 continuous Query Consumer。 | false | 布尔值 |
| oneExchangePerUpdate (consumer) | 是否在单个交换中打包每个更新，即使一个批处理中收到多个更新。仅供 continuous Query Consumer 使用。 | true | 布尔值 |
| pageSize (consumer) | 页面大小。仅供 continuous Query Consumer 使用。 | 1 | int |
| query (consumer) | Query to execute，只适用于需要它的操作，以及 continuous Query Consumer。 | 查询 | |
| remoteFilter (consumer) | 远程过滤器，仅供 continuous Query Consumer 使用。 | CacheEntryEvent SerializableFilter | |
| timeInterval (consumer) | continuous Query Consumer 的时间间隔。 | 0 | long |
| exceptionHandler (consumer) | 要让使用者使用自定义例外处理程序：请注意，如果启用了 bridgeErrorHandler 选项，则此选项不使用。默认情况下，消费者将处理异常，其记录在 WARN 或 ERROR 级别中，并忽略。 | ExceptionHandler | |
| exchangePattern (consumer) | 在消费者创建交换时设置交换模式。 | ExchangePattern | |
| cachePeekMode (producer) | CachePeekMode 只适用于需要它的操作(IgniteCacheOperation#SIZE)。 | ALL | CachePeekMode |
| failIfInexistentCache (producer) | 如果缓存不存在，是否失败初始化。 | false | 布尔值 |
| operation (producer) | 要调用的缓存操作。可能的值有：GET、PUT、REMOVE、SIZE、REBALANCE、QUERY、CLEAR。 | IgniteCacheOperation | |
| 同步 (advanced) | 设置是否应严格使用同步处理，或者 Camel 允许使用异步处理（如果受支持）。 | false | 布尔值 |
