Java-Web-Service für die IBM WebSphere-JAX-WS-Laufzeitumgebung mit Ant-Tasks erstellen
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
- 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
- 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.
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.