MANUAL DE MANTENIMIENTO

Transcripción

1 MANUAL DE MANTENIMIENTO CLUBMAT: GESTOR DE CLUBES DE MATEMÁTICAS CONSTRUIDO CON TECNOLOGÍAS JAVA EE 6 Y JAVAFX 2 ANDRÉS EDUARDO SÁNCHEZ MENDIETA PONTIFICIA UNIVERSIDAD JAVERIANA FACULTAD DE INGENIERIA CARRERA DE INGENIERIA DE SISTEMAS BOGOTÁ, D.C. 2013

2 Tabla de contenido INTRODUCCIÓN TECNOLOGÍAS INVOLUCRADAS INSTALACIÓN DE HERRAMIENTAS Instalación de JDK Instalación de Netbeans junto a Glassfish Instalación de PostgreSQL Inicio de sesión secundario en Windows Instalación de PostgreSQL Instalación de JavaFX2 Scene Builder Librería para dialogos flotantes en JavaFX DESARROLLO BÁSICO DE UNA APLICACIÓN JAVAFX2 ACOPLADO A COMPONENTES DE JAVA EE Creación de una base de datos en PostgreSQL Conexión de Netbeans con PostgreSQL Creación en Netbeans de un proyecto Java EE Creación del proyecto Generación del descriptor de Persistencia en Netbeans Creando un proyecto Java EE 6 con una entidad y un EJB en Netbeans exponer el EJB como un Servicio Web SOAP en Netbeans Desplegar el proyecto Java EE en Netbeans Creación en Netbeans de un proyecto JavaFX 2 que invocará Servicios Web Creación del proyecto

3 Generar métodos auxiliares que invocan Un Servicio Web desde el proyecto JavaFX Construir la interfaz gráfica usando JavaFX Scene Builder Inyección de elementos gráficos de Javafx Scene Builder e invocación del Servicio Web como reacción a eventos Invocación de la aplicación JavaFX 2 a través del navegador Web PONER EN EJECUCIÓN LA APLICACIÓN WEB CLUBMAT DESDE NETBEANS Creación de base de datos en PostgreSQL Ejecucion de CLUBMAT desde la IDE Netbeans GESTIÓN DE VENTANAS CON JAVAFX MANEJO DE DIALOGOS CON JAVAFX ESQUEMA DE DESARROLLO DE UN CRUD EN JAVAFX Estructura de los proyectos que componen la aplicación web CLUBMAT Pasos generales para crear un CRUD en JavaFX REFERENCIAS Y BIBLIOGRAFÍA

4 INTRODUCCIÓN En el presente manual encontrará como realizar el acoplamiento entre JavaFX 2 y Java EE 6. También encontrará cómo desarrollar en ese ambiente combinado. Este manual fue realizado para el sistema operativo Microsoft Windows 7. 4

5 1. TECNOLOGÍAS INVOLUCRADAS Antes de explicar cómo se realizó el acoplamiento de tecnologías es importante que se tenga claridad sobre que tecnologías se van a integrar y que herramientas se deben usar. Java EE 6: es una plataforma de programación que se compone de varios framework, utilizado para el desarrollo de aplicaciones empresariales distribuidas, empleando el lenguaje de programación Java. JavaFX 2: JavaFX 2 [2] es el framework propuesto por Sun Microsystems, hoy Oracle, para el desarrollo de aplicaciones RIA basadas en el lenguaje de programación Java. [3] Las aplicaciones JavaFX 2 tienen una orientación hacia multimedia y pueden ser ejecutadas en el navegador, sin necesidad de cargar ningún plugin, gracias a que los navegadores soportan la máquina virtual Java. [3] JavaFX Scene Builder: herramienta bastante útil para los programadores que construyen aplicaciones en Java y necesitan crear interfaces gráficas complejas. Esta utilidad se puede usar para la construcción de la interfaz de una aplicación en forma visual, sin necesidad de escribir código. Glassfish 3: es un servidor de aplicaciones de código abierto compatible con Java EE 6 [1], listo para funcionar en entornos de producción. GlassFish 3 proporciona una pequeña base con todas las funciones para la implementación de Java EE 6. [1] PostgreSQL 9: es un sistema de base de datos relacional basado en POSTGRES. Fue pionera en muchos conceptos implementados en algunas soluciones comerciales. Por 5

6 su licencia libre, PostgreSQL puede ser utilizado, modificado, y distribuido gratuitamente para cualquier propósito, sea privado, comercial, o académico. [4] 6

