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
de la barra de herramientas para crear una nueva interfaz Java.
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-> Extensión.
- Debe tener a su disposición la opción "com.example.xyz.parsers". Selecciónela
y pulse Finalizar.
- Seleccione el elemento "com.example.xyz.parsers" 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 nuevo elemento parser. La sección Detalles de elementos de extensión
deberá mostrar 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".
- Pulse en el hiperenlace class de la sección Detalles de elementos de extensión.
Aquí verá que el PDE está totalmente integrado con el asistente "Clase Java nueva" de JDT
y utiliza atributos de esquema para implementar automáticamente la interfaz IParser.
Cree su clase con "com.example.xyz/src" como carpeta origen, "com.example.xyz" como el
paquete y DefaultParser como el nombre de 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".
Tenga en cuenta que si cierra el editor y vuelve a pulsar en el hiperenlace
class, el editor volverá a abrir la clase DefaultParser. El asistente
"Clase Java nueva" solamente aparecerá cuando no pueda encontrarse la clase especificada
en el campo de texto del atributo de clase; de lo contrario, el enlace abrirá la clase en
un editor.
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.
