Testen eines Web Services mit einer Proxy-Klasse

von Tony Patton am 11. August 2005 , 10:04 Uhr

Eine Proxy-Klasse kann aus einer Service-Beschreibung generiert werden, sofern diese dem WSDL-Standard (Web Services Description Language) entspricht. Man kann eine Proxy-Klasse mithilfe des Befehlszeilentools von .NET namens wsdl.exe erzeugen. Ein Web Service-Client kann wiederum Proxy-Klassen-Methoden aufrufen, die über das Netzwerk mit einem Web Service kommunizieren, indem sie die vom und an den Web Service versandten SOAP-Mitteilungen verarbeiten.

Da eine Proxy-Klasse über das Internet mit dem Web Service kommuniziert, empfiehlt es sich, zu überprüfen, dass die URL-Eigenschaft der Proxy-Klasse auf eine vertrauenswürdige Adresse verweist. Der folgende Befehl verwendet das Tool wsdl.exe zum generieren einer Proxy-Klasse für unseren Service:


wsdl /language:cs /protocol:soap
http://localhost/WebServiceExample/Service1.asmx

Listing A enthält einen kleinen Ausschnitt der durch diesen Aufruf generierten Klasse.

[System.Diagnostics.DebuggerStepThroughAttribute()] 
[System.ComponentModel.DesignerCategoryAttribute(„code“)] 
[System.Web.Services.WebServiceBindingAttribute(Name=“Service1Soap“, 
Namespace=“http://tempuri.org/“)] 
public class Service1 : System.Web.Services.Protocols.SoapHttpClientProtocol { 
public Service1() { 
this.Url = „http://localhost/WebServiceExample/Service1.asmx“; 
} 
[System.Web.Services.Protocols.SoapDocumentMethodAttribute(„GetProductsById“, 
RequestNamespace=“http://tempuri.org/“, 
ResponseNamespace=“http://tempuri.org/“, 
Use=System.Web.Services.Description.SoapBindingUse.Literal, 
ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)] 
public System.Data.DataSetGetProductsById(intproductID) { 
object[] results = this.Invoke(„GetProductsById“, new object[] {productID}); 
return ((System.Data.DataSet)(results[0])); 
} 
public System.IAsyncResultBeginGetProductsById(intproductID, 
System.AsyncCallback 
callback, object asyncState) { 
return this.BeginInvoke(„GetProductsById“, new object[] { 
productID}, callback, asyncState); 
} 
public System.Data.DataSetEndGetProductsById(System.IAsyncResultasyncResult) 
{ 
object[] results = this.EndInvoke(asyncResult); 
return ((System.Data.DataSet)(results[0])); 
}

Ein zentraler Aspekt der Proxy-Klasse ist ihr Konstruktor, der die URL-Eigenschaft so festlegt, dass korrekt auf den Web Service zugegriffen wird. Die generierten Methoden imitieren Methoden im tatsächlichen Web Service. Dabei ist zu beachten, dass jede Methode die entsprechende Methode im Web Service aufruft.

Das wsdl-Tool akzeptiert verschiedene Parameter, wie im vorangehenden Aufruf zu sehen. Hier ein Überblick über die verwendeten Parameter:

/language: Ermöglicht die Festlegung der zum Erstellen der Proxy-Klasse verwendeten Sprache. Als Standard wird C# verwendet, weshalb seine Einfügung in den vorherigen Aufruf irrelevant ist. Man kann CS (C#; Standard), VB (Visual Basic), JS (JScript) oder VJS (Visual J#) als Sprachargument angeben.
/protocol: Das in der Proxy-Klasse implementierte Protokoll, mit SOAP als Standardeinstellung. Weitere Optionen sind SOAP12, HttpGet/ HttpPost oder ein anderes Protokoll.
Die URL verweist auf den Web Service. Sie kann auch auf ein XSD-Schema oder .discomap-Dokument verweisen. Man kann Discovery-Dokumente für einen XML-Web Service mithilfe des Web Services Discovery Tool (Disco.exe) erhalten. Die von diesem Tool gelieferten Dateien .discomap, .disco, .wsdl und .xsd können als Eingabe für wsdl.exe dienen. Nähere Informationen zu weiteren verfügbaren Befehlszeilenoptionen sind der Dokumentation des wsdl.exe-Tools zu entnehmen.

Die folgende Zeile generiert eine Proxy-Klasse unter Verwendung von VB.NET:


wsdl /language:vb /protocol:soap
http://localhost/WebServiceExample/Service1.asmx

Listing B enthält einen Ausschnitt der vom wsdl-Tool generierten VB.NET-Proxy-Klasse.

Public Sub New() 
MyBase.New 
Me.Url = „http://localhost/WebServiceExample/Service1.asmx“ 
End Sub 
<System.Web.Services.Protocols.SoapDocumentMethodAttribute("GetProductsById",
RequestNamespace:="http://tempuri.org/",
ResponseNamespace:="http://tempuri.org/",
Use:=System.Web.Services.Description.SoapBindingUse.Literal,
ParameterStyle:=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)> _ 
Public Function GetProductsById(ByValproductID As Integer) As 
System.Data.DataSet 
Dim results() As Object = Me.Invoke(„GetProductsById“, New Object() 
{productID}) 
Return CType(results(0),System.Data.DataSet) 
End Function 
Public Function BeginGetProductsById(ByValproductID As Integer, ByVal callback 
As 
System.AsyncCallback, ByValasyncState As Object) As System.IAsyncResult 
Return Me.BeginInvoke(„GetProductsById“, New Object() {productID}, callback, 
asyncState) 
End Function 
Public Function EndGetProductsById(ByValasyncResult As System.IAsyncResult) As 
System.Data.DataSet 
Dim results() As Object = Me.EndInvoke(asyncResult) 
Return CType(results(0),System.Data.DataSet) 
End Function

Nach der Einrichtung der Proxy-Klasse kann diese zum Testen des verwendeten Web Service benutzt werden. (Anmerkung: Die Proxy-Klasse kann mit einer Sprache nach Wahl entwickelt werden. Es muss sich dabei nicht um dieselbe Sprache handeln, die im eigentlichen Web Service verwendet wird.)

Inhalt

Testen eines Web Services mit einer Proxy-Klasse

Neueste Kommentare

Noch keine Kommentare zu Testen eines Web Services mit einer Proxy-Klasse

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 Testen eines Web Services mit einer Proxy-Klasse

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.