XML 架构工具：检索和引用外部 XML 资源

本教程的目的旨在介绍如何将外部架构文件检索到 mySchemaPrj 项目中。XML 资源检索操作将检索 XML 架构和 WSDL（Web Services Description Language，Web 服务描述语言）文档。向导将验证传递的闭包是否满足要求，包括内嵌在 WSDL 中的 XML 架构。从 URL 检索资源时，IDE 将检索资源闭包。

注意：无论 图标出现在何处，都可以单击它来查看教程中所描述的步骤的详细交互式演示。

返回页首

检索 XML 资源

使用本过程中的说明检索 XML 资源后，您将在下一部分（引用外部架构）中引用这些资源。

检索 XML 资源：

1. 如果在 IDE 中未打开 mySchemaPrj，请立即将其打开。
2. 如果未显示“输出”窗口，请选择“窗口”>“输出”。
   在 IDE 检索资源时，“输出”窗口中将显示信息消息。
3. 在“项目”窗口中，展开 "mySchemaPrj" 项目节点，然后展开“源包”节点。
4. 选择 "<缺省包>" 节点，单击鼠标右键，然后选择“新建”>“文件/文件夹”。
5. 在“新建文件”对话框的“类别”下面选择 "XML" 节点，然后在“文件类型”列表中选择“外部的 XML 架构文档”。
6. 单击“下一步”。
   将打开“新建检索文档”页。
7. 在“指定资源位置”页中，选择从中检索文件的来源。
   
   • 从 URL 检索资源：
     
     1. 选择 "URL" 单选按钮。
     2. 在 "URL" 单选按钮下面的文本字段中，键入 http://docs.oasis-open.org/ubl/cd-UBL-1.0/xsd/maindoc/UBL-Order-1.0.xsd。
        在本示例中，我们将直接从 URL 检索 UBL 样例架构（包含在 Java WSDP 2.0 版中），而不是使用本地安装。
     3. 接受“保存到文件夹”字段的缺省值 path-to-project\mySchemaPrj\src。
     4. 单击“完成”。
        请注意在“输出”窗口中显示的信息。IDE 将显示要复制到项目文件夹中的文件，如果有任何错误，则会在“输出”窗口中显示它们。
        现在，项目的“源包”节点会包含其他三个节点：docs.oasis-open.org.ubl.cd-UBL-1.0.xsd.codelist、docs.oasis-open.org.ubl.cd-UBL-1.0.xsd.common 和 docs.oasis-open.org.ubl.cd-UBL-1.0.xsd.maindoc。

     查看演示

   • 从本地文件系统检索资源：
     
     1. 选择“本地文件系统”单选按钮。
     2. 单击“本地文件系统”单选按钮下面的文本字段旁边的“浏览”按钮。
     3. 在“打开”对话框中，导航并选择要检索的架构所在的文件夹。
        在本示例中，我们将检索 Java WSDP 2.0 版中包含的样例架构。该架构文件位于以下文件夹中：
        jwsdp-installation-folder\jwsdp-2.0\jaxb\samples\ubl\cd-UBL-1.0\。
     4. 接受“保存到文件夹”字段的缺省值 path-to-project\mySchemaPrj\src。
     5. 单击“完成”。
        请注意在“输出”窗口中显示的信息。IDE 将显示要复制到项目文件夹中的文件，如果有任何错误，则会在“输出”窗口中显示它们。
        现在，项目的“源包”节点会包含其他三个节点：xsd.codelist、xsd.common 和 xsd.maindoc。

     查看演示

   展开这些节点可以查看检索到项目中的架构文件的相关信息。下图显示了从本地安装的 UBL 样例架构检索的资源的已展开节点。
   
   

   

返回页首

引用外部架构

在本过程中，您将在项目中添加一个 XML 架构文件，然后引用在前一部分中检索的架构文件。

在 mySchemaPrj 项目中添加新的 XML 架构文件：

1. 在“项目”窗口中，展开 "mySchemaPrj" 节点，然后展开“源包”节点。
2. 选择 "<缺省包>" 节点，单击鼠标右键，然后选择“新建”>“文件/文件夹”。
   将打开“新建文件”向导。
3. 在“类别”列表中选择 "XML"，然后在“文件类型”列表中选择“XML 架构”。
4. 单击“下一步”。
   将打开向导的“名称和位置”页。
5. 在向导的“名称和位置”页中，确保文件名为 newXmlSchema，接受其他缺省值，然后单击“完成”。
   注意：如果文件名的缺省值不是 newXmlSchema，请将其更改为 newXmlSchema 以便与本文档中的说明相匹配。
   IDE 将在“架构”视图中打开新的 newXmlSchema 文件标签。

查看演示

添加外部引用：

1. 在 newXmlSchema.xsd 文件的“架构”视图的列视图中，选择根节点 (http://xml.netbeans.org/schema/newXMLSchema)，单击鼠标右键，然后选择“添加”>“导入”。
   将打开“导入”对话框。
2. 在“位置”列表中，选择架构文件。
   
   • 在从 URL 检索的资源中选择架构文件：
     
     1. 展开“按文件”> "mySchemaPrj" > "src" > "docs.oasis-open.org" > "ubl" > "cd-UBL-1.0" > "xsd" > "maindoc" 节点。
     2. 选择 "UBL-Order-1.0.xsd"。
        IDE 将填充“位置”列表下面的“名称空间”字段，该字段包含以下值：urn:oasis:names:specification:ubl:schema:xsd:Order-1.0。
     3. 在“新建前缀”字段中，键入 myRef，然后单击“确定”。
        IDE 将在架构文件中添加 import。

     查看演示

   • 在从本地安装的样例检索的资源中选择架构文件：
     
     1. 展开“按文件”> "mySchemaPrj" > "src" > "xsd" > "maindoc" 节点。
     2. 选择 "UBL-Order-1.0.xsd"。
        IDE 将填充“位置”列表下面的“名称空间”字段，该字段包含以下值：urn:oasis:names:tc:ubl:Order:1:0。
     3. 在“新建前缀”字段中，键入 myRef。
     4. 单击“确定”。
        IDE 将在架构文件中添加 import。

     查看演示

3. 在“架构”视图的第一列中，选择“引用的架构”节点。
   IDE 将在视图的第二列中显示新的 import 节点。如果是从本地安装的样例检索的资源，import 节点应如下所示。
   
   

   

4. 在“架构”视图的第二列中，选择 import 节点，单击鼠标右键，然后选择“转至”>“源”。
   IDE 将使用“源”视图替换“架构”视图。请注意，IDE 已对 schema 组件进行了更新，以便使引用的架构和定义的前缀包含 xmlns 属性。
5. 单击“输出”窗口标题栏中的“关闭”按钮以关闭该窗口。
6. 从 IDE 主菜单中，选择“窗口”>“关闭所有文档”。
7. 当 IDE 提示您保存所做的更改时，请单击“保存”。
8. 在“项目”窗口中，右键单击 "mySchemaPrj" 节点，然后选择“关闭项目”。

返回页首

后续步骤

使用“设计”视图填充 XML 架构中的步骤说明了如何使用 XML 架构编辑器中的“设计”视图来填充和修改 XML 架构文件。

返回页首