Ping
és Echo - konfigurálás
|
 |
A Ping és Echo példák két egyszerű JAX-WS webszolgáltatás.
A Ping példa egyutas műveletet mutat be. A program a szolgáltatás számára egy
egyszerű karaktersorozat értéket ad át. Az ügyfélművelet teljes, miután az felvette
a kapcsolatot a szolgáltatással. A mintában két végpont szerepel. Az egyik végpont
SOAP 1.1, a másik SOAP 1.2 protokollt használ.
Az Echo példa kétutas műveletet mutat be. A program a szolgáltatás számára egy
egyszerű karaktersorozat értéket ad át. A szolgáltatás egy azonosító
karaktersorozatot fűz annak elejére, majd visszaküldi ezt az értéket az ügyfélhez.
A
példában két végpont található. Az egyik végpont SOAP 1.1, a másik SOAP 1.2
protokollt használ. Az Echo példa bemutatja a szinkron és aszinkron programozási
modelleket is, valamint a szinkron és aszinkron viselkedést is:
- Szinkron: Az ügyfél megvárja a szolgáltatás válaszát.
- Aszinkron szinkron kommunikációval: A szolgáltatás ügyfele nem várja meg a szolgáltatás válaszát. Visszahívási metódus biztosított. A szolgáltatás válaszakor a
visszahívási metódus meghívásával kezelhető a válasz karaktersorozata. A
kommunikáció azonban továbbra is szinkron módú.
- Aszinkron aszinkron kommunikációval: A szolgáltatás ügyfele nem várja meg a szolgáltatás válaszát. Visszahívási metódus biztosított. A szolgáltatás válaszakor a
visszahívási metódus meghívásával kezelhető a válasz karaktersorozata. A
szolgáltatás nem ugyanazon a csatornán lép kapcsolatba az ügyféllel, mint amit az
ügyfél használt arra, hogy kapcsolatba lépjen a szolgáltatással.
Példa szolgáltatásvégpontok
URI |
Leírás |
http://localhost:9080/WSSampleSei/PingService
|
Ping szolgáltatáspélda SOAP 1.1 használatával
|
http://localhost:9080/WSSampleSei/PingService12
|
Ping szolgáltatáspélda SOAP 1.2 használatával |
http://localhost:9080/WSSampleSei/EchoService
|
Echo szolgáltatáspélda SOAP 1.1 használatával |
http://localhost:9080/WSSampleSei/EchoService12
|
Echo szolgáltatáspélda SOAP 1.2 használatával |
A 9080 port az alapértelmezett érték; más lesz azonban a
portszám, ha egy AppSrv01
profiltól eltérő profilba végzi a telepítést.
A Ping és Echo példa beállításának végrehajtásához telepítse a kiszolgálóra a
Jax-WS webszolgáltatások példa alkalmazást. Ha a mintaalkalmazás még nincs
telepítve, akkor tekintse meg az útmutatásokat a című részben.
Az ügyfelek futtatása előtt ellenőriznie kell, hogy az alkalmazáskiszolgáló fut-e.
A Ping és Echo példa két szolgáltatást tartalmaz (Ping és Echo).
A Ping példa egyutas szolgáltatás-tranzakciót mutat be. A példa forrása a profil_gyökér/samples/src/JaxWSServicesSamples/SampleClientSei könyvtárban található.
Az Echo példa kétutas szolgáltatás-tranzakciót mutat be. A példa forrása a profil_gyökér/samples/src/JaxWSServicesSamples/SampleClientSei könyvtárban található.
A Ping és Echo ügyfél szervlet futtatásához WebSphere Application Server
alkalmazásból tegye a következőket:
- Indítsa el a kiszolgálót.
- Kattintson a Futtatás gombra.
A Ping és Echo vékony ügyfél példa hasonló a Ping és Echo ügyfél szervlethez. Ez a példa ugyanazokat a Ping és Echo webszolgáltatás komponenseket éri
el, de a Java archívum (JAR) fájlt használja, amelynek szüksége van a Thin Client for
JAX-WS with WebSphere Application JAR fájlra az osztályútvonalon.
A WSSampleClientSei.jar fájl a samples/lib/JaxWSServicesSamples könyvtárban található.
A Ping és Echo vékony ügyfél példa JAX-WS proxyt hoz létre a Ping vagy Echo webszolgáltatáshoz a megadott paraméterek alapján. A proxy ezután egy üzenetet küld
a szolgáltatásvégponthoz. Az Echo példa megvárja a választ.
A következő lépésekben az alk_kiszolgáló_gyökér változó az
alkalmazáskiszolgáló telepítési gyökérkönyvtárát jelenti.
Ha egy WebSphere Application Server kiszolgálóról kívánja futtatni a Ping és Echo vékony ügyfelet, akkor hajtsa végre a következő lépéseket az operációs rendszer alapján.
- Indítsa el a kiszolgálót.
- Parancssor megnyitása.
- Lépjen be a JaxWSServicesSamples könyvtárba.
Windows operációs rendszereken:
cd
alk_kiszolgáló_gyökér\samples\bin\JaxWSServicesSamples
AIX, Linux és z/OS operációs rendszereken:
cd
alk_kiszolgáló_gyökér/samples/bin/JaxWSServicesSamples
iSeries operációs rendszereken:
cd
alk_kiszolgáló_gyökér/samples/bin/JaxWSServicesSamples
- A Ping és Echo vékony ügyfél példa futtatása.
Windows operációs rendszereken:
runSampleSei.bat -h hosztnév -p
port -f urlUtótag -m tesztÜzenet -s
szolgáltatás -t időtúllépés -w aszinkVezeték -c
szám -1 -2
AIX, Linux és z/OS operációs rendszereken:
./runSampleSei.sh -h hosztnév -p
port -f urlUtótag -m tesztÜzenet -s
szolgáltatás -t időtúllépés -w aszinkVezeték -c
szám -1 -2
iSeries operációs rendszereken:
./runSampleSei -h hosztnév -p port
-f urlUtótag -m tesztÜzenet -s szolgáltatás
-t időtúllépés -w aszinkVezeték -c szám -1
-2
A paraméterek a következők:
-h <hosztnév> a hoszt neve. Az alapértelmezett a localhost.
-p <port> a portszám. Az alapértelmezett érték 9080.
-f <urlUtótag> a szolgáltatási végpont kontextusa.
Az alapértelmezés /WSSampleSei/EchoService.
-m <tesztÜzenet> az üzenet szövege.
Az alapértelmezés hello. Tegye idézőjelbe az üzenetet, ha az szóközöket tartalmaz.
-c szám a futtatandó tranzakciók számát adja meg. Az alapértelmezés 1.
-1 a SOAP 1.1 használatát adja meg. Az alapértelmezés a SOAP 1.1.
-2 a SOAP 1.2 használatát adja meg.
A következő példa a Ping és Echo ügyfél sikeres futtatását mutatja be Windows operációs rendszeren:
runSampleSei.bat -p 9081 Aug 8, 2007 7:01:00 PM com.ibm.ws.ssl.config.SSLConfigManager INFO: ssl.disable.url.hostname.verification.CWPKI0027I >> CLIENT: SEI Async to http://localhost:9081/WSSampleSei/EchoService [WAShttpAsyncResponseListener] listening on port 4733 >> CLIENT: SEI Async invocation complete. >> CLIENT: SEI Async response is: JAX-WS==>>HELLO
|
A példaügyfél és -alkalmazás működéséről további információkat a Ping
és Echo technikai megjegyzéseiben vagy a Java forráskódban találhat.
A webszolgáltatások ügyfelekről további információkat a webszolgáltatás
ügyfelek fejlesztésének és telepítésének dokumentációjában talál a
WebSphere Application Server információs központ könyvtárában.
Az irányelv-készletek a Szolgáltatási minőség
(QoS) engedélyezésére szolgálnak, mint például a ReliableMessaging és a
SecureConversation. Az alkalmazáshoz csatolt irányelv-készletek
határozzák meg az alkalmazás szolgáltatási minőségét. Rendelkezésre áll a
parancsfájlok készlete a WS-ReliableMessaging (WS-RM), WS-SecureConversation (WS-SC)
és WS-I Reliable Secure Profil (RSP) irányelv-készleteinek engedélyezéséhez. Az RSP a WS-RM és a WS-SC kompozíciója. Ezek a parancsfájlok példaként szolgálnak. Az irányelv-készletek az adminisztrációs konzol segítségével is engedélyezhetők. Ezeket a parancsfájlokat úgy tervezték, hogy csak a
példaalkalmazásokkal működjenek. A következő táblázatok az irányelvkészlet
példaparancsfájljait írják le.
A Windows operációs rendszer parancsfájljai
Fájlnév |
Leírás |
enableRMQoS.bat |
WS-ReliableMessaging 1.1-es változat engedélyezése |
enableRM1QoS.bat |
WS-ReliableMessaging 1.0-s változat engedélyezése |
enableSCQoS.bat |
WS-SecureConversation engedélyezése |
enableRSPQoS.bat |
WS-ReliableMessaging és WS-SecureConversation engedélyezése |
enableWSAQoS.bat |
WS-Addressing engedélyezése |
disableRMQoS.bat |
WS-ReliableMessaging 1.1-es változat letiltása |
disableRM1QoS.bat |
WS-ReliableMessaging 1.0-s változat letiltása |
disableSCQoS.bat |
WS-SecureConversation letiltása |
disableRSPQoS.bat |
WS-ReliableMessaging és WS-SecureConversation letiltása |
disableWSAQoS.bat |
WS-Addressing letiltása |
AIX, Linux és z/OS operációs rendszerek parancsfájljai
Fájlnév |
Leírás |
enableRMQoS.sh |
WS-ReliableMessaging 1.1-es változat engedélyezése |
enableRM1QoS.sh |
WS-ReliableMessaging 1.0-s változat engedélyezése |
enableSCQoS.sh |
WS-SecureConversation engedélyezése |
enableRSPQoS.sh |
WS-ReliableMessaging és WS-SecureConversation engedélyezése |
enableWSAQoS.sh |
WS-Addressing engedélyezése |
disableRMQoS.sh |
WS-ReliableMessaging 1.1-es változat letiltása |
disableRM1QoS.sh |
WS-ReliableMessaging 1.0-s változat letiltása |
disableSCQoS.sh |
WS-SecureConversation letiltása |
disableRSPQoS.sh |
WS-ReliableMessaging és WS-SecureConversation letiltása |
disableWSAQoS.sh |
WS-Addressing letiltása |
Az i5/OS operációs rendszer parancsfájljai
Fájlnév |
Leírás |
enableRMQoS |
WS-ReliableMessaging 1.1-es változat engedélyezése |
enableRM1QoS |
WS-ReliableMessaging 1.0-s változat engedélyezése |
enableSCQoS |
WS-SecureConversation engedélyezése |
enableRSPQoS |
WS-ReliableMessaging és WS-SecureConversation engedélyezése |
enableWSAQoS |
WS-Addressing engedélyezése |
disableRMQoS |
WS-ReliableMessaging 1.1-es változat letiltása |
disableRM1QoS |
WS-ReliableMessaging 1.0-s változat letiltása |
disableSCQoS |
WS-SecureConversation letiltása |
disableRSPQoS |
WS-ReliableMessaging és WS-SecureConversation letiltása |
disableWSAQoS |
WS-Addressing letiltása |
A következő lépések a megbízható üzenetkezelési parancsfájlok futtatását
mutatják be Windows operációs rendszeren. Az operációs rendszernek megfelelően minden
parancsfájlt hasonlóan futtathat.
- Nyisson meg egy parancssort a Start menüből:
Kattintson a Start-> Futtatás menüpontra. Írja be a cmd utasítást.
- Lépjen be az alk_kiszolgáló_gyökér/samples/bin/JaxWSServicesSamples könyvtárba. Például: cd C:/Program Files/IBM/WebSphere/AppServer/samples/bin/JaxWSServiceSamples
- Futtassa a megbízható üzenetkezelési parancsfájlokat.
- A megbízható üzenetkezelés engedélyezési parancsfájljának futtatásához írja
be a következő parancsot: enableRMQos.bat
- A megbízható üzenetkezelés letiltási parancsfájljának futtatásához írja
be a következő parancsot: disableRMQos.bat
- (Választható) A megbízható üzenetkezelési vagy biztonsági parancsfájlok
futtatásakor adja meg a profilját, celláját, csomópontját vagy kiszolgálónevét. A
megbízható üzenetkezelés és biztonság engedélyezési és letiltási parancsfájljai négy
opcionális paramétert várnak:
- profil: alkalmazáskiszolgáló profilja
- cella: alkalmazáskiszolgáló cellája
- csomópont: alkalmazáskiszolgáló csomópontja
- kiszolgáló: alkalmazáskiszolgáló neve
A következő példa a WS-ReliableMessaging engedélyezési parancsfájl futtatását
mutatja be a választható profil, cella és csomópont paraméterek megadásával:
enableRMQoS.bat AppSrv02 MyServerNode01Cell MyServerNode01
A következő példa a WS-ReliableMessaging letiltási parancsfájl futtatását
mutatja be a választható profil, cella és csomópont paraméterek megadásával:
disableRMQoS.bat AppSrv02 MyServerNode01Cell MyServerNode01
- Szükség szerint adjon meg további paramétereket a parancssorban. Ha a
kiszolgálón engedélyezve van az adminisztrációs biztonság, akkor meg kell adni a
felhasználói azonosítót és jelszót, különben a parancsfájl végrehajtása meghiúsul, például:
./enableRMQoS.sh -user felh_azonosító -password jelszó
- Gondoskodjon a példaalkalmazások megfelelő indításáról. Ha figyelmeztető
üzenetet kap, akkor lehet, hogy a példaalkalmazások nem indultak el megfelelően. Az adminisztrációs konzol segítségével állítsa le majd indítsa újra a
minta alkalmazásokat.
A Ping és Echo vékony ügyfél minta QoS
irányelv-készletek teszteléséhez tegye a következőket:
- Alkalmazza a tesztelni kívánt Szolgáltatási minőséget (QoS) a
minta alkalmazásokra az Irányelv-készlet parancsfájlok című részben
leírtak szerint.
- Módosítsa az operációs rendszernek megfelelő runSampleSei parancsfájlt.
- A WS-I RSP és SecureConversation irányelvek hozzáadásához vegye fel a következő
utasítást a Java hitelesítési és jogosultsági (JAAS) bejelentkezési fájl útvonalának
hozzáadásához.
Windows operációs rendszeren:
set
JAASLOGIN=-Djava.security.auth.login.config=<profilgyökér>/properties/wsjaas_client.conf
AIX, Linux és z/OS operációs rendszereken:
export
JAASLOGIN=-Djava.security.auth.login.config=<profilgyökér>/properties/wsjaas_client.conf
A profilgyökér azt a kiszolgáló könyvtárat jelöli, amelyben
a profil található, például:
set
JAASLOGIN=-Djava.security.auth.login.config=C:/IBM/WebSphere/profiles/AppSrv02/properties/wsjaas_client.conf
- Módosítsa az osztályútvonal utasítását.
Windows operációs rendszeren:
set
CLASSPATH=%THIN_JAR%;./WSSampleClientSei.jar;.
AIX, Linux és z/OS operációs rendszereken:
export
CLASSPATH=${THIN_JAR}:./WSSampleClientSei.jar:.
Megjegyzés: Az osztályútvonal utasítás végén szerepel egy pont (.) is.
A pont azért szerepel, hogy az irányelvkészlet betöltési kód megtalálja a META-INF
könyvtárat. Ne hagyja le a pontot.
- Adja hozzá a <JAASLOGIN> és -DUSER_INSTALL_ROOT="<profilgyökér>"
paramétereket a Java parancshoz.
Windows operációs rendszeren:
java %JAASLOGIN%
-DUSER_INSTALL_ROOT= "<profilgyökér>" -cp
"%CLASSPATH%" com.ibm.was.wssample.sei.cli.SampleClient %*
AIX, Linux és z/OS operációs rendszereken:
java ${JAASLOGIN}
-DUSER_INSTALL_ROOT="<profilgyökér>" -cp
"${CLASSPATH} " com.ibm.was.wssample.sei.cli.SampleClient
$@
- Hozzon létre META-INF nevű könyvtárt az
alk_kiszolgáló_gyökér/samples/bin/JaxWSServicesSamples könyvtár alatt.
- Másolja a profilgyökér/config/cells/CELLANÉV/
könyvtár alatti PolicySets könyvtárt az
alk_kiszolgáló_gyökér/samples/bin/JaxWSServicesSamples/META-INF
könyvtárba.
- Másolja át a bindings alkönyvtárat és a clientPolicyAttachment.xml
fájlt a profil_gyökér/config/cells/ CELLA_NEVE/applications/JaxWSServicesSamples.ear/deployments/JaxWSServicesSamples/META-INF
könyvtárból az
alkalmazáskiszolgáló_gyökér/samples/bin/JaxWSServicesSamples/META-INF
könyvtárba.
A teljes bindings alkönyvtárat és tartalmát át kell másolnia, például
SecureConversationClientBinding vagy RAMP_client_default_bindings.
- Váltsa át az aktuális könyvtárat az alkalmazáskiszolgáló_gyökér/samples/bin/JaxWSServicesSamples könyvtárra, majd futtassa a mintát.