Produktinformationen per Web Service veröffentlichen

von Tony Patton am 9. August 2005 , 09:57 Uhr

Für die Formatierung beziehungsweise den Stil des SOAP-Bodys bietet WSDL (Web Services Description Language) zwei Möglichkeiten: RPC und document. Das .NET Framework kontrolliert diese beiden Codierungsmöglichkeiten mithilfe von Attributen. Document bedeutet die Formatierung der XML Web Service-Methode nach einem XSD-Schema. Der RPC-Stil bedeutet die Formatierung des Body-Elements als Abfolge mehrerer Nachrichtenbestandteile, die dem Body-Element folgen.

Listing A enthält den Code für den Beispiel-Web Service.

using <a href="https://www.zdnet.de/unternehmen/microsoft/" title="Themenschwerpunkt: Microsoft">Microsoft</a>.ApplicationBlocks.Data; 
using System; 
using System.Collections; 
using System.ComponentModel; 
using System.Data; 
using System.Data.SqlClient; 
using System.Diagnostics; 
using System.Web; 
using System.Web.Services; 
using System.Web.Services.Protocols; 
namespace WebServiceExample { 
public class Service1 : WebService { 
private DataSetds; 
private SqlParameter[] sp = new SqlParameter[1]; 
private const string connString = 
„server=(local);UID=Chester;PWD=Tester;INITIAL CATALOG=Northwind“; 
private string strSQL; 
public Service1() { } 
[SoapDocumentMethod(Action=“GetProductsById“)] 
[WebMethod] 
public DataSetGetProductsById(intproductID) { 
strSQL = „sp_GetProductById“; 
sp[0] = new SqlParameter(„@ProductID“, productID); 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp); 
return ds; 
} 
[SoapDocumentMethod(Action=“GetProductsByName“)] 
[WebMethod] 
public DataSetGetProductsByName(string productName) { 
strSQL = „sp_GetProductByName“; 
sp[0] = new SqlParameter(„@ProductName“, productName); 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp); 
return ds; 
} 
[SoapDocumentMethod(Action=“GetProductsByCategoryId“)] 
[WebMethod] 
public DataSetGetProductsByCategoryId(intcategoryID) { 
strSQL = „sp_GetProductByCategoryId“; 
sp[0] = new SqlParameter(„@CategoryID“, categoryID); 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp); 
return ds; 
} 
[SoapDocumentMethod(Action=“GetProductsByCategoryName“)] 
[WebMethod] 
public DataSetGetProductsByCategoryName(string categoryName) { 
strSQL = „sp_GetProductByCategoryName“; 
sp[0] = new SqlParameter(„@CategoryName“, categoryName); 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp); 
return ds; 
} 
[SoapDocumentMethod(Action=“GetProductsBySupplierId“)] 
[WebMethod] 
public DataSetGetProductsBySupplierId(intsupplierID) { 
strSQL = „sp_GetProductBySupplierId“; 
sp[0] = new SqlParameter(„@SupplierID“, supplierID); 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, sp); 
return ds; 
} 
[SoapDocumentMethod(Action=“GetProductsBySupplierName“)] 
[WebMethod] 
public DataSetGetProductsBySupplierName(string supplierName) { 
strSQL = „sp_GetProductBySupplierName“; 
sp[0] = new SqlParameter(„@SupplierName“, supplierName); 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp); 
return ds; 
} } }

Der Web Service ist ganz einfach aufgebaut. Diese Einfachheit wird noch durch den Data Access Application Block (DAAB) unterstützt. DAAB ist eine hervorragende Ergänzung für den Werkzeugsatz eines .NET-Entwicklers. Er bietet eine saubere und elegante Methode für den Zugriff auf Daten in .NET-Anwendungen.

Einer der besten Aspekte von DAAB ist das einfache Verfahren zur Erstellung von Methoden. Man kann es zur Rückgabe fast aller datenbezogener Objekte im Beispiel verwenden, auch für DataSets. Die überladenen Methodensignaturen sorgen für Benutzerfreundlichkeit. Sie akzeptieren denselben Satz von Parametern: Verbindungs-String, Befehlstyp, SQL und Parameter-Objekt. Das Parameter-Objekt ist nur notwendig, wenn man – wie bei diesem Beispiel – gespeicherte Prozeduren mit Parametern verwenden will. Es ist praktisch, wenn man mit so wenigen Codezeilen eine Schnittstelle zu SQL Server aufbauen kann. Listing B zeigt den Web Service, geschrieben mit VB.NET.

Listing B zeigt den Web Service, geschrieben mit VB.NET.

