EvaluateXPath 2025.5.31.15¶
捆绑包¶
org.apache.nifi | nifi-standard-nar
描述¶
对照 FlowFile 的内容评估一个或多个 XPaths。这些 XPaths 的结果将分配给 FlowFile 属性或写入 FlowFile 本身的内容，具体取决于处理器的配置。XPaths 通过添加用户定义的属性来输入；属性的名称映射到要放置结果的属性名称（当目标是“flowfile-attribute”时有效；否则，属性名称将被忽略）。该属性的值必须是有效的 XPath 表达式。如果 XPath 计算结果有多个节点，且返回类型设置为“nodeset”（直接设置或通过“auto-detect”，目标为“flowfile-content”），则不会修改 FlowFile 并且会将其路由至“failure”。如果 XPath 未评估为某个节点，则 FlowFile 将在不修改其内容的情况下路由到“unmatched”。如果目标值为“flowfile-attribute”且表达式不匹配任何内容，则使用空字符串作为值创建属性，且 FlowFile 将始终路由到“matched”
输入要求¶
REQUIRED
支持敏感的动态属性¶
false
属性¶
属性 |
描述 |
|---|---|
目标 |
表示 XPath 评估结果是写入 FlowFile 内容还是写入 FlowFile 属性；如果使用属性，则必须指定“属性名称”属性。如果设置为 flowfile-content，则只能指定一个 XPath 且属性名称将被忽略。 |
返回类型 |
指示 Xpath 表达式的所需返回类型。 选择“auto-detect”会将“flowfile-content”的目标返回类型设置为“nodeset”，将“flowfile-attribute”的目标返回类型设置为“string”。 |
验证 DTD |
允许在 XML 中嵌入文档类型声明。应禁用此功能以避免 XML 实体扩展漏洞。 |
关系¶
名称 |
描述 |
|---|---|
failure |
当 XPath 无法根据 FlowFile 的内容进行评估时，FlowFiles 将路由到此关系；例如，如果 FlowFile 非有效 XML，或返回类型为“nodeset”且 XPath 评估为多节点 |
matched |
成功评估 XPath 且 FlowFile 因此被修改后，FlowFiles 将路由到此关系 |
unmatched |
当 XPath 与 FlowFile 的内容不匹配且目标设置为“flowfile-content”时，FlowFiles 将路由到此关系 |
写入属性¶
名称 |
描述 |
|---|---|
user-defined |
如果 <Destination> 属性设置为 flowfile-attribute，则该处理器会添加用户定义的属性。 |