Gewusst wie: Migrieren von ASP.NET-Webdienstcode zu Windows Communication Foundation

Artikel
09/12/2008

Die folgende Prozedur beschreibt, wie ein ASP.NET-Webdienst zu Windows Communication Foundation (WCF) migriert wird.

Prozedur

So migrieren Sie ASP.NET-Webdienstcode zu WCF

Stellen Sie sicher, dass für den Dienst ein umfassender Satz von Tests vorhanden ist.
Generieren Sie die WSDL für den Dienst, und speichern Sie eine Kopie in dem Ordner, in dem sich auch die ASMX-Datei des Diensts befindet.
Aktualisieren Sie den ASP.NET-Webdienst für die Verwendung von .NET 2.0. Stellen Sie zunächst .NET Framework 2.0 für die Anwendungen der IIS bereit, und automatisieren Sie anschließend mithilfe von Visual Studio 2005 den Codeumwandlungsprozess gemäß den Anweisungen in Schritt-für-Schritt-Anweisungen zum Umwandeln von Webprojekten aus Visual Studio .NET 2002/2003 für Visual Studio 2005 (möglicherweise in englischer Sprache). Führen Sie die Tests aus.
Geben Sie explizite Werte für den Namespace und die Name-Parameter der WebService-Attribute an, sofern diese nicht bereits vorhanden sind. Führen Sie die gleichen Schritte für die MessageName-Parameter von WebMethodAttribute aus. Sind für die SOAPAction-HTTP-Header, gemäß denen Anforderungen zu Methoden geroutet werden, noch keine expliziten Werte angegeben, geben Sie explizit den Standardwert für den Action-Parameter mit einem SoapDocumentMethodAttribute an.
```
[WebService(Namespace = "http://tempuri.org/", Name = "Adder")]
public class Adder
{
     [WebMethod(MessageName = "Add")]
     [SoapDocumentMethod(Action = "http://tempuri.org/Add")]
     public double Add(SumInput input)
     {
          double sum = 0.00;
          foreach (double inputValue in input.Input)
          {
              sum += inputValue;
          }
      return sum;
     }
}
```
Testen Sie die Änderung.

Verschieben Sie sämtlichen substanziellen Code im Textkörper der Methoden der Klasse in eine separate Klasse, die von der ursprünglichen Klasse verwendet wird.

[WebService(Namespace = "http://tempuri.org/", Name = "Adder")]
public class Adder
{
     [WebMethod(MessageName = "Add")]
     [SoapDocumentMethod(Action = "http://tempuri.org/Add")]
     public double Add(SumInput input)
     {
          return new ActualAdder().Add(input);
     }
}

internal class ActualAdder
{
     internal double Add(SumInput input)
     {
          double sum = 0.00;
          foreach (double inputValue in input.Input)
          {
              sum += inputValue;
          }
      return sum;
     }
}

Testen Sie die Änderung.
Fügen Sie dem ASP.NET-Webdienstprojekt Verweise auf die WCF-Assemblys System.ServiceModel und System.Runtime.Serialization hinzu.
Führen Sie ServiceModel Metadata Utility Tool (Svcutil.exe) aus, um eine WCF-Clientklasse der WSDL zu generieren. Fügen Sie der Lösung das generierte Klassenmodul hinzu.

Das im vorangehenden Schritt generierte Klassenmodul enthält die Definition einer Schnittstelle.

[System.ServiceModel.ServiceContractAttribute()]
public interface AdderSoap
{
     [System.ServiceModel.OperationContractAttribute(
      Action="http://tempuri.org/Add", 
      ReplyAction="http://tempuri.org/Add")]
     AddResponse Add(AddRequest request);
}

Passen Sie die Definition der ASP.NET-Webdienstklasse so an, dass für die Klasse die Implementierung dieser Schnittstelle festgelegt ist. Im Folgenden finden Sie ein entsprechendes Codebeispiel.

[WebService(Namespace = "http://tempuri.org/", Name = "Adder")]
public class Adder: AdderSoap
{
     [WebMethod(MessageName = "Add")]
     [SoapDocumentMethod(Action = "http://tempuri.org/Add")]
     public double Add(SumInput input)
     {
          return new ActualAdder().Add(input);
     }

