Usługa MTOM - konfigurowanie i uruchamianie


Konfigurowanie przykładu
Uruchamianie przykładu

Istnieją dwa klienty usługi mechanizmu optymalizacji transmisji komunikatów (MTOM): wersja uruchamiana w wierszu komend, która używa pliku archiwum Java (JAR) na potrzeby cienkiego klienta usług JAX-WS z serwerem WebSphere Application Server, oraz wersja serwletowa, uzyskująca dostęp do usługi MTOM za pomocą technologii JavaServer pages (JSP).

Punkty końcowe usługi przykładowej
Identyfikator URI Opis
http://localhost:9080/WSSampleMTOM/MtomSampleService
Przykład usługi MTOM z użyciem protokołu SOAP 1.1
http://localhost:9080/WSSampleMTOM/MtomSampleService12
Przykład usługi MTOM z użyciem protokołu SOAP 1.2

Port 9080 jest używany domyślnie, jednak numer portu jest inny, jeśli przykład został zainstalowany w profilu innym niż AppSrv01.



Konfigurowanie przykładu

W celu przeprowadzenia konfiguracji tego przykładu należy wdrożyć na serwerze aplikację przykładu usług WWW JAX-WS. Jeśli przykładowa aplikacja nie została jeszcze wdrożona, należy zapoznać się z instrukcjami w sekcji Odbudowywanie i wdrażanie pliku JaxWSServicesSamples.ear.

Uruchamianie przykładu

Przed uruchomieniem klientów należy sprawdzić, czy serwer aplikacji jest uruchomiony.

Przykład usługi MTOM zawiera dwa klienty i jeden komponent EJB wdrożony na serwerze. Jeden z klientów jest przeznaczony do używania w wierszu komend i używa pliku JAR cienkiego klienta dla usług JAX-WS z serwerem WebSphere Application Server. Drugi klient jest serwletem i uzyskuje dostęp do usługi MTOM za pomocą pliku JSP.

Uruchamianie serwletu usługi MTOM
Uruchamianie aplikacji cienkiego klienta usługi MTOM

Klienty usługi MTOM

Klienty usługi MTOM wysyłają plik zakodowany za pomocą mechanizmu MTOM do określonego punktu końcowego usługi. Domyślnym hostem jest komputer lokalny, jednak tę wartość można zmienić. Nazwa pliku jest wymagana i nie przyjmuje wartości domyślnej. W tym przykładzie usługa odbiera plik wysłany z klienta, a następnie plik jest zwracany do klienta przy użyciu modelu programistycznego rozsyłania lub proxy zgodnie z ustawionymi opcjami.

Uruchamianie klienta serwletowego usługi MTOM

Klient serwletowy usługi MTOM nie jest zarządzany przez kontener.

Więcej informacji na temat wywoływania klienta serwletowego w środowisku cienkiego klienta usług JAX-WS zawiera dokumentacja dotycząca uruchamiania niezarządzanych klientów usług WWW JAX-WS w bibliotece Centrum informacyjnego serwera WebSphere Application Server.

Aby uruchomić prosty przykładowy klient usługi serwletu MTOM z poziomu serwera WebSphere Application Server, wykonaj następujące kroki:

  1. Uruchom serwer.
  2. Kliknij przycisk Uruchom.

Uruchamianie aplikacji cienkiego klienta usługi MTOM

Plik WSSampleMTOMClient.jar jest aplikacją cienkiego klienta usługi MTOM w wersji uruchamianej z wiersza komend.

W poniższych krokach zmienna katalog_główny_serwera_aplikacji oznacza główny katalog instalacyjny serwera aplikacji.

Aby uruchomić aplikację cienkiego klienta usługi MTOM z poziomu serwera WebSphere Application Server, wykonaj następujące kroki odpowiednie dla używanego systemu operacyjnego:

  1. Uruchom serwer.
  2. Otwórz wiersz komend.
  3. Przejdź do katalogu JaxWSServicesSamples.

    W systemach operacyjnych Windows:

    cd katalog_główny_serwera_aplikacji\samples\bin\JaxWSServicesSamples

    W systemach operacyjnych takich jak AIX, Linux i z/OS:

    cd katalog_główny_serwera_aplikacji/samples/bin/JaxWSServicesSamples

    W systemach operacyjnych iSeries:

    cd katalog_główny_serwera_aplikacji/samples/bin/JaxWSServicesSamples

  4. Uruchom przykład usługi MTOM.

    W systemach operacyjnych Windows:

    runSampleMtom.bat -i nazwa_pliku -h nazwa_hosta -p port -f przyrostek_URL -d -x -1 -2

    W systemach operacyjnych takich jak AIX, Linux i z/OS:

    ./runSampleMtom.sh -i nazwa_pliku -h nazwa_hosta -p port -f przyrostek_URL -d -x -1 -2

    W systemach operacyjnych iSeries:

    ./runSampleMtom -i nazwa_pliku -h nazwa_hosta -p port -f przyrostek_URL -d -x -1 -2

    Parametry:
    -i <nazwa_pliku> określa nazwę pliku, który ma zostać wysłany. Ten parametr jest wymagany i nie przyjmuje żadnej wartości domyślnej.
    -h <nazwa_hosta> określa nazwę hosta. Wartość domyślna to localhost.
    -p <port> określa numer portu. Wartość domyślna to 9080.
    -f <przyrostek_URL> określa kontekst punktu końcowego usługi. Wartość domyślna to /WSSampleMTOM/MtomSampleService.
    -d określa, że ma zostać użyty tylko model rozsyłania.
    -x określa, że ma zostać użyty tylko model proxy.
    -1 określa, że ma zostać użyty protokół SOAP 1.1. Jest to ustawienie domyślne.
    -2 określa, że ma zostać użyty protokół SOAP 1.2.

    Poniższy przykład przedstawia rezultat pomyślnego uruchomienia aplikacji cienkiego klienta usługi MTOM w systemie operacyjnym 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

Więcej informacji na temat działania klienta i aplikacji można uzyskać, przeglądając noty techniczne usługi MTOM oraz kod źródłowy Java.