目录
asp#bdadotnetwebservice1_topic1" target=_self>简介
asp#bdadotnetwebservice1_topic2" target=_self>现有代码提供的数据类型
asp#bdadotnetwebservice1_topic2a" target=_self>ADO 2x Command 对象
asp#bdadotnetwebservice1_topic2b" target=_self>ADO 2x Recordset 对象
asp#bdadotnetwebservice1_topic2c" target=_self>Stream 对象
asp#bdadotnetwebservice1_topic2d" target=_self>XMLDOM 对象
asp#bdadotnetwebservice1_topic2e" target=_self>XML 字符串
asp#bdadotnetwebservice1_topic3" target=_self>总结
简介
.NET 框架简化了将 .NET 代码作为 Web 服务提供的任务。.NET 框架开发人员指南中的 asp?url=/library/en-us/cpguidnf/html/cpconaspnetbuildingwebservicesaspnetwebserviceclients.asp">ASP.NET Web 服务和 ASP.NET Web 服务客户机(英文)对此进行了说明。之所以能够实现这种简化,其中一个原因是 .NET 框架提供了一系列规则,用于将复杂的 .NET 数据类型转换为 XML(序列化)以及反向转换(反序列化)。
编写为 .NET 之前的类的现有代码通过特定于语言的数据类型或 COM 对象来传递数据,因此不能依赖于相同的标准规则将这些数据类型序列化为 XML。本文介绍了将现有 Microsoft? Visual Basic 6.0 代码作为 ASP.NET Web 服务提供时所需的数据转换。
评估现有代码是否适合于作为 Web 服务提供时,本文讨论的数据转换问题并不是唯一需要考虑的问题。应考虑的其它因素包括对象和状态模型、返回的数据大小、如何表示已经成功、如何返回错误信息、安全模型(包括访问控制、身份验证和加密)、执行模型(同步或异步)、如何分发代码,以及事务模型(COM+ 事务或声明型事务),等等。这些问题将在即将发表的asp">体系结构主题(英文)文章中进行讨论。
现有代码提供的数据类型
讨论现有代码传递的所有数据类型的转换将是一个相当大的工程,因此本文只介绍一些最常用的数据类型,以及 XML(作为字符串),因为如果使用 XML 对现有代码进行扩展,那么 XML 就可以涵盖几乎所有其它的数据类型。本文讨论以下数据类型的转换方法:
ADO 2x Command 对象
ADO2x Recordset 对象
Stream 对象
XMLDOM 对象
XML
ADO 2x Command 对象
直接访问数据库的现有代码经常会提供 Microsoft ActiveX? 数据对象 (ADO) 的 Command 对象。虽然不能在运行于不同进程中的应用程序层之间传递 Command 对象,但可以在同一进程内传递该对象。对于单行数据实体,通过 Command 对象的输出参数返回数据比通过 ADO 记录集返回数据效率更高。因此,ADO Command 对象对于返回单行实体数据十分有用。
读数据
以下示例中的现有代码返回一个 ADO Command 对象,它包含作为输出参数的数据。Command 对象的 Parameters 集合转换为 XML 并返回给 Web 服务的客户:
' 现有代码返回 ADO Command 对象
Cmd = CType(EC.Example1(), ADODB.Command)
' 使用 XmlTextWriter 和 StringWriter 转换 Command 对象的 Parameters 集合
' 初始化 stringwriter 和 xmlwriter 以返回 xml 字符串
strWriter = New StringWriter()
xmlWriter = New XmlTextWriter(strWriter)
' 在 Parameters 集合内循环,写入名称和值
For i = 0 To Cmd.Parameters.Count - 1
xmlwriter.WriteElementString(Cmd.Parameters(i).Name.Substring(1),_
Cmd.Parameters(i).Value.ToString)
Next
' 将 xml 作为字符串返回
Example1 = strWriter.GetStringBuilder.ToString()
写数据
将数据作为 Command 对象的参数传递是一种非常有效的数据传递方法。它还可以进行扩展,并提供了一些类型检查功能。不幸的是,由于 Beta 1 中存在缺陷,Command 对象产生的数据无法传递到现有代码。Beta 2 中解决了这个问题。Beta 1 的解决方法是对现有的 VB 6 代码进行扩展,接受 XML。
ADO2x Recordset 对象
ADO 2x 断开连接的记录集通常用于在多层应用程序的各层之间传递数据。数据可以是单行、多行或分层次的行。
读数据
本示例中,现有代码返回一个 ADO Recordset 对象,它包含的层次行数据将被转换为 XML,然后由 Web 服务返回:
' 现有代码返回记录集
RS = CType(EC.Example3(), ADODB.Recordset)
' 实例化一个接收记录集数据的流
Stream = New ADODB.Stream()
' 将记录集的 XML 表示写入流
RS.Save(Stream, ADODB.PersistFormatEnum.adPersistXML)
' 将 XML 作为字符串从流返回
Example3 = Stream.ReadText
写数据
以下示例中,使用表示层次行数据的 XML 填充 ADO Recordset 对象,该对象将被传递到现有代码:
' 实例化一个记录集对象
RS = New ADODB.Recordset()
' 实例化一个流对象
Stream = New ADODB.Stream()
' 打开流对象
Stream.Open()
' 将 XML 写入流
Stream.WriteText(RsXML)
' 将指针定位到流的开头
Stream.Position = 0
' 使用流中的 XML 数据打开记录集
RS.Open(Stream)
' 将记录集传递到现有代码
EC.Example4(RS)
Stream 对象
流提供了一种在应用程序的本地层之间传递数据的有效方法。它是从 Microsoft SQL Server?2000 中读取 XML 的主要方法。
读数据
以下示例中,现有代码返回表示层次行数据的 XML 流,它被作为字符串读取,并由 Web 服务返回:
Dim Stream As ADODB.Stream
Stream = CType(EC.Example5(), adodb.stream)
Example5 = Stream.ReadText
XMLDOM 对象
XMLDOM 对象是一种在多层应用程序的本地层之间传递数据的好方法。它提供了接口可扩展性、类型检查和架构验证功能。
读数据
以下示例中,现有代码返回一个 XML 文档对象模型 (XMLDOM),它被转换为 XML 字符串并由 Web 服务返回:
Dim Doc As MSXML2.DOMDocument
' 现有代码返回 XMLDOM 对象
Doc = CType(EC.Example6(), msxml2.DOMDocument)
' 从 DOM 对象返回 XML
Example6 = Doc.xml
写数据
以下示例中,使用表示层次行数据的 XML 填充 XMLDOM 对象,并将该对象传递到现有代码:
Dim Doc As MSXML2.DOMDocument
' 实例化一个 XMLDOMDocument 对象
Doc = New MSXML2.DOMDocument()
' 将 XML 载入 DOM
Doc.loadXML(orderXML)
' 将 DOM 传递到现有代码
EC.Example7(Doc)
XML 字符串
XML 是一种在层与层之间传递数据的简单方法。它还将数据的 XML 转换过程推到 COM 互操作边界的“现有代码”端,根据接口的不同,这可能会比在 COM 互操作边界将数据转换为 XML 更有效。
读数据
以下示例中,现有代码返回一个包含 XML 数据的字符串,然后,该字符串由 Web 服务传递给客户:
EC = New ExCode.ExClass()
' 将 XML 字符串直接从现有代码传递给客户
Example8 = EC.Example8()
写数据
以下示例中,层次行数据的 XML 表示作为字符串传递到现有代码:
EC = New ExCode.ExClass()
' 将 XML 字符串直接从客户传递到现有代码
EC.Example9(orderXML)
总结
本文及附带的示例介绍了有关数据转换的信息。通过数据转换,可以使用 ASP.NET 将现有代码作为 Web 服务提供。本文讨论了一些常用的接口对象,其中包括 XML 字符串,如果使用相应的接口对现有代码进行扩展,它可以涵盖大多数数据。
这些解决方案的性能各异,并且受所传递的数据大小影响。在本系列后面的文章中,我们将对这些实现方法进行比较。
评估现有代码是否适合作为 Web 服务时,接口只不过是应当考虑的诸多因素之一。应考虑的其它因素包括安全性(包括授权、身份验证和加密)、事务模型、状态模型、返回错误和结果的方式,以及代码是同步还是异步执行,等等。