Utilizar el esquema de punto de extensión
Los puntos de extensión definidos por los conectores existentes en el área
de trabajo están disponibles para el propio conector y para otros
conectores. Si se ha definido un esquema para los puntos de extensión, el PDE
puede servir de ayuda a la hora de crear extensiones nuevas. Esta ayuda consiste en:
- Proporcionar opciones para el menú emergente Nuevo con el fin de
que solo se añadan elementos hijo válidos.
- Proporcionar información de atributos para la hoja de propiedades con el
fin de que solo se establezcan atributos válidos.
- Proporcionar editores de propiedades de atributos correctos que coincidan
con los tipos (boolean, string y enumeration) de los atributos.
- Proporcionar soporte adicional para los tipos de atributos especiales
("java" y "resource").
- Utilizar la línea de estado para mostrar la primera frase del fragmento
de código de documentación de los atributos cuando se seleccionan en la hoja de
propiedades.
Ejemplo: utilizar el punto de extensión "Analizadores de ejemplo"
Para poder utilizar el punto de extensión que definimos anteriormente, primero
tenemos que definir la interfaz prevista. Seleccione el proyecto
com.example.xyz en el Navegador y pulse el botón "Crear una
interfaz Java" de la barra de herramientas. Asegúrese de establecer el
nombre del paquete en com.example.xyz y el nombre de la interfaz en
IParser antes de pulsar Finalizar. Edite la interfaz para que
sea como esta:
package com.example.xyz;
public interface IParser {
/**
* Ejecutar el analizador utilizando la modalidad proporcionada
*/
public void parse(int mode);
}
Ahora tenemos el punto de extensión, su esquema XML y la interfaz
necesaria. Asegúrese de guardar el contenido de los editores que estén
abiertos. Ya lo tenemos todo a punto para que nuestro conector u otros
conectores aporten contribuciones al punto de extensión.
- Abra el editor de manifiestos del conector com.example.xyz.
- Pase a la página Extensiones y pulse Nuevo->Extensiones basadas en esquema.
- Debe tener a su disposición la opción "Analizadores de ejemplo". Selecciónela
y pulse Finalizar.
- Seleccione el elemento "Analizadores de ejemplo" que se acaba
de añadir y active el menú emergente Nuevo->parser. (Hemos
especificado que el punto de extensión pueda aceptar cualquier número de
elementos "parser").
- Seleccione el elemento nuevo y vaya a la vista Propiedades. Deben verse
cuatro atributos: id, name, class y mode. Fíjese en
que la línea de estado muestra una breve información sobre los atributos a
medida que los selecciona. Esta información procede directamente del esquema del
punto de extensión.
- Cambie el atributo name por "Analizador por omisión".
Cambie el atributo mode por "manual".
- Seleccione el atributo class. Esta propiedad no se puede editar
directamente. Abra el diálogo de propiedades.
- Elija que desea crear una clase nueva. Seleccione el "conector XYZ" como
carpeta fuente, com.example.xyz como paquete y DefaultParser como
nombre de la clase. Pulse Finalizar.
- Ahora debe estar en el editor Java de la clase DefaultParser.
Observe que se ha implementado la interfaz correcta (IParser) y que ya
se tiene la implementación del apéndice del método "parse".
Como puede ver, si proporciona un esquema XML completo para el punto de
extensión, ello resultará de ayuda para todos los usuarios potenciales, porque el
PDE les impedirá cometer errores.