Imports System.Data 
Imports System.Data.SqlClient 
Imports Microsoft.ApplicationBlocks.Data 
Imports System.Web.Services 
Imports System.Web.Services.Protocols 
<System.Web.Services.WebService(Namespace :=
"http://tempuri.org/WebServiceExample/Service1")> _ 
Public Class Service1 
Inherits WebService 
Dim ds As DataSet 
Dim sp(1) As SqlParameter 
Const connString As String = „server=(local);UID=Chester;PWD=Tester;INITIAL 
CATALOG=Northwind“ 
Dim strSQL As String 
<SoapDocumentMethod(ResponseElementName:="GetProductsById"), _
WebMethod()> _ 
Public Function GetProductsById(ByValproductID As Integer) As DataSet 
strSQL = „sp_GetProductById“ 
sp(0) = New SqlParameter(„@ProductID“, productID) 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp) 
Return ds 
End Function 
<SoapDocumentMethod(ResponseElementName:="GetProductsByName"), _
WebMethod()> _ 
Public Function GetProductsByName(ByValproductName As String) As DataSet 
strSQL = „sp_GetProductByName“ 
sp(0) = New SqlParameter(„@ProductName“, productName) 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp) 
Return ds 
End Function 
<SoapDocumentMethod(ResponseElementName:="GetProductsByCategoryId"), _
WebMethod()> _ 
Public Function GetProductsByCategoryId(ByValcategoryID As Integer) As DataSet 
strSQL = „sp_GetProductByCategoryId“ 
sp(0) = New SqlParameter(„@CategoryID“, categoryID) 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp) 
Return ds 
End Function 
<SoapDocumentMethod(ResponseElementName:="GetProductsByCategoryName"), _
WebMethod()> _ 
Public Function GetProductsByCategoryName(ByValcategoryName As String) As 
DataSet 
strSQL = „sp_GetProductByCategoryName“ 
sp(0) = New SqlParameter(„@CategoryName“, categoryName) 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp) 
Return ds 
End Function 
<SoapDocumentMethod(ResponseElementName:="GetProductsBySupplierId"), _
WebMethod()> _ 
Public Function GetProductsBySupplierId(ByValsupplierID As Integer) As DataSet 
strSQL = „sp_GetProductBySupplierId“ 
sp(0) = New SqlParameter(„@SupplierID“, supplierID) 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp) 
Return ds 
End Function 
<SoapDocumentMethod(ResponseElementName:="GetProductsBySupplierName"), _
WebMethod()> _ 
Public Function GetProductsBySupplierName(ByValsupplierName As String) As 
DataSet 
strSQL = „sp_GetProductBySupplierName“ 
sp(0) = New SqlParameter(„@SupplierName“, supplierName) 
ds = SqlHelper.ExecuteDataset(connString, CommandType.StoredProcedure, strSQL, 
sp) 
Return ds 
End Function 
End Class

Praxistest

Web Services können über jedes Netzwerk mittels Standardprotokoll kommunizieren. Eine Möglichkeit besteht in der Verwendung von Standard-HTTP und einem Browser für den Zugriff auf den Service. So soll auch der Beispielcode getestet werden.

Die folgende URL ruft den Web Service auf und bietet Verknüpfungen zu den bereitgestellten Methoden (Hinweis: Wie man an „localhost“ sieht, liegt die Datei auf einem lokalen Entwicklungsrechner):


http://localhost/WebServiceExample/Service1.asmx

Ein schneller Test der GetProductsById-Methode mit einem Parameter von 5 liefert das XML-Dokument in Listing C zurück.

<?xml version="1.0" encoding="utf-8" ?>
<DataSetxmlns="http://tempuri.org/"> 
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"> 
<xs:element name="NewDataSet" msdata:IsDataSet="true"> 
<xs:complexType> 
<xs:choicemaxOccurs="unbounded"> 
<xs:element name="Table"> 
<xs:complexType> 
<xs:sequence> 
<xs:element name="ProductID" type="xs:int" minOccurs="0" /> 
<xs:element name="ProductName" type="xs:string" minOccurs="0" /> 
<xs:element name="CompanyName" type="xs:string" minOccurs="0" /> 
<xs:element name="UnitPrice" type="xs:decimal" minOccurs="0" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
</xs:choice> 
</xs:complexType> 
</xs:element> 
</xs:schema> 
<diffgr:diffgramxmlns:msdata="urn:schemas-microsoft-com:xml-msdata"
xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"> 
<NewDataSetxmlns=""> 
<Table diffgr:id="Table1" msdata:rowOrder="0"> 
<ProductID>5</ProductID> 
<ProductName>Chef Anton’s Gumbo Mix</ProductName> 
<CompanyName>New Orleans Cajun Delights</CompanyName> 
<UnitPrice>21.3500</UnitPrice> 
</Table> 
</NewDataSet> 
</diffgr:diffgram> 
</DataSet>

Man beachte, dass das XSD-Schema enthalten ist, wie vom SoapDocument-Attribut angegeben. Hier ein kleiner Exkurs zum Thema XSD.

Inhalt

Produktinformationen per Web Service veröffentlichen

Neueste Kommentare

Noch keine Kommentare zu Produktinformationen per Web Service veröffentlichen

Vielen Dank für Ihren Kommentar.
Ihr Kommentar wurde gespeichert und wartet auf Moderation.

Schreibe einen Kommentar Antworten abbrechen

Neueste Kommentare

Noch keine Kommentare zu Produktinformationen per Web Service veröffentlichen

Vielen Dank für Ihren Kommentar.Ihr Kommentar wurde gespeichert und wartet auf Moderation.

Schreibe einen Kommentar Antworten abbrechen

Vielen Dank für Ihren Kommentar.
Ihr Kommentar wurde gespeichert und wartet auf Moderation.