JAX-RPC-Web-Services |
|
|
![]() |
|
Konfiguration und Ausführung | Technische Informationen | Javadoc | Eigenen Build erstellen - Ant |
Beispiel konfigurieren |
Beispiel ausführen |
Es sind zwei AddressBook-Clients verfügbar: eine J2SE-Version (Java 2 Standard Edition) und eine containergesteuerte J2EE-Version (Java 2 Enterprise Edition). Wenn Sie alle Vorteile der J2EE-Containerservices nutzen möchten, führen Sie die J2EE-Version aus.
Zur Konfiguration des Beispiels implementieren Sie die Anwendung "JAX-RPC Web services Sample" im Server. Falls die Beispielanwendung noch nicht implementiert wurde, ziehen Sie die Anweisungen zum erneuten Erstellen und Implementieren der Datei WebServicesSamples.ear zu Rate.
Vergewissern Sie sich, dass der Server gestartet ist, bevor Sie die Clients ausführen.
Es sind zwei AddressBook-Clients vorhanden: eine externe J2SE-Version und eine containergesteuerte J2EE-Version (Java 2 Enterprise Edition). Jeder Client verwendet die vier Varianten der Web-Service-Bean "AddressBook", die im Server implementiert sind. Die Web-Service-Beans "AddressBook" geben einen festen Wert zurück und benötigen keine aktive Internet-Verbindung.
Den einfachen J2SE-AddressBook-Client ausführen |
Den J2EE-AddressBook-Client ausführen |
Der J2SE-AddressBook-Client veranschaulicht, wie die Web-Service-Bean "AddressBook" abgefragt wird, um eine Adresse vom Web Service zu erhalten. Sie finden den Quellcode im Verzeichnis Profilstammverzeichnis/samples/src/WebServicesSamples/Clients/simpleClients/samples/address.
Die Datei AddressBook.wsdl muss im aktuellen Verzeichnis gespeichert sein, wenn Sie den AddressBook-Client ausführen. Extrahieren Sie die Datei AddressBook.wsdl aus der Datei simpleClients.jar und speichern Sie sie in dem Verzeichnis, in dem Sie das Beispiel ausführen möchten. Sie finden die Datei simpleClients.jar im Verzeichnis Installationsstammverzeichnissamples/lib/WebServicesSamples.
Der J2SE-Client führt zwei Schleifen durch jede der Web-Service-Beans "AddressBook" durch, die im Server implementiert sind. In der ersten Schleife ruft der Client die Methode getPort auf, um einen eindeutigen Port für jede Bean der Beispielanwendung zu erhalten. Für jeden Port ruft der Client die Methode getAddressFromName auf. Die zweite Schleife beginnt bei einem der Ports und setzt dann nacheinander für alle Ports seine Endpoint-Adresse auf jeden der vier möglichen Endpoints. Für jeden Port ruft der Client die Methode getAddressFromName auf.
Allgemeinere Anweisungen zum Aufrufen eines WebSphere-Clients finden Sie im Artikel über die Entwicklung von Thin-Application-Client-Code im InfoCenter.
Führen Sie die im Folgenden beschriebenen und für Ihr Betriebssystem gültigen Anweisungen zum Ausführen
des einfachen J2SE-AddressBook-Clients aus:
C:\>"%JAVA_HOME%\bin\java" %WAS_LOGGING% -classpath "%WAS_CLASSPATH%;%WAS_HOME%\samples\lib\WebServicesSamples\simpleClients.jar;%WAS_HOME%\runtimes\com.ibm.ws.webservices.thinclient_7.0.0.jar" samples.address.AddressBookClient >> Querying address for 'Purdue Boilermaker' using port AddressBookW2JE >> Response is: 1 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Querying address for 'Purdue Boilermaker' using port AddressBookJ2WE >> Response is: 2 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Querying address for 'Purdue Boilermaker' using port AddressBookJ2WB >> Response is: 3 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Querying address for 'Purdue Boilermaker' using port AddressBookW2JB >> Response is: 4 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> >> Get port AddressBookJ2WB >> Set port AddressBookJ2WB's endpoint to http://localhost:9080/AddressBookW2JE/services/AddressBook >> Querying address for 'Purdue Boilermaker' >> Response is: 1 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Set port AddressBookJ2WB's endpoint to http://localhost:9080/AddressBookJ2WE/services/AddressBook >> Querying address for 'Purdue Boilermaker' >> Response is: 2 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Set port AddressBookJ2WB's endpoint to http://localhost:9080/AddressBookJ2WB/services/AddressBook >> Querying address for 'Purdue Boilermaker' >> Response is: 3 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Set port AddressBookJ2WB's endpoint to http://localhost:9080/AddressBookW2JB/services/AddressBook >> Querying address for 'Purdue Boilermaker' >> Response is: 4 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 |
Der J2EE-AddressBook-Client gleicht dem einfachen J2SE-AddressBook-Client. Er greift auf dieselben Web-Service-Beans "AddressBook" zu, führt hierfür aber den Befehl "launchClient" in einem J2EE-Anwendungsclientcontainer aus.
Der J2EE-Client führt eine Schleife durch jede der Web-Service-Beans "AddressBook" durch, die im Server implementiert sind. Dieser Client verwendet den JNDI-Befehl lookup, um den Service "AddressBook" zu suchen und setzt Aufrufe zum Anfordern von Ports ab, um eindeutige Ports für jede der vier AddressBook-Beans zu erhalten. Für jeden Port ruft der Client die Methode getAddressFromName auf.
In den folgenden Schritten steht die Variable Installationsstammverzeichnis für das Installationsstammverzeichnis von WebSphere.
Führen Sie die im Folgenden beschriebenen und für Ihr Betriebssystem gültigen
Schritte aus, um den AddressBook-Client der J2EE-Anwendung unter WebSphere
Application Server auszuführen:
C:\WebSphere\AppServer\samples>\WebSphere\AppServer\bin\launchClient \WebSphere\AppServer\samples\lib\WebServicesSamples\ApplicationClients.ear -CCjar=AddressBookClient.jar IBM WebSphere Application Server, Release 7.0 J2EE Application Client Tool Copyright IBM Corp., 1997-2008 WSCL0012I: Die Befehlszeilenparameter werden verarbeitet. WSCL0013I: Die Umgebung des J2EE Application Client wird initialisiert. [3/29/06 14:47:51:062 CST] 0000000a W UOW=null source=com.ibm.ws.ssl.config.SSLConfig org=IBM prod=WebSphere component=Application Server thread=[P=269328:O=0:CT] CWPKI0041W: Mindestens ein Keystore verwendet das Standardkennwort. WSCL0035I: Die Initialisierung der Umgebung des J2EE Application Client ist abgeschlossen. WSCL0014I: Der Application Client com.ibm.websphere.samples.webservices.addr.AddressBookClient wird aufgerufen. >> Querying address for 'Purdue Boilermaker' using port AddressBookW2JE >> Response is: 1 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Querying address for 'Purdue Boilermaker' using port AddressBookJ2WE >> Response is: 2 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Querying address for 'Purdue Boilermaker' using port AddressBookJ2WB >> Response is: 3 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 >> Querying address for 'Purdue Boilermaker' using port AddressBookW2JB >> Response is: 4 University Drive West Lafayette, IN 47907 Phone: (765) 555-4900 |
Nähere Informationen darüber, wie der Client und die Anwendung funktionieren, finden Sie in den technischen Informationen und im Java-Quellcode des Beispiels "AddressBook".