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 Proyecto de fragmento nuevo, escriba el nombre de proyecto "com.example.german".  Acepte los valores por omisión y pulse Siguiente.

La página Contenido del fragmento tiene tres campos adicionales del asistente de creación del conector: ID de conector principal, versión de conector padre y regla de coincidencia de versión.

Como estamos escribiendo un fragmento para un conector concreto, podemos utilizar el botón Examinar para seleccionar "com.example.xyz" en el diálogo de selección de conectores. Utilizando el diálogo, también podríamos haber elegido cualquier conector externo.

Ejemplo de fragmento - Página de contenido del fragmento de ejemplo

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

Ejemplo de fragmento - Visión general de manifiesto

Al contrario que un conector, un fragmento no tiene una clase de conector ya que siguen el ciclo de vida de su conector principal.

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 "org.eclipse.ui.actionSets" en la lista de puntos de extensión. Pulse Finalizar.
  3. Seleccione el conjunto de acciones nuevo. Pulse Nuevo->actionSet en el menú emergente.
  4. En la sección Detalles de elemento de extensión, cambie la propiedad label por "Deutsche Aktionsmenge."
  5. En la sección Todas las extensiones, pulse con el botón derecho del ratón en el nuevo conjunto de acciones y seleccione Nuevo->menú en la ventana emergente.
  6. Cambie la propiedad label del menú por "Beispiel Menu" y la propiedad id por "beispielMenu".
  7. Vuelva a seleccionar el elemento de menú y elija Nuevo->separator en el menú emergente. Cambie su nombre por "beispielGruppe" y guárdelo.
  8. Cree un elemento "action" nuevo (como en el paso 6). Establezca la propiedad label en "Beispiel Aktion". Establezca la propiedad menubarPath en "beispielMenu/beispielGruppe".
  9. Pulse en el hiperenlace de la propiedad class para generar una nueva clase para la acción. Utilice "com.example.german/src" como carpeta origen y deje en blanco el nombre de paquete (utiliza el paquete por omisión). Cambie el nombre de la clase por "DeutscheBeispielAktion". Pulse Finalizar.
  10. Cuando se abra el editor Java con la nueva clase, busque el método "run" y añada lo siguiente:

    System.out.println("Hallo, PDE welt!");

  11. 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.