Este documento describe cómo construir un generador de código utilizando MOSKitt SDK. Explica la estructura general de una transformación modelo a texto (M2T) y proporciona detalles sobre el metamodelo DataForms y el entorno de desarrollo. Además, detalla directivas y funciones útiles de Xpand para definir plantillas de transformación que generan HTML a partir de modelos DataForms. Finalmente, propone algunas actividades prácticas para aplicar la transformación y extenderla a nuevos tipos de datos.

1. Construye tu propio generador de código con MOSKitt SDK Jose Manuel García Valladolid Héctor Iturria Sánchez [email_address] [email_address]

2. Estructura general de una transformación

3. Estructura de una transformación M2T

4. Contexto de Entrada Modelo de dominio: UML2 Class Modelo de Interfaz de Usuario: DataForms

5. Contexto de Entrada

6. Metamodelo DataForms El usuario interactúa con el sistema a través de un Editor de formularios.

7. Este editor de formularios es una ventana con título que contiene un conjunto de páginas. Cada página tiene una etiqueta que le permite al usuario identificarla.

8. El editor proporcionará algún mecanismo para que el usuario pueda conmutar entre páginas accediendo al contenido de cada una de ellas.

9. Una página del editor es un contenedor de formularios de datos.

10. Un formulario de datos es un contenedor de campos y botones de acción. Existen dos estrategias de disposición de los campos y botones en un formulario: a modo de registro y a modo tabular.

11. Cada campo tiene una etiqueta para que el usuario pueda identificarlo.

12. Cada botón de acción también tendrá una etiqueta para poder identificarlo.

13. Cada campo del formulario representará el dato definido por una propiedad de una clase UML2. Se establece pues una referencia y/o dependencia sobre UML2.

14. Cada botón de acción tendrá una referencia con una operación de una clase UML2.

15. Metamodelo Ecore DataForms

16. Contexto de Salida: HTML+CSS

17. Entorno de desarrollo

18. Plugin de Transformación M2T

19. Definición de la transformación

20. Clase XPANDTransformation I

21. Clase XPANDTransformation II

22. Workflow XPAND

23. Workflow XPAND

24. Plantillas Xpand Importa una definición de modelo

25. Carga una extensión

26. Define una sección de una plantilla para una clase Java simple que es aplicada a un elemento del tipo Entity .

27. Directivas básicas Xpand DEFINE : definición de una plantilla. Tiene un nombre y se aplica a un tipo de elemento específico (incluidas las colecciones).

28. IMPORT : da acceso a las plantillas y metamodelos definidos en un espacio de nombres dado.

29. EXTENSION : carga extensiones en lenguaje XTend.

30. Directivas para control de flujo EXPAND : se usa para ejecutar un bloque DEFINE para un elemento del tipo especificado.

31. FOR y FOREACH (dentro de EXPAND ): permiten aplicar una definición de una plantilla a una colección de elementos. FOR -> Ejecuta la plantilla para el resultado de la expresión.

32. FOREACH -> Ejecuta la plantilla para todos los elementos de la colección especificada. Es posible indicar un separador. IF : Define la ejecución condicional del bloque que encierra.

33. Otras directivas FILE : define una sección en la cual todo el texto generado por las directivas existentes será almacenado en el fichero especificado.

34. LET : permite definir variables y su contenido.

35. ERROR : permite detener el procesamiento de las plantillas.

36. REM : permite la inclusión de comentarios en nuestras plantillas.

37. Funciones interesantes Operaciones sobre collecciones: Select: books.select(b | b.isReserved = false);

38. Collect: books.collect(b.title | b.isReserved = false);

39. SortBy: books.sortBy(b.author);

40. Size: books.size

41. Exists: books.exists(b | b.isReserved = false);

42. Get: books.get(1); Otras operaciones IsInstance: library::Book.isInstance(selectedObject)

43. Actividad 1 Uso del gestor de transformaciones de MOSKitt. Abrir el modelo ClubUI.dataforms y evaluar el diseño de interfaz de usuario que propone.

44. Lanzar la transformación a partir del modelo DataForms de ejemplo.

45. Comprobar el resultado. Verificar que la aplicación HTML generada concuerda con el modelo DataForms de entrada.

46. Actividad 2 Modelar una página nueva con DataForms La página contendrá un formulario tipo registro para los atributos de la clase Socio del modelo de dominio UML2.

47. Añadir, además, 2 acciones al formulario, “Guardar” y “Cancelar”.

48. Ejecutar la transformación y comprobar el resultado.

49. Actividad 3 Dar soporte a la transformación para el tipo de datos uml::Boolean Modificar la plantilla XPAND “field.xpt” para incluir el soporte a uml::Boolean.

50. El control HTML asociado a este tipo de dato será un CheckBox. Su código HTML es: <input name=”nombreControl” type=”checkbox”/>

51. Crear en el modelo UML2 club.uml un atributo nuevo a la clase Participacion llamado enVenta de tipo uml::Boolean.

52. Crear un campo nuevo en formulario de la página de Participación asociado al atributo enVenta.

53. Ejecutar la transformación y comprobar el resultado.

54. Actividad 4 Dar soporte a la transformación para el tipo de datos uml::Enumeration Modificar la plantilla XPAND “field.xpt” para incluir el soporte a uml::Enumeration.

55. El control HTML asociado a este tipo de dato será un ComboBox. Su código HTML es: <select name=”nombreControl”> <option name=”opcion”>TituloOpcion</option> </select>

56. Ejecutar la transformación y comprobar que el campo TipoSocio está soportado en el resultado.

57. Actividad 5 Dar soporte al patrón de visualización VisualizationPattern de un Form en DataForms Modificar las plantillas necesarias para que la disposición de los campos del formulario sea: Registro: disposición actual.

58. Tabular: se creará una tabla en la que la primera línea contendrá los títulos de las columnas, que serán las etiquetas de los campos. Después en una segunda línea contendrá cada uno de los campos. Realizar cambios en el modelo DataForms de entrada y comprobar la transformación.