En este post aprenderemos a crear un proyecto JPA Stand Alone usando Hibernate como implementación de JPA y Maven, que es una herramienta de software para la gestión y construcción de proyectos.
¿Qué es JPA?
Java Persistence API es una especificación de persistencia para la plataforma JAVA que aplica el Mapeo Relacional Objeto (ORM: Object-Relational Mapping) permitiendo interactuar con bases de datos relacionales sin perder las ventajas de la orientación a objetos. Esto permite construir aplicaciones completamente orientadas a objetos. Algunas de las implementaciones mas conocidas de JPA son: Hibernate, TopLink, OpenJPA, EclipseLink.
¿Qué es Hibernate?
Hibernate es una herramienta de mapeo objeto-relacional (ORM) para Java, que facilita el mapeo de atributos en una base de datos tradicional, y el modelo de objetos de un aplicación mediante archivos declarativos o anotaciones en los beans de las entidades que permiten establecer estas relaciones.
¿Qué es JPA?
Java Persistence API es una especificación de persistencia para la plataforma JAVA que aplica el Mapeo Relacional Objeto (ORM: Object-Relational Mapping) permitiendo interactuar con bases de datos relacionales sin perder las ventajas de la orientación a objetos. Esto permite construir aplicaciones completamente orientadas a objetos. Algunas de las implementaciones mas conocidas de JPA son: Hibernate, TopLink, OpenJPA, EclipseLink.
¿Qué es Hibernate?
Hibernate es una herramienta de mapeo objeto-relacional (ORM) para Java, que facilita el mapeo de atributos en una base de datos tradicional, y el modelo de objetos de un aplicación mediante archivos declarativos o anotaciones en los beans de las entidades que permiten establecer estas relaciones.
¿Qué es Maven?
Normalmente cuando trabajamos con Java/JavaEE el uso de librerías es algo común como en cualquier otro lenguaje de programación. Sin embargo, una librería puede depender de otras librerías para funcionar de forma correcta. Por ende, su gestión se puede volver tedioso a la hora de buscar las librerías y ver que versión exacta debemos de elegir. Así pues necesitamos más información para gestionarlo todo de forma correcta y para ellos existe MAVEN, que es una herramienta que nos va a permitir tener una gestión correcta de nuestra librerías, proyectos y dependencias. Dentro de un proyecto Maven el archivo pom.xml (Proyect Object Model) es el de mayor importancia ya que contiene toda la información del artefacto que usará nuestro proyecto. Un Artefacto puede verse como una librería con esteroides (aunque agrupa mas conceptos). Contiene las clases propias de la librería pero ademas incluye toda la información necesaria para su correcta gestión (grupo, versión, dependencias etc).
PASOS
1. Crear la base de datos
Abrir el MySQL Workbench y ejecutar el siguiente script:
2. Crear un Maven Project
Clic en File/New/Maven Project.
Group Id: identifica de forma exclusiva su proyecto en todos los proyectos. Una ID de grupo debe seguir las reglas de nombre de paquete de Java . Esto significa que comienza con un nombre de dominio invertido que controlas. Por ejemplo, org.apache.maven, org.apache.commons.
Artifact Id: es el nombre del jar sin versión. Si lo creó, puede elegir el nombre que desee con letras minúsculas y sin símbolos extraños. Si se trata de un jar de un tercero, debe tomar el nombre del jar tal como está distribuido.
Versión: si distribuye, entonces usted puede elegir cualquier versión típica con números y puntos (1.0, 1.1, 1.0.1, ...). No use fechas, ya que generalmente están asociadas con compilaciones SNAPSHOT (todas las noches). Si se trata de un artefacto de un tercero, debe usar su número de versión, sea lo que sea, y por extraño que parezca. Por ejemplo, 2.0, 2.0.1, 1.3.1.
Clic en "Finish" y tendremos la siguiente estructura
El error que no muestra va a desaparecer cuando agreguemos las dependencias.
javax.servlet-api: para trabajar con serlvets (hace que desaparezca el error anterior).
mysql-connector-java: driver de conexión mysql.
hibernate-core: para trabajar con hibernate.
No olvidemos que tenemos que cambiar la versión de Java de 1.7 a 1.8.
Guardamos los cambios y podemos observar que dentro del directorio Maven Dependencies se han descargados todas las librerías. Si no les descarga las librerías de manera automática, debemos hacer clic derecho al proyecto y seleccionar la opción Maven/Update Project...
4 Aparecer directorio ocultos de Java
Clic derecho al proyecto y seleccionamos la opción /Build Path/Configure Build Path...
En la venta que se abre marcamos la casilla Maven Dependencies y hacemos clic en Aplicar.
Como podemos observar, aparecieron directorios que estaban ocultos.
5. Crear el archivo persistence.xml
Clic derecho al proyecto y seleccionamos la opción New/Folder.
Dentro del proyecto seleccionamos la ubicación src/main/java y creamos el folder llamado META-INF
Ahora damos clic derecho en la carpeta META-INF y seleccionamos la opción New/Other/XML File.
Dentro de esta carpeta crearemos el archivo persistence.xml y copiamos el siguiente código.
El código "?useTimezone=true&serverTimezone=UTC" es adicional. Si no colocaba esta instrucción me iba a saltar el error "Client does not support authentication protocol requested by server; consider upgrading MySQL client".
6. Crear el modelo
Crear la clase Producto.java dentro del paquete com.aprendec.model.
⧭ ORM es una técnica para convertir datos entre el sistema utilizado en lenguaje de POO y el utilizado en una Base de Datos Relacional. Como resultado de aplicar esta técnica, el programador podrá codificar en Java como si interactuará virtualmente con una Base de Datos Orientada a Objetos, cuya base es una Base de Datos Relacional, permitiendo así aprovechar todas las características de la programación Orientada a Objetos al interactuar con una Base de Datos Relacional.
⧭ Una instancia de una clase Entidad representará una fila de una Tabla relacional.
⧭ En el caso de JPA, tenemos 2 posibilidades de aplicar ORM
⧭ Una instancia de una clase Entidad representará una fila de una Tabla relacional.
⧭ En el caso de JPA, tenemos 2 posibilidades de aplicar ORM
- Utilizando el archivo de configuración orm.xml
- Utilizando @Anotaciones
Aplicando ORM a la Clase “Empleado”.
@Entity: Significa que esta clase entidad representa una tabla de datos relacional
@Table: es la tabla que representa esta clase entidad.
@id: sirve para indicar el atributo que representa la PK de la tabla.
@column: sirve para indicar que el atributo es una columna, en este caso no es necesario ya que los atributos de la clase tienen el mismo nombre que las columnas de la tabla relacional.
7. Invocar a la unidad de persistencia
Crearemos las clases en donde se implementarán las funcionalidades de acceso a base de datos y operaciones CRUD con las tablas relacionales.
Crear la clase JPAUtil.java dentro del paquete com.aprendec.app para que haga el llamado a la unidad de persistencia definida en el archivo persistence.xml, de tal manera que podamos instanciar a este archivo y podamos tener contacto con la base de datos.
Crear la clase MainApp.java dentro del paquete com.aprendec.app para crear las operaciones CRUD.
Donde:
Método listar:
- em.getResultList(): obtiene la lista de entidades, en base al JPQL definido.
Método insertar:
- em.persist(entidadEmpleado): genera un insert a la tabla relacional mapeada con los datos del objeto.
Método actualizar:
- em.merge(entidadEmpleado): genera un update a la tabla relacional mapeada con los datos del objeto.
Método eliminar:
Para eliminar una entidad en JPA, primero debe colocarse en estado “managed”, es decir, debe cargarse al contexto de persistencia. Para ello primero debe realizarse una búsqueda.
- em.find(ClaseEntidad.class, valorLlavePrimaria): realiza una búsqueda por llave primaria en la tabla que representa la Clase Entidad.
- em.remove(entidadEmpleado): genera un delete a la tabla relacional mapeada con los datos del objeto.
IMPORTANTE: Asegúrense que los objetos “entidad” fueron cargados con todos los valores necesarios en sus atributos antes de ejecutar las transacciones, de lo contrario puede dar error al momento de ejecutarlas.
Método listar:
- em.getResultList(): obtiene la lista de entidades, en base al JPQL definido.
Método insertar:
- em.persist(entidadEmpleado): genera un insert a la tabla relacional mapeada con los datos del objeto.
Método actualizar:
- em.merge(entidadEmpleado): genera un update a la tabla relacional mapeada con los datos del objeto.
Método eliminar:
Para eliminar una entidad en JPA, primero debe colocarse en estado “managed”, es decir, debe cargarse al contexto de persistencia. Para ello primero debe realizarse una búsqueda.
- em.find(ClaseEntidad.class, valorLlavePrimaria): realiza una búsqueda por llave primaria en la tabla que representa la Clase Entidad.
- em.remove(entidadEmpleado): genera un delete a la tabla relacional mapeada con los datos del objeto.
IMPORTANTE: Asegúrense que los objetos “entidad” fueron cargados con todos los valores necesarios en sus atributos antes de ejecutar las transacciones, de lo contrario puede dar error al momento de ejecutarlas.
8, Probar aplicación
9. Estructura final del proyecto
Descargar proyecto
