Ukázka Address Book - konfigurace a spuštění


Konfigurování ukázky
Spuštění ukázky

K dispozici jsou dva klienti ukázky AddressBook: verze pro prostředí J2SE (Java 2 Standard Edition) a verze pro prostředí J2EE (Java 2 Enterprise Edition) spravovaná kontejnery. Chcete-li využívat všechny výhody služeb kontejneru prostředí J2EE, spusťte verzi pro prostředí J2EE.

Konfigurování ukázky

Chcete-li dokončit konfiguraci této ukázky, implementujte aplikaci s ukázkou webových služeb JAX-RPC na serveru. Pokud ukázková aplikace dosud nebyla implementována, postupujte podle pokynů v části Opětné sestavení a implementace souboru WebServicesSamples.ear.

Spuštění ukázky

Před spouštěním klientů ověřte, že je server spuštěn.

K dispozici jsou dva klienti ukázky AddressBook: verze pro prostředí J2SE a verze pro prostředí J2EE (Java 2 Enterprise Edition) spravovaná kontejnery. Každý klient používá čtyři varianty objektu bean webové služby AddressBook implementované na serveru. Objekty bean webové služby AddressBook vracejí pevnou hodnotu a pro spuštění nevyžadují připojení k Internetu.

Spuštění jednoduchého klienta ukázky AddressBook pro prostředí J2SE
Spuštění klienta ukázky AddressBook aplikace pro prostředí J2EE

Spuštění jednoduchého klienta ukázky AddressBook pro prostředí J2SE

Klient ukázky AddressBook pro prostředí J2SE demonstruje zadávání dotazů na objekt bean webové služby AddressBook s cílem získat z webové služby adresu. Zdroj ukázky naleznete v adresáři kořen_profilu/samples/src/WebServicesSamples/Clients/simpleClients/samples/address.

Při spouštění klienta AddressBookClient musí být soubor AddressBook.wsdl umístěn v aktuálním adresáři. Extrahujte soubor AddressBook.wsdl ze souboru simpleClients.jar a umístěte je do adresáře, ve kterém chcete ukázku spouštět. Soubor simpleClients.jar naleznete v adresáři kořenový_adresář_instalacesamples/lib/WebServicesSamples.

Klient J2SE v cyklu prochází dvakrát každý objekt bean webové služby AddressBook implementovaný na serveru. V prvním cyklu klient volá metodu getPort s cílem získat jedinečný port pro každý objekt typu bean ukázkové aplikace. Klient volá pro každý port metodu getAddressFromName. Druhý cyklus může začít libovolným portem; poté je v rámci cyklu nastavena adresa koncového bodu pro každý ze čtyř možných koncových bodů. Klient volá pro každý port metodu getAddressFromName.

Další obecné pokyny pro vyvolávání klienta platformy WebSphere naleznete v tématu týkajícím se vývoje kódu tenkých aplikačních klientů v Informačním centru.

Chcete-li jednoduchého klienta ukázky AddressBook pro prostředí J2SE spustit z produktu WebSphere Application Server, proveďte následující kroky v závislosti na používaném operačním systému:

  1. Spusťte server.
  2. Otevřete příkazový řádek.
  3. Spusťte následující příkazy:

    Na platformách systému Windows:

    cd kořen_profilu\bin
    setupCmdLine
    cd kořenový_adresář_instalace\bin
    setupCmdLine

    Na platformách systémů Linux, UNIX a z/OS:

    cd kořen_profilu/bin
    . ./setupCmdLine.sh
    cd kořenový_adresář_instalace/bin
    . ./setupCmdLine.sh

    Na platformách systému iSeries:

    cd kořen_profilu/bin
    . ./setupCmdLine
    cd kořenový_adresář_instalace/bin
    . ./setupCmdLine

  4. Přejděte do adresáře obsahujícího soubor AddressBook.wsdl.
  5. Spusťte následující příkaz:

    Na platformách systému Windows:

    "%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 [<název_hostitele> <číslo_portu>]

    Na platformách systémů Linux, UNIX a z/OS:

    "$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 [<název_hostitele> <číslo_portu>]

    Na platformách systému iSeries:

    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 [<název_hostitele> <číslo_portu>]

    kde:
    <název_hostitele> je název hostitele adresy koncového bodu služby. Výchozí název hostitele je localhost.
    <číslo_portu> je číslo portu adresy koncového bodu služby. Výchozí číslo portu je 9080.

    V následujícím příkladu je uvedeno úspěšné spuštění klienta AddressBook:

    
    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
    
    

