第四十三章在 SOAP 消息中使用数据集

本主题讨论 %XML.DataSet，这是一个支持 XML 的数据集，当 Web 服务和客户端都基于 IRIS 数据平台或一方使用 .NET 时，可以在 SOAP 消息中使用它。

重要提示：其他 SOAP 供应商不支持数据集，也无法处理使用数据集的 Web 服务生成的 WSDL。

关于数据集

数据集是 Microsoft 定义的 XML 格式结果集（用于 .NET），并且也受 IRIS 支持。如果 Web 服务和客户端都基于 IRIS，或者其中一方使用 .NET，则可以使用数据集作为 Web 方法的输入或输出。其他 SOAP 技术无法理解这种格式。

当使用 IRIS 中的 Web 服务或客户端时，可以使用 %XML.DataSet（或自定义子类）来表示数据集。有关在使用 %XML.DataSet的详细信息，请参阅类参考。

注意：%XML.DataSet 类仅支持单个表。也就是说，它使用的查询只能返回单个表。

示例 Web 服务 SOAP.Demo（在 SAMPLES 命名空间中）演示了 IRIS 中的数据集。具体来说，以下 Web 方法使用数据集：

GetByName()
GetDataSetByName()
QueryByName()

要输出查询结果以便基于 Java 的 Web 客户端可以使用它，请类中使用 %ListOfObjects；SOAP.Demo 显示了一个例子。

定义类型化数据集

任何数据集都使用查询来指定要检索的数据。如果查询在编译时已知，则数据集是类型化的；否则它是非类型化的。类型化数据集在许多情况下都很方便；例如，在 .NET 中，类型化数据集允许在 Microsoft Visual Studio 中完成代码。

要定义类型化数据集，请在创建 %XML.DataSet的子类并指定 QUERYNAME 和 CLASSNAME 参数。这些参数一起引用特定的 SQL 查询。在为数据集生成架构时，%XML.DataSet 会考虑类和属性元数据，例如自定义数据类型中的任何 LogicalToXSD() 方法。

注意：如果使用 %XML.DataSet 作为方法的返回值，则该值的 XML 类型为 DataSet。另一方面，如果使用 %XML.DataSet 的子类作为返回值，则该值的 XML 类型是该子类的名称。此行为与其他支持 XML 的类的行为相同，并且会影响 WSDL 中描述的 XML 类型。请参阅控制对 XML 类型的投影