7 2. INSTALACIÓN DE HERRAMIENTAS Debe instalar las siguientes herramientas para poder realizar el acople entre el framework JavaFX 2 y la plataforma Java EE 6. Igualmente son necesarias para desarrollar y mantener la aplicación CLUBMAT: Gestor de clubes de matemáticas INSTALACIÓN DE JDK Descargue e instale Java SE Development Kit (JDK) en su última versión de la URL: La JDK usada al momento de realizar este manual fue la versión 7u25. Nota: El JDK a partir de la versión 7 incluye las librerías de soporte para JavaFX INSTALACIÓN DE NETBEANS JUNTO A GLASSFISH Descargue e instale la IDE Netbeans con soporte para Java EE y en idioma ingles de la URL: Al momento de realizar este manual se usó la versión Esta IDE incluye: Driver actualizado para PostgreSQL 9. Servidor de aplicaciones Glassfish Soporte para trabajar con JavaFX INSTALACIÓN DE POSTGRESQL Debe realizar los siguientes pasos para instalar el motor de la base de datos PostgreSQL: INICIO DE SESIÓN SECUNDARIO EN WINDOWS 7 1) Verifique que su sistema operativo tiene activo el servicio Inicio de sesión secundario. Para esto vaya a Inicio >> Panel de control >> Herramientas administrativas >> Servicios >> Inicio de sesión secundario. 2) En el campo Tipo de inicio elija Automático. Haga Click en aceptar. 7

8 3) Verifique que el estado de este servicio se encuentre en Iniciado. Si no es así, haga Click derecho sobre Inicio de sesión secundario >> Iniciar. El servicio debe mostrarse de la siguiente manera: INSTALACIÓN DE POSTGRESQL 1) Ejecute el instalador de PostgreSQL, en el caso de la versión 9.2.4, el archivo es postgresql windows.exe. 2) En el asistente de instalación de PostgreSQL llega un punto en que le dice: Por favor, proporcione una contraseña para el superusuario base de datos postgres. Establezca la contraseña: postgres. 3) Seleccione las opciones por defecto para las demás preguntas que le realice el asistente de instalación. Al finalizar el asistente le pregunta si desea lanzar Stack Builder, diga que no y haga Click en terminar INSTALACIÓN DE JAVAFX2 SCENE BUILDER Descargue e instale JavaFX Scene Builder de la URL: Al momento de realizar este manual se usó la versión

9 2.5. LIBRERÍA PARA DIALOGOS FLOTANTES EN JAVAFX 2 Descargue la librería javafx-dialogs jar. La puede descargar de la URL: 9

10 3. DESARROLLO BÁSICO DE UNA APLICACIÓN JAVAFX2 ACOPLADO A COMPONENTES DE JAVA EE 6 En esta sección se explica paso a paso cómo realizar el acople entre el framework JavaFX 2 y la plataforma Java EE 6, desarrollando una aplicación sencilla que usa una base de datos PostgreSQL y el servidor de aplicaciones Glassfish Para lograr la integración de tecnologías mencionada realice los siguientes pasos: 3.1. CREACIÓN DE UNA BASE DE DATOS EN POSTGRESQL 1) Ejecute el software pgadmin III y luego haga doble Click en el servidor. Ingrese la contraseña que ingreso en el proceso de instalación. 2) Vaya a Bases de datos >> postgres. En la barra de herramientas haga Click en Ejecutar consultas SQL arbitrarias. 3) Copie y pegue el siguiente Script para crear el usuario "clubmat": CREATE USER clubmat LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE 10

11 ENCRYPTED PASSWORD 'clubmat'; Ejecute el Script haciendo Click en Ejecutar consulta. Nota: En el script remplace clubmat por el nombre de usuario que usted desee crear. 4) Para crear la base de datos vaya a Ejecutar consultas SQL arbitrarias y copie y pegue el siguiente script. Con el va crear una base de datos "clubmat" cuyo usuario dueño será "clubmat": CREATE DATABASE clubmat WITH OWNER = clubmat ENCODING = 'UTF8'; Ejecute el Script haciendo Click en Ejecutar consulta. 5) Compruebe que la base de datos que acabo de crear salga listada como existente. En algunos casos pgadmin III se demora en listar una base de datos recién creada. Espere un momento, haga Clickk en Bases de Datos y ejecute la opción refrescar hasta que salga listada la base de datos. 11

12 3.2. CONEXIÓN DE NETBEANS CON POSTGRESQL 1) Abra la IDE Netbeans, diríjase a la pestaña Services >> Databases >> Drivers. 2) La IDE Netbeans en su versión 7 o superior incluye el driver para PostgreSQL. Compruebe que sale listado. 12

13 3) Ahora cree la conexión que le servirá de referencia para la unidad de persistencia. Haga Click derecho sobre PostgreSQL y seleccione Connect Ussing y aparecerá una ventana en la cual tiene que llenar todos los datos requeridos. Debe quedar algo como lo siguiente: 13

