Herramienta CASE (Bouml) Ingeniería de la Programación Práctica 6 1
Contenido La presentación es una traducción, con alguna pequeña aportación, del tutorial sobre Bouml que puede encontrarse en inglés en: http://bouml.free.fr/tutorial/tutorial.html Introducción a Bouml. Arranque de la herramienta. Creación de un proyecto. Vistas. Vista de clase. Creación de diagramas de clase. Vista de casos de uso. Creación de diagramas de casos de uso Captura de modelos al portapapeles. Generación de documentación en HTML. Estructuración del proyecto en paquetes. Generácion de código. Reverse Engineering. 2
Introducción a Bouml Bouml = Bo UML Es una herramienta CASE libre, no integrada con Eclipse. Descargas desde: http://bouml.free.fr/ Características: Versiones: Unix/Linux/Solaris, MacOS X(Power PC and Intel) y Windows. Soporta los modelos de UML 2.0 Extensible y las extensiones pueden programarse en C++ o Java. Dispone de extensiones para generar código en varios lenguajes (Java, C++, PHP, Phyton, etc.) y realizar ingeniería inversa. Herramientas adicionales para el control de proyectos y la sincronización de los mismos. 3
Introducción a Bouml Extensiones adicionales: Generador de máquinas de estados. Generación de documentación en HTML, los diagramas pueden ser generados en PNG o SVG. Generadores para el lenguaje de intercambio entre herramientas Case XMI 1.2 y 2.1 generators Importa archivos en XMI 2.1. Asistente (Wizard) para casos de uso. Utilizades para código en C++. Etc. 4
Arranque de la herramienta La primera vez que se ejecuta aparece el siguiente mensaje de error: Para eliminarlo introduzca un número entero que permitirá identificar al usuario que está trabajando en el proyecto. 5
Creación de un proyecto La ventana principal, que aparece al arrancar la herramienta, está dividida en las siguientes zonas: Editor de Diagramas Navegador de diagramas Panel de mensajes 6
Creación de un proyecto Para crear un proyecto nuevo seleccione: Proyecto -> New. En este caso se crea un nuevo directorio bajo /tmp/ con el nombre del proyecto, dentro se crean varios archivos uno de ellos foo.prj. Al crear el proyecto aparece un diálogo para recordarnos que debemos elegir el lenguaje(s) en el que queramos generar código. 7
Creación de un proyecto En el menú Languages podemos seleccionar uno o varios. En el navegador de proyecto aparece el nombre del proyecto que acabamos de crear. No cambie el nombre a ninguno de los archivos generados por Bouml en el directorio en el que se almacena el proyecto. Para llevarse el proyecto a otro ordenador comprima el directorio que contiene el proyecto. 8
Vistas Para poder crear modelos como un diagrama de clases, en el proyecto hay que definir vistas. Las vistas soportadas y los modelos UML que pueden incluirse en las mismas, son las siguientes: Vista Casos de uso Clases Componentes Despliegue Modelos casos de uso, secuencia, comunicación, objetos, máquina de estados y de actividad. diagrama de clases, secuencia, comunicación, objetos, máquina de estados y de actividad. Diagrama de componentes Diagrama de despliegue 9
Creación de Vistas de clase En el navegador del proyecto, sobre el nombre del proyecto creado (proyecto 1), pulse el botón derecho del ratón y seleccione: New class view y ponga un nombre (vista de clases 1), tal como se muestra en las siguientes ventanas. 10
Creación de diagramas de clase Una vez creada la vista de clase, selecciónela y pulse el botón derecho del ratón y seleccione New class diagram, póngale nombre (diagrama de clases 1). 11
Creación de diagramas de clase Al hacer doble click en la ventana de proyecto sobre el nuevo diagrama de clases, nos aparece la zona de edición gráfica. 12
Creación de diagramas de clase Para añadir clases al diagrama puede: seleccionar el icono correspondiente de la barra de herramientas y pulsar sobre la zona de edición, o bien, crear la clase en la zona de navegación del proyecto (selecciones la vista de clases sobre la que está trabajando, pulse el botón derecho del ratón y seleccione New Class) y arrastrarla sobre la zona de dibujo del diagrama. Dibuje las clases Cliente y Pedido. Puede acceder a la ventana de configuración de la clase haciendo doble click sobre la clase seleccionada. 13
Creación de diagramas de clase (atributos) Para añadir atributos a una clase, seleccione la clase en la ventana de navegación de proyecto, o en el diagrama. Pulse el botón derecho del ratón y seleccione Add atribute y ponga el nombre. P.e. Añada el atributo nombre a la clase Cliente. 14
Creación de diagramas de clase (atributos) Después de poner nombre al atributo se muestra la ventana de edición de atributos, donde podemos añadir el tipo, los valores iniciales y cambiar el script de generación de código, en las pestañas de los lenguajes del proyecto (C++, Java en este caso). También puede modificarse la visibilidad del atributo. Defina el atributo nombre de tipo String y privado. 15
Creación de diagramas de clase (métodos) En la ventana de proyecto seleccionado el atributo y con el botón derecho del ratón se pueden añadir los métodos setter y getter, que modifican el valor del mismo o lo retornan. 16
Creación de diagramas de clase (métodos) Con el botón derecho sobre la clase correspondiente se selecciona Add operation, se da nombre al método y, a continuación, el sistema muestra la ventana de edición de métodos. Puede indicar la visibilidad, valor de retorno (value type), parámetros y excepciones. En la pestaña Java puede observar la estructura de código Java que se generará. Añada el método public void fijar_limite_credito (int lim) 17
Creación de diagramas de clase (asociaciones) Seleccione en la barra de herramientas el símbolo de asociación y conecte las dos clases (Pedido y Cliente). Seleccione la relación y con el botón derecho del ratón marque Edit, en la ventana resultante puede fijar la multiplicidad y otras propiedades de la relación. 18
Creación de diagramas de clase (agregación) Las relaciones de agregación referencial e inclusiva se crean de la misma forma. Añada al diagrama, las clases y relaciones de la figura. 19
Creación de diagramas de clase (especialización) Se dibujan de igual forma que las anteriores. Añada las clases Persona y Empresa como clases derivadas de Cliente. 20
Creación de diagramas de clase (tipo enum) Los tipos enumerados se crean mediante estereotipos. Para crear el tipo enumerado tipo_cliente con dos valores (nacional, internacional) Cree una nueva clase con ese nombre. En la ventana de edición de Clases, escoja el estereotipo enum. Pulsando con el botón derecho sobre la clase enumerada, seleccione Add item para añadir los distintos valores enumerados. 21
Creación de diagramas de clase (borrado) Puede borrar un elemento (clase o relación) de la vista, con el botón derecho seleccione Remove from the view. Para borrar el elemento del modelo seleccione Delete from model. Undelete. Los elementos gráficos se pueden borrar y sobre ellos posteriormente puede aplicarse la operación undelete. Si borramos la asociación entre pedido y cliente, en el navegador de proyecto aparece marcada con un aspa roja. Los elementos marcados con el aspa roja (deleted) no se borran hasta que se cierra el proyecto. Al seleccionar el elemento borrado y pulsar con el botón derecho del ratón podemos marcar Undelete. Para que la relación aparezca dibujada de nuevo en el diagrama arrástrela sobre el mismo. 22
Capturar modelos al portapapeles Sobre el diagrama de clases del ejemplo que estamos siguiendo, pulse con el botón derecho del ratón para que le aparezca el menú de captura: Las opciones en el cuadro rojo permiten copiar al portapapeles o salvar en formato gráfico (png, svg) el contenido de los modelos. Copiar la parte óptima permite capturar la zona que contiene únicamente elementos gráficos. Copiar la parte visible captura el lienzo de dibujo visible en la pantalla. El diagrama una vez abierto puede ser también enviado a imprimir (vea la barra de herramientas debajo del menú principal). 23
Creación de vistas de casos de uso Tal como se ha comentado anteriormente, dentro de un proyecto puede crearse una vista de casos de uso y dentro de ésta un diagrama de casos de uso. En la paleta de herramientas del diagrama de casos de uso se muestra: 24
Generación de documentación en HTML Sobre la venta de navegación de proyecto, en el nodo que contien el nombre del mismo, pulse el botón derecho del ratón y en Tools -> HTML documentation. Elija el directorio dónde desea que se creen los archivos html. Puede abrir con el navegador cualquiera de los siguientes archivos html: Index.html Index-withframe.html 25
Estructuración del proyecto en paquetes Aunque las distintas vistas se pueden situar en el navegador de proyectos debajo del proyecto, es conveniente en sistemas complejos (con gran número de diagramas) estructurar las vistas en paquetes. Dentro de las vistas, en el navegador, no pueden situarse paquetes, pero debajo del nodo del proyecto sí, con los niveles de anidamiento que el analista considere oportunos. Debajo de cada paquete pueden situarse las vistas que se consideren oportunas. 26
Generación de código En primer lugar se debe generar un artefact (archivo de código fuente.java) para cada clase. Para ello se crea una Vista de Despliegue: con el botón derecho sobre el proyecto seleccionar New Deployment View y dar un nombre a la vista (p.e. Vista de Despliegue 1). Seleccione en el navegador de proyecto la vista de clases, pulse el botón derecho del ratón y marque Edit y en la ventana class view dialog seleccione vista de desplieque 1. 27
Generación de código Marque en la ventana de proyecto la vista de clase 1, seleccionando con el botón derecho del ratón: Tools-> Deploy classes. 28
Generación de código En la ventana de proyecto y en la vista ha creado un artefacto para cada clase: La vista de despliegue para la generación de código puede también crearse sin necesidad de crear con anterioridad la vista de despliegue. Para ello en la vista de clase utilice el botón derecho del ratón y seleccione: Tools->Deploy classes. Se crea automáticamente una vista de despliegue con los artefactos de cada clase. A continuación hay que indicar el directorio de salida del código generado. Con el botón derecho sobre el proyecto escoger Edit generation settings, y en la pestaña Directory introducir el directorio. 29
Generación de código Ahora ya puede generar código, con el botón derecho sobre el proyecto o sobre la vista de despliegue: Generate -> Java. Bouml ha creado un archivo.java por cada clase del proyecto. Si no queremos generar código para algún elemento podemos marcar Not generated in Java desde la ventana Edit de dicho elemento. Puede inspeccionarse el código generado para una clase con el botón derecho sobre la clase en la vista de despliegue y seleccionado See file. 30
Generación de código Puede configurar algunos aspectos de la generación de código desde Edit Generation Settings (botón derecho sobre el proyecto) Por ejemplo, vamos a añadir el tipo Date en la pestaña Types. Debemos indicar el tipo correspondiente en las cuatro primeras columnas, uml=date, java=date (como no nos interesa ponga 'ignored' para C++ e Idl). Ahora podrá definir atributos, parámetros y valores de retorno de tipo Date. Por ejemplo, añada a la clase pedido el atributo fecha y defina los correspondientes métodos get y set. 31
Generación de código (relaciones) En el caso de las asociaciones y agregaciones cuya multiplicidad es distinta de 1 debe especificarse un estereotipo (stereotype). En Bouml se han definido los estereotipos list, set, map y vector. Y sus correspondencias con clases de Java. En la pestaña Stereotypes de Edit Generation Settings podemos acceder a los estereotipos de atributos y clases para modificarlos o añadir nuevos. Edite la asociación entre Cliente y Pedido: Defina el estereotipo como list. Ponga un nombre a los dos extremos de la asociación. En el campo name de Cliente y de Pedido. Ahora podrá crear los métodos set y get para la asociación. 32
Generación de código (relaciones) En la pestaña Java de la ventana de edición de las relaciones podemos observar el resultado del código Java. En la relación Cliente-Pedido ha generado la declaración de la lista de pedidos así: private List <Pedido> lpedidos. En el campo Declaration podemos modificar el scripts de generación de código. Por ejemplo, si no queremos una lista parametrizada borramos del script la variable <$type>. Los cambios afectarán sólo al elemento activo. Para que el cambio sea global hay que modificar la configuración del proyecto desde Edit generation settings. 33
Ejercicio Complete el diagrama de clases como ilustra la figura. Genere el esqueleto de código Java asociado. Para mostrar la definición completa de los atributos acceda al menú Edit drawing settings pulsado con el botón derecho del ratón sobre la zona de edición. Ponga yes en la opción show class members full definition. 34
Reverse engineering A partir de código Java Bouml puede generar el diagrama de clases correspondiente. Cree un nuevo proyecto. Escoja la opción de proyecto: Reverse -> Java Primero Bouml le pide que escoja un catálogo Java. Esta opción tiene sentido si queremos incorporar a nuestro proyecto alguna librería de clases ya implementada. Cancele. A continuación seleccione el directorio donde está el código fuente. Escoja el código fuente del ejercicio anterior. Mostrará una ventana de información con el número de elementos generados. En el navegador del proyecto aparecerán las clases generadas. Cree un diagrama de clases y arrastre todas las clases al diagrama. Compare el diagrama resultante con el diagrama original del ejercicio anterior. 35