Ping és Echo - konfigurálás


A példa futtatása
A vékony ügyfél példa futtatása
Megbízható üzenetkezelés és biztonság engedélyezése

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:


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 példa beállítása

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 JaxWSServicesSamples.ear fájl újraépítése és telepítése című részben.

A példa futtatása

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 és Echo példa futtatása

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:

  1. Indítsa el a kiszolgálót.
  2. Kattintson a Futtatás gombra.

A Ping és Echo vékony ügyfél példa futtatása

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.

  1. Indítsa el a kiszolgálót.
  2. Parancssor megnyitása.
  3. 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

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

Megbízható üzenetkezelés és biztonság engedélyezése

Irányelv-készlet parancsfájlok
QoS alkalmazása a Ping és Echo vékony ügyfél példára

Irányelv-készlet parancsfájlok

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.

  1. Nyisson meg egy parancssort a Start menüből: Kattintson a Start-> Futtatás menüpontra. Írja be a cmd utasítást.
  2. 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
  3. Futtassa a megbízható üzenetkezelési parancsfájlokat.
  4. (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:

    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

  5. 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ó
  6. 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.  

QoS alkalmazása a Ping és Echo vékony ügyfél példára

A Ping és Echo vékony ügyfél minta QoS irányelv-készletek teszteléséhez tegye a következőket:
  1. 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.
  2. Módosítsa az operációs rendszernek megfelelő runSampleSei parancsfájlt.
  3. 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

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

  5. 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 $@

  6. Hozzon létre META-INF nevű könyvtárt az alk_kiszolgáló_gyökér/samples/bin/JaxWSServicesSamples könyvtár alatt.
  7. 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.
  8. 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.
  9. 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.