14 En el campo Database coloque el nombre de la base de datos que creó en PostgreSQL. Luego haga Click en Test Connection y si la conexión se realizó exitosamente le debe salir un aviso diciéndole Connection Succeeded. Después haga Click en Next. 4) En el campo Select schema: elija public. Haga Click en Finish CREACIÓN EN NETBEANS DE UN PROYECTO JAVA EE CREACIÓN DEL PROYECTO 1) Ahora lo que debe hacer es crear un proyecto para la aplicación empresarial Java EE 6. Vaya a File >> New Project >> Java EE >> Enterprise Aplication y después haga Click en Next. 14

15 2) Elija el nombre de proyecto que desee, luego haga Click en el botón Next. Desactive la opción Create EJB Module. Luego haga Click en Finish. Debe quedar algo como lo siguiente: GENERACIÓN DEL DESCRIPTOR DE PERSISTENCIA EN NETBEANS 1) Ahora debe crear una unidad de persistencia. Para esto haga Click derecho sobre el modulo web de la aplicación y vaya a New >> Other >> Persistence >> Persistence Unit. Haga Click en Next. 15

16 2) Seleccione Eclipselink como proveedor de persistencia. Puede dejar el nombre por defecto para la unidad de persistencia o colocar el que usted deseé. En el campo Data Source seleccione New Data Source. 3) En Database Connection seleccione la conexión PostgreSQL a la base de datos que usted creó. En JNDI Name coloque el nombre que desee. Haga Click en OK. Después haga Click en Finish, debe quedarle algo como en la siguiente ilustración: 16

17 4) Debe complementar el archivo persistence.xml que fue generado por Netbeans. Vaya al módulo web de la aplicación >> Configuration Files >> persistence.xml Haga Click en Source. 5) Después de la línea: <property name="eclipselink.ddl-generation" value="create-tables"/> Agregue el siguiente código, editando los datos según el nombre de su base de datos, usuario y contraseña: <property name="eclipselink.target-database" value="postgresql"/> <property name="javax.persistence.jdbc.driver" value="org.postgresql.driver"/> 17

18 <property name="javax.persistence.jdbc.url" value="jdbc:postgresql://localhost:5432/clubmat"/> <property name="javax.persistence.jdbc.user" value="clubmat"/> <property name="javax.persistence.jdbc.password" value="clubmat"/> <property name="eclipselink.logging.level" value="info"/> CREANDO UN PROYECTO JAVA EE 6 CON UNA ENTIDAD Y UN EJB EN NETBEANS 1) Primero que todo, debemos crear un paquete para colocar nuestra entidad persistente. Haga Click derecho sobre el modulo web de su proyecto >> New >> Java Package. 2) En el campo Package Name coloque co.edu.javeriana.clubmat.ejb y haga Click en Finish. 3) Haga Click derecho sobre el modulo web de su proyecto >> New >> Other >> Persistence >> Entity Class. Haga Click en Next. 18

19 4) En este ejemplo vamos a crear una entidad Rol. En package seleccione co.edu.javeriana.clubmat.ejb. Haga Click en Finish. 19

20 5) La entidad Rol que usted va a crear tendrá dos atributos. Id (Long) y nombrerol (String). Haga doble Click sobre Rol.java y reemplace todo el código generado por el siguiente: package co.edu.javeriana.clubmat.jpa; import java.io.serializable; import javax.persistence.*; @NamedQuery(name = "Rol.existRol", query = "SELECT COUNT(r.nombrerol) FROM Rol r WHERE r.nombrerol = :nombrerol")}) 20

21 public class Rol implements Serializable { private static final long serialversionuid = GenerationType.AUTO) private Long = = true, nullable = false, length = 40) private String nombrerol; public Rol() { } public Rol( String rol ) { } this.nombrerol = rol; public Long getid() { } return id; public void setid(long id) { } this.id = id; public String getnombrerol() { } return nombrerol; public void setnombrerol(string nombrerol) { } this.nombrerol = nombrerol; public String tostring() { return "JPA.Rol[ id=" + id + " nombrerol=" + nombrerol + " ]"; } 21

22 6) Para la creación del EJB debe crear un nuevo paquete llamado co.edu.javeriana.clubmat.ejb. Use el método enseñado anteriormente. (Ver sección Creando un proyecto Java EE 6 con una entidad y un EJB en Netbeans) 7) Haga Clickk derecho sobre el modulo web de su proyecto >> New >> Other >> Enterprise JavaBeans >> Sessions Beans for Entity Classes. Haga Click en Next. 8) Haga Click en Add all y luego en Next. En la siguiente ventana en Package seleccione co.edu.javeriana.clubmat.ejb y haga Click en Finish. 9) Se generan dos archivos, un AbstractFacade.java y un RolFacade.java. 22

