Služba MTOM - Konfigurace a spuštění


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

Existují dva klienti služby MTOM (Message Transmission Optomization Mechanism), a to verze příkazového řádku, která používá soubor JAR tenkého klienta pro standard JAX-WS s produktem WebSphere Application Server, a verze servletu, která používá k přístupu ke službě MTOM stránky JSP (JavaServer Pages).

Koncové body ukázkové služby
Identifikátor URI Popis
http://localhost:9080/WSSampleMTOM/MtomSampleService
Ukázka služby MTOM používající protokol SOAP 1.1
http://localhost:9080/WSSampleMTOM/MtomSampleService12
Ukázka služby MTOM 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 dokončit konfiguraci této ukázky, zaveďte aplikaci s ukázkou webových služeb JAX-WS na server. 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 služby MTOM sestává ze dvou klientů a jednoho objektu enterprise bean implementovaného na serveru. Verze jednoho klienta je verze příkazového řádku, která používá tenkého klienta pro standard JAX-WS se souborem JAR produktu WebSphere Application Server. Druhým z klientů je verze servletu, která používá pro přístup ke službě MTOM soubor stránek JSP.

Spuštění servletu služby MTOM
Spuštění aplikace tenkého klienta služby MTOM

Klienti služby MTOM

Klienti služby MTOM odesílají soubor kódovaný pomocí služby MTOM do zadaného koncového bodu služby. Při výchozím nastavení je název hostitele nastaven na hodnotu lokálního hostitele, ale tuto hodnotu lze změnit. Je vyžadován název souboru, pro který není poskytována žádná výchozí volba. V této ukázce služba přijímá soubor odeslaný klientem a poté jej vrací klientovi v programovacím modelu serveru proxy nebo odbavení, jak bylo určeno.

Spuštění klienta servletu služby MTOM

Klient servletu služby MTOM není spravován kontejnerem.

Další informace o vyvolání klienta servletu v tenkém klientovi prostředí JAX-WS naleznete v dokumentaci ke spuštění nespravovaného klienta JAX-WS webových služeb v části Knihovna Informačního centra produktu WebSphere Application Server.

Chcete-li jednoduchého klienta služby servletu MTOM spustit z produktu WebSphere Application Server, postupujte takto:

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

Spuštění aplikace tenkého klienta služby MTOM

Soubor WSSampleMTOMClient.jar je verzí aplikace tenkého klienta služby MTOM pro příkazový řádek.

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 aplikaci tenkého klienta služby MTOM 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 služby MTOM.

    V operačních systémech Windows:

    runSampleMtom.bat -i název_souboru -h název_hostitele -p port -f přípona_adresy_URL -d -x -1 -2

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

    ./runSampleMtom.sh -i název_souboru -h název_hostitele -p port -f přípona_adresy_URL -d -x -1 -2

    V operačních systémech iSeries:

    ./runSampleMtom -i název_souboru -h název_hostitele -p port -f přípona_adresy_URL -d -x -1 -2

    Parametry:
    -i <název_souboru> je názvem souboru k odeslání. Jedná se o požadovaný parametr a není poskytována žádná výchozí hodnota.
    -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 /WSSampleMTOM/MtomSampleService.
    -d určuje použití pouze modelu Odbavení.
    -x určuje použití pouze modelu Server proxy.
    -1 určuje použití protokolu SOAP 1.1. Toto je výchozí nastavení.
    -2 určuje použití protokolu SOAP 1.2.

    Následující příklad ilustruje úspěšné spuštění aplikace tenkého klienta služby MTOM v operačním systému Windows:

    runSampleMtom.bat -i c:\SYSLEVEL.IBM -p 9081
    >>---------------------------------------
    >>MTOM Dispatch Test
    >>MTOM Loading data from: 'file:/c:/SYSLEVEL.IBM'
    Aug 10, 2007 12:11:49 PM com.ibm.ws.ssl.config.SSLConfigManager
    INFO: ssl.disable.url.hostname.verification.CWPKI0027I
    >>MTOM Invoking Dispatch with a binary payload
    >>MTOM Response received
    >>MTOM Writing returned image to dispatch_response.gif
    >>MTOM Dispatch Done
    >>---------------------------------------
    >>MTOM Proxy Test
    >>MTOM Invoking proxy with a binary payload
    >>MTOM Response received
    >>MTOM Writing returned image to proxy_response.gif
    >>MTOM Proxy Done

Chcete-li získat další informace o fungování klienta a aplikace, zobrazte technické poznámky služby MTOM nebo zdrojový kód jazyka Java.