MTOM service - Configurar e Executar


Configurando a Amostra
Executando a Amostra

Há dois clientes de serviço MTOM (Message Transmission Optomization Mechanism), uma versão de linha de comandos que usa o arquivo JAR (Java archive) para o Thin Client para JAX-WS com o WebSphere Application Server e uma versão de servlet que usa um JSP (JavaServer Pages) para acessar o serviço MTOM.

Terminais de Serviço de Amostra
URI Descrição
http://localhost:9080/WSSampleMTOM/MtomSampleService
Amostra de serviço MTOM utilizando SOAP 1.1
http://localhost:9080/WSSampleMTOM/MtomSampleService12
Amostra de serviço MTOM utilizando SOAP 1.2

A porta 9080 é o valor padrão, mas o número da porta será diferente se você instalar em um perfil diferente do AppSrv01.



Configurando a Amostra

Para concluir a configuração dessa amostra, implemente o aplicativo de amostra dos serviços da Web do JAX-WS no servidor. Se o aplicativo de amostra ainda não estiver implementado, consulte as instruções em Reconstruindo e Implementando o Arquivo JaxWSServicesSamples.ear.

Executando a Amostra

Antes de começar, você deve verificar se o servidor de aplicativos está em execução antes de executar os clientes.

A Amostra de Serviço MTOM consiste em dois clientes e em um único bean corporativo implementado no servidor. Um cliente é uma versão de linha de comandos que usa o Thin Client para JAX-WS com o arquivo JAR do WebSphere Application Server. O outro cliente é uma versão de servlet que utiliza um arquivo JSP para acessar o serviço MTOM.

Executando o Servlet de Serviço MTOM
Executando o Aplicativo Thin Client do Serviço MTOM

Clientes de Serviço MTOM

Os clientes de serviço MTOM enviam um arquivo codificado com o MTOM para o terminal de serviço especificado. Por padrão, o host é configurado como host local, mas você pode alterar esse valor. Um nome de arquivo é necessário e nenhum padrão é fornecido. Nesta amostra, o serviço recebe o arquivo enviado do cliente e o arquivo é retornado para o cliente no modelo de programação de dispatch ou proxy, conforme especificado.

Executando o Cliente de Servlet do Serviço MTOM

O cliente de servlet do serviço MTOM não é gerenciado pelo contêiner.

Para obter mais informações sobre como chamar o cliente de servlet em um ambiente de Thin Client para JAX-WS, consulte a documentação sobre como executar um cliente JAX-WS de serviços da Web não-gerenciados na Biblioteca Centro de Informações do WebSphere Application Server.

Para executar o cliente de serviço de servlet simples do MTOM de um WebSphere Application Server, execute as seguintes etapas:

  1. Inicie o servidor.
  2. Clique em Executar.

Executando o Aplicativo Thin Client do Serviço MTOM

O arquivo WSSampleMTOMClient.jar é uma versão de linha de comandos do aplicativo thin client do serviço MTOM.

Nas seguintes etapas, a variável raiz_do_servidor_de_aplicativos refere-se ao diretório raiz de instalação do servidor de aplicativos.

Para executar o aplicativo thin client do serviço MTOM a partir do WebSphere Application Server, execute as seguintes etapas, com base em seu sistema operacional:

  1. Inicie o servidor.
  2. Abra um prompt de comandos.
  3. Vá para o diretório JaxWSServicesSamples.

    Em sistemas operacionais Windows:

    cd raiz_do_servidor_de_aplicativos\samples\bin\JaxWSServicesSamples

    Em sistemas operacionais como AIX, Linux e z/OS:

    cd raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples

    Em sistemas operacionais iSeries:

    cd raiz_do_servidor_de_aplicativos/samples/bin/JaxWSServicesSamples

  4. Execute a amostra do serviço MTOM.

    Em sistemas operacionais Windows:

    runSampleMtom.bat -i nome_do_arquivo -h nome_do_host -p porta -f urlSuffix -d -x -1 -2

    Em sistemas operacionais como AIX, Linux e z/OS:

    ./runSampleMtom.sh -i nome_do_arquivo -h nome_do_host -p porta -f urlSuffix -d -x -1 -2

    Em sistemas operacionais iSeries:

    ./runSampleMtom -i nome_do_arquivo -h nome_do_host -p porta -f urlsuffix -d -x -1 -2

    Os parâmetros são:
    -i <nome_do_arquivo> é o nome do arquivo que será enviado. Este é um parâmetro obrigatório e nenhum valor padrão será fornecido.
    -h <nome_do_host> é o nome do host. O padrão é localhost.
    -p <porta> é o número da porta. O padrão é 9080.
    -f <sufixo_da_URL> o contexto do terminal em serviço. O padrão é /WSSampleMTOM/MtomSampleService.
    -d especifica o uso apenas do modelo dispatch.
    -x especifica o uso apenas do modelo proxy.
    -1 especifica o uso de SOAP 1.1. Esse é o padrão.
    -2 especifica o uso de SOAP 1.2.

    O exemplo a seguir ilustra uma execução bem-sucedida do aplicativo thin client do serviço MTOM no sistema operacional 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

Para saber mais sobre como o cliente e o aplicativo trabalham, consulte as notas técnicas do serviço MTOM ou visualize o código-fonte Java.