23 En RolFacade es donde usted implementará los métodos de negocio para la entidad Rol. AbstractFacade es una clase abstracta que tiene métodos genéricos para soportar operaciones CRUD (crear, eliminar, buscar, etc.) para todas las entidades. 10) Agregue estos dos métodos: existerol: Método al cual se le envía el nombre de un rol y dice si este existe en el sistema por medio de un booleano. crearrol: Método al cual se le envía el nombre de un rol, lo crea y confirma que la operación fue exitosa. Si el rol ya existe en el sistema, retorna una cadena advirtiendo que ya existe. 11) Edite RolFacade.java y copie y pegue los siguientes dos métodos: public Boolean existerol( String rol ) { Query q = em.createnamedquery( "Rol.existRol" ); q.setparameter( "nombrerol", rol ); Long exist = ( Long ) q.getsingleresult( ); if( exist > 0 ) return true; } return false; public String crearrol( String rol ) { if( existerol( rol ) ) return "El rol ya existe en el sistema, elija otro"; Rol r = new Rol( rol ); em.persist( r ); } return "exitoso"; 23

24 EXPONER EL EJB COMO UN SERVICIO WEB SOAP EN NETBEANS 1) Ahora debe exponer el EJB creado como un Servicio Web SOAP. Para ellos haga Click derecho sobre el modulo web de la aplicación >> New >> Web Service. 2) En Web Service Name coloque RolWS. En paquete coloque co.edu.javeriana.clubmat.ws. Seleccione Create Web Service from Existing Session Bean y luego haga Click en Browse. 3) Seleccione el EJB al que desea generarle un Servicio Web. En este caso RolFacade. Haga Click en OK. 24

25 4) Haga Click en Finish. En el paquete WS de su proyecto debe aparecer una clase RolWS.java la cual implementa el Servicio Web DESPLEGAR EL PROYECTO JAVA EE EN NETBEANS 1) Click derecho sobre su proyecto empresarial Java EE >> Clean and Build Click derecho sobre su proyecto empresarial Java EE >> Deploy Luego de estas dos acciones, se debe generar automáticamente la tabla en la base de datos PostgreSQL. 25

26 Verifique esto con pgadmin III. 2) Ahora debe verificar que su servicio web realmente funciona, para ello abra el modulo web de su proyecto >> Web Services >> Click derecho a RolWS >> Test Web Service 26

27 3) Se abre el navegador web con una página web llamada RolWS Web Service Tester. Allí podrá usar los dos métodos que implementados: existerol y crearrol. Escriba Lider para probar el método existerol. 27

28 4) Debe obtener una página web donde dice que es falso que exista el rol Lider. 5) Ahora cree el rol Lider usando el método crearrol, luego verifique que existe dicho rol con el método existerol y obtendrá true. La tabla rol de su base de datos tendrá un nuevo registro, con un id y un rol llamado Lider CREACIÓN EN NETBEANS DE UN PROYECTO JAVAFX 2 QUE INVOCARÁ SERVICIOS WEB CREACIÓN DEL PROYECTO 1) Ahora debe crear un proyecto JavaFX 2 para que consuma el Servicio Web que construyo. Para ello vaya a: File >> New >> JavaFX >> JavaFX FXML Application 28

29 2) Elija el nombre de proyecto que deseé. En el campo FXML Name coloque el nombre que quiere colocarle a la pantalla principal de su aplicación JavaFX2. Haga Click en Finish. 3) Netbeans genera tres archivos en su proyecto. 29

30 JavaFXApplication9.java (varía según el nombre que le haya dado al proyecto): Esta clase es la encargada de ejecutar la aplicación. Carga el archivo PantallaInicial.fxml. PantallaInicial.fxml: Archivo en lenguaje XML que contiene la descripción de todo diseño gráfico de la pantalla inicial. PantallaInicialController.java: Clase que controla los elementos gráficos descritos en el archivo PantallaInicial.fxml. Acá también se implementan los métodos de negocio necesarios para la pantalla inicial. Como puede observar se usa el Modelo Vista Controlador (MVC) para separar la interfaz gráfica de la lógica GENERAR MÉTODOS AUXILIARES QUE INVOCAN UN SERVICIO WEB DESDE EL PROYECTO JAVAFX 2 1) Haga Click derecho sobre su proyecto JavaFX 2 >> New >> Web Service Client 2) Seleccione WSDL URL: y coloque la URL del WSDL del servicio web que desea consumir, en este caso RolWS. Haga Click en Finish. 30

