使用 SOAP Toolkit 2.0 將現有代碼作為 Web 服務提供

來源:互聯網
上載者:User
web 使用 SOAP Toolkit 2.0 將現有代碼作為 Web 服務提供
使用 .NET 建立分布式應用程式
Steve Kirk 和 Priya Dhawan
Microsoft Developer Network

摘要:本文介紹了使用 Microsoft SOAP Toolkit 版本 2.0 將現有 Microsoft Visual Basic 6.0 代碼作為 Web 服務提供時所進行的資料轉換。

目錄
簡介
現有代碼提供的資料類型
ADO 2x Command 對象
ADO 2x Recordset 對象
Stream 對象
XMLDOM 對象
總結

簡介
Microsoft®SOAP Toolkit 版本 2.0 簡化了將現有代碼作為 Web 服務提供和使用的任務,MSDN Library 的 SDK 部分中的 SOAP Toolkit 2.0 文檔(英文)對此進行了說明。在伺服器端執行的一些主要功能是,在現有代碼傳遞的不同資料類型的資料和 XML 訊息(在 Web 服務客戶機和伺服器之間使用)之間進行轉換。單一資料型別的轉換可以自動處理,較為複雜的資料類型則需要開發人員提供轉碼。

評估現有代碼是否適合於作為 Web 服務提供時,本文討論的資料轉換問題並不是唯一需要考慮的問題。應考慮的其它因素包括對象和狀態模型、返回的資料大小、如何表示已經成功、如何返回錯誤資訊、安全模型(包括存取控制、身分識別驗證和加密)、執行模型(同步或非同步)、如何分發代碼,以及事務模型(COM+ 事務或聲明型事務),等等。這些問題將在即將發表的體繫結構主題(英文)文章中進行討論。

現有代碼提供的資料類型
要介紹現有代碼傳遞的所有資料類型的轉換是一個相當大的工程,因此本文介紹了某些最常用的資料類型。通過 SOAP Toolkit 代碼進行轉換的一個替代方案是使用 XML 介面對現有代碼進行擴充。本文討論了以下資料類型的轉換方法:

ADO 2x Command 對象
ADO2x Recordset 對象
Stream 對象
XMLDOM 對象
ADO 2x Command 對象
直接存取資料庫的現有代碼經常會提供 Microsoft ActiveX® 資料對象 (ADO) 的 Command 對象。雖然不能在運行於不同進程中的應用程式層之間傳遞 Command 對象,但可以在同一進程內傳遞該對象。對於單行資料實體,通過 Command 對象的輸出參數返回資料比通過 ADO 記錄集返回資料效率更高。因此,ADO Command 對象對於返回單行實體資料十分有用。

讀資料
以下樣本中的現有代碼返回一個 ADO Command 對象,它包含作為輸出參數的資料。在傳遞給 Web 服務的客戶之前,Custom Type Mapper 中的代碼使用 SoapSerializer 對象對 Command 對象進行轉換:

