Ping a Echo - Konfigurace


Spuštění ukázky
Spuštění ukázky tenkého klienta
Povolení spolehlivého systému zpráv a zabezpečení

Ukázky Ping a Echo jsou jednoduchými ukázkami webových služeb JAX-WS.

Ukázka Ping demonstruje jednocestnou operaci. Službě je předána jednoduchá hodnota řetězce. Operace klienta je dokončena po kontaktování služby. V této ukázce existují dva koncové body. Jeden koncový bod používá rozhraní SOAP 1.1 a druhý koncový bod používá rozhraní SOAP 1.2.

Ukázka Echo demonstruje dvoucestnou operaci. Službě je předána jednoduchá hodnota řetězce. Služba připojí hodnotu řetězce identifikátoru a vrátí tuto hodnotu zpět klientovi. V této ukázce existují dva koncové body. Jeden koncový bod používá rozhraní SOAP 1.1 a druhý koncový bod používá rozhraní SOAP 1.2. Ukázka Echo dále demonstruje synchronní a asynchronní modely programování a synchronní a asynchronní chování přes spoj:


Koncové body ukázkové služby
Identifikátor URI Popis
http://localhost:9080/WSSampleSei/PingService
Ukázka služby Ping používající protokol SOAP 1.1
http://localhost:9080/WSSampleSei/PingService12
Ukázka služby Ping používající protokol SOAP 1.2
http://localhost:9080/WSSampleSei/EchoService
Ukázka služby Echo používající protokol SOAP 1.1
http://localhost:9080/WSSampleSei/EchoService12
Ukázka služby Echo používající protokol SOAP 1.2

Číslo portu 9080 je výchozí hodnotou, ale při instalaci jiného profilu než AppSrv01 bude použito jiné číslo portu.



Konfigurování ukázky

Chcete-li konfigurovat ukázku Ping a Echo, zaveďte aplikaci s ukázkou webových služeb JAX-WS na serveru. Pokud ukázková aplikace dosud nebyla implementována, postupujte podle pokynů v části Opětné sestavení a implementace souboru JaxWSServicesSamples.ear.

Spuštění ukázky

Před spuštěním musíte ověřit, že je před spuštěním klientů spuštěn aplikační server.

Ukázka Ping a Echo zahrnuje dvě služby, Ping a Echo.

Spuštění ukázky Ping a Echo

Ukázka Ping demonstruje jednocestnou transakci služeb. Zdrojový soubor této ukázky je umístěn v adresáři kořenový_adresář_profilu/samples/src/JaxWSServicesSamples/SampleClientSei.

Ukázka Echo demonstruje dvoucestnou transakci služeb. Zdrojový soubor této ukázky je umístěn v adresáři kořenový_adresář_profilu/samples/src/JaxWSServicesSamples/SampleClientSei.

Chcete-li servlet klienta ukázky Ping a Echo spustit z produktu WebSphere Application Server, proveďte následující kroky:

  1. Spusťte server.
  2. Klepněte na volbu Spustit.

Spuštění ukázky tenkého klienta Ping a Echo

Ukázka tenkého klienta Ping a Echo se podobá servletu klienta Ping a Echo. Tato ukázka přistupuje ke stejným objektům bean webových služeb Ping a Echo, ale používá soubor JAR, který vyžaduje tenkého klienta standardu JAX-WS se souborem JAR aplikace produktu WebSphere v cestě ke třídě.

Soubor WSSampleClientSei.jar naleznete v adresáři samples/lib/JaxWSServicesSamples.

Ukázka tenkého klienta Ping a Echo vytváří server proxy standardu JAX-WS pro webové služby ukázek Ping a Echo v závislosti na zadaných parametrech. Server proxy poté kontaktuje koncový bod služby pomocí zprávy. Ukázka Echo čeká na odezvu.

V následujících instrukcích proměnná kořen_apl_serveru odkazuje na kořenový adresář instalace aplikačního serveru.

Chcete-li klienta ukázek tenkého klienta Ping a Echo 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. Přejděte do adresáře JaxWSServicesSamples.

    V operačních systémech Windows:

    cd kořen_apl_serveru\samples\bin\JaxWSServicesSamples

    V operačních systémech, jako je AIX, Linux a z/OS:

    cd kořen_apl_serveru/samples/bin/JaxWSServicesSamples

    V operačních systémech iSeries:

    cd kořen_apl_serveru/samples/bin/JaxWSServicesSamples

  4. Spusťte ukázku tenkého klienta Ping a Echo.

    V operačních systémech Windows:

    runSampleSei.bat -h název_hostitele -p port -f přípona_adresy_URL -m testovací_zpráva -s služba -t časový_limit -w asynchronní_spoj -c počet -1 -2

    V operačních systémech, jako je AIX, Linux a z/OS:

    ./runSampleSei.sh -h název_hostitele -p port -f přípona_adresy_URL -m testovací_zpráva -s služba -t časový_limit -w asynchronní_spoj -c počet -1 -2

    V operačních systémech iSeries:

    ./runSampleSei -h název_hostitele -p port -f přípona_adresy_URL -m testovací_zpráva -s služba -t časový_limit -w asynchronní_spoj -c počet -1 -2

    Parametry:
    -h <název_hostitele> je názvem hostitele. Výchozí hodnota je localhost.
    -p <port> je číslem portu. Výchozí hodnota je 9080.
    -f <přípona_adresy_URL> je kontextem koncového bodu služby. Výchozí hodnota je /WSSampleSei/EchoService.
    -m <zpráva> je textem zprávy. Výchozí hodnota je hello. Pokud zpráva obsahuje mezery, uveďte zprávu v uvozovkách.
    -c počet určuje počet transakcí ke spuštění. Výchozí hodnota je 1.
    -1 určuje použití protokolu SOAP 1.1. Výchozí je protokol SOAP 1.1.
    -2 určuje použití protokolu SOAP 1.2.

    Následující příklad ilustruje úspěšné spuštění klienta ukázky Ping a Echo v operačním systému Windows:


    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


