Después de crear un proyecto de plug-in para que contenga los artefactos para un analizador de anotaciones, debe configurar el plug-in para que lo pueda utilizar el Analizador de anotaciones y rastreo. Siga los pasos que se indican a continuación:
Se deben incluir las dependencias de plug-in siguientes al archivo de manifiesto de plug-in. Abra el archivo plugin.xml en un editor de texto. Localice el elemento necesario en el archivo y añada las dependencias de plug-in al mismo. Por ejemplo:
<import plugin="org.eclipse.core.runtime"/> <requires> <import plugin="org.eclipse.hyades.logging.adapter"/> <import plugin="org.eclipse.hyades.logging.parsers"/> <import plugin="org.eclipse.hyades.logging.adapter.config"/> </requires>
Nota: Los plug-ins necesarios especificados más arriba se deben situar en el directorio de plug-ins de Eclipse, o bien, se deben incluir en el espacio de trabajo actual.
Debe definir un punto de extensión para cada tipo de archivo de anotaciones de aplicación que desea analizar e importar al Analizador de anotaciones y rastreo. Más abajo se muestra un punto de extensión de ejemplo para la aplicación MyApp con un adaptador de reglas y un adaptador estático definidos:
<extension
point="org.eclipse.hyades.logging.parsers.logParser">
<parser
name="Sample Rules Adapter for MyApp"
icon=""
description="%STR_MYAPP_PARSER_DESCRIPTION"
class="RulesParser.StaticParserExtension"
ui_name="MyApp myapp.log file"
id="org.eclipse.hyades.logging.parsers.MyAppLogParser">
<field
useBrowse="true"
defaultValue="d:\temp\sample.log"
name="Directory"
helpContextId=""
tooltip="%STR_MYAPP_TOOLTIP1"
id="file_path"
browseType="*.log">
</field>
<field
useBrowse="false"
defaultValue="MyApp 1.0(rules), MyApp 1.0(static)"
name="Supported versions"
helpContextId=""
tooltip="%STR_MYAPP_TOOLTIP2"
ui_type="combobox"
id="version">
</field>
<parserParameter
name="MyApp 1.0(rules)"
value="./MyAdapter/myadapter.adapter">
</parserParameter>
<parserParameter
name="MyApp 1.0(static)"
value="./MyAdapter/mystaticadapter.adapter">
</parserParameter>
</parser>
</extension>
Para personalizar el punto de extensión para el analizador de anotaciones, debe realizar algunas actualizaciones:
<parserParameter name="Default" value="./MyAdapter/myadapter.adapter"> </parserParameter>
Los campos especificados más arriba crean una opción para myapp.log de MyApp en el asistente de Importar anotaciones, tal como se muestra más abajo:
Puede utilizar un archivo plugin.properties para definir determinadas propiedades en el archivo plugin.xml por si necesita tener versiones diferentes. Por ejemplo, si hay cadenas de caracteres de texto que se van a incluir en el asistente de Importar archivo de anotaciones, y que se deben traducir a diferentes idiomas, se pueden definir en el archivo plugin.properties e incluir archivos de propiedades diferentes para los idiomas para los que desea ofrecer soporte. En el archivo plugin.properties puede definir las variables de sustitución que se pueden utilizar en el archivo plugin.xml. El archivo plugin.properties para el archivo plugin.xml anterior podría ser similar al siguiente:
# Propiedades para el plug-in RulesParser pluginName = RulesParser providerName = MyCompany # Mensajes de punto de extensión de logParser: STR_MYAPP_PARSER_DESCRIPTION = Analizador de reglas de MyApp v1.0 STR_MYAPP_TOOLTIP1 = Especifique la ubicación del archivo de anotaciones STR_MYAPP_TOOLTIP2 = Seleccione la versión del archivo de anotaciones que importar
Sugerencia: Una aplicación puede escribir datos en el archivo de anotaciones en diferentes idiomas, dependiendo del entorno local en el que se ejecute. Las clases de analizador estático o las reglas de las expresiones regulares se escriben para analizar un archivo de anotaciones en un solo idioma. Por este motivo, para ofrecer soporte para un tipo de archivo de anotaciones que se pueda escribir en varios idiomas, se debe crear un archivo de adaptador de analizador estático separado o un archivo de adaptador de reglas para cada idioma. A continuación, en el punto de extensión logParser para el tipo de archivo de anotaciones, se debe añadir una etiqueta parserParameter para cada archivo de adaptador especificando el idioma al que se aplica en el campo de nombre. No olvide añadir los valores de nombre de parserParameter a la lista en el atributo defaultValue del campo de versión. De este modo, al importar el archivo de anotaciones, el usuario puede elegir el idioma correcto del archivo de anotaciones.
Por ejemplo, se pueden añadir los parámetros de analizador siguientes al punto de extensión logParser para ofrecer soporte para la importación de anotaciones en inglés, francés y alemán:
<parserParameter name="MyApp 1.0(rules) English" value="./MyAdapter/myadapter_en.adapter"/> <parserParameter name="MyApp 1.0(rules) French" value="./MyAdapter/myadapter_fr.adapter"/> <parserParameter name="MyApp 1.0(rules) German" value="./MyAdapter/myadapter_de.adapter"/>
Este paso es obligatorio si se crea un analizador estático.
Para analizadores estáticos, la clase de analizador estático que se crea se debe especificar en el plugin.xml por medio de una extensión staticParser. Este punto de extensión permite que se pueda localizar la clase cuando se utiliza para analizar un archivo en el localice la clase en el caso de Importación de anotaciones.
Añada el punto de extensión siguiente:
<extension
point="org.eclipse.hyades.logging.adapter.config.staticParser">
<parserClassname
name="myLogParser33.MyStaticParser">
</parserClassname>
</extension>
Cree una clase de ajustador estático que amplíe org.eclipse.hyades.logging.adapter.config.StaticParserWrapper. Utilizan esta clase los analizadores estáticos y los analizadores basados en reglas para ejecutar el archivo de configuración del adaptador asociado a la versión que selecciona el usuario en el asistente de Importación de anotaciones, utilizando el tiempo de ejecución del Adaptador de anotaciones genérico.
/*
* Created on Apr 12, 2004
* StaticParserExtension class created to be used in RulesParser Plug-in
*/
package RulesParser;
import org.eclipse.hyades.logging.adapter.config.StaticParserWrapper;
/**
* @author developer
* StaticParserExtension class
*/
public class StaticParserExtension extends StaticParserWrapper {
public StaticParserExtension(){
super();
currentPlugin="RulesParser";
}
}
Para verificar si ha configurado correctamente el archivo de manifiesto del plug-in, puede ejecutar el proyecto de plug-in en una nueva área de trabajo de tiempo de ejecución. Siga los pasos que se indican a continuación:
Para desplegar el plug-in del analizador de anotaciones en un área de trabajo Eclipse, debe empaquetar los archivos de plug-in exportándolos a un archivo zip. Siga los pasos que se indican a continuación:
<?xml version="1.0" encoding="UTF-8"?>
<PluginConfiguration requires="org.eclipse.hyades.logging.parsers">
<Application configuration="default"
executable="RemoteLogParserLoader"
extends="default"
location=="%SYS_TEMP_DIR%"
path="%JAVA_PATH%">
<Variable name="CLASSPATH"
position="prepend"
value="%RASERVER_HOME%\plugins\RulesParser_1.0.0\parsers.jar"/>
<Variable name="GLA_CONFIG_PATH" position="prepend" value="%RASERVER_HOME%\plugins\RulesParser_1.0.0"/>
<Parameter position="append" value=""config_path=%GLA_CONFIG_PATH%""/>
</Application>
<Option name="RulesParser" type="version" value="1.0.0"/>
</PluginConfiguration>
Puede desplegar el plug-in del analizador de anotaciones descomprimiendo el archivo zip que acaba de crear en el directorio eclipse de una instalación de Eclipse. Ahora ya está preparado para probar el plug-in del analizador de anotaciones recién creado utilizando el Analizador de anotaciones y rastreo.
Para desplegar el plug-in del analizador de anotaciones en un sistema remoto a fin de que se pueda importar de modo remoto un archivo de anotaciones, descomprima el archivo zip que acaba de crear en el directorio de instalación del controlador de agentes del sistema remoto. Reinicie el controlador de agentes.
Conceptos relacionados
Tareas relacionadas
Crear un analizador de anotaciones
Crear un adaptador estático
Crear un adaptador basado en reglas
Probar un analizador de anotaciones
Configurar un proyecto de plug-in para un analizador de anotaciones
Consultas relacionadas
Estructura del archivo de configuración del adaptador
Editor de configuraciones de adaptador
Gramática de las expresiones regulares
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.