Sie können eine Ant-Task anstelle der Web-Service-Assistenten verwenden, um einen
Java™-Web-Service für die
IBM® WebSphere-JAX-WS-Laufzeitumgebung zu generieren.
Ant-Tasks unterstützen die Bottom-up- und die Bottom-up-Top-down-Entwicklung von Web-Services.
Vorbereitende Schritte
Vor der Erstellung eines Web-Service müssen Sie die folgenden Voraussetzungen erfüllen:
- Erstellen Sie einen Server und ein Webprojekt für Ihren Web-Service. Diesbezügliche Informationen finden Sie unter JAX-WS-fähigen WebSphere-Server erstellen.
- Importieren Sie die Ant-Task und die Eigenschaftendateien in Ihren Arbeitsbereich. Diesbezügliche Informationen finden Sie unter Ant-Dateien für Ihren JAX-WS-Web-Service importieren.
- Passen Sie den Ant-Eigenschaftendateien für Ihren Web-Service an:
- Erstellen Sie je nach Typ des zu erstellenden Web-Services Dateien in einem Ordner des Webprojekts, das Sie erstellt haben, oder importieren Sie Dateien
in diesen Ordner:
- Wenn Sie einen Bottom-up-Service erstellen möchten, erstellen Sie eine Bean im Ordner
src oder importieren Sie eine Bean in diesen Ordner.
- Wenn Sie einen Top-down-Service erstellen möchten, suchen oder erstellen Sie eine WSDL-Datei oder importieren Sie eine WSDL-Datei
in das Projekt, das Sie erstellt haben.
Informationen zu diesem Vorgang
Zum Erstellen des Web-Service ändern Sie die Ant-Eigenschaftendatei des Service.
Der Name der Ant-Eigenschaftendatei richtet sich nach dem Typ des Web-Service, den Sie erstellen möchten:
- Wenn Sie einen Bottom-up-Service erstellen möchten, ist der Name der Ant-Eigenschaftendatei was_jaxws_bujava.properties.
- Wenn Sie einen Top-down-Service erstellen möchten, ist der Name der Ant-Eigenschaftendatei was_jaxws_tdjava.properties.
- Wenn Sie einen Client erstellen möchten, ist der Name der Ant-Eigenschaftendatei
was_jaxws_client.properties.
Vorgehensweise
Führen Sie Ihre Ant-Task aus. - Wenn Sie die Task im Produktarbeitsbereich ausführen möchten, gehen Sie wie folgt vor:
- Klicken Sie mit der rechten Maustaste auf die importierte XML-Datei für die Web-Service-Generierung und wählen Sie
aus.
- Klicken Sie im Dialogfenster auf das Register JRE und wählen Sie
In gleicher JRE wie Arbeitsbereich ausführen.
- Klicken Sie auf Anwenden und dann auf Ausführen.
Nach der Generierung des Web-Service wird in der Konsole oder Befehlszeile die Nachricht
BUILD ERFOLGREICH angezeigt.
Ergebnisse
Bei der Generierung Ihres Web-Service werden je nach ausgewählten Optionen und Typ des generierten Web-Service die folgenden Dateien erstellt:
- Top-down: Serviceendpunktschnittstelle. Die Serviceendpunktschnittstelle ist die annotierte
Java-Darstellung der WSDL-Datei für den Web-Service. Diese Schnittstelle
wird für die Implementierung der JavaBeans-Endpunkte oder die Erstellung
von Instanzen des dynamischen Proxy-Clients verwendet. Datentypreferenzen in der Serviceendpunktschnittstelle.
- Bottom-up: Die Stellvertreterklasse. Diese Klasse ist ein Wrapper, der alle Methoden aus der Bean und die JAX-WS-Annotation enthält, die die Laufzeitumgebung als Web-Service erkennt.
Wenn Sie bereits eine Bean mit der Annotation "@javax.jws.WebService" haben, bevor Sie die Ant-Task ausführen, wird diese Bean unverändert verwendet, und es werden keine neuen Annotationen hinzugefügt.
- Wrapperklassen für Anforderungen/Antworten/Ausnahmen
Tipp: Die Datei
wsant.bat
wird im Verzeichnis
bin des Produkts installiert.
Auf einigen Systemen kann dieses Verzeichnis schreibgeschützt sein. In diesen Fällen kann die Ant-Task die Ausgabe nicht erstellen, und die Erstellung des Web-Service
schlägt fehl.
Dieses Problem kann auf zwei Arten behoben werden:
- Setzen Sie die Anweisung PATH so, dass sie auf den Ordner bin verweist, wechseln Sie in ein Verzeichnis, für das Sie Schreibberechtigung
haben und führen Sie das Script dort aus.
- Kopieren Sie die Datei wsant.bat in ein beschreibbares Verzeichnis.