     public AddResponse Add(AddRequest request)
     {
        return new AddResponse(
        new AddResponseBody(
        this.Add(request.Body.input)));
     }
}

Kompilieren Sie das Projekt. Aufgrund des in Schritt 9 generierten Codes treten möglicherweise einige Fehler auf, da einige Typdefinitionen dupliziert wurden. Beheben Sie diese Fehler. In der Regel ist hierzu das Löschen der bereits vorhandenen Typendefinitionen ausreichend. Testen Sie die Änderung.

Entfernen Sie die ASP.NET-spezifischen Attribute. Beispiele: WebService, WebMethodAttribute und SoapDocumentMethodAttribute.

public class Adder: AdderSoap
{
     public double Add(SumInput input)
     {
          return new ActualAdder().Add(input);
     }

     public AddResponse Add(AddRequest request)
     {
          return new AddResponse(
         new AddResponseBody(
        this.Add(request.Body.input)));
     }
}

Konfigurieren Sie die Klasse, bei der es sich nun um eine WCF-Dienstklasse handelt, sodass der WCF-ASP.NET-Kompatibilitätsmodus verwendet wird, wenn der ASP.NET-Webdienst auf einem der folgenden Elemente beruht:
- Der HttpContext-Klasse.
- Den ASP.NET-Profilen.
- Den ACLs für ASMX-Dateien.
- Den IIS-Authentifizierungsoptionen.
- Den Identitätswechseloptionen von ASP.NET.
- Der ASP.NET-Globalisierung.
```
[System.ServiceModel.AspNetCompatibilityRequirements(
  RequirementsMode=AspNetCompatbilityRequirementsMode.Required)]
public class Adder: AdderSoap
```
Benennen Sie die ursprüngliche ASMX-Datei zu .asmx.old um.
Erstellen Sie für den Dienst eine WCF-Dienstdatei, versehen Sie sie mit der Erweiterung .asmx, und speichern Sie sie im Anwendungsstammverzeichnis der IIS.
```
<%@Service Class="MyOrganization.Adder" %>
<%@Assembly Name="MyServiceAssembly" %> 
```

Fügen Sie der entsprechenden Web.config-Datei eine WCF-Konfiguration hinzu. Konfigurieren Sie den Dienst so, dass basicHttpBinding Element sowie die im vorangegangenen Schritt erstellte ASMX-Datei verwendet werden und keine eigene WSDL erstellt, sondern die WSDL aus dem zweiten Schritt verwendet wird. Konfigurieren Sie den Dienst zudem für die Verwendung des ASP.NET-Kompatibilitätsmodus (sofern erforderlich).

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
 <system.web>
  <compilation>
  <buildProviders>
   <remove extension=".asmx" />
   <add extension=".asmx" 
    type=
    "System.ServiceModel.Activation.ServiceBuildProvider,
    T:System.ServiceModel, Version=2.0.0.0, 
   Culture=neutral, 
   PublicKeyToken=b77a5c561934e089" />
  </buildProviders>
  </compilation>
 </system.web>
 <system.serviceModel>
  <services>
  <service name="MyOrganization.Adder "
    behaviorConfiguration="AdderBehavior">
   <endpoint 
    address="”
    binding="basicHttpBinding"
    contract="AdderSoap "/>
   </service>
  </services>
  <behaviors>
  <behavior name="AdderBehavior">
   <metadataPublishing 
    enableMetadataExchange="true" 
    enableGetWsdl="true" 
    enableHelpPage="true" 
    metadataLocation=
    "http://MyHost.com/AdderService/Service.WSDL"/>
  </behavior>
  </behaviors>
  <serviceHostingEnvironment 
   aspNetCompatibilityEnabled ="true"/>
 </system.serviceModel>
</configuration>

Speichern Sie die Konfiguration.
Kompilieren Sie das Projekt.
Vergewissern Sie sich durch Ausführen der Tests, dass alle Änderungen ordnungsgemäß funktionieren.

Siehe auch

Aufgaben

Gewusst wie: Migrieren von ASP.NET-Webdienstcode zu Windows Communication Foundation

Freigeben über

Gewusst wie: Migrieren von ASP.NET-Webdienstcode zu Windows Communication Foundation

Prozedur

So migrieren Sie ASP.NET-Webdienstcode zu WCF

Siehe auch

Aufgaben

Zusätzliche Ressourcen