Añadir un componente personalizado a un adaptador

El Adaptador de anotaciones genérico se puede ampliar por medio de la adición de componentes personalizados que se pueden incluir en el contexto de un archivo de configuración del adaptador. Los componentes personalizados se pueden añadir como un nuevo componente del adaptador, o bien, se pueden utilizar para reemplazar un componente existente del adaptador.

Requisito previo:
Crear un adaptador basado en reglas
Crear un componente personalizado

Añadir un nuevo componente al adaptador

Para añadir un nuevo componente a un adaptador:

  1. En la perspectiva Adaptador de anotaciones genérico, seleccione el archivo de configuración del adaptador en el panel Navegador. Pulse el botón derecho del ratón y seleccione Abrir con > Editor de configuraciones de adaptador. El archivo se abre en el editor.
  2. En la ventana Editor de configuraciones de adaptador, expanda el nodo Adaptador > Configuración > Instancia de contexto.
  3. Pulse el botón derecho del ratón sobre Instancia de contexto y seleccione Añadir > Unidad de proceso. Se crea una nueva unidad de proceso en la Instancia de contexto.
  4. Especifique una descripción para el componente en el campo Descripción.
  5. Si hay entradas obligatorias para el componente, añada propiedades a la unidad de proceso para cada entrada necesaria. Para añadir una propiedad a la unidad de proceso, pulse el botón derecho del ratón sobre la unidad de proceso y seleccione Añadir propiedad.
  6. Para cada propiedad añadida, especifique un nombre y valor para la propiedad.
  7. Para configurar el adaptador para utilizar la nueva unidad de proceso, debe crear un componente asociado en un contexto. Abra el contexto al que desea añadir la unidad de proceso. Para abrir el contexto por omisión, seleccione Adaptador > Contextos > Contexto de implementación básica de contexto.
  8. Pulse el botón derecho del ratón sobre el contexto al que desea añadir la unidad de proceso. Para el contexto por omisión, pulse el botón derecho del ratón sobre Contexto de implementación básica de contexto y seleccione Añadir > Componente. Se añade un nuevo componente al contexto.
    Nota: El orden en el que aparecen los componentes en el Contexto define el orden en el que se ejecutan. Asegúrese de que coloca el nuevo componente en el orden correcto. Puede cambiar el orden de los componentes en el contexto por medio de arrastrar y soltar.
  9. Configure el nuevo componente con los valores siguientes:
    Nombre: Nombre de la nueva unidad de proceso en el contexto
    Descripción: Descripción de lo que hace el componente
    Clase ejecutable: Clase Java que se ha creado para este componente
    Nivel de anotacionesNivel de anotaciones internas que debe utilizar el componente productor.
    Un valor de 99 significa que el productor no va a anotar ningún mensaje.
    Un valor de 0 significa que el productor va a anotar mensajes de todos los niveles de gravedad.
    El valor que se recomienda es 50, puesto que significa que sólo se van a anotar los mensajes de error del productor internos Críticos y Muy graves.
    Rol: El rol del componente se debe seleccionar de la lista desplegable. Consulte el apartado Estructura del archivo de configuración del adaptador para obtener información sobre los diferentes roles. Para un rol que no esté en la lista, seleccione no declarado.
    ID exclusivo: Debe señalar al componente que se ha definido en la Instancia de contexto en el paso 3. Utilice el botón Examinar para seleccionar el ID correcto.
  10. Guarde los cambios del archivo de configuración del adaptador.

Reemplazar un componente existente de un adaptador

Para reemplazar un componente existente de un adaptador con un componente personalizado:

  1. En la ventana Editor de configuraciones de adaptador, expanda el contexto en el que desea reemplazar un componente. Para expandir el contexto por omisión, seleccione y expanda el nodo Adaptador > Contextos > Implementación de contexto básica de contexto.
  2. Pulse el componente que desea reemplazar. Los detalles del componente se muestran en el panel situado a la derecha.
  3. Actualice los campos Nombre y Descripción para describir el componente.
  4. Actualice la Clase ejecutable con el nombre de la clase de componente personalizado. Más abajo se incluye un ejemplo de un componente de productor que se ha reemplazado por un productor personalizado.
    El productor de componente de implementación de contexto se ha actualizado con cambios para un componente personalizado
  5. Si el componente que va a reemplazar requiere propiedades específicas, abra el nodo Configuración > Instancia de contexto y seleccione el componente que va a reemplazar.
  6. Añada propiedades según se requiera para el componente seleccionando Añadir propiedad. Elimine las propiedades que no se necesiten para la configuración del componente pulsando el botón derecho del ratón sobre la propiedad y seleccionando Suprimir.
  7. Guarde los cambios del archivo de configuración del adaptador.

Tareas relacionadas
Crear un analizador de anotaciones

Consultas relacionadas
Estructura del archivo de configuración del adaptador