Escribir un manejador de mediación

Puede escribir un manejador de mediaciones, añadirle funciones de mediación y prepararlo para la instalación en un servidor de aplicaciones.

Antes de empezar

Debe tener acceso a un entorno de programación Java™ y una herramienta de ensamblaje como, por ejemplo, IBM® Rational Application Developer.

Acerca de esta tarea

Un manejador de mediación se puede desplegar. Cada manejador de mediación ejecuta un proceso de mensaje específico en tiempo de ejecución, por ejemplo, transformar un formato de mensaje o direccionar un mensaje a un destino concreto. Un manejador de mediación es una infraestructura de un programa Java, al que se añade el código que ejecuta la función de mediación.

Puede definir una clase de manejador de mediaciones en un proyecto Java o un proyecto EJB (que es necesario para el artefacto de despliegue). Los artefactos de programación y de despliegue se pueden separar en proyectos diferentes. Los pasos siguientes son para un proyecto EJB, pero los pasos son muy similares si desea crear un proyecto Java, porque debe definir un servidor de destino para un proyecto Java o un proyecto EJB y el plug-in de tiempo de ejecución del servidor establece la vía de acceso de clases correctamente.

Procedimiento

  1. Cree un nuevo proyecto EJB:
    1. Vaya a la perspectiva Java EE para trabajar con proyectos Java EE. Pulse Ventana > Abrir perspectiva > Otro > Java EE.
    2. En el menú Archivo, seleccione Nuevo > Proyecto.
    3. Expanda la carpeta Java EE y seleccione Proyecto de aplicación empresarial. Pulse Siguiente.
    4. Opcional: Si ha creado un proyecto Java en lugar de un proyecto EJB, pulse con el botón derecho del ratón en el icono de la carpeta del proyecto Java para el menú contextual y seleccione Propiedades. Cuando aparezca el panel de Propiedades, seleccione las propiedades del servidor y el destino del proyecto en un servidor adecuados para su sistema, como en el paso siguiente.
    5. Escriba un nombre para el proyecto y el destino del proyecto en un servidor apropiado para el sistema. (Si esta es la primera vez que selecciona como destino este servidor, pulse Nuevo...). Pulse Siguiente para pasar a la ventana Proyectos de módulo EAR.
    6. Pulse Nuevo proyecto de módulo....
    7. Cree un nuevo proyecto de módulo seleccionando el recuadro de selección del proyecto EJB y especificando el nombre del manejador de mediación.
    8. Pulse Finalizar. Regresará a la ventana Proyectos de módulo EAR.
    9. Pulse Finalizar para crear el proyecto nuevo.
  2. Cree una clase de manejador de mediación implementando la interfaz com.ibm.websphere.sib.mediation.handler.MediationHandler.
    1. En el menú Archivo, seleccione Nuevo > Clase Java.
    2. Especifique la carpeta de origen para el proyecto EAR de mediación.
    3. Especifique un nombre para el manejador de mediación.
    4. Seleccione la superclase java.lang.Object.
    5. Seleccione la interfaz com.ibm.websphere.sib.mediation.handler.MediationHandler.
    6. Seleccione el recuadro de selección Métodos abstractos heredados.
    7. Pulse Finalizar para crear la nueva clase de manejador de mediación.
  3. Añada código funcional que transforme o direccione los mensajes al manejador de mediación utilizando IBM Rational Application Developer. Para obtener más información, consulte Adición de funciones de mediación al código del manejador. Tenga precaución porque el valor de retorno predeterminado del método de manejador creado por el kit de herramientas AST es false, que causará que se descarte el mensaje. Debe cambiar el valor de retorno por true para conservar el mensaje.
  4. Genere un archivo EAR a partir de la clase de manejador de mediación. Siga las instrucciones de la documentación de IBM Rational Application Developer.

Qué hacer a continuación

A continuación, ya podrá instalar el archivo EAR que contiene el manejador de mediación en el servidor de aplicaciones.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjy1700
File name: tjy1700.html