90.13. 命名空间审核以协助调试
用户经常遇到的许多与 XPath 相关的问题都链接到命名空间的使用。您可能在消息中存在的命名空间之间有一些错误对齐,并且您的 XPath 表达式了解或引用。无法找到 XML 元素和属性的 XPath predicates 或表达式,因为命名空间问题可能只是像 它们无法正常工作,当它们实际上都不存在 命名空间定义时。
XML 中的命名空间是完全必要的,同时我们希望通过对空闲命名空间实施一定程度或 voodoo 来简化它们的使用,但实际上,这个路径的任何操作都会与标准不兼容,并大大隐藏互操作性。
因此,我们最多可以通过为 XPath 表达式语言添加两个新功能并可从 predicates 和表达式访问,从而帮助您调试这些问题。
90.13.1. 日志记录 XPath 表达式/索引的命名空间上下文 复制链接链接已复制到粘贴板!
每次在内部池中创建新的 XPath 表达式时,Camel 会在 org.apache.camel.language.xpath.XPathBuilder
日志记录器下记录表达式的命名空间上下文。由于 Camel 以分级方式表示命名空间上下文(父关系),所以整个树都会以递归方式输出,其格式如下:
[me: {prefix -> namespace}, {prefix -> namespace}], [parent: [me: {prefix -> namespace}, {prefix -> namespace}], [parent: [me: {prefix -> namespace}]]]
[me: {prefix -> namespace}, {prefix -> namespace}], [parent: [me: {prefix -> namespace}, {prefix -> namespace}], [parent: [me: {prefix -> namespace}]]]
这些选项可用于激活此日志记录:
-
在
org.apache.camel.language.xpath.XPathBuilder
日志记录器或一些父日志记录器(如org.apache.camel
或 root logger)上启用 TRACE 日志记录 -
启用
logNamespaces
选项,如以下部分所示,这会在 INFO 级别中进行日志记录
90.13.2. 审计命名空间 复制链接链接已复制到粘贴板!
Camel 可以在评估 XPath 表达式前发现并转储每个传入消息上存在的所有命名空间,从而为您提供帮助您分析并固定可能的命名空间问题所需的所有信息。
为达到此目的,它在内部使用另一个特殊定制的 XPath 表达式来提取消息中显示的所有命名空间映射,显示每个映射的前缀和完整命名空间 URI。
需要考虑的一些点:
-
隐式 XML 命名空间(
xmlns:xml="http://www.w3.org/XML/1998/namespace"
)被禁止在输出中,因为它没有值 -
默认命名空间列在输出中的
DEFAULT
关键字下 - 请记住,命名空间可以在不同的范围下重新映射。认为顶级"a"前缀,内部元素中可分配不同的命名空间,或者在内部范围内更改默认命名空间。对于每个发现的前缀,会列出所有关联的 URI。
您可以在 Java DSL 和 XML DSL 中启用这个选项:
Java DSL:
XPathBuilder.xpath("/foo:person/@id", String.class).logNamespaces()
XPathBuilder.xpath("/foo:person/@id", String.class).logNamespaces()
XML DSL:
<xpath logNamespaces="true" resultType="String">/foo:person/@id</xpath>
<xpath logNamespaces="true" resultType="String">/foo:person/@id</xpath>
审计的结果将显示在 org.apache.camel.language.xpath.XPathBuilder
日志记录器下的 INFO 级别,并类似如下:
2012-01-16 13:23:45,878 [stSaxonWithFlag] INFO XPathBuilder - Namespaces discovered in message: {xmlns:a=[http://apache.org/camel], DEFAULT=[http://apache.org/default], xmlns:b=[http://apache.org/camelA, http://apache.org/camelB]}
2012-01-16 13:23:45,878 [stSaxonWithFlag] INFO XPathBuilder - Namespaces discovered in message:
{xmlns:a=[http://apache.org/camel], DEFAULT=[http://apache.org/default],
xmlns:b=[http://apache.org/camelA, http://apache.org/camelB]}