Servicio MTOM - Configurar y ejecutar


Configurar el ejemplo
Ejecutar el ejemplo

Hay dos clientes del servicio del mecanismo de optimización de transmisión de mensajes (MTOM), una versión de línea de mandatos que utiliza el archivo archivador Java (JAR) de Thin Client para JAX-WS con WebSphere Application Server y una versión de servlet que utiliza JavaServer Pages (JSP) para acceder al servicio MTOM.

Puntos finales de servicio de ejemplo
URI Descripción
http://localhost:9080/WSSampleMTOM/MtomSampleService
Ejemplo de servicio MTOM que utiliza SOAP 1.1
http://localhost:9080/WSSampleMTOM/MtomSampleService12
Ejemplo de servicio MTOM que utiliza SOAP 1.2

El puerto 9080 es el valor por omisión, pero el número de puerto es distinto si instala un perfil distinto al perfil AppSrv01.



Configurar el ejemplo

Para completar la configuración de este ejemplo, despliegue la aplicación de ejemplos de servicios Web de JAX-WS en el servidor. Si la aplicación de ejemplo aún no se ha desplegado, consulte las instrucciones en Cómo volver a crear y desplegar el archivo JaxWSServicesSamples.ear.

Ejecutar el ejemplo

Antes de empezar, debe verificar que el servidor de aplicaciones se está ejecutando antes de ejecutar los clientes.

El ejemplo del servicio MTOM consta de dos clientes y un solo enterprise bean desplegado en el servidor. Un cliente es una versión de línea de mandatos que utiliza Thin Client para JAX-WS con el archivo JAR de WebSphere Application Server. El otro cliente es una versión de servlet que utiliza un archivo JSP para acceder al servicio MTOM.

Ejecución del servlet de servicio MTOM
Ejecución de la aplicación de cliente ligero de servlet de servicio MTOM

Clientes de servicio MTOM

Los clientes de servicio MTOM envían un archivo codificado con MTOM al punto final de servicio especificado. Por omisión, el host se establece en el host local, pero puede cambiar este valor. Se precisa un nombre de archivo y no se proporciona ningún valor por omisión. En este ejemplo, el servicio recibe el archivo enviado del cliente y, a continuación, el archivo se devuelve al cliente en el modelo de programación de envío o proxy, según se especifique.

Ejecución del cliente de servlet de servicio MTOM

El cliente de servlet de servicio MTOM no está gestionado por contenedor.

Para obtener más información sobre la invocación de un cliente de servlet en un entorno de Thin Client para JAX-WS, consulte la documentación sobre la ejecución de un cliente JAX-WS de servicios Web no gestionado en la biblioteca del centro de información de WebSphere Application Server.

Para ejecutar el cliente de servicio de servlet de MTOM desde WebSphere Application Server, efectúe los siguientes pasos:

  1. Inicie el servidor.
  2. Pulse Ejecutar.

Ejecución de la aplicación de cliente ligero de servlet de servicio MTOM

El archivo WSSampleMTOMClient.jar es una versión de línea de mandatos de la aplicación de cliente ligero del servicio MTOM.

En los siguientes pasos, la variable raíz_servidor_aplicaciones hace referencia al directorio raíz de instalación del servidor de aplicaciones.

Para ejecutar la aplicación del cliente ligero de servicio MTOM desde WebSphere Application Server, efectúe los siguientes pasos, según el sistema operativo:

  1. Inicie el servidor.
  2. Abra un indicador de mandatos.
  3. Vaya al directorio JaxWSServicesSamples.

    En los sistemas operativos Windows:

    cd raíz_servidor_aplicaciones\samples\bin\JaxWSServicesSamples

    En los sistemas operativos como AIX, Linux y z/OS:

    cd raíz_servidor_aplicaciones/samples/bin/JaxWSServicesSamples

    En los sistemas operativos iSeries:

    cd raíz_servidor_aplicaciones/samples/bin/JaxWSServicesSamples

  4. Ejecute el ejemplo del servicio MTOM.

    En los sistemas operativos Windows:

    runSampleMtom.bat -i nombre_archivo -h nombre_host -p puerto -f sufijo_url -d -x -1 -2

    En los sistemas operativos como AIX, Linux y z/OS:

    ./runSampleMtom.sh -i nombre_archivo -h nombre_host -p puerto -f sufijo_url -d -x -1 -2

    En los sistemas operativos iSeries:

    ./runSampleMtom -i nombre_archivo -h nombre_host -p puerto -f sufijo_url -d -x -1 -2

    Los parámetros son:
    -i <nombre_archivo> es el nombre del archivo que debe enviar. Se trata de un parámetro necesario y no se proporciona ningún valor por omisión.
    -h <nombre_host> es el nombre del host. El valor por omisión es localhost.
    -p <puerto> es el número de puerto. El valor por omisión es 9080.
    -f <sufijo_url> es el contexto de punto final del servicio. El valor por omisión es /WSSampleMTOM/MtomSampleService.
    -d especifica que sólo se utilice el modelo de envío.
    -x especifica que sólo se utilice el modelo proxy.
    -1 especifica que se utilice SOAP 1.1. Es el valor por omisión.
    -2 especifica que se utilice SOAP 1.2.

    En el siguiente ejemplo muestra una ejecución satisfactoria de la aplicación de cliente ligero de servicio MTOM en el sistema operativo Windows:

    runSampleMtom.bat -i c:\SYSLEVEL.IBM -p 9081
    >>---------------------------------------
    >>Prueba de envío de MTOM
    >>MTOM cargando datos de: '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 invocando el envío con una carga útil binaria
    >>Respuesta MTOM recibida
    >>MTOM grabando imagen devuelta en dispatch_response.gif
    >>MTOM de envío realizada
    >>---------------------------------------
    >>Prueba de proxy de MTOM
    >>MTOM invocando proxy con una carga útil binaria
    >>Respuesta MTOM recibida
    >>MTOM grabando imagen devuelta en proxy_response.gif
    >>MTOM de proxy realizada

Para obtener más información sobre el funcionamiento del cliente y de la aplicación, consulte las notas técnicas del servicio MTOM o visualice el código fuente de Java.