EvaluateXPath Processor
类型全限定名：cn.org.acal.lynxus.processors.standard.EvaluateXPath
所属 Bundle：cn.org.acal.lynxus:lynxus-standard-nar:2.11.8
描述
对 FlowFile 的内容计算一个或多个 XPath 表达式。
属性
下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。
| 名称 | 默认值 | 可选值 | 描述 |
|---|
| Destination | flowfile-content | - flowfile-content
- flowfile-attribute
| 指示 XPath 求值的结果是写入 FlowFile 内容还是 FlowFile 属性；如果使用属性，必须指定属性名称属性。如果设置为 flowfile-content，则只能指定一个 XPath，并且属性名称将被忽略。 |
| Return Type | auto-detect | | 指示 XPath 表达式的期望返回类型。选择 'auto-detect' 将为 'flowfile-content' 的目标设置返回类型为 'nodeset'，为 'flowfile-attribute' 的目标设置返回类型为 'string'。 |
| Allow DTD | false | | 允许 XML 中嵌入文档类型声明。应禁用此功能以避免 XML 实体扩展漏洞。 |
动态属性
动态属性允许用户自定义属性的名称与值。
| 名称 | 值 | 描述 |
|---|
| 一个 FlowFile 属性（如果 <Destination> 设为 'flowfile-attribute'） | 一个 XPath 表达式 | 如果 <Destination>='flowfile-attribute'，则 FlowFile 属性将设置为 XPath 表达式的计算结果。如果 <Destination>='flowfile-content'，则 FlowFile 内容将设置为 XPath 表达式的计算结果。 |
关系 (Relationships)
| 名称 | 描述 | 自动终止 |
|---|
failure | 当无法对 FlowFile 的内容进行 XPath 求值时，例如 FlowFile 不是有效的 XML，或者返回类型为 'nodeset' 且 XPath 求值为多个节点时，FlowFile 被路由到此关系 | 否 |
matched | 当 XPath 成功求值并且 FlowFile 因此被修改时，FlowFile 被路由到此关系 | 否 |
unmatched | 当 XPath 不匹配 FlowFile 的内容且目标设置为 flowfile-content 时，FlowFile 被路由到此关系 | 否 |
写入的 FlowFile 属性
| 名称 | 描述 |
|---|
user-defined | 如果 <Destination> 属性设置为 flowfile-attribute，则此处理器会添加用户定义的属性。 |
系统资源考量
| 资源 | 描述 |
|---|
| MEMORY | 处理需要将整个 FlowFile 读入内存 |