Address Book - Beállítás és futtatás


A példa beállítása
A példa futtatása

Két AddressBook ügyfél létezik, egy Java 2 Standard Edition (J2SE) változat és egy Java 2 Enterprise Edition (J2EE) tárolókezelésű változat. Ha a J2EE tároló szolgáltatások minden előnyét élvezni akarja, akkor futtassa a J2EE változatot.

A példa beállítása

A példa beállításának végrehajtásához telepítse a kiszolgálóra a JAX-RPC webszolgáltatások példa alkalmazást. Ha a példa alkalmazás még nincs telepítve, akkor kövesse a WebServicesSamples.ear fájl újraépítése és telepítése című rész utasításait.

A példa futtatása

Az ügyfelek futtatása előtt ellenőrizze, hogy a kiszolgáló elindult.

Két AddressBook ügyfél létezik, egy J2SE külső változat és egy Java 2 Enterprise Edition (J2EE) tárolókezelésű változat. Minden egyes ügyfél gyakorolja az AddressBook Web Service komponensnek a kiszolgálóra telepített négy változatát. Az AddressBook Web Service komponensek rögzített értékkel térnek vissza és futtatásuk nem igényel internet-kapcsolatot.

A J2SE egyszerű AddressBook ügyfél futtatása
A J2EE alkalmazás AddressBook ügyfél futtatása

A J2SE egyszerű AddressBook ügyfél futtatása

A J2SE AddressBook ügyfél bemutatja a Web Service AddressBook komponensből történő lekérdezést a Web Service szolgáltatásból cím megszerzése érdekében. A forrása a profil_gyökér/samples/src/WebServicesSamples/Clients/simpleClients/samples/address könyvtárban található.

Az AddressBook.wsdl fájlnak az aktuális könyvtárban kell lennie az AddressBookClient futtatásakor. Csomagolja ki az AddressBook.wsdl fájlt a simpleClients.jar fájlból és helyezze abba a könyvtárba, ahonnan tervezi a példák futtatását. A simpleClients.jar fájl a telepítés_gyökér/samples/lib/WebServicesSamples könyvtárban található.

A J2SE ügyfél kétszer fut le a kiszolgálóra telepített minden egyes AddressBook Web Service komponensen. Az első ciklus során az ügyfél meghívja a getPort metódust, hogy a példa alkalmazás minden egyes komponenséhez egyedi portot szerezzen. Az ügyfél meghívja a getAddressFromName metódust minden egyes porton. A második ciklus önkényesen az egyik porttal indul, majd végigvonul és a négy lehetséges végpont mindegyikéhez beállítja a végpont címet. Az ügyfél meghívja a getAddressFromName metódust minden egyes porton.

A WebSphere ügyfél meghívásával kapcsolatos további általános útmutatásért forduljon az Információs központban található témakörhöz a vékony alkalmazásügyfél kód fejlesztéséről.

A J2SE egyszerű AddressBook ügyfél futtatásához a WebSphere Application Server kiszolgálóról az operációs rendszernek megfelelően tegye a következőket:

  1. Indítsa el a kiszolgálót.
  2. Parancssor megnyitása.
  3. Adja ki a következő parancsokat:

    Windows platformokon:

    cd profil_gyökér\bin
    setupCmdLine
    cd telepítő_gyökér\bin
    setupCmdLine

    Linux, UNIX és z/OS platformokon:

    cd profil_gyökér/bin
    . ./setupCmdLine.sh
    cd telepítő_gyökér/bin
    . ./setupCmdLine.sh

    iSeries platformokon:

    cd profil_gyökér/bin
    . ./setupCmdLine
    cd telepítő_gyökér/bin
    . ./setupCmdLine

  4. Lépjen be az AddressBook.wsdl fájlt tartalmazó könyvtárba.
  5. Adja ki a következő parancsot:

    Windows platformokon:

    "%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 [<hosztnév> <portszám>]

    Linux, UNIX és z/OS platformokon:

    "$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 [<hosztnév> <portszám>]

    iSeries platformokon:

    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 [<hosztnév> <portszám>]

    ahol:
    A <hoszt_név> a szolgáltatás végpont címének hosztneve. Az alapértelmezett hosztnév a helyihoszt.
    A <port_szám> a szolgáltatás végpont címének portszáma. Az alapértelmezett portszám a 9080.

    Az alábbi példa az AddressBook ügyfél egy sikeres futtatását mutatja:

    
    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
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookW2JE port használatával
    >>A válasz:
    	1 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookJ2WE port használatával
    >>A válasz:
    	2 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookJ2WB port használatával
    >>A válasz:
    	3 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookW2JB port használatával
    >>A válasz:
    	4 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >>
    >> Az AddressBookJ2WB port megszerzése
    >> Az AddressBookJ2WB port végpontjának beállítása: http://helyihoszt:9080/AddressBookW2JE/services/AddressBook
    >> A 'Purdue Boilermaker' címének lekérdezése
    >>A válasz:
    	1 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> Az AddressBookJ2WB port végpontjának beállítása: http://helyihoszt:9080/AddressBookJ2WE/services/AddressBook
    >> A 'Purdue Boilermaker' címének lekérdezése
    >>A válasz:
    	2 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> Az AddressBookJ2WB port végpontjának beállítása: http://helyihoszt:9080/AddressBookJ2WB/services/AddressBook
    >> A 'Purdue Boilermaker' címének lekérdezése
    >>A válasz:
    	3 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> Az AddressBookJ2WB port végpontjának beállítása: http://helyihoszt:9080/AddressBookW2JB/services/AddressBook
    >> A 'Purdue Boilermaker' címének lekérdezése
    >>A válasz:
    	4 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    
    

