XML 目录条目用于将外部实体引用映射至本地定义的资源。可提供规则以指定如何解析这些实体。
有关 XML 目录的标准的详细信息,请参阅:http://www.oasis-open.org/committees/download.php/14809/xml-catalogs.html。
例如,正在处理计算机上的 XML 文件,并将它的 schemaLocation 指向称为 c:\MySchema.xsd 的模式。如果不使用
XML 目录,那么编辑完 XML 文件并准备在 Web 上发布此文件时,需要编辑 schemaLocation 以使其指向 Web 上可访问的资源。
为避免频繁更改 XML 文档,可使用 XML
目录:可指定用于重定向互联网资源引用的规则(例如,"http://www.ibm.com/published-schemas/MySchema.xsd"),以使其指向本地机器上的资源(例如,"file:///C:/MySchema.xsd")。现在,只需要在 XML 目录中更新一个规则,而不必频繁地编辑 XML 文档以更新 URI 或位置(尤其是项目中有许多文档时)。
下列指示信息是为“资源”透视图编写的,但是也适用于其他许多透视图。
要将条目添加至 XML 目录,请执行下列步骤:
- 打开想要与 DTD 或 XML 模式相关联的 XML 文件。
- 单击并选择 。XML 目录条目部分包含用户定义的和插件定义的任何目录条目的列表。选择任何条目,以在详细信息部分查看有关它的信息。
- 单击添加以创建新的目录条目。
- 在左边的列中,单击要添加的目录条目的类型:
| 选项 |
描述
|
| 目录条目
|
解析实体引用时由 XML 处理器使用。可以对目录提供规则以指定应如何解析实体。XML
目录条目包含以下两个部分:
- 键(表示 DTD 或 XML 模式)
- 位置(类似于 URI,它包含有关 DTD 或 XML 模式的位置的信息)。
可以将“键”放入 XML 文件中。当 XML 处理器遇到该“键”时,它将使用 XML 目录条目来查找与该“键”相关联的 DTD 或 XML 模式的位置。
|
| 重写条目 |
用于重定向一组实体。 |
| 后缀条目 |
用于与 URI 或 systemID 的后缀相匹配。 |
| 下一个目录
|
用于引用另一目录而不将其导入到工作台。 |
| 代表目录 |
用于使备用目录与标识相关联。 |
- 填写用于您选择的目录条目的字段:
表 1. 目录条目类型和关联字段
| 目录类型 |
字段 |
| 目录条目
|
- 在位置字段中,直接输入或者通过浏览以找到 DTD 或 XML 模式文件的位置或 URI。这将使用计算机的路径样式来描述该文件的位置。
- 选择键类型:
- 如果您指定了 DTD,那么从键类型字段中选择公用标识、系统标识或 URI。如果选择公用标识,那么在键字段中输入的值应与 XML 文件的 DOCTYPE 声明中的“公用标识”相同。如果选择系统标识,那么输入的值应对应于 XML 文件的 DOCTYPE 声明中的“系统标识”。如果选择 URI,那么输入的值必须是标准 URI。
- 如果您指定了 XML 模式,那么从键类型字段中选择名称空间名称或模式位置。如果模式定义了目标名称空间,它将自动出现在键字段中。否则,可在键字段中输入模式位置。
- 如果希望能为资源指定备用 Web 地址,那么选中指定备用 Web 地址复选框。
从此目录条目生成 XML 实例时,将使用此 Web 地址。 注:仅当在键类型字段中选择了公用标识(对于 DTD)或名称空间名称(对于模式)时,此选项才可用。
|
| 重写条目 |
- 选择要匹配的键类型(URI 或 systemID)。
- 匹配起始字符串:要从提供的标识中除去的匹配前缀。
- 重写前缀:使用此前缀来代替除去的前缀。
|
| 后缀条目 |
- 在位置字段中,直接输入或者通过浏览以找到 DTD 或 XML 模式文件的位置或 URI。这将使用计算机的路径样式来描述该文件的位置。
- 选择要匹配的键类型(URI 或 systemID)。
- 输入要匹配的标识的后缀。
|
| 下一个目录
|
在另一 XML 目录文件的位置字段中,输入或浏览至要引用的 XML 目录。 |
| 代表目录 |
- 选择要匹配的键类型(URI 或 systemID)。
- 匹配起始字符串要匹配的已提供标识的前缀。
- 委托给此 XML 文件:要关联的备用目录。
|
- 创建完目录条目时,单击确定以关闭“添加 XML 目录条目”对话框。再次单击确定以保存设置。
- 确保 XML 文件为当前焦点并单击重新装入依赖项工具栏按钮。
XML 文件现在即与 XML 模式或 DTD 的最新版本相关联。
您还可以导出和导入 XML 目录信息:
要导出 XML 目录信息,请单击并选择 。将提示您选择一个项目并提供一个文件名以将目录条目存储在一个 .xmlcatalog 文件中,可以从“导航器”视图中打开它。由于目录条目存储在 .xmlcatalog 文件中,因此可以检入和检出它们,并像任何其他项目资源一样共享它们。
要导入 XML 目录信息,请单击并选择 。然后指定将用来装入 XML 目录设置的文件。当导入
.xmlcatalog 文件时,将把其中的任何条目装入到 XML 目录中(并覆盖任何现有条目)。