Curso: Desarrollo de aplicaciones en Java EE 5 en base a frameworks

Gua de configuracin de la consola Hibernate de un proyecto Java EE 5 para poder probar consultas JPQL versin 2.2.0.GA

por: Mara Consuelo Franky

Dpto. Ingeniera de Sistemas Pontificia Universidad Javeriana email: lfranky@javeriana.edu.co

Febrero de 2011

pg. 1

Curso: Desarrollo de aplicaciones en Java EE 5 en base a frameworks

Tabla de Contenido

1 2 3 4 5 6

Propsito de este documento .................................................................................................................. 3 Prerequisitos antes de configurar la consola Hibernate ...................................................................... 3 Configuracin del proyecto en Eclipse .................................................................................................. 3 Configuracin de la consola Hibernate en Eclipse ............................................................................... 4 Mostrar en la consola Hibernate las entidades del proyecto ............................................................... 5 Ejecutar consultas JPQL ........................................................................................................................ 6

pg. 2

Curso: Desarrollo de aplicaciones en Java EE 5 en base a frameworks

Propsito de este documento

Se indica cmo configurar la consola Hibernate para un proyecto Java EE 5 generado previamente con Seam. La consola Hibernate permite probar consultas JPQL y tambin seleccionar tablas de la base de datos para la generacin de entidades Java (ingeniera reversa que se explica en la gua 4-guia.generadores.seam). Este documento se centra en las facilidades para ejecutar consultas JPQL.

Prerequisitos antes de configurar la consola Hibernate

El ambiente Eclipse debe tener los plugins JBossTools-ALL (ver gua 1-guia-configuracionjavaee5). La consola Hibernate se configurar para un proyecto que haya sido generado previamente con Seam (ver 4-guia.generadores.seam).

Configuracin del proyecto en Eclipse

El proyecto debe declarar como folder de salida el subdirectorio test-build porque es all donde la consola Hibernate buscar el descriptor persistence.xml Cada subdirectorio de fuentes debe generar los archivos .class en el subdirectorio classes porque as lo necesitan la tarea ANT que construye el ear. La tarea ANT builtest copiar estos archivos hacia el subdirectorio test-build

pg. 3

Curso: Desarrollo de aplicaciones en Java EE 5 en base a frameworks Para un proyecto llamado maratones la configuracin se refleja en la anterior ventana.

Configuracin de la consola Hibernate en Eclipse

Debe abrirse la perspectiva Hibernate. Aparecer una vista Hibernate. Si no aparece en esta vista la consola correspondiente al proyecto se debe proceder con click-derecho a aadirla con la opcin Add configuration. A continuacin se muestra el contenido con que deben quedar dos tarjetas de la configuracin de la nueva consola de Hibernate para un proyecto llamado maratones (las otras tarjetas se dejan con los valores por defecto que traen): Tarjeta main:

pg. 4

Curso: Desarrollo de aplicaciones en Java EE 5 en base a frameworks Tarjeta Common:

Mostrar en la consola Hibernate las entidades del proyecto

Deben ejecutarse la tarea ANT clean y ear para asegurar que se generan las clases bajo el subdirectorio classes. Luego debe ejecutarse la tarea ANT buildtest para que las clases sean copiadas al subdirectorio test-build y para que el descriptor persistence.xml aparezca bajo testbuild/META-INF Despus de sto debe refrescarse el proyecto y tambin la consola. Por ltimo, sobre la consola con click-derecho debe solicitarse la opcin Rebuild configuration: deben aparecer las entidades del proyecto bajo el tem Configuration, y las tablas de la base de datos bajo el tem Database.

pg. 5

Curso: Desarrollo de aplicaciones en Java EE 5 en base a frameworks

Ejecutar consultas JPQL

Sobre la consola Hibernate con click-derecho se puede solicitar abrir el editor HQL Editor. En la ventana de este editor aparece una lista de los proyectos para seleccionar el proyecto de inters. Luego teclee la consulta JPQL, por ejemplo select m from Menu m, y ejectela. Podr observar los resultados de la consulta JPQL en la ventana Hibernate Query NOTA: la legibilidad de los resultados depende del toSTring() que est definido para las entidades que participan en la consulta. La traduccin a SQL de la consulta puede verse en la ventana Hibernate Dynamic SQL Preview Result (a veces sale un error y es necesario seleccionar otro proyecto y volver a seleccionar el proyecto de inters para lograr que salga el texto SQL la primera vez). Observe que el editor de consultas ofrece ayuda contextual para formar las expresiones de navegacin de JPQL.

pg. 6