En los últimos meses he recibido bastantes correos de personas que necesitan ayuda sobre el uso de J2EE v 5.0, en especial con temas relacionados con JPA (Java Persistence Api) y EJB 3 con Annotations (Enterprise Java Beans v3.0) , pues bien, Aquí pongo un ejemplo practico de conceptos necesarios para poder dominar esta tecnología, en este pequeño HOW-TO expondré el uso de JSF-EJB3-JPA de una forma clara identificando muchos de los elementos que se emplean en aplicaciones de alto rendimiento en organizaciones que lo emplean, es bastante simple, y sirve para comenzar a adentrarse un poco con esta tecnología.Espero sea de vuestro agrado.
COMENZANDO:
Comenzaremos con un ejemplo simple de integración, donde utilizaremos JPA como capa de datos y EJB como capa de acceso, (aquí hay un poco mas de información sobre JPA y EJB 3.0 en términos técnicos y de especificación).
Se da por hecho que las personas que sigan este pequeño HOW-TO deberán tener un servidor J2EE instalado y funcionando correctamente, personalmente empleo como plataforma operativa GNU/Linux en su distribución Debían Etch 4.0r3 y Sun Application Server 9.1 (Glassfish), todo esto bajo NetBeans v 6.x, Empleo todo esto con frecuencia en trabajo, entonces me resulta bastante familiar e intuitivo, si deseas obtener el software aquí encontraras los enlaces de referencia: NetBeans, Glassfish En el enlace de Netbeans, podéis ver que se encuentra disponible la opción de descarga completa, con todos los componentes incluidos, instalando de una sola vez NetBeans, Glassfish, librerías de desarrollo adicionales e inclusive Tomcat como servidor web, así que podría ser una opción también valida.
En esta reseña se asumirá que se emplea como servidor de aplicaciones Glassfish, no importa lo que se emplee para editar los archivos, puedes utilizar un IDE como NetBeans, JDeveloper o Eclipse, inclusive si lo deseas gedit, nano, vi o uno con menos funcionalidades como notepad, lo que desees....
Ahora, para comenzar el pequeño ejercicio vamos a asumir la siguiente situación: Se tiene una pequeña empresa que desarrolla productos de diferentes tipos, los cuales se encuentran agrupados por diferentes categorías, por supuesto cada categoría contiene un conjunto de productos que tiene características comunes, por ejemplo Categoría: Informática, Producto: Ordenador Portátil, Mause, Router...... cada uno de estos productos a su vez están compuestos por diferentes partes, es decir, un Ordenador común, cuando menos contiene una placa de sonido, tarjeta de red, Unidades de Entrada (USB, CD/DVD...). Para este ejemplo vamos a asumir que cada producto puede estar asociado a muchas categorías, y que cada categoría puede contener muchos productos, (relación n:n). En bases de datos de primer semestre se nos detallan este tipo de situaciones, y normalmente nos piden generar un diagrama entidad relación creando tablas y obviamente relaciones entre ellas, con JPA esto cambia en el sentido de que ya no hablamos directamente de tablas sino de entidades las cuales representan un objeto persistente cada entidad tiene atributos y relaciones y son simplemente objetos planos POJO que normalmente solamente contienen una estructura básica de información con los métodos básicos de acceso a objetos por medio de métodos setXXX y getXXX donde XXX representa el atributo.
Para este caso se emplea se pueden determinar 3 entidades básicas que son Categoría, Producto y Partes, ahora, las entidades serían las siguientes:
Categoria.java
Producto.java
Parte.java
Como se puede ver, se han emitido algunos atributos que podrían contener las entidades, dado que para este ejemplo no representan mayor importancia no se enfoca mucho en ellos, lo que si resulta interesante es el uso de las relaciones que son las que en realidad realizan el trabajo de integridad y consistencia en el modelo de datos, el uso correcto de las mismas es vital, ya que esta es la forma de normalizar el modelo de tablas que se crearan y/o borraran de la base de datos. A continuación detallare un poco sobre las funciones de cada una de dichas relaciones.
@ManyToMany:
Una relación de muchos a muchos que puede ser bidireccional o unidireccional, donde se especifican los atributos que harán parte de este tipo de relaciones, en este caso dado que una Categoria puede tener muchos productos y un producto puede estar en muchas categorías, esta anotación debe de estar integrada en ambas entidades.
Podemos ver varios elementos en este ejemplo, la anotación ManyToMany en la clase Categoria (que se será la clase que gobierne la relación) tiene una anotación anidada @JoinColumns que a su vez tiene otra @JoinColumn, esto tiene una razón muy simple, debe existir una tabla intermedia cuando existe una relación n:n (Bases de Datos I capitulo de Normalización) en este caso, JPA con el uso de estas anotaciones define el nombre de la tabla que sera creada como tabla intermedia y define también los campos que representaran las claves foráneas respectivas en la relación de entidades, a partir de aquí, la persistencia se realiza prácticamente de forma automática entre las 3 entidades (bueno.... como veremos en otra entrada no es tan automática) sin embargo el manejo de consistencia es mucho mas simple, también existe un atributo en la anotación ManyToMany llamado mappedBy, en este atributo se define el nombre del atributo de la tabla con la cual se tiene relación, por lo tanto en ambas entidades estos nombres deben de coincidir de forma exacta
@OneToMany:
Aquí se especifica una relación de uno a muchos la entidad que contenga esta anotación deberá especificar una lista o conjunto de objetos que deberán hacer referencia a otra entidad, y al igual que ocurre con la anotación ManyToMany, se deberá identificar el atributo mappedBy
@ManyToOne:
Aquí se trata el sentido inverso de la relación tratando Muchos a Uno, la entidad que haga uso de esta entidad deberá contener un atributo univalorado, (es decir un solo objeto) que haga referencia a otra entidad que contenga una anotación OneToMany apuntando a una lista de objetos de su mismo tipo, estas situaciones se notan claramente en el ejemplo de Producto-Parte
Cabe anotar que todas estas anotaciones y clases en su gran mayoría se encuentran en el paquete
javax.persistence
Ahora hay otra caracteristica importante que debe ser tomada en cuenta en este punto, y es el hecho de que debe existir una conexión a la base de datos para que estas entidades puedan materializarse en tablas, para esto es necesario tener incluido un archivo persistence.xml el cual contiene el nombre JNDI del pool de conexiones, para que despues de esta forma el EntityManager pueda hacer uso de esta referencia JNDI y así localizar el pool y solicitar la conexión, para este caso el archivo podria incluir el siguiente contenido (cambiando XXXX por el nombre de la base de datos)
Persistence.xml
Aqui empleamos como framework de persistencia TopLink de oracle, tambien podriamos usar Hibernate o Kodo, cada uno tendra sus propias caracteristicas, sin embargo con JPA tenemos la libertad de usar cualquiera de ellos e inclusive cambiarlo si nos apetece en cualquier punto de la aplicación.
Por el momento esta breve introducción a JPA será algo para comenzar, sin embargo obviamente no suficiente, en próximas entradas ingresaré como integrar EJB y JPA por medio de beans de Sesión sin estado haciendo uso de un Contexto de Persistencia y un manejador de entidades, posterior a esto ingresaré otra entrada indicando los pasos para integrar estas 2 entradas con JSF y una aplicación web simple empleando este framework, y finalmente en otra entrada más, mostraré el uso de NetBeans y Sun Application Server para desplegar y probar la aplicación, si estáis siguiendo estos pasos seguro no tendrás muchos problemas empleando J2EE v5.0, de cualquier modo mi correo siempre esta abierto a preguntas/comentarios que se os ocurran....
jdaanial.