31 Para obtener la URL del WSDL fácilmente, vaya al testing de RolWS y haga Click en WSDL File. 3) Usted usará remotamente los métodos existerol y crearrol que ofrece el Servicio Web. Para ello abra PantallaInicialController.java y haga Click derecho en el editor >> Insert code >> Call Web Service Operation 31

32 4) En la ventana de Servicios Web disponibles, seleccione su proyecto JavaFX >> RolWS >> RolWSPort >> existerol >> OK Realice el mismo proceso con crearrol. 32

33 Esto generará dos métodos que podrán invocar a existerol y createrol de forma remota CONSTRUIR LA INTERFAZ GRÁFICA USANDO JAVAFX SCENE BUILDER 1) Haga doble Click sobre el archivo PantallaInicial.fxml. Se abrirá JavaFX Scene Builder así como lo muestra la siguiente ilustración: 33

34 2) Elimine el botón y el Label existente seleccionándolos y presionando la tecla Supr. 3) Amplíe el tamaño de la ventana situándose en una de las esquinas del rectángulo y moviendo el mouse. 4) Para invocar el Servicio Web y mostrar los resultados debe agregar los siguientes elementos gráficos: Un Label con el texto Nombre del rol: Un Textfield en donde se ingresara el nombre del rol Un Button con el texto Crear rol Un Button con el texto Existe rol Un Label con el texto Resultado: Un Textfield en donde se colocara el resultado obtenido luego de invocar a los métodos. 5) Use la opción Search del JavaFX Scene Builder para buscar los elementos gráficos listados en el paso anterior y arrástrelos en la ventana. 34

35 6) Luego de arrastrar y soltar debe obtener una interfaz gráfica así: Nota: puede pre-visualizar la interfaz gráfica que está diseñando en Preview >> Show Preview in Window. 7) A los elementos gráficos que desee manipular dinamicamente desde el controlador debe darles un Id con nombre claro. 35

36 En este caso solo vale la pena realizar esa manipulación en los dos Textfield. Allí es donde usted va a hacer una lectura y escritura de información. Para esto, debe hacer Click sobre cada Textfield y usar la herramienta Inspector para buscar la propiedad id. En la propiedad fx:id coloque el nombre que deseé para cada elemento. El Textfield donde se ingresa el nombre del rol llámelo textfieldnombrerol y el Textfield donde muestra el resultado llámelo textfieldresultado. 8) Los dos botones disparan eventos. Para especificar la reacción a eventos debe hacer Click en cada botón y buscar action usando la herramienta Inspector. En la propiedad On Action, nombre crearrol al evento de hacer Click en el botón Crear Rol. El evento del otro botón identifíquelo como existerol. Vaya a File >> Save. 36

37 INYECCIÓN DE ELEMENTOS GRÁFICOS DE JAVAFX SCENE BUILDER E INVOCACIÓN DEL SERVICIO WEB COMO REACCIÓN A EVENTOS 1) Ahora necesita inyectar los elementos gráficos que desea manipular en la clase controladora. Esto se hace con la Abra PantallaInicialController.java y private Label label; private TextField private TextField textfieldresultado; 2) También necesita inyectar los eventos que nombro en JavaFX Scene Builder, indicando la invocación del Servicio Web como reacción a cada evento: private void handlebuttonaction(actionevent event) { System.out.println("You Clickked me!"); label.settext("hello World!"); } private void crearrol(actionevent event) { 37

38 ) ); } String resultado = crearrol( this.textfieldnombrerol.gettext( this.textfieldresultado.settext( resultado private void existerol(actionevent event) { Boolean resultado = existerol( this.textfieldnombrerol.gettext( ) ); if( resultado ) this.textfieldresultado.settext( "El rol existe en el sistema" ); else this.textfieldresultado.settext( "El rol no existe en el sistema" ); } 3) Haga Click derecho sobre su proyecto JavaFX >> Clean and Build. Haga Click derecho sobre su proyecto JavaFX >> Run Pruebe la aplicación con diversos datos:. 38

39 39

40 INVOCACIÓN DE LA APLICACIÓN JAVAFX 2 A TRAVÉS DEL NAVEGADOR WEB Para que la aplicación JavaFX 2 construida pueda ser ejecutada en el navegador web debe realizar los siguientes pasos: 1) Vaya a la carpeta de su proyecto JavaFX 2, dentro de ella hay una carpeta llamada dist. Cópiela. 2) Vaya a la carpeta de su proyecto empresarial Java EE y luego a la carpeta del módulo web de su proyecto. Dentro de esta última hay una carpeta llamada web. Ábrala. 3) Pegue la carpeta dist en la carpeta web. 4) Abra la carpeta dist que acabo de copiar en la carpeta web. Allí encontrará un único archivo html. A ese archivo debe cambiarle el nombre a index. 5) Click derecho sobre su proyecto empresarial Java EE >> Clean and Build Click derecho sobre su proyecto empresarial Java EE >> Deploy Click derecho sobre su proyecto empresarial Java EE >> Run 6) Se le abre el navegador web con una página que dice Hello World! Esa página web corresponde al index.jsp que se encuentra en la carpeta web del módulo web de su proyecto. 7) En la barra de direcciones, conserve la dirección que se encuentra y añádale la palabra dist. Se le debe abrir una página web en donde sale cargándose una aplicación javafx. 40

