Tutorial SpringBoot: Crear entidades JPA

Las entidades JPA (Java Persistence API) son un componente fundamental en la persistencia de datos en aplicaciones Spring Boot. En esencia, son clases POJO (Plain Old Java Object) que representan tablas en una base de datos. Se utilizan para interactuar con la base de datos y manipular sus registros.

Anotaciones

En las entidades JPA se utilizan varias anotaciones para configurar la forma en la que los objetos de Java se mapean con las tablas de una base de datos.

Aquí algunas de las anotaciones más comunes y su significado:

• @Entity: Esta anotación se utiliza para marcar una clase en Java como una entidad que debe ser gestionada por el contexto de persistencia de JPA.

• @Table: Esta anotación se utiliza para especificar detalles de la tabla a la que se mapeará la entidad. Puedes especificar el nombre de la tabla, esquema, catálogo, y restricciones de la tabla.

• @Id: Esta anotación se utiliza para especificar la propiedad de la clase que mapea a la clave primaria de la tabla.

• @GeneratedValue: Esta anotación se utiliza junto con @Id para especificar la estrategia de generación de la clave primaria.

• @Column: Esta anotación se utiliza para mapear una propiedad de la clase a una columna en la tabla de la base de datos.

• @Transient: Si no quieres que un campo en particular se persista en la base de datos, puedes usar la anotación @Transient en ese campo.

• @OneToOne, @OneToMany, @ManyToOne, @ManyToMany: Estas anotaciones se utilizan para representar las relaciones entre las entidades.

• @JoinColumn: Esta anotación se utiliza para especificar una columna para unir una entidad asociada.

• @MappedSuperclass: Esta anotación se utiliza para especificar una clase cuyos detalles de mapeo se aplican a las entidades que heredan de ella.

• @Embeddable y @Embedded: Estas anotaciones se utilizan para especificar una clase cuyas instancias son almacenadas como un valor intrínseco de una entidad y la entidad en sí respectivamente.

• @Temporal: Esta anotación se utiliza para convertir la fecha y hora de Java en el tipo de fecha y hora de SQL correspondiente cuando se persiste la fecha/hora.

• @Enumerated: Esta anotación se utiliza para especificar que un campo persistente o propiedad de una entidad será persistida como un tipo enumerado.

Las anotaciones en JPA son herramientas muy útiles para configurar la persistencia de datos en aplicaciones Java, haciendo el proceso más sencillo y directo.

Ejemplo de entidad JPA

En una nueva clase llamada User.java:

import jakarta.persistence.Entity;
import jakarta.persistence.Table;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Column;

@Entity // Indica que la clase es una entidad JPA
@Table(name = "users") // Especifica el nombre de la tabla en la base de datos
public class User {

    @Id // Indica que el campo es la clave primaria de la tabla
    @GeneratedValue(strategy = GenerationType.AUTO) // Configura cómo se genera el valor del ID
    private Long id;

    @Column(name = "username", nullable = false, unique = true) // Personaliza la columna asociada al campo
    private String username;

    @Column(name = "email", nullable = false)
    private String email;

    @Column(name = "password", nullable = false)
    private String password;

    // Getters y Setters
}

Estrategia de Generación de Identificadores

La estrategia de generación de identificadores en JPA se refiere a cómo se crean automáticamente los valores de las claves primarias cuando se crea un nuevo registro en una tabla de la base de datos. Esto se configura utilizando la anotación @GeneratedValue, generalmente en combinación con @Id.

Hay cuatro estrategias de generación que se pueden especificar utilizando la enumeración GenerationType:

1. AUTO: Esto delega la selección de la estrategia de generación al proveedor de persistencia que se utiliza. El proveedor de persistencia seleccionará la estrategia de generación que considere más apropiada según el contexto. Es la opción por defecto si no se especifica ninguna estrategia.

@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;

2. IDENTITY: Esta estrategia se basa en columnas de base de datos de auto incremento. Cuando se inserta una nueva fila, la base de datos automáticamente genera un nuevo valor para el campo.

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

3. SEQUENCE: Esta estrategia se basa en secuencias de bases de datos. Es muy eficaz en términos de rendimiento porque utiliza una secuencia de base de datos que es una entidad separada que puede generar valores únicos de ID en paralelo.

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE)
private Long id;

4. TABLE: Esta estrategia utiliza una tabla adicional para generar valores de identificador. No es la más eficiente en términos de rendimiento, pero tiene la ventaja de ser portable entre diferentes bases de datos.

@Id
@GeneratedValue(strategy = GenerationType.TABLE)
private Long id;

Cada una de estas estrategias tiene sus ventajas y desventajas, y la elección entre ellas depende de las necesidades específicas de la aplicación y la base de datos que se esté utilizando.

A partir de las nuevas versiones de Jakarta Persistence (JPA) se incorpora una nueva estrategia de generación de ids: UUID.

Conclusión

Crear y manejar adecuadamente las entidades JPA es un aspecto crucial del desarrollo de aplicaciones con Spring Boot, especialmente cuando se trata de aplicaciones que requieren persistencia de datos en una base de datos.

Las entidades JPA permiten a los desarrolladores representar las tablas de la base de datos como clases en Java, y los campos de la tabla como atributos en esas clases.

Las anotaciones proporcionadas por JPA permiten un mapeo detallado de la relación entre las entidades de Java y las tablas de la base de datos. Algunas anotaciones se utilizan para definir qué clases son entidades y cómo deben mapearse a las tablas de la base de datos. Otras anotaciones se utilizan para definir las claves primarias y cómo deben generarse sus valores. Además, hay anotaciones para definir las relaciones entre las entidades, como las relaciones uno a uno, uno a muchos, muchos a uno y muchos a muchos.