XML Hacks是一本介绍 XML 技巧和窍门的书籍。这是一本很有用的参考资料，其内容十分广泛，但如果某些材料能够进一步展开或者改写的话，可能会更好。Uche Ogbuji 提供了该书的应用报告。
在 上一期文章中，我评论了 Elliotte Rusty Harold 所著的 Effective XML，所有 XML 专业人员都应该读一读这本很棒的著作。在本期文章中，我把目光投向了另一本实用 XML 书籍，Michael Fitzgerald 编纂的 XML Hacks（O'Reilly and Associates，2004 年）。这本书涉及的范围很广，包括入门性的基础知识、中阶和高阶的设计与实现技术，以及一些工具的使用技巧。本专栏和其他 developerWorks文章的读者，可能更希望我能专注于 XML 设计和 XML 词汇表的问题。 XML Hacks论述更多的是实现细节和工具使用，但是这些知识也很重要，在本期文章中，我将介绍我自己应用书中内容的一些实际观察。与关于 Effective XML的文章一样，本文并不是书评，而是受该书启发想到的一些东西，本书是为不具备这些知识的读者编写的。
使用 XInclude 包含外部文本文档
在这本书的第 26 章“Include External Documents with XInclude”中，说明了如何以类似 XML 内置外部已解析实体的方式使用 XInclude（请参阅 Resources）。书中给出了一个示例文档，其中插入了由 HTTP URL 指定的外部 XML 文档。XInclude 确实为这种混合增加了为数不多的一些技巧，比如后退支持（出现错误时提供替代内容），以及处理程序发出 HTTP 请求时指定内容协商方式的机制。但是我认为与已解析实体机制相比，XInclude 的两个最主要优点是：
- 能够使用 XPointer 从目标文档中选择要包含的部分。
- 能够改变解析机制，将外部文档作为完全转移的文本文件而不是 XML 文档插入。
如果正在撰写包含代码清单或者示例的 XML 文档，第二点尤其方便。比方说，假设您撰写的文档中要包含清单 1 所示的 Python 语言代码。
清单 1. 作为清单插入 XML 文档的 Python 实例代码
def game_show(contestant_guess, prices): if prices[contestant_guess] < 1000: print "you win!" else: print "you lose!"
您应该在单独的文件中开发这些代码，这样，就可以在将它们放入文档之前对其进行测试，以确保它们能像您期望的那样工作。首先您可以把这些代码剪切并粘贴到 XML 文件中，如清单 2 所示。
清单 2. 直接剪切粘贴示例代码的插入文档
<?xml version='1.0' encoding='iso-8859-1'?>"-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> On-line game show programming in Python
A simple example
Examine the following code:
example 1
<!-- paste Python code here -->
这样会造成错误，因为 if prices[contestant_guess] < 1000: 这一行包含没有转义的小于号（
清单 3. 通过剪切粘贴到 CDATA 节插入示例代码的文档
<?xml version='1.0' encoding='iso-8859-1'?>"-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> On-line game show programming in Python
A simple example
Examine the following code:
example 1
这种方法无疑能够避免了转义错误，但是您必须注意那些估计可能很少出现的字符串“]]>”，如清单 4 中所示。
清单 4. 作为清单插入 XML 文档的 Python 示例代码
def game_show(guesses, contestant, prices): if prices[guesses[contestant]]>1000: print "you win!" else: print "you lose!"
为了在 CDATA 部分中正确转义这一行，您至少需要像 if prices[guesses[contestant]]]]>1000: 这样复杂的代码。还要注意的是，我使用的是 Python 代码，多数情况下，Python 需要转义的地方相对较少。如果编写的是关于 XML 的文档，手工转义可能就无法胜任了。而且出现“]]>”这个字符串组合的机会也多得多（比如 XML 清单可能本身包含 CDATA 部分）。
当然，您可以选择自己的方法绕开这个障碍，但是我发现，处理文章中所包含代码的最简单的方法就是使用 XInclude 的 parse="text" 功能。只要在 xi:include 元素中添加该属性，就能自动将代码作为 XML CDATA 解析，从而自动转义包含的内容。清单 5 就是以这种方式使用 XInlude 的一个例子：
清单 5. 使用文本行 XInclude 插入示例代码的文档
<?xml version='1.0' encoding='iso-8859-1'?>"-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> On-line game show programming in Python
A simple example
Examine the following code:
example 1
xi:include 元素被替换为完全转义的 gameshow1.py （比如 清单 1）的内容，该文件是相对于元素的基 URL 进行解析的。感谢 parse="text" ，转义是自动完成的。我总是使用 encoding 属性（如果使用 parse="xml" ，偶尔可以忽略它）。在我的应用中，Python 文件通常使用“iso-8859-1”编码，而 XML 文件使用“utf-8”编码，当然，您的环境中可能使用不同的编码。
我在为 developerWorks（它要求作者以精心设计的 XML 格式提供文稿）撰写这些文章时，使用的就是已解析文本 XInclude 技术，并发现这样极大提高了编辑速度。
另一个注意事项是：该书使用的是当时正在开发之中的 XInclude 名称空间 http://www.w3.org/2003/XInclude ，但是现在，这个名称空间已经不存在了。在 2004 年 4 月 13 日发布的 Candidate Recommendation 中，W3C 工作组又回到了原来的名称空间 http://www.w3.org/2001/XInclude 。据我了解，多数工具只支持后一种（2001）名称空间形式，这可能是 W3C 决定回到原来的名称空间的原因，但这种名称空间的变化和撤销确实带来了一些混乱。该书作者就成了这种变化的无辜的牺牲品，我已经就此向出版商提供了一份刊误表。
更简单的恒等转换
第 37 章“Generate an XSLT Identity Stylesheet with Relaxer”讨论一种相当复杂的生成 恒等转换的方法，即输出和源文档等价的 XML 的 XSLT 转换。在以这种方法得到的转换中，对应词汇表中的每个元素都有一个模板，这的确很复杂。这样做可能是为了提供一个样本，以便用于创建更专门的转换，但我认为它没有给出一种简单得多的恒等转换，甚至 XSLT 规范中都作为例子给出了这样的一个转换。在后一章（38）“Pretty-Print XML Using a Generic Identity Stylesheet and Xalan”中，讨论了这种更简单的恒等转换，其中包括为了获得整齐的打印效果而经常采用的 。我建议您首先阅读第 38 章，熟悉简单的恒等转换之后，再来研究 37 章中那种复杂的方法。这样做的还有一种好处，理解这种简单的恒等变换是熟悉和掌握几种 XSLT 短语的关键，包括将源节点复制到输出中的 xsl:copy-of 与常见 XPath 节点测试的细微差别： * 、 @* 和 node() 。
不使用 XSLT 2.0 生成多个输出文档
第 45 章“Generate Multiple Output Documents with XSLT 2.0”讨论了如何使用 XSLT 2.0 xsl:result-document 在一次转换中序列化多个结果树。整章都写得不错，除了最后出现的一句：
来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/10752019/viewspace-950164/，如需转载，请注明出处，否则将追究法律责任。
转载于:http://blog.itpub.net/10752019/viewspace-950164/
177
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
