JAR-Datei mit Unterstützung für Web-Service-Clients zu einer EAR-Datei assemblieren

Nachdem Sie Ihre Anwendungsartefakte generiert haben, müssen Sie diese Artefakte zu einer EAR-Datei assemblieren, die in der Web-Service-Anwendung verwendet wird.

Vorbereitende Schritte

Für JAX-WS-Web-Service-Anwendungen (Java™ API for XML-Based Web Services) benötigen Sie die portierbaren Artefakte, die vom Befehlszeilentool wsimport generiert werden, wenn für die Ausführung dieser Task eine WSDL-Datei als Ausgangspunkt verwendet wird. Das Tool wsimport verarbeitet eine WSDL-Datei als Eingabe und generiert die folgenden portierbaren Artefakte:
  • Serviceendpunktschnittstelle
  • Serviceklasse
  • Ausnahmeklassen, die über die Klasse wsdl:fault zugeordnet werden (sofern vorhanden)
  • Generierte JAXB-Typwerte (Java Architecture for XML Binding), bei denen es sich um Java-Klassen handelt, die über XML-Schematypen zugeordnet werden
  • Ein assembliertes Clientmodul, das die Implementierung, alle vom Befehlszeilentool wsimport generierten Klassen und den Implementierungsdeskriptor ejb-jar.xml oder den Implementierungsdeskriptor application-client.xml enthält. Bei diesem Modul kann es sich um eines der folgenden Module handeln:
    • Ein Anwendungsclientmodul, das die Datei META-INF/application-client.xml enthält.
    • Ein EJB-Modul (Enterprise JavaBeans), das die Datei META-INF/ejb-jar.xml enthält.
Für JAX-RPC-Web-Service-Anwendungen (Java API for XML-based RPC) benötigen Sie die folgenden Artefakte, die vom Befehlszeilentool WSDL2Java generiert werden, um diese Task auszuführen:
  • Ein assembliertes Clientmodul, das die Implementierung, alle vom Befehlszeilentool WSDL2Java generierten Klassen und den Implementierungsdeskriptor ejb-jar.xml oder den Implementierungsdeskriptor application-client.xml enthält. Bei diesem Modul kann es sich um eines der folgenden Module handeln:
    • Ein Anwendungsclientmodul, das die Datei META-INF/application-client.xml enthält.
    • Ein EJB-Modul (Enterprise JavaBeans), das die Datei META-INF/ejb-jar.xml enthält.
  • Die WSDL-Datei, die Sie für die Entwicklung des Clients verwendet haben.
  • Die Schablonen für die Implementierungsdeskriptoren ibm-webservicesclient-ext.xmi und ibm-webservicesclient-bnd.xmi, falls diese verwendet werden.
  • Ein Implementierungsdeskriptor mit einer generierten JAX-RPC-Zuordnung (Java API for XML-based Remote Procedure Call).
Einschränkung: Verwenden Sie im Namen von Dateien, die in ein Anwendungsarchiv gepackt werden, kein Nummernzeichen (#). Aufgrund der internen Verarbeitung kann der Anwendungsserver die Anwendung nicht ordnungsgemäß implementieren, wenn ein Nummernzeichen in einem Dateinamen im Anwendungsarchiv enthalten ist. Wenn dieser Fehler auftritt, kann bei der Verarbeitung der Anwendung eine Ausnahme eintreten. Außerdem können nach der Implementierung der Anwendung Teile der Anwendung fehlen. Um dieses Problem zu beheben, müssen Sie alle Dateien im Anwendungsarchiv so umbenennen, dass ihr Name kein Nummernzeichen mehr enthält.

Informationen zu diesem Vorgang

Sie können die mit WebSphere Application Server bereitgestellten Assembliertools verwenden, um Clientanwendungen mit Unterstützung für Web-Services zu assemblieren.

Führen Sie die folgenden Schritte aus, um den Clientcode und die Artefakte, die dem Client den Zugriff auf einen Web-Service ermöglichen, zu assemblieren:

Vorgehensweise

  1. Starten Sie ein Assembliertool. Informationen zum Starten des Assembliertools finden Sie in der Dokumentation zu Rational Application Developer.
  2. Konfigurieren Sie das Assembliertool, falls noch nicht geschehen, für Java EE-Module. Stellen Sie sicher, dass die Kategorien Java EE und Web aktiviert sind. Informationen zum Konfigurieren des Assembliertools finden Sie in der Dokumentation zu Rational Application Developer.
  3. Importieren Sie die Clientimplementierung und die von den Befehlszeilentools generierten Artefakte in das Assembliertool.
  4. Migrieren Sie die JAR-Dateien mit dem Assembliertool Rational Application Developer. Zum Migrieren von Dateien importieren Sie Ihre JAR-Dateien in das Assembliertool. Informationen zum Migrieren von Codeartefakten in ein Assembliertool finden Sie in der Dokumentation zu Rational Application Developer.
  5. Assemblieren Sie die JAR-Datei unter Verwendung der herkömmlichen Assemblierungsverfahren zu einer EAR-Datei, wenn der Client in einem Container ausgeführt wird.

Ergebnisse

Sie haben die Artefakte generiert, die erforderlich sind, um die Clientanwendung für Web-Services in einer EAR-Datei zu aktivieren.

Beispiel

Dieses Beispiel für die Assemblierung verwendet die WAR-Datei AddressBookClient.jar und die EAR-Datei AddressBookClient.ear:
META-INF/MANIFEST.MF 
META-INF/application-client.xml
META-INF/wsdl/AddressBook.wsdl 
META-INF/AddressBook_mapping.xml 

com/ibm/websphere/samples/webservices/addr/Address.class
com/ibm/websphere/samples/webservices/addr/AddressBook.class
com/ibm/websphere/samples/webservices/addr/AddressBookClient.class
com/ibm/websphere/samples/webservices/addr/AddressBookService.class
... weitere generierte Klassen ...
Nach der Assemblierung der Datei AddressBookClient.jar zur Datei AddressBookClient.ear enthält die Datei AddressBookClient.ear die folgenden Dateien:
META-INF/MANIFEST.MF 
AddressBookClient.jar 
META-INF/application.xml

Nächste Schritte

Für JAX-WS-Anwendungen (Java API for XML-Based Web Services) können Sie jetzt die Web-Service-Clientanwendung implementieren.

Für JAX-RPC-Anwendungen (Java API for XML-based RPC) müssen Sie die Bindungen für den Clientimplementierungsdeskriptor mit einem Assembliertool so konfigurieren, dass der Client mit einem in einem Server implementierten Web-Service kommunizieren kann.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_assembclient
Dateiname:twbs_assembclient.html