41 8) Diga que acepta los riesgos y que desea ejecutar la aplicación. Pruebe la aplicación con diversos datos. 41

42 4. PONER EN EJECUCIÓN LA APLICACIÓN WEB CLUBMAT DESDE NETBEANS Para ejecutar la aplicación web CLUBMAT desde la IDE Netbeans 7.3 realice los siguientes pasos: 4.1. CREACIÓN DE BASE DE DATOS EN POSTGRESQL 1) Abra el cliente de PostgreSQL ejecutando la aplicación pgadmin III que se encuentra en el directorio donde se instaló el motor de base de datos. 2) Haga doble Click sobre el servidor PostgreSQL 9.2, allí la aplicación le pedirá una contraseña, ingrese la contraseña que estableció en el proceso de instalación de PostgreSQL. 3) Vaya a Bases de Datos >> postgres En la barra de herramientas haga Click en Ejecutar consultas SQL arbitrarias. 4) En el editor copie y pegue el siguiente Script: CREATE USER clubmat LOGIN NOSUPERUSER INHERIT CREATEDB NOCREATEROLE ENCRYPTED PASSWORD 'clubmat'; 42

43 Ejecute el Script haciendo Click en Ejecutar consulta. 5) Para crear la base de datos vaya a Ejecutar consultas SQL arbitrarias y copie y pegue el siguiente script: CREATE DATABASE gestorclubesm WITH OWNER = clubmat ENCODING = 'UTF8'; Ejecute el Script haciendo Click en Ejecutar consulta. 6) Compruebe que la base de datos que acabo de crear salga listada como existente. En algunos casos pgadmin III se demora en listar una base de datos recién creada. Espere un momento, haga Clickk en Bases de Datos y ejecute la opción refrescar hasta que salga listada la base de datos. 43

44 4.2. EJECUCION DE CLUBMAT DESDE LA IDE NETBEANS 1) Abra la IDE Netbeans 7.3 y vaya a: File >> Open Project Seleccione el proyecto empresarial CLUBMAT >> Click en Open Project. Nota: el proyecto empresarial CLUBMAT se encuentra en el archivo [CLUBMAT]ICodigo.zip disponible en la página web del presente proyecto. Debe descomprimirlo en su disco duro y obtendrá una carpeta CLUBMAT. Esa carpeta es un proyecto que puede abrir con la IDE Netbeans. 2) Es posible que cuando abra el módulo web del proyecto empresarial CLUBMAT tenga errores de advertencia acerca del Data Source. 44

45 Soluciónelo haciendo Clickk derecho sobre CLUBMAT-war >> Resolver Data Source Problem. Seleccione clubmatpool y luego haga Clickk en Add Connection. Realice el Test Conecction con los datos por defecto. Netbeans debe indicarle que la conexión fue exitosa con el aviso Connection Succeeded. Después haga Clickk en Next y seleccione el esquema public. Haga Clickk en Finish. 3) Click derecho sobre el módulo web CLUBMAT-war >> Clean and Build Click derecho sobre el módulo web CLUBMAT-war >> Deploy 4) Click derecho sobre el proyecto empresarial CLUBMAT >> Clean and Build Click derecho sobre el proyecto empresarial CLUBMAT >> Deploy Luego de estas dos acciones, se deben generar las tablas en la base de datos gestorclubesm de PostgreSQL. Verifique esto con pgadmin III. 1) En pgadmin III elija la base de datos gestorclubesm y ejecute el script que está en el archivo Inserts_datosminimos.sql (carpeta [CLUBMAT]Instalación) usando la opción "consultas SQL arbitrarias": 45

46 Nota: Si desea que la aplicación web CLUBMAT inicie con más datos, pero todos ellos ficticios, no ejecute el anterior script. Vaya a la carpeta [CLUBMAT]Instalación, abra el archivo Inserts_datosficticios.sql y ejecute todo el script en consultas SQL arbitrarias. Esto le ayudará a observar mejor la funcionalidad de la aplicación web cuando la ejecute. 5) Click derecho sobre el proyecto empresarial CLUBMAT >> Run. Se le debe abrir el navegador web desplegándole la aplicación web: CLUBMAT. 6) Al ser la interfaz gráfica de la aplicación web construida con la tecnología JavaFX 2, debe aceptar los riesgos para ejecutar la aplicación y hacer Click en ejecutar. 46

