DISH-Dienste erstellen

In SQL Anywhere können Sie DISH-Dienste erstellen, die als SOAP-Endpunkte für Gruppen von SOAP-Diensten agieren. DISH-Dienste erstellen auch automatisch WSDL-Dokumente (Web Services Description Language), mit denen SOAP-Client-Toolkits die notwendigen Schnittstellen für den Datenaustausch mit den durch die WSDL beschriebenen SOAP-Diensten generieren können. SOAP-Dienste können ohne Wartung der DISH-Dienste hinzugefügt und entfernt werden, weil der aktuelle Arbeitssatz von SOAP über HTTP-Diensten immer bereitgestellt wird.

Beispiel

Führen Sie die folgende SQL-Anweisung in Interactive SQL aus, um Beispiel-SOAP- und -DISH-Dienste auf dem HTTP-Webserver zu erstellen:

CREATE SERVICE "Samples/TestSoapOp"
    TYPE 'SOAP'
    DATATYPE ON
    USER DBA
    AUTHORIZATION OFF
    AS CALL sp_echo(:i, :f, :s);

CREATE PROCEDURE sp_echo(i INTEGER, f REAL, s LONG VARCHAR)
RESULT( ret_i INTEGER, ret_f REAL, ret_s LONG VARCHAR )
BEGIN
	SELECT i, f, s;
END;

CREATE SERVICE "dnet_endpoint"
    TYPE 'DISH'
    GROUP "Samples"
    FORMAT 'DNET';

Die erste CREATE SERVICE-Anweisung erstellt einen neuen SOAP-Dienst mit dem Namen Samples/TestSoapOp.

Die zweite CREATE SERVICE-Anweisung erstellt einen neuen DISH-Dienst mit dem Namen dnet_endpoint. Der Samples-Teil der GROUP-Klausel kennzeichnet die Gruppe der bereitzustellenden SOAP-Dienste. Sie können das vom DISH-Dienst generierte WSDL-Dokument anzeigen. Wenn Sie Ihren SQL Anywhere-Webserver auf einem Computer ausführen, können Sie auf den Dienst mit der URL http://localhost:port-number/dnet_endpoint zugreifen, wobei port-number für die Portnummer steht, auf der der Server läuft.

In diesem Beispiel enthält der SOAP-Dienst keine FORMAT-Klausel zur Angabe eines SOAP-Antwortformats. Aus diesem Grund wird das SOAP-Antwortformat vom DISH-Dienst bestimmt, wobei dieser nicht die FORMAT-Klausel des SOAP-Dienstes überschreibt. Mit dieser Funktion können Sie homogene DISH-Dienste erstellen, wobei jeder DISH-Endpunkt SOAP-Clients verschiedene Funktionen bereitstellen kann.

Homogene DISH-Dienste erstellen

Wenn SOAP-Dienstdefinitionen die Spezifikation der FORMAT-Klausel dem DISH-Dienst überlassen, kann ein Satz von SOAP-Diensten innerhalb eines DISH-Dienstes gruppiert werden, der das Format definiert. Mehrere DISH-Dienste können dann dieselbe Gruppe von SOAP-Diensten mit unterschiedlichen FORMAT-Spezifikationen bereitstellen. Wenn Sie das TestSoapOp-Beispiel ausweiten, können Sie mit folgender SQL-Anweisung einen anderen DISH-Dienst mit dem Namen java_endpoint erstellen:

CREATE SERVICE "java_endpoint"
    TYPE 'DISH'
    GROUP "Samples"
    FORMAT 'CONCRETE';

In diesem Beispiel erhält der SOAP-Client ein Antwortobjekt mit dem Namen TestSoapOp_Dataset, wenn er eine Webdienstanforderung für den Vorgang TestSoapOp über den DISH-Dienst java_endpoint erstellt. Die WSDL kann zum Vergleich der Unterschiede zwischen dnet_endpoint und java_endpoint untersucht werden. Wenn Sie so vorgehen, kann ein SOAP-Endpunkt, der die Anforderungen eines bestimmten SOAP-Client-Toolkits erfüllt, schnell konstruiert werden.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.