Das Dienstprogramm zum Importieren von WSDL verwenden

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Server mit Web-Service-Unterstützung schreiben


Wählen Sie für die Verwendung des Dienstprogramms zum Importieren von WSDL eine der folgenden Methoden:

  • Datei > Neu > Weitere > Delphi-Projekte oder C++Builder-Projekte > WebServices > WSDL-Import
  • Komponente > WSDL importieren

Hinweis: Wenn das Dialogfeld WSDL importieren über Datei > Neu > Weitere aufgerufen werden soll, müssen Sie zuerst eine Anwendung erstellen, bevor Sie diesen Befehl aktivieren können. Mit dem Befehl Komponente > WSDL importieren können Sie den Experten ohne vorherige Erstellung einer Anwendung aufrufen.

Dieses Themen bietet nur einen allgemeinen Überblick. Einzelheiten zu diesem Experten finden Sie im Thema Experte für den WSDL-Import.

Geben Sie auf der Seite WSDL-Speicherort des Experten WSDL importieren entweder den Dateinamen eines WSDL-Dokuments (oder einer XML-Datei) oder die Adresse (URL) an, unter der das WSDL- oder XML-Dokument veröffentlicht ist. Wenn sich das WSDL-Dokument auf einem Server befindet, der eine Benutzerauthentifizierung erfordert (oder wenn der Zugriff über einen Proxy-Server erfolgt, der Benutzerauthentifizierungen erfordert), kann der Experte das WSDL-Dokument erst abrufen, nachdem Sie einen Benutzernamen und ein Kennwort angegeben haben.

Sie müssen außerdem die SOAP-Version und die WSDL-Optionen für den Import im Experten auswählen. Die ausgewählten Optionen legen fest, wie beim Import Code erzeugt wird. Nach Abschluss Ihrer Auswahl und dem Klicken auf die Schaltfläche Fertig stellen zeigt das WSDL-Importprogramm den Code an, den es für diejenigen im WSDL-Dokument enthaltenen Definitionen generiert, die mit dem Web-Service-Framework kompatibel sind. Es werden also nur die Port-Typen verwendet, die eine SOAP-Bindung aufweisen.

Das WSDL-Importprogramm kann sowohl zum Erstellen von Server- als auch von Client-Anwendungen verwendet werden. Wenn Sie eine Serveranwendung erstellen, klicken Sie auf die Schaltfläche Optionen und aktivieren im angezeigten Dialogfeld die Option zum Generieren von Server-Code. Das Importprogramm erzeugt dann Implementierungsklassen für die aufrufbaren Interfaces, und Sie müssen lediglich die Methodenrümpfe vervollständigen.

Warnung: Wenn Sie zum Erstellen eines Servers ein WSDL-Dokument importieren, der einen bereits definierten Web-Service implementiert, müssen Sie dennoch Ihr eigenes WSDL-Dokument für diesen Dienst publizieren. Das importierte WSDL-Dokument kann sich geringfügig von der generierten Implementierung unterscheiden. Wenn das WSDL-Dokument oder die XML-Schemadatei Bezeichner verwendet, die gleichzeitig Schlüsselwörter darstellen, werden deren Namen vom Importprogramm automatisch geändert, so dass sich der generierte Code compilieren lässt.

Wenn Sie auf Fertig stellen klicken, erstellt das Importprogramm neue Units, die aufrufbare Interfaces für die im Dokument definierten Operationen sowie Remotable-Klassen für die im Dokument definierten Typen definieren und registrieren.

Alternativ können Sie das WSDL-Importprogramm für die Befehlszeile verwenden. Zum Erstellen einer Serveranwendung rufen Sie das Befehlszeilen-Importprogramm mit der Option -Os auf:

WSDLIMP -Os -P -V MyWSDLDoc.wsdl
WSDLIMP -Os -C -V MyWSDLDoc.wsdl

Im Fall einer Client-Anwendung rufen Sie das Programm ohne die Option -Os auf:

WSDLIMP -P -V MyWSDLDoc.wsdl
WSDLIMP -C -V MyWSDLDoc.wsdl

Tipp: Das Befehlszeilen-Importprogramm enthält einige Optionen, die für die WSDL-Importfunktion in der IDE nicht zur Verfügung stehen. Weitere Informationen dazu finden Sie in der Online-Hilfe für WSDLIMP.

Siehe auch