Spuštění klienta ukázky AddressBook aplikace pro prostředí J2EE

Klient AddressBook aplikace pro prostředí J2EE je podobný jednoduchému klientu AddressBook pro prostředí J2SE. Přistupuje ke stejným objektům bean webových služeb AddressBook, činí tak však z kontejneru aplikačního klienta pro prostředí J2EE pomocí příkazu launchClient.

Klient pro prostředí J2EE v cyklu prochází každý objekt bean webové služby AddressBook implementovaný na serveru. Tento klient využívá příkaz lookup rozhraní JNDI (Java Naming and Directory Interface) k vyhledávání služby AddressBook a iniciuje volání get port s cílem získat jedinečné porty pro každý ze čtyř objektů bean AddressBook. Klient volá pro každý port metodu getAddressFromName.

V následujících krocích proměnná kořenový_adresář_instalace odkazuje na kořenový adresář instalace platformy WebSphere.

Chcete-li klienta ukázky AddressBook aplikace pro prostředí J2EE spustit z produktu WebSphere Application Server, proveďte následující kroky v závislosti na používaném operačním systému:

  1. Spusťte server.
  2. Otevřete příkazový řádek.
  3. Zadejte následující příkazy:

    Na platformách systému Windows:

    cd <kořen_profilu>\bin
    setupCmdLine

    Na platformách systému Linux, UNIX a z/OS:

    cd <kořen_profilu>/bin
    . ./setupCmdLine.sh

    Na platformách systému iSeries:

    cd <kořen_profilu>/bin
    . ./setupCmdLine

    kde <kořen_profilu> představuje instalační adresář profilu.
  4. Přejděte do adresáře kořenový_adresář_instalace/samples/lib/WebServicesSamples
    kde:
    Parametr kořenový_adresář_instalace reprezentuje kořenový adresář instalace produktu WebSphere Application Server nebo kořenový adresář instalace profilu (v případě opětného sestavení ukázky).
  5. Nahraďte parametr kořenový_adresář_instalace kořenovým adresářem instalace platformy WebSphere a spusťte následující příkaz:

    Na platformách systému Windows:

    kořenový_adresář_instalace\bin\launchClient ApplicationClients.ear -CCjar=AddressBookClient.jar [<název_hostitele> <číslo_portu>]

    Na platformách systémů Linux, UNIX a z/OS:

    kořenový_adresář_instalace/bin/launchClient.sh ApplicationClients.ear -CCjar=AddressBookClient.jar [<název_hostitele> <číslo_portu>]

    Na platformách systému iSeries:

    kořenový_adresář_instalace/bin/launchClient ApplicationClients.ear -CCjar=AddressBookClient.jar [<název_hostitele> <číslo_portu>]

    kde:
    <název_hostitele> je název hostitele adresy koncového bodu služby. Výchozí název hostitele je localhost.
    <číslo_portu> je číslo portu adresy koncového bodu služby. Výchozí číslo portu je 9080.


    V následujícím příkladu je uvedeno úspěšné spuštění klienta AddressBook:

    
    C:\WebSphere\AppServer\samples>\WebSphere\AppServer\bin\launchClient
    \WebSphere\AppServer\samples\lib\WebServicesSamples\ApplicationClients.ear
    -CCjar=AddressBookClient.jar
    IBM WebSphere Application Server, verze 7.0
    J2EE Application Client Tool
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Processing command line arguments.
    WSCL0013I: Initializing the J2EE Application Client Environment.
    [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: One or more key stores are using the default password.
    WSCL0035I: Initialization of the J2EE Application Client Environment has completed.
    WSCL0014I: Invoking the Application Client class com.ibm.websphere.samples.webservices.addr.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
    
    

Další informace o práci klienta a aplikace naleznete v technických poznámkách k ukázce Address Book. Můžete si také prohlédnout zdrojový kód v jazyku Java.