A J2EE alkalmazás AddressBook ügyfél futtatása

A J2EE alkalmazás AddressBook ügyfél hasonló a J2SE egyszerű AddressBook ügyfélhez. Ugyanazokat az AddressBook webszolgáltatás komponenseket éri el, de ezt egy J2EE alkalmazás ügyféltárolóból teszi, a launchClient parancs használatával.

A J2EE ügyfél végigvonul minden egyes AddressBook Web Service komponensen, amely telepítve van a kiszolgálóra. Ez az ügyfél egy Java Naming and Directory Interface (JNDI) lookup parancsot használ az AddressBook szolgáltatás megkereséséhez és get port hívásokat végez annak érdekében, hogy egyedi portokat szerezzen a négy AddressBook komponens mindegyikének. Az ügyfél meghívja a getAddressFromName metódust minden egyes porton.

Az alábbi lépésekben a telepítő_gyökér változó a WebSphere telepítési gyökérre vonatkozik.

A J2EE alkalmazás AddressBook ügyfélnek a WebSphere Application Server kiszolgálóról történő futtatásához az operációs rendszernek megfelelően tegye a következőket:

  1. Indítsa el a kiszolgálót.
  2. Parancssor megnyitása.
  3. Írja be a következő parancsokat:

    Windows platformokon:

    cd <profil_gyökér>\bin
    setupCmdLine

    Linux, UNIX és z/OS platformokon:

    cd <profil_gyökér>/bin
    . ./setupCmdLine.sh

    iSeries platformokon:

    cd <profil_gyökér>/bin
    . ./setupCmdLine

    ahol a <profil_gyökér> a profil telepítési könyvtárát képviseli.
  4. Lépjen be a telepítő_gyökér/samples/lib/WebServicesSamples könyvtárba,
    A
    telepítő_gyökér a WebSphere Application Server telepítési gyökere, vagy a profil telepítési gyökér, amennyiben a példa újraépített.
  5. Cserélje le a telepítő_gyökér könyvtárat WebSphere telepítő gyökerére és adja ki a következő parancsot:

    Windows platformokon:

    telepítő_gyökér\bin\launchClient ApplicationClients.ear -CCjar=AddressBookClient.jar [<hoszt_név> <port_szám>]

    Linux, UNIX és z/OS platformokon:

    telepítő_gyökér/bin/launchClient.sh ApplicationClients.ear -CCjar=AddressBookClient.jar [<hoszt_név> <port_szám>]

    iSeries platformokon:

    telepítő_gyökér/bin/launchClient ApplicationClients.ear -CCjar=AddressBookClient.jar [<hoszt_név> <port_szám>]

    ahol:
    A <hoszt_név> a szolgáltatás végpont címének hosztneve. Az alapértelmezett hosztnév a helyihoszt.
    A <port_szám> a szolgáltatás végpont címének portszáma. Az alapértelmezett portszám a 9080.


    Az alábbi példa az AddressBook ügyfél egy sikeres futtatását mutatja:

    
    C:\WebSphere\AppServer\samples>\WebSphere\AppServer\bin\launchClient \WebSphere\AppServer\samples\lib\WebServicesSamples\ApplicationClients.ear -CCjar=AddressBookClient.jar
    IBM WebSphere Application Server, 7.0 kiadás
    J2EE Application Client eszköz
    Copyright IBM Corp., 1997-2008
    WSCL0012I: Parancssori paraméterek feldolgozása.
    WSCL0013I: A J2EE Application Client Environment inicializálása.
    [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: Legalább egy kulcstároló az alapértelmezett jelszót használja.
    WSCL0035I: A J2EE Application Client Environment inicializálása befejeződött.
    WSCL0014I: Az Application Client osztály meghívása com.ibm.websphere.samples.webservices.addr.AddressBookClient
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookW2JE port használatával
    >>A válasz:
    	1 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookJ2WE port használatával
    >>A válasz:
    	2 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookJ2WB port használatával
    >>A válasz:
    	3 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    >> A 'Purdue Boilermaker' címének lekérdezése az AddressBookW2JB port használatával  
    >>A válasz:
    	4 University Drive
    	West Lafayette, IN 47907
    	Telefon: (765) 555-4900
    
    

Az ügyfél és az alkalmazás működésének módjáról többet megtudhat, ha az Address Book technikai jegyzeteihez fordul és megtekinti a Java forráskódot.