Address Book - Konfiguration und Ausführung


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.

Beispiel konfigurieren

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.

Beispiel ausführen

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

Den einfachen J2SE-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:

  1. Starten Sie den Server.
  2. Öffnen Sie eine Eingabeaufforderung.
  3. Setzen Sie die folgenden Befehle ab:

    Auf Windows-Plattformen:

    cd Profilstammverzeichnis\bin
    setupCmdLine
    cd Installationsstammverzeichnis\bin
    setupCmdLine

    Auf Linux-, UNIX- und z/OS-Plattformen:

    cd Profilstammverzeichnis/bin
    . ./setupCmdLine.sh
    cd Installationsstammverzeichnis/bin
    . ./setupCmdLine.sh

    Auf iSeries-Plattformen:

    cd Profilstammverzeichnis/bin
    . ./setupCmdLine
    cd Installationsstammverzeichnis/bin
    . ./setupCmdLine

  4. Wechseln Sie in das Verzeichnis mit der Datei AddressBook.wsdl.
  5. Setzen Sie den folgenden Befehl ab:

    Auf Windows-Plattformen:

    "%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 [<Hostname> <Portnummer>]

    Auf Linux-, UNIX- und z/OS-Plattformen:

    "$JAVA_HOME/bin/java" $WAS_LOGGING -classpath "$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 [<Hostname> <Portnummer>]

    Auf iSeries-Plattformen:

    java $JAVA_PARM -classpath "$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 [<Hostname> <Portnummer>]

    Für diese Befehle gilt Folgendes:
    <Hostname> steht für den Hostnamen der Service-Endpoint-Adresse. Der Standardhostname ist localhost.
    <Port-Nummer> steht für die Port-Nummer der Service-Endpoint-Adresse. Die Standard-Port-Nummer ist 9080.

    Das folgende Beispiel zeigt die erfolgreiche Ausführung des AddressBook-Clients:

    
    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
    
    

Den J2EE-AddressBook-Client ausführen

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:

  1. Starten Sie den Server.
  2. Öffnen Sie eine Eingabeaufforderung.
  3. Geben Sie die folgenden Befehle ein:

    Auf Windows-Plattformen:

    cd <Profilstammverzeichnis>\bin
    setupCmdLine

    Auf Linux-, UNIX- und z/OS-Plattformen:

    cd <Profilstammverzeichnis>/bin
    . ./setupCmdLine.sh

    Auf iSeries-Plattformen:

    cd <Profilstammverzeichnis>/bin
    . ./setupCmdLine

    <Profilstammverzeichnis> steht für das Installationsverzeichnis des Profils.
  4. Wechseln Sie in das Verzeichnis Installationsstammverzeichnis/samples/lib/WebServicesSamples.
    wobei:
    Installationsstammverzeichnis steht für das Installationsstammverzeichnis von WebSphere Application Server oder das Installationsstammverzeichnis des Profils, falls das Beispiel erneut erstellt wird.
  5. Ersetzen Sie Installationsstammverzeichnis durch das Installationsstammverzeichnis von WebSphere und setzen Sie den folgenden Befehl ab:

    Auf Windows-Plattformen:

    Installationsstammverzeichnis\bin\launchClient ApplicationClients.ear -CCjar=AddressBookClient.jar [<Hostname> <Port-Nummer>]

    Auf Linux-, UNIX- und z/OS-Plattformen:

    Installationsstammverzeichnis/bin/launchClient.sh ApplicationClients.ear -CCjar=AddressBookClient.jar [<Hostname> <Port-Nummer>]

    Auf iSeries-Plattformen:

    Installationsstammverzeichnis/bin/launchClient ApplicationClients.ear -CCjar=AddressBookClient.jar [<Hostname> <Port-Nummer>]

    Für diese Befehle gilt Folgendes:
    <Hostname> steht für den Hostnamen der Service-Endpoint-Adresse. Der Standardhostname ist localhost.
    <Port-Nummer> steht für die Port-Nummer der Service-Endpoint-Adresse. Die Standard-Port-Nummer ist 9080.


    Das folgende Beispiel zeigt die erfolgreiche Ausführung des AddressBook-Clients:

    
    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".