El Adaptador genérico de anotaciones proporciona una clase Outputter que permite enviar los objetos Suceso base común generados por su adaptador a un Agente de anotación. El Analizador de rastreo y anotaciones se puede utilizar para la conexión al Agente de anotación, para supervisar y analizar las anotaciones de la aplicación en tiempo real.
Requisitos previos:Siga estos pasos para configurar el adaptador para supervisión.
Nota: Cuando se crea un archivo de configuración de adaptador nuevo, se configura
utilizando la clase CBELogOutputter por omisión. Si no se ha cambiado este valor, puede
saltar este procedimiento.
El componente Outputter del archivo de configuración del adaptador se debe actualizar para que
utilice la clase CBELogOutputter que graba los objetos Suceso base común en un Agente de
anotaciones. Se puede actualizar el componente Outputter existente o añadir un
componente Outputter nuevo.
Para añadir un componente Outputter nuevo:
Si quiere que el analizador de anotaciones supervise el archivo de anotaciones de forma continua, hay que actualizar las propiedades de instancia de contexto del archivo de configuración del adaptador para que funcione continuamente.
El analizador de anotaciones creado se puede ejecutar de forma externa desde un
archivo por lotes en el entorno de Windows o en un script de shell en entornos que no
sean Windows. A continuación se muestran archivos de ejemplo que se pueden utilizar para
lanzar el proceso Java que ejecutará el adaptador de anotaciones.
Nota: Para conectar y supervisar el agente de anotaciones
creado por el Adaptador de anotaciones genérico, Agent Controller debe estar instalado
en el sistema en que se ejecutará el Adaptador genérico de anotaciones y se debe iniciar
antes de iniciar el Adaptador genérico de anotaciones.
Archivo por lotes de Windows:
@rem USO: runregex @rem OBJETIVO: Muestra las posibilidades funcionales en tiempo de ejecución del Analizador genérico de anotaciones (GLA) utilizando un archivo adaptador y un archivo de anotaciones de ejemplo. @rem INSTRUCCIONES: Cuando se ejecuta en un entorno de ejecución de GLA, hay que cambiar el valor de la variable de entorno %GLA_HOME% por la vía de acceso absoluta del la ubicación del tiempo de ejecución GLA descomprimido. @rem NOTA: Cuando se ejecuta en un entorno de ejecución de conector (p.e. Eclipse), hay que crear un directorio de trabajo temporal y cambiar el valor de la variable de entorno %GLA_HOME% @rem por la vía de acceso absoluta del nuevo directorio de trabajo temporal. Además, hay que crear el directorio %GLA_HOME%\config y copiar el contenido del conector org.eclipse.hyades.logging.adapter.config @rem en el nuevo directorio %GLA_HOME%\config. Por último, hay que crear un directorio %GLA_HOME%\lib y copiar los archivos JAR siguientes en el directorio %GLA_HOME%\lib nuevo: @rem Plug-in | JAR @rem --------------------------------------------------- @rem org.eclipse.hyades.logging.adapter | hgla.jar @rem org.eclipse.hyades.logging.core | hlcbe101.jar @rem org.eclipse.hyades.logging.core | hlcore.jar @rem org.eclipse.hyades.execution.remote | hexr.jar @rem org.eclipse.emf.ecore | ecore.jar @rem org.eclipse.emf.common | common.jar SET GLA_HOME=d:\GenericLogAdapter SET MY_DIRECTORY=MyAdapter SET CONFIG_FILE=%GLA_HOME%\config\%MY_DIRECTORY%\myadapter.adapter PUSHD %GLA_HOME%\config\%MY_DIRECTORY%\java -DGLA_HOME="%GLA_HOME%" -classpath "%GLA_HOME%\lib\hgla.jar;%GLA_HOME%\lib\hexr.jar;%GLA_HOME%\lib\hlcbe101.jar;%GLA_HOME%\lib\ecore.jar;%GLA_HOME%\lib\common.jar;%GLA_HOME%\lib\hlcore.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%" POPDArchivo por lotes para entornos que no son Windows:
#!/bin/sh # USO: runregex_example.sh # OBJETIVO: Muestra las posibilidades funcionales en tiempo de ejecución del Analizador genérico de anotaciones (GLA) utilizando un archivo adaptador y un archivo de anotaciones de ejemplo. # INSTRUCCIONES: Cuando se ejecuta en un entorno de ejecución de GLA, hay que cambiar el valor de la variable de entorno $GLA_HOME por la vía de acceso absoluta del la ubicación del tiempo de ejecución GLA descomprimido. # NOTA: Cuando se ejecuta en un entorno de ejecución de conector (p.e. Eclipse), hay que crear un directorio de trabajo temporal y cambiar el valor de la variable de entorno $GLA_HOME # por la vía de acceso absoluta del nuevo directorio de trabajo temporal. Además, hay que crear el directorio $GLA_HOME/config y copiar el contenido del conector com.ibm.etools.logging.adapter.config # en el nuevo directorio $GLA_HOME/config. Por último, hay que crear un directorio $GLA_HOME/lib y copiar los archivos JAR siguientes en el directorio $GLA_HOME/lib nuevo: # Plug-in | JAR # --------------------------------------------------- # org.eclipse.hyades.logging.adapter | hgla.jar # org.eclipse.hyades.logging.core | hlcbe101.jar # org.eclipse.hyades.logging.core | hlcore.jar # org.eclipse.hyades.execution.remote | hexr.jar # org.eclipse.emf.ecore | ecore.jar # org.eclipse.emf.common | common.jar GLA_HOME=/home/eclipse/GenericLogAdapter export GLA_HOME YOUR_DIRECTORY=MY_DIRECTORY export MY_DIRECTORY CONFIG_FILE="$GLA_HOME/config/$MY_DIRECTORY/myadapter.adapter" export CONFIG_FILE CUR_DIR=`pwd` export CUR_DIR cd "$GLA_HOME/config/$MY_DIRECTORY java -DGLA_HOME="$GLA_HOME" -classpath "$GLA_HOME/lib/hgla.jar:$GLA_HOME/lib/hexr.jar:$GLA_HOME/lib/hlcbe101.jar:$GLA_HOME/lib/ecore.jar:$GLA_HOME/lib/common.jar:$GLA_HOME/lib/hlcore.jar"org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE" cd "$CUR_DIR"Configure el archivo según sea necesario para lanzar el proceso Java que ejecutará su adaptador.
Ya está preparado para supervisar las anotaciones de la aplicación en tiempo real.
Conceptos relacionados
Visión general de Hyades Generic
Log Adapter
Especificación del formato de Suceso de base común
Tareas relacionadas
Creación de un analizador de anotaciones
Consultas relacionadas
Estructura del archivo de configuración de adaptador
Editor de configuración de adaptador
Gramática de expresiones regulares
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.