Chcete-li získat další informace o fungování aplikace a klienta ukázek, zobrazte technické poznámky ukázky Ping a Echo nebo zobrazte zdrojový kód jazyka Java.

Další informace o klientech webových služeb naleznete v dokumentaci k vývoji a implementaci klientů webových služeb v části Knihovna Informačního centra produktu WebSphere Application Server.

Povolení spolehlivého systému zpráv a zabezpečení

Skripty sad zásad
Použití kvality služeb pro ukázku tenkého klienta Ping a Echo

Skripty sad zásad

Sady zásad slouží k povolení kvality služeb (QoS), jako jsou například služby ReliableMessaging a SecureConversation. Sady zásad připojené k aplikaci definují kvalitu služeb dané aplikace. Sada skriptů je poskytována, aby povolila sady zásad pro služby WS-RM (WS-ReliableMessaging), WS-SC (WS-SecureConversation) a RSP (WS-I Reliable Secure Profile). Služba RSP je složením služeb WS-RM a WS-SC. Tyto skripty jsou poskytovány jako příklady. Sady zásad můžete povolit také pomocí administrativní konzoly. Tyto skripty jsou navrženy pouze pro práci s ukázkovými aplikacemi. V následujících tabulkách jsou uvedeny ukázkové skripty sady zásad.

Skripty pro operační systém Windows
Název souboru Popis
enableRMQoS.bat Povolení služby WS-ReliableMessaging verze 1.1
enableRM1QoS.bat Povolení služby WS-ReliableMessaging verze 1.0
enableSCQoS.bat Povolení služby WS-SecureConversation
enableRSPQoS.bat Povolení služeb WS-ReliableMessaging a WS-SecureConversation
enableWSAQoS.bat Povolení služby WS-Addressing
disableRMQoS.bat Zakázání služby WS-ReliableMessaging verze 1.1
disableRM1QoS.bat Zakázání služby WS-ReliableMessaging verze 1.0
disableSCQoS.bat Zakázání služby WS-SecureConversation
disableRSPQoS.bat Zakázání služeb WS-ReliableMessaging a WS-SecureConversation
disableWSAQoS.bat Zakázání služby WS-Addressing

Skripty pro operační systémy, jako je AIX, Linux a z/OS:
Název souboru Popis
enableRMQoS.sh Povolení služby WS-ReliableMessaging verze 1.1
enableRM1QoS.sh Povolení služby WS-ReliableMessaging verze 1.0
enableSCQoS.sh Povolení služby WS-SecureConversation
enableRSPQoS.sh Povolení služeb WS-ReliableMessaging a WS-SecureConversation
enableWSAQoS.sh Povolení služby WS-Addressing
disableRMQoS.sh Zakázání služby WS-ReliableMessaging verze 1.1
disableRM1QoS.sh Zakázání služby WS-ReliableMessaging verze 1.0
disableSCQoS.sh Zakázání služby WS-SecureConversation
disableRSPQoS.sh Zakázání služeb WS-ReliableMessaging a WS-SecureConversation
disableWSAQoS.sh Zakázání služby WS-Addressing

Skripty pro operační systémy i5/OS
Název souboru Popis
enableRMQoS Povolení služby WS-ReliableMessaging verze 1.1
enableRM1QoS Povolení služby WS-ReliableMessaging verze 1.0
enableSCQoS Povolení služby WS-SecureConversation
enableRSPQoS Povolení služeb WS-ReliableMessaging a WS-SecureConversation
enableWSAQoS Povolení služby WS-Addressing
disableRMQoS Zakázání služby WS-ReliableMessaging verze 1.1
disableRM1QoS Zakázání služby WS-ReliableMessaging verze 1.0
disableSCQoS Zakázání služby WS-SecureConversation
disableRSPQoS Zakázání služeb WS-ReliableMessaging a WS-SecureConversation
disableWSAQoS Zakázání služby WS-Addressing


