Una de las ventajas de utilizar enumeraciones en Java, es podemos limitar los valores posibles para una propiedad, forzando a los desarrolladores a utilizar los valores ya definidos y evitando el margen de error.
@Enumerated
Con JPA tambi茅n es posible utilizar enumeraciones y pueden ser de mucha ayuda para asegurar que los programadores persistan un valor v谩lido dentro de una lista previamente definida. JPA nos permite mediante la anotaci贸n @Enumerated definir la forma en que una enumeraci贸n ser谩 persistida, las cuales se explican a continuaci贸n:
- String: permite persistir la enumeraci贸n por su nombre, lo que significa que ser谩 una columna alfanum茅rica. La anotaci贸n quedar铆a as铆:
- @Enumerated(value = EnumType.STRING)
- Ordinal: esta estrategia persiste un valor entero que corresponde al valor ordinal o posici贸n de valor en la enumeraci贸n. La anotaci贸n quedar铆a de la siguiente manera:
- @Enumerated(value = EnumType.ORDINAL)
Retomaremos la entidad Employee que hemos venido analizando en todo este tutorial y le agregaremos una nueva propiedad que corresponda al status:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 | package com.obb.jpa.jpaturorial.entity; import java.util.Calendar; import java.util.Objects; import javax.persistence.*; /** * @author Oscar Blancarte */ @Entity @Table( name = "EMPLOYEES" , schema = "jpatutorial", indexes = {@Index(name = "name_index", columnList = "name",unique = true)} ) public class Employee { @Id @GeneratedValue(strategy = GenerationType.IDENTITY, generator = "EmployeeTable") @Column(name = "ID") private Long id; @Column(name = "NAME", nullable = false, length = 150) private String name; @Column(name = "SALARY", nullable = false, scale = 2) private double salary; @Column(name = "REGIST_DATE", updatable = false, nullable = false) @Temporal(TemporalType.DATE) private Calendar registDate; @Column(name="status", nullable = false, length = 8 ) @Enumerated(value = EnumType.STRING) private Status status; /** * GETs and SETs */ } |
Veamos que la propiedad es de tipo Status, la cual es una enumeraci贸n y tiene definida la estrategia String. Tambi茅n podemos ver que est谩 definida la anotaci贸n @Column para definir las caracter铆sticas de la columna.
Por otra parte, tenemos la enumeraci贸n Status la cual tiene los posibles valores ACTIVE e INACTIVE.
1 2 3 4 5 6 7 8 9 | package com.obb.jpa.jpaturorial.entity; /** * @author Oscar Blancarte */ public enum Status { ACTIVE, INACTIVE } |
La anotaci贸n @Enumerated no es mandataria, pero el hecho de omitirla provocara que JPA determine la estrategia por default, que en nuestro caso ser铆a Ordinal. Por eso yo siempre aconsejo definirla para no tener sorpresas.
Si ejecutamos nuestro el programa para que cree las tablas por nosotros veremos que se creara una columna de tipo VARCHAR ya que definimos String como estrategia. Por otro lado, si utilizamos Ordinal se crear谩 una columna de tipo INT.
Yo siempre recomiendo utilizar Enumeraciones cuando definamos atributos que requieren valores fijos y previamente determinados, como una lista de valores, pero que esta lista no requiera cambiar en tiempo de ejecuci贸n. Una mala opci贸n para utilizarla es para definir listas de valores que en el futuro requieran ampliarse sin necesidad de recompilar.
NOTA: Este art铆culo es solo una secci贸n del Tutorial de JPA, para ver el contenido completo de este tutorial regresa al 脥ndice en el bot贸n de abajo.