47 7) Ingrese como nombre de usuario: admin y contraseña: admin. El sistema le dirá que realizó login correctamente y que tiene rol de Lider. Ya puede empezar a usar todas las acciones implementadas en CLUBMAT. Nota: Vea el manual de usuario para conocer las opciones ofrecidas por el sistema. 8) Si desea editar la capa de presentación de la aplicación web CLUBMAT debe abrir el proyecto CLUBMATClient. Cuando lo abra importe la librería javafx-dialogs jar 47

48 5. GESTIÓN DE VENTANAS CON JAVAFX 2 La gestión de ventanas en JavaFX 2 consiste en tener una estrategia fácil y clara que permita navegar de una pantalla a otra, usando el modelo vista controlador generado por la herramienta JavaFX Scene Builder. El ir de una pantalla a otra, devolverse, actualizarla o mantenerla desactualizada se convierte en un problema complejo en el framework JavaFX 2. Para ello fue necesario usar un framework gratuito escrito por la Ingeniera Angela Caicedo, buscando simplificar este problema. [5] Angela Caicedo es una Java Evangelist de Oracle, especialista en sistemas Java empresariales. Tiene amplia experiencia en: Java ME, Java SE, Java EE y JavaFX. Participo en varias conferencias de JavaOne. COMO SE USÓ EL FRAMEWORK DE PANTALLAS EN LA APLICACIÓN WEB CLUBMAT Para utilizar el framework de pantallas en la aplicación web CLUBMAT, fue necesario seguir paso a paso el manual del mismo, publicado en el blog de la ingeniera Ángela Caicedo en: También fue necesario ayudarse con un video tutorial sobre este framework, también realizado por la ingeniera Ángela Caicedo en la URL: En la clase Club_MatematicasClient.java, la cual ejecuta la aplicación web CLUBMAT, fue necesario usar cadenas constantes estáticas. De esta manera las constantes pudieron ser accedidas por cualquier otra clase del proyecto JavaFX 2: CLUBMATClient. Por cada pantalla de la aplicación web CLUBMAT se declararon dos cadenas constantes, una con el nombre de la pantalla y otra con el nombre de la vista FXML de esa pantalla. En el siguiente código Java de la clase Club_MatematicasClient.java, puede observar cómo, por cada pantalla, fue necesario declarar dos cadenas constantes: 48

49 En cada clase controladora de una pantalla se realizó una implementación de una interface llamada ControlledScreen. ControlledScreen es una interface que hace parte del framework de pantallas. De igual forma, por cada clase controladora fue necesario declarar un atributo mycontroller de tipo ScreensController. ScreensController es una clase que hace parte del framework de pantallas. Como en cada clase controladora se implementó la interfaz ControlledScreen, fue necesario implementar el método setscreenparent en cada una de ellas, de la siguiente manera: El atributo mycontroller es el que ayuda a realizar la navegación entre todas las pantallas, haciendo uso de las constantes declaradas en la clase Club_MatematicasClient.java y de ciertos métodos. Por ejemplo, para ir desde la pantalla de listar roles hacia la pantalla de editar roles es necesario el siguiente código: 49

50 Como puede observar se hace siempre uso del atributo mycontroller. Con el puede usar los métodos: unloadscreen: destruye la pantalla que se le pase por parámetro. loadscreen: carga una pantalla. Se le debe enviar el nombre de la pantalla y el archivo FXML de la pantalla, por medio de las constantes. setscreen: hace visible una pantalla. Se le debe enviar el nombre de la pantalla por medio de la constante indicada. Es importante decir que al usar loadscreen se refresca o se construye una pantalla, llamando al método Initialize de la misma. El método Initialize se encuentra en cada clase controladora. Si no se destruye una pantalla, esta continua activa en segundo plano, con el mismo estado que tenía ante de ir a otra pantalla. 50

51 6. MANEJO DE DIALOGOS CON JAVAFX 2 En algunas aplicaciones se necesitan ventanas flotantes (popups) con los cuales se pueda interactuar con el usuario de una manera sencilla, informándole de algo o para recoger datos sin necesidad de usar una nueva pantalla. En Java usando el framework Swing existía la clase JOptionPane, la cual permitía usar diálogos flotantes. Una clase similar no existe en el framework JavaFX 2. Para solucionar este problema se usó la librería javafx-dialogs jar, descargable desde la URL: Esta librería permite usar diálogos flotantes por medio de la clase Dialogs, la cual contiene métodos estáticos que se pueden acceder desde cualquier otra clase. En la aplicación web CLUBMAT, los diálogos flotantes se usaron para informar errores o para confirmar operaciones como la acción eliminar de un CRUD. Por ejemplo, para iniciar sesión en la aplicación web se debe ingresar un nombre de usuario y contraseña válidos. El siguiente código de la clase InicioController.java le informa al usuario que no ingreso el usuario. Para poder usar la clase Dialogs es necesario hacer un import en la clase controladora como el siguiente: import javafx.scene.control.dialogs; El resultado gráfico es el siguiente: 51

