Ejemplo: escribir un fragmento alemán para el conector XYZ

Los asistentes y editores del PDE que manipulan conectores son prácticamente idénticos a los que manipulan fragmentos. Sin embargo, conviene tener en cuenta algunas diferencias importantes. 

Empezaremos por crear un proyecto de fragmento nuevo.   

En la primera página del asistente Fragmento nuevo, escriba el nombre de proyecto "com.example.german". Pulse Siguiente y acepte los valores por omisión de la segunda página. Pulse Siguiente otra vez. En la página "Generadores de código de fragmento", elija el botón de selección que permite crear un fragmento a partir de una plantilla y seleccione el asistente "Generador de fragmentos por omisión". Después de pulsar Siguiente, debe ver la página "Contenido de fragmento simple". 

Esta página parece algo distinta de la del asistente del conector, porque tiene dos campos adicionales: el ID y la versión del conector destino. Como estamos escribiendo un fragmento para un conector concreto, podemos utilizar el botón Examinar para seleccionar el "conector XYZ" del grupo "Conectores del área de trabajo" (también podríamos elegir uno de los conectores externos).

Ejemplo de fragmento: página de contenido de fragmento de ejemplo

Una vez creado el proyecto, se abre el editor de manifiestos de fragmento.

Ejemplo de fragmento: visión general de manifiesto

Es casi idéntico al editor de manifiestos de conector, con las excepciones siguientes:

  1. En la página Visión general, ha desaparecido el atributo "class". Los fragmentos no tienen una clase de conector porque siguen el ciclo de vida de su conector destino. En cambio, se muestran los campos del ID y la versión del conector destino. 
  2. Hay un cuadro combinado desplegable que permite definir con precisión la referencia del conector (perfecta, compatible, equivalente, etcétera).

Añadiremos un conjunto de acciones similares a las del ejemplo del conector, pero esta vez en alemán.

  1. Vaya a la página Extensiones del editor de manifiestos de fragmento. Pulse Añadir para lanzar el asistente Extensión.
  2. Seleccione "Asistentes genéricos" y "Extensión basada en esquema". Pulse Siguiente.
  3. Seleccione "Conjuntos de acciones" en la lista de puntos de extensión. Pulse Finalizar.
  4. Seleccione el conjunto de acciones nuevo. Pulse Nuevo->actionSet en el menú emergente.
  5. Vaya a la hoja de propiedades y cambie la propiedad label por "Deutsche Aktionsmenge".
  6. Vaya a la sección "Hijos de elemento de extensión" y seleccione Nuevo->menu en el menú emergente.
  7. Cambie la propiedad label del menú por "Beispiel Menu" y la propiedad id por "beispielMenu".
  8. Vuelva a seleccionar el elemento de menú y elija Nuevo->separator en el menú emergente. Cambie su nombre en las propiedades por "beispielGruppe" y guárdelo.
  9. Cree un elemento "action" nuevo (como en el paso 6). Establezca la propiedad label en "Beispiel Aktion". Establezca la propiedad menubarPath en "beispielMenu/beispielGruppe".
  10. Seleccione la propiedad class para editarla y aparecerá el diálogo del editor de la casilla. Marque el botón de selección "Generar una clase nueva".
  11. Examine en busca del contenedor de clase y seleccione la carpeta "Fragmento ALEMÁN" del proyecto "com.example.german".
  12. Cambie el nombre de la clase por "DeutscheBeispielAktion". Pulse Finalizar.
  13. Cuando se abra el editor Java con la clase nueva, busque el método "run" y añada lo siguiente:
   System.out.println("Hallo, PDE welt!");

Guarde el contenido del editor Java y del editor de manifiestos de fragmento y cierre los editores.

Cuando ejecute el fragmento utilizando el botón "Ejecutar" de la barra de herramientas, en la instancia de la plataforma de tiempo de ejecución deberá estar disponible el conjunto de acciones "Deutsche Aktionsmenge". (Utilice Ventana->Personalizar perspectiva...->Otros para acceder a la lista de conjuntos de acciones). Cuando active el conjunto de acciones, el menú "Beispiel Menu" debe figurar en la barra de herramientas. Cuando seleccione la opción del menú, debe ver "Hallo, PDE welt!" en la consola. La plataforma de tiempo de ejecución no ha visto el fragmento alemán directamente. En lugar de ello, su registro de conectores ha resuelto las referencias del fragmento de tal manera que el conjunto de acciones del fragmento apareció ante la plataforma como si procediese directamente del conector XYZ.

 
Copyright IBM Corporation y otras empresas 2000, 2003