将条目添加至 XML 目录

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 目录,请执行下列步骤:

  1. 打开想要与 DTD 或 XML 模式相关联的 XML 文件。
  2. 单击窗口 > 首选项并选择 XML > XML 目录。XML 目录条目部分包含用户定义的和插件定义的任何目录条目的列表。选择任何条目,以在详细信息部分查看有关它的信息。
  3. 单击添加以创建新的目录条目。
  4. 在左边的列中,单击要添加的目录条目的类型:
    选项 描述
    目录条目 解析实体引用时由 XML 处理器使用。可以对目录提供规则以指定应如何解析实体。
    XML 目录条目包含以下两个部分:
    • 键(表示 DTD 或 XML 模式)
    • 位置(类似于 URI,它包含有关 DTD 或 XML 模式的位置的信息)。
    可以将“键”放入 XML 文件中。当 XML 处理器遇到该“键”时,它将使用 XML 目录条目来查找与该“键”相关联的 DTD 或 XML 模式的位置。
    重写条目 用于重定向一组实体。
    后缀条目 用于与 URI 或 systemID 的后缀相匹配。
    下一个目录 用于引用另一目录而不将其导入到工作台。
    代表目录 用于使备用目录与标识相关联。
  5. 填写用于您选择的目录条目的字段:
    表 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 文件:要关联的备用目录。
  6. 创建完目录条目时,单击确定以关闭“添加 XML 目录条目”对话框。再次单击确定以保存设置。
  7. 确保 XML 文件为当前焦点并单击重新装入依赖项工具栏按钮。
XML 文件现在即与 XML 模式或 DTD 的最新版本相关联。

您还可以导出和导入 XML 目录信息:

要导出 XML 目录信息,请单击文件 > 导出 并选择 XML > XML 目录。将提示您选择一个项目并提供一个文件名以将目录条目存储在一个 .xmlcatalog 文件中,可以从“导航器”视图中打开它。由于目录条目存储在 .xmlcatalog 文件中,因此可以检入和检出它们,并像任何其他项目资源一样共享它们。

要导入 XML 目录信息,请单击文件 > 导入并选择 XML > XML 目录 。然后指定将用来装入 XML 目录设置的文件。当导入 .xmlcatalog 文件时,将把其中的任何条目装入到 XML 目录中(并覆盖任何现有条目)。

相关概念
XML 文件与 DTD 和 XML 模式的关联
相关任务
在具有 DTD 或 XML 模式约束的情况下编辑
编辑 DOCTYPE 声明
使用对 DTD 和模式的更改来更新 XML 文件
编辑名称空间信息