52 Si desea leer más sobre esta librería y sus distintas funcionalidades vaya a la URL: 52

53 7. ESQUEMA DE DESARROLLO DE UN CRUD EN JAVAFX 2 A continuación se explicara cual fue la organización y el esquema seguido para crear un CRUD para la aplicación CLUBMAT: Gestión de clubes de matemáticas. Para facilitar ese objetivo, por favor siga los siguientes pasos: 7.1. ESTRUCTURA DE LOS PROYECTOS QUE COMPONEN LA APLICACIÓN WEB CLUBMAT 1) Abra la IDE Netbeans 7.3 y vaya a: File >> Open Project Seleccione el proyecto empresarial CLUBMAT >> Click en Open Project. Nota: el proyecto empresarial CLUBMAT se encuentra publicado en la página web del presente proyecto. Debe descomprimirlo en su disco duro y obtendrá una carpeta CLUBMAT. Esa carpeta es un proyecto que puede abrir con la IDE Netbeans. 2) Para que pueda observar la implementación del módulo web vaya a: CLUBMAT >> Java EE Modules >> Doble Click en CLUBMAT-war.war. 53

54 3) Netbeans le mostrara el modulo web de la aplicación web CLUBMAT. Vaya a CLUBMAT-war >> Source packages. Despliegue cada uno de los paquetes. Paquete co.edu.javeriana.clubmat.ejb: Aquí se encuentran todos los EJBs generados a partir de las entidades JPA. Paquete co.edu.javeriana.clubmat.jpa: Aquí se encuentran todas las Entidades de persistencia implementadas. Escritas manualmente. co.edu.javeriana.clubmat.tipo: Aquí se encuentran las enumeraciones usada en este proyecto. Paquete co.edu.javeriana.clubmat.ws: Aquí se encuentran las clases que implementan los Servicios Web SOAP. Son generadas a partir de los EJB. 4) Ahora debe abrir el proyecto JavaFX 2 construido para CLUBMAT. 54

55 Vaya a File >> Open Project >> CLUBMATClient >> Click en Open Project. Nota: El proyecto CLUBMATClient se encuentra en el archivo [CLUBMAT]ICodigo.zip disponible en la página web del presente proyecto. 5) Importe la librería javafx-dialogs jar al proyecto CLUBMATClient 6) Vaya a CLUBMATClient >> Source Packages Como puede observar por cada CRUD se creó un paquete. 7) Despliegue el paquete co.edu.javeriana.clubmat.screensmanager : 55

56 Como puede observar el paquete co.edu.javeriana.clubmat.screensmanager contiene todos los archivos.fxml que componen la vista de las pantallas de la aplicación web CLUBMAT. Los archivos.fxml que inician con el verbo Crear corresponden al diseño de pantallas de la acción crear de algún CRUD. En algunos CRUD se usó una misma pantalla para las acciones: ver y editar, las dos a la vez. Un ejemplo de este caso es VerEditarInstitucion.fxml 8) Despliegue los paquetes CRUDClub y CRUDInstituion: 56

57 Para crear un CRUD en JavaFX 2 es necesario crear mínimo tres clases controladores, cada una de ellas controla una vista.fxml, ubicada en el paquete ScreensManager. Esto quiere decir que por cada CRUD se deben diseñar mínimo tres vistas. Por ejemplo, en el caso del CRUD de clubes se diseñaron tres vistas, las cuales fueron las siguientes: CrearClub.fxml: Vista para la acción de crear un nuevo club. ListarClub.fxml: Vista para la acción de ver todos los clubes por medio de una tabla. VerEditarClub.fxml: Vista para las acciones de ver y editar un club. Como puede observar por cada vista siempre hay una clase controladora, la relación es uno a uno en todos los casos PASOS GENERALES PARA CREAR UN CRUD EN JAVAFX 2 9) Cree una vista FXML vacía para la acción de Listar (Click derecho sobre CLUBMATClient >> New >> Empty FXML ) 10) Siempre debe usar una clase controladora por cada FXML que cree. 11) La clase controladora para la acción Listar de un CRUD es la más compleja, pues requiere usar múltiples atributos gráficos para manejar la tabla. 57