Definición de columnas con @Column

Una de las principales características cuando trabajamos con base de datos es que todas las tablas tienen Columnas, y dichas columnas esta mapeadas contra los atributos de las entidades, para lo cual es necesario que JPA identifique que columna mapea contra cada atributo de la clase y es aquí donde entra @Column.

@Column

La anotación @Column nos permitirá definir aspectos muy importantes sobre las columnas de la base de datos de la base de datos como lo es el nombre, la longitud, constrains, etc. En caso de no definir esta anotación en los atributos, JPA determinara el nombre de la columna de forma automática mediante el nombre del atributo, por lo que siempre es recomendable establecer esta anotación en todos los atributos de la clase y evitarnos problemas.

Las propiedades que podemos definirle a @Column son las siguientes:

• name: Permite establecer el nombre de la columna de la tabla con la que el atributo debe de mapear. A pesar de que ningún atributo de @Column es obligatorio, este atributo siempre recomiendo establecerlo.
• length: Permite definir la longitud de la columna en caracteres, solo aplica para Strings, en los demás tipos de datos será omitida. Solo se utiliza cuando JPA creará las tablas.
• insertable: Le indica a JPA si esa columna debe ser tomada en cuenta en los inserts, en caso de ser true, el valor será insertado, en caso contrario el valor será omitido y será colocado el valor default de la columna o null.
• updatable: Parecido al caso anterior, solo que en este caso la columna se toma en cuenta para operaciones de Update.
• nullable: Crea una restricción en la tabla (Not Null) para impedir que se inserten valores nulos. Solo se utiliza cuando JPA creará las tablas.
• precisión:
• scale: Utilizada únicamente para columnas que deben tener decimales, como valore recibe el número de decimales. Solo se utiliza cuando JPA creará las tablas.
• table: Esta propiedad es muy avanzada y la analizaremos más adelante. Se utiliza cuando existe herencia en las entidades y las columnas pueden estar distribuidas en más de una tabla.
• unique: Creara una restricción en la tabla para que sea el valor de esa columna sea única. Solo se utiliza cuando JPA creará las tablas.

Para comprender como funciona la anotación @Column retomaremos la entidad Employee que hemos venido analizando en todo el tutorial: Recordemos como la habíamos dejo en las secciones anteriores:

@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")
    private Long id;
    
    @Column(name = "NAME", nullable = false, length = 150)
    private String name; 

}

Ahora bien, para utilizar el mayor número de características agregaremos un par de atributos más, agregaremos el salario y la fecha de ingreso del empleado. Veamos cómo quedaría:

@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;

}

Veamos que el atributo id, solo requiere definir la propiedad name, pues por default, ya es única, no nula, no actualizable. Por lo que con definir el nombre será necesario.

En el caso del nombre, definimos la propiedad name, le indicamos que no puede ser nulo y le estamos definiendo una longitud de 150 caracteres.

En el caso del salario también ponemos el nombre, le indicamos que el suledo puede tener 2 decimales y que no debe de ser nulo.

Tambíen los quiero invitar a ver mi curso de JPA, donde explico todos estos temas aplicados con API REST, https://codmind.com/courses/jpa

Finalmente, en la fecha de registro también establecemos el nombre, pero en este caso veamos que el nombre de la columna es diferente que el de la propiedad y es cuando es especialmente necesario definir la propiedad name, le indicamos que no debe de ser nulo y finalmente, la fecha de ingreso no debe de ser actualizable. Por el momento no tomemos en cuenta la anotación @Temporal, más adelante la estudiaremos

Definición de la tabla:

En las imágenes vemos como quedarían las tablas generadas por JPA, veamos que ID es llave primaria y es auto incremental, todas las columnas son not null y el nombre tiene una longitud de 150 caracteres.

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.