Freigeben über

  • Artikel

Einfaches WSDL

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird.

Einfaches WSDL erstellt eine vereinfachte Version des WSDL-Dokuments, in der Systemdatentypen von SQL Server durch primitive XSD-Datentypen ersetzt werden, die in Standard-WSDL umfassender beschrieben werden. Einfaches WSDL verringert zwar die Reichhaltigkeit der SQL Server-Datentypen, die im Standard-WSDL vollständig unterstützt werden, vereinfacht jedoch auch den Vorgang des Bereitstellens von verwendbaren WSDL-Dokumenten für Clients und Proxyklassengeneratoren, die nicht alle Facets von Standard-WSDL und dem zugehörigen Datentypsystem zuordnen bzw. verarbeiten können.

Unterschiede zwischen einfachem und Standard-WSDL

Der Hauptgrund für die Verwendung sowohl des einfachen als auch des Standard-WSDL-Formats besteht darin, dass das einfache WSDL-Format Abwärtskompatibilität und Unterstützung für SOAP-Clients bereitstellen soll, die das Standard-WSDL-Format nicht verarbeiten können.

Dies schließt einfache Webdiensteclients ein, z. B. solche, die auf dem SOAP Toolkit basieren. Diese Clients können das Standard-WSDL-Dokument nicht so interpretieren, wie es von einer Instanz von SQL Server generiert wird. Diese Einschränkung beruht darauf, dass das SOAP-Toolkit und andere einfachere Webdiensteclients die Reichhaltigkeit einiger in SQL Server 2005 eingeführten Systemdatentypen nicht interpretieren können. Aus diesem Grund ordnet das einfache WSDL alle SQL Server-Typelemente systemeigenen XSD-Typen zu, damit auch einfachere oder ältere Clients verwendet werden können.

Der SOAP Toolkit-Client weist bekanntermaßen Probleme bei der Verarbeitung von sqltypes:money auf, die durch die Definitionsgranularität von totalDigits und fractionDigits bedingt sind, sowie von anderen zusätzlichen Elementen, die zum Ableiten der ursprünglichen XSD-Typen verwendet werden. Das SOAP Toolkit kann jedoch die direkte Zuordnung von XSD-Typen einwandfrei verarbeiten, z. B. int.

Abgeleitete Typen (Standard-WSDL)

<xsd:simpleType name="money">
             <xsd:restriction base="xsd:decimal">
             <xsd:totalDigits value="19">
             </xsd:totalDigits>
             <xsd:fractionDigits value="4">
             </xsd:fractionDigits>
             <xsd:maxInclusive value="922337203685477.5807">
             </xsd:maxInclusive>
             <xsd:minInclusive value="-922337203685477.5808">
        </xsd:minInclusive>
     </xsd:restriction>
</xsd:simpleType>

Direkte Ableitung (einfaches WSDL)

<xsd:simpleType name="int">
    <xsd:restriction base="xsd:int">
    </xsd:restriction>
</xsd:simpleType>

Ein weiteres Beispiel ist eine RPC-Antwort. Standard-WSDL legt einen Antworttyp auf SqlResultStream fest. Dieser wird im Abschnitt zu den verfügbaren Typen näher definiert. Im Gegensatz dazu wird der Antworttyp auf einen allgemeinen <xsd:complexType> festgelegt, der <xsd:any> angibt. Auf diese Weise wird beliebiger Inhalt ermöglicht. Durch diese Änderung des WSDL-Dokuments kann der einfache Webdiensteclient seine Unfähigkeit umgehen, die abgeleiteten SQL Server-Antworttypen zu analysieren.

HinweisHinweis

WSDL-Anforderungen können nicht in SOAP-Sitzungen enthalten sein. Weitere Informationen zu SOAP-Sitzungen finden Sie unter Arbeiten mit SOAP-Sitzungen.

Zuordnungen von SQL Server- zu XSD-Datentypen für einfaches WSDL

Weitere Informationen dazu, wie SQL Server-Systemdatentypen XML-Schema-Datentypen (XSD-Datentypen) für einfaches WDSL zugeordnet werden, finden Sie unter Datentypzuordnungen in systemeigenen XML-Webdiensten.