Sie können einen über HTTP zugänglichen JAX-RPC-Web-Service (Java API for XML-based Remote Procedure Call)
entwickeln, wenn Sie bereits ein JavaBeans-Objekt haben, das Sie als Web-Service aktivieren können.
Vorbereitende Schritte
Wählen Sie den neuen Befehl
Java2WSDL aus, um
eine WSDL-Datei (Web Services Description Language) zu erstellen. Wenn Sie den Befehl
Java2WSDL ausführen, verwenden Sie die Option
"-bindingsTypes" zusammen mit
http, um die HTTP-Transportbindungen festzulegen. Beispiel:
java2wsdl -bindingTypes http,jms -implClass my.pkg.MyEJBClass my.pkg.MySEI
Weitere
Informationen zur Verwendung des Befehls
Java2WSDL finden Sie in der Dokumentation zum Befehl "Java2WSDL"
für JAX-RPC-Anwendungen.
Das Befehlszeilentool
Java2WSDL
wird auf der Plattform z/OS nicht unterstützt. Diese Funktionalität wird von den
Assembliertools, die in der z/OS-Version des Produkts enthalten sind, bereitgestellt. Weitere Informationen zu diesem Tool
finden Sie in der Beschreibung des Befehlszeilentools Java2WSDL
für JAX-RPC-Anwendungen (Java API for XML-based Remote Procedure Call).
Informationen zu diesem Vorgang
Der Anwendungsserver
unterstützt die Verwendung von HTTP für den Transport von
Web-Service-Clientanforderungen. Mit HTTP können Ihre Web-Service-Clients und
-Server über SOAP-Nachrichten kommunizieren. SOAP ist das zugrunde liegende
Übertragungsprotokoll, das in Web-Services verwendet wird, die die
Spezifikationen Java EE (Java Platform,
Enterprise Edition) und JAX-RPC (Java API for XML-based Remote Procedure Call)
unterstützen.
HTTP wird als Transport für Web-Services am häufigsten verwendet.
Gehen
Sie wie folgt vor, um einen Web-Service, auf den mit HTTP zugegriffen werden kann, über
ein vorhandenes JavaBeans-Objekt zu entwickeln:
- Fügen Sie eine HTTP-Bindung und eine SOAP-Adresse zur WSDL-Datei hinzu.
Die WSDL-Datei eines Web-Service muss eine HTTP-Bindung und eine SOAP-Adresse
enthalten, die eine Zeichenfolge für einen HTTP-Endpunkt-URL angibt, damit der Zugriff
per HTTP-Transport möglich wird. Eine HTTP-Bindung ist ein Element vom Typ "wsdl:binding", das ein Element
"wsdlsoap:binding" mit einem auf soap/http endenden Transportattribut enthält.
Neben der HTTP-Bindung muss ein Element "wsdl:port", das eine HTTP-Bindung referenziert,
in das Element "wsdl:service" innerhalb der WSDL-Datei aufgenommen werden. Das
Element "wsdl:port" enthält ein wsdlsoap:address-Element mit einem Positionsattribut, das
einen HTTP-Endpunkt-URL angibt.
Wenn Sie den Web-Service entwickeln, können Sie einen Platzhalter wie file:unspecified_location
für die Endpunkt-URL-Zeichenfolge verwenden.
- Fügen Sie die HTTP-Endpunkte mit dem Befehl endptEnabler zu Ihrer EAR-Datei (Unternehmensarchiv) hinzu, wenn Ihre Anwendung
Enterprise-Beans enthält.
Standardmäßig fügt der Befehl endptEnabler nur HTTP-Endpunkte hinzu.
- Implementieren Sie die Web-Service-Anwendung.
- Konfigurieren Sie die Sicherheit für die HTTP-Verbindung.
Um eine sichere HTTP-Verbindung zu erhalten, fügen Sie für eine sichere HTTP-Verbindung
die Assembliereigenschaft "basicAuth" zur Implementierungsdeskriptordatei ibm-webservicesclient-bnd.xmi hinzu. Legen
Sie die Attribute für die Benutzer-ID und das Kennwort fest.
- Konfigurieren Sie die
Endpunkt-URL-Informationen für HTTP-Bindungen.
Der WSDL-Herausgeber
(Publisher) verwendet diesen Abschnitt der URL-Zeichenfolge, um für jede in der
EJB-Datei definierte Portkomponente den tatsächlichen HTTP-URL zu erzeugen. Die
veröffentlichte WSDL-Datei kann von Clients, die den Web-Service aufrufen müssen,
verwendet werden.