With SoapSerializer
`轉換 CommandType
.startElement "CommandType"
.writeString Cmd.CommandType
.endElement
`轉換 CommandText
.startElement "CommandText"
cmdText = Cmd.CommandText
cmdText = Left(Cmd.CommandText, Len(cmdText) - 8)
cmdText = Right(cmdText, Len(cmdText) - 7)
.writeString cmdText
.endElement
`轉換 Parameters 集合
.startElement "Parameters"
For i = 0 To oCmd.Parameters.Count - 1
.startElement Right(oCmd.Parameters(i).Name, _
Len(oCmd.Parameters(i).Name) - 1)
.startElement "Direction"
.writeString oCmd.Parameters(i).Direction
.endElement
.startElement "Type"
.writeString oCmd.Parameters(i).Type
.endElement
.startElement "Size"
.writeString oCmd.Parameters(i).Size
.endElement
.startElement "Value"
.writeString oCmd.Parameters(i).Value
.endElement
.endElement
Next
.endElement
End With
寫資料
將資料作為 Command 對象的參數傳遞是一種非常有效資料傳遞方法。它還可以進行擴充,並提供了一些類型檢查功能。

以下樣本中,客戶提交給 Web 服務的 XML 資料被轉換為 ADO Command 對象的參數,它將被傳遞到現有代碼:

Dim Cmd As ADODB.Command
Dim Param As ADODB.Parameter
' pNode 是包含客戶提交的 XML 的 MSXML2.IXMLDOMNode
' 執行個體化一個 ADO Command 對象
Set Cmd = New ADODB.Command
With Cmd
' 應用 CommandType 和 CommandText
.CommandType = _
CInt(pNode.selectSingleNode("CommandType").nodeTypedValue)
.CommandText = pNode.selectSingleNode("CommandText").nodeTypedValue
' 填充 Parameters 集合
Set nodeParent = pNode.selectSingleNode("Parameters")
For i = 0 To nodeParent.childNodes.length - 1
Set nodeParameter = nodeParent.childNodes(i)
Set Param = New ADODB.Parameter
With Param
.Name = "@" + nodeParameter.nodeName
.Direction = _
nodeParameter.selectSingleNode("Direction").nodeTypedValue
.Type = nodeParameter.selectSingleNode("Type").nodeTypedValue
.Size = nodeParameter.selectSingleNode("Size").nodeTypedValue
.Value = factory.getMapper(enXSDstring, _
Nothing).Read(nodeParameter.selectSingleNode("Value"), _
bstrEncoding, encodingMode, lFlags)
End With
.Parameters.Append oParam
Next
End With

ADO 2x Recordset 對象
ADO 2x 中斷連線的記錄集通常用於在多層應用程式的各層之間傳遞資料。資料可以是單行、多行或分層次的行。

讀資料
本樣本中,現有代碼返回一個 ADO Recordset 對象,它包含的層次行資料將被轉換為 XML,然後再返回給客戶:

Dim Doc As MSXML2.DOMDocument
Set Doc = New MSXML2.DOMDocument
' 將記錄集資料寫入 XMLDOM
rs.Save oDoc, adPersistXML
' 將 XML 傳遞到 SOAP Toolkit Serializer
SoapSerializer.writeXML Doc.xml

寫資料
以下樣本中,使用展示層次行資料的 XML 填充 ADO Recordset 對象,該對象將被傳遞到現有代碼:

Dim rs As ADODB.Recordset
Dim Doc As MSXML2.DOMDocument
Set rs = New ADODB.Recordset
Set Doc = New MSXML2.DOMDocument
' 將 XML 載入 XMLDOMDocument
Doc.loadXML pNode.xml
' 使用來自 XMLDOMDocument 的 XML 填充記錄集
rs.Open Doc
Stream 對象
流提供了一種在應用程式的本地層之間傳遞資料的有效方法。它是從 Microsoft SQL Server™2000 中讀取 XML 的主要方法。

讀資料
以下樣本中,現有代碼返回展示層次行資料的 XML 流,它將被轉換,然後返回給客戶:

Dim inStream As ADODB.Stream
' pvar 包含現有代碼返回的流對象
Set inStream = pvar
' 將 XML 資料從流傳遞到 SOAP Serializer
SoapSerializer.writeString inStream.ReadText
XMLDOM 對象
XMLDOM 對象是一種在多層應用程式的本地層之間傳遞資料的好方法。它提供了介面可擴充性、類型檢查和結構描述驗證功能。

讀資料
以下樣本中,現有代碼返回一個 XMLDOMDocument 對象,該對象將被轉換,然後返回給客戶:

`pvar 包含 XMLDOMDocument
pSoapSerializer.writeXML pvar.xml

寫資料
以下樣本中,使用展示層次行資料(由客戶提交)的 XML 填充 XMLDOM 對象,然後將該對象傳遞到現有代碼:

Set oDoc = New MSXML2.DOMDocument
' 將 IXMLDOMNode XML 載入 DOMDocument 對象
`pnode 包含 IXMLDOMNode 對象
oDoc.loadXML pNode.childNodes(0).xml
總結
本文及附帶的樣本介紹了有關資料轉換的資訊。通過資料轉換,可以使用 SOAP Toolkit 2.0 將現有代碼作為 Web 服務提供。本文介紹了一些常用的介面對象。

這些解決方案的效能各異,並且受所傳遞的資料大小影響。在本系列後面的文章中,我們將對這些實現方法進行比較。

評估現有代碼是否適合作為 Web 服務時,介面只不過是應當考慮的諸多因素之一。應考慮的其它因素包括安全性(包括授權、身分識別驗證和加密)、事務模型、狀態模型、返回錯誤和結果的方式,以及代碼是同步還是非同步執行,等等。


相關文章

E-Commerce Solutions

Leverage the same tools powering the Alibaba Ecosystem

Learn more >

Apsara Conference 2019

The Rise of Data Intelligence, September 25th - 27th, Hangzhou, China

Learn more >

Alibaba Cloud Free Trial

Learn and experience the power of Alibaba Cloud with a free trial worth $300-1200 USD

Learn more >

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。