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

Vor der Erstellung eines Web-Service müssen Sie die folgenden Voraussetzungen erfüllen:

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:
    1. Klicken Sie mit der rechten Maustaste auf die importierte XML-Datei für die Web-Service-Generierung und wählen Sie Ausführen als > Ant-Erstellung aus.
    2. Klicken Sie im Dialogfenster auf das Register JRE und wählen Sie In gleicher JRE wie Arbeitsbereich ausführen.
    3. 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.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tantjavajaxws.html