Serviciul MTOM - Configurare şi rulare


Configurarea exemplului
Rularea exemplului

Există doi clienţi ai serviciului MTOM (Message Transmission Optomization Mechanism), o versiune linie de comandă care foloseşte fişierul JAR pentru clientul subţire al JAX-WS cu WebSphere Application Server şi o versiune servlet care foloseşte un fişier JSP pentru a accesa serviciul MTOM.

Punctele finale ale serviciului Exemplu
URI Descriere
http://localhost:9080/WSSampleMTOM/MtomSampleService
Exemplu de serviciu MTOM care foloseşte SOAP 1.1
http://localhost:9080/WSSampleMTOM/MtomSampleService12
Exemplu de serviciu MTOM care foloseşte SOAP 1.2

Portul 9080 este valoarea implicită, dar numărul portului este diferit dacă instalaţi la un alt profil decât profilul AppSrv01.



Configurarea exemplului

Pentru a finaliza configuraţia exemplului, implementaţi pe server aplicaţia Exemple JAX-WS Web services. Dacă aplicaţia exemplu nu este implementată deja, vedeţi instrucţiunile pentru Reconstruirea şi implementarea fişierului JaxWSServicesSamples.ear.

Rularea exemplului

Înainte de a rula clienţii, trebuie să verificaţi că serverul de aplicaţii rulează.

Exemplul de serviciu MTOM constă din doi clienţi şi un singur bean enterprise implementat pe server. Un client este o versiune de linie de comandă care foloseşte fişierul JAR pentru clientul subţire al JAX-WS cu WebSphere Application Server. Celălalt client este o versiune servlet care foloseşte un fişier JSP pentru a accesa serviciul MTOM.

Rularea servletului Serviciu MTOM
Rularea aplicaţiei client subţire Serviciu MTOM

Clienţii serviciului MTOM

Clienţii serviciului MTOM trimit un fişier codificat cu MTOM către punctul final specificat al serviciului. Implicit, gazda este setată la localhost, dar puteţi modifica această valoare. Este necesar un nume de fişier şi nu este furnizată nici o valoare implicită. În acest Exemplu, serviciul primeşte fişierul trimis de la client şi apoi fişierul este returnat clientului într-un model de programare dispatch sau proxy, după cum se specifică.

Rularea clientului servlet Serviciu MTOM

Clientul servlet Serviciu MTOM nu este gestionat de container.

Pentru mai multe informaţii despre invocarea unui client servlet într-un mediu de client subţire pentru JAX-WS, vedeţi documentaţia despre rularea unui client JAX-WS de servicii Web în Biblioteca centrului de informare WebSphere Application Server.

Pentru a rula clientul serviciului servlet MTOM din WebSphere Application Server, realizaţi următorii paşi:

  1. Porniţi serverul.
  2. Faceţi clic pe Rulare.

Rularea aplicaţiei client subţire Serviciu MTOM

Fişierul WSSampleMTOMClient.jar este o versiune cu linie de comandă a aplicaţiei clientului subţire pentru serviciul MTOM.

În următorii paşi, variabila app_server_root se referă la directorul de instalare a serverului de aplicaţii.

Pentru a rula aplicaţia de Client subţire al serviciului MTOM de pe WebSphere Application Server, realizaţi următorii paşi, bazat pe sistemul de operare folosit:

  1. Porniţi serverul.
  2. Deschideţi un prompt de comandă.
  3. Mergeţi la directorul JaxWSServicesSamples.

    Pe sistemele de operare Windows:

    cd app_server_root\samples\bin\JaxWSServicesSamples

    Pe sistemele de operare AIX, Linux şi z/OS:

    cd app_server_root/samples/bin/JaxWSServicesSamples

    Pe sistemele de operare iSeries:

    cd app_server_root/samples/bin/JaxWSServicesSamples

  4. Rulaţi exemplul Serviciu MTOM.

    Pe sistemele de operare Windows:

    runSampleMtom.bat -i filename -h hostname -p port -f urlSuffix -d -x -1 -2

    Pe sistemele de operare AIX, Linux şi z/OS:

    ./runSampleMtom.sh -i filename -h hostname -p port -f urlSuffix -d -x -1 -2

    Pe sistemele de operare iSeries:

    ./runSampleMtom -i filename -h hostname -p port -f urlsuffix -d -x -1 -2

    Parametrii sunt:
    -i <filename> este numele fişierului de trimis. Acesta este un parametru necesar şi nu este furnizată nici o valoare implicită.
    -h <hostname> este numele gazdei. Valoarea implicită este localhost.
    -p <port> este numărul portului. Valoarea implicită este 9080.
    -f <urlsuffix> contextul punctului final al serviciului. Valoarea implicită este /WSSampleMTOM/MtomSampleService.
    -d specifică folosirea doar a modelului dispatch.
    -x specifică folosirea doar a modelului proxy.
    -1 specifică folosirea SOAP 1.1. Aceasta este valoarea implicită.
    -2 specifică folosirea SOAP 1.2.

    Următorul exemplu ilustrează o rulare cu succes a aplicaţiei client subţire pentru serviciul MTOM pe sistemul de operare 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

Pentru a afla mai multe despre cum lucrează clientul şi aplicaţia, vedeţi notele tehnice ale serviciului MTOM sau vedeţi codul sursă Java.