Následující kroky slouží ke spuštění skriptů spolehlivého systému zpráv v operačním systému Windows. Podobným způsobem můžete spouštět všechny skripty v závislosti na operačním systému.

  1. Otevřete příkazový řádek pomocí nabídky Start: Klepněte na volbu Start -> Spustit. Zadejte příkaz cmd.
  2. Přejděte do adresáře kořen_apl_serveru/samples/bin/JaxWSServicesSamples. Příklad: cd C:/Program Files/IBM/WebSphere/AppServer/samples/bin/JaxWSServiceSamples
  3. Spusťte skripty spolehlivého systému zpráv.
  4. (Volitelné) Při spuštění skriptů zabezpečení nebo spolehlivého systému zpráv zadejte název profilu, buňky, uzlu nebo serveru. Skripty pro povolení a zakázání spolehlivého systému zpráv a zabezpečení mají čtyři volitelné parametry:

    V následujícím příkladu je uveden způsob spuštění skriptu pro povolení služby WS-ReliableMessaging se zadanými volitelnými parametry profil, buňka a uzel:

    enableRMQoS.bat AppSrv02 MyServerNode01Cell MyServerNode01

    V následujícím příkladu je uveden způsob spuštění skriptu pro zakázání služby WS-ReliableMessaging se zadanými volitelnými parametry profil, buňka a uzel:

    disableRMQoS.bat AppSrv02 MyServerNode01Cell MyServerNode01

  5. Na příkazovém řádku můžete konfigurovat další parametry podle potřeby. Je-li pro server povoleno zabezpečení administrace, musíte zadat jméno uživatele a heslo, jinak skript selže, například:
    ./enableRMQoS.sh -user jméno_uživatele -password heslo
  6. Ujistěte se, že byly ukázkové aplikace správně spuštěny. Pokud obdržíte varovnou zprávu, mohly být některé ukázkové aplikace spuštěny nesprávně. Pomocí administrativní konzoly tyto ukázkové aplikace zastavte a znovu spusťte.  

Použití kvality služeb pro ukázku tenkého klienta Ping a Echo

Chcete-li testovat ukázku Ping a Echo tenkého klienta se sadami zásad kvality služeb, postupujte podle následujících pokynů.
  1. Kvalitu služeb (QoS), kterou chcete testovat, použijte na ukázkové aplikace, jak je uvedeno v části Skripty sad zásad.
  2. Upravte skript runSampleSei pro daný operační systém.
  3. Chcete-li přidat zásady WS-I RSP a SecureConversation, přidejte následující příkaz spolu s cestou k souboru přihlášení ke službě JAAS (Java Authentication and Authorization Service):

    V operačních systémech Windows:

    set JAASLOGIN=-Djava.security.auth.login.config=<kořen_profilu>/properties/wsjaas_client.conf

    V operačních systémech, jako je AIX, Linux a z/OS:

    export JAASLOGIN=-Djava.security.auth.login.config=<kořen_profilu>/properties/wsjaas_client.conf

    Volba kořen_profilu indikuje adresář serveru, kde je profil umístěn. Příklad:
    set JAASLOGIN=-Djava.security.auth.login.config=C:/IBM/WebSphere/profiles/AppSrv02/properties/wsjaas_client.conf

  4. Změňte příkaz cesty ke třídám.

    V operačních systémech Windows:

    set CLASSPATH=%THIN_JAR%;./WSSampleClientSei.jar;.

    V operačních systémech, jako je AIX, Linux a z/OS:

    export CLASSPATH=${THIN_JAR}:./WSSampleClientSei.jar:.

    Poznámka: Znak "." je uveden na konci příkazu cesty ke třídám. Tečka je zde uvedena, aby kód načítání sady zásad nalezl adresář META-INF. Tečku nevynechávejte.

  5. Do příkazu jazyka přidejte volby <JAASLOGIN> a -DUSER_INSTALL_ROOT="<kořen_profilu>".

    V operačních systémech Windows:

    java %JAASLOGIN% -DUSER_INSTALL_ROOT= "<kořen_profilu>" -cp "%CLASSPATH%" com.ibm.was.wssample.sei.cli.SampleClient %*

    V operačních systémech, jako je AIX, Linux a z/OS:

    java ${JAASLOGIN} -DUSER_INSTALL_ROOT="<kořen_profilu>" -cp "${CLASSPATH} " com.ibm.was.wssample.sei.cli.SampleClient $@

  6. Vytvořte podadresář s názvem META-INF v adresáři kořen_apl_serveru/samples/bin/JaxWSServicesSamples.
  7. Zkopírujte podadresář PolicySets adresáře kořen_profilu/config/cells/název_buňky/do adresáře kořen_apl_serveru/samples/bin/JaxWSServicesSamples/META-INF.
  8. Zkopírujte podadresář vazeb a soubor clientPolicyAttachment.xml z adresáře kořen_profilu/config/cells/ název_buňky/applications/JaxWSServicesSamples.ear/deployments/JaxWSServicesSamples/META-INF do adresáře kořen_apl_serveru/samples/bin/JaxWSServicesSamples/META-INF. Zkopírujte celý podadresář vazeb a veškerý jeho obsah, například objekty SecureConversationClientBinding nebo RAMP_client_default_bindings.
  9. Změňte aktuální adresář na kořen_apl_serveru/samples/bin/JaxWSServicesSamples a spusťte ukázku.