JPA的@Column()注解详解

就像@Table注解用来标识实体类与数据表的对应关系类似，@Column注解来标识实体类中属性与数据表中字段的对应关系。

该注解的定义如下：

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by Fernflower decompiler)
//

package javax.persistence;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target({ElementType.METHOD, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Column {
    String name() default "";

    boolean unique() default false;

    boolean nullable() default true;

    boolean insertable() default true;

    boolean updatable() default true;

    String columnDefinition() default "";

    String table() default "";

    int length() default 255;

    int precision() default 0;

    int scale() default 0;
}

从定义可以看出，@Column注解一共有10个属性，这10个属性均为可选属性，各属性含义分别如下：

1、name

2、unique

3、nullable

4、insertable

5、updatable

6、columnDefinition

7、table

8、length

9、precision和10、scale 

precision属性和scale属性表示精度，当字段类型为double时，precision表示数值的总长度，scale表示小数点所占的位数。

API文档地址： ​​http://docs.oracle.com/javaee/5/api/javax/persistence/Column.html​​

在使用此@Column标记时，需要注意以下几个问题：

1、此标记可以标注在getter方法

2、此标记可以标注在属性前

例如以下的两种标注方法都是正确的：

1、标注在属性前：

import javax.persistence.Column; 
import javax.persistence.Entity; 
import javax.persistence.Table; 

@Entity 
@Table(name = "contact") 
public class ContactEO { 


     @Column(name = " contact_name ") 

     private String name; 
     

public String getName() { 
return name; 
} 

public void setName(String name) { 
this.name = name; 
} 
}

2、标注在getter方法前：

import javax.persistence.Column; 
import javax.persistence.Entity; 
import javax.persistence.Table; 

@Entity 
@Table(name = "contact") 
public class ContactEO { 
private String name; 


     @Column(name = " contact_name ") 
     
public String getName() { 
return name; 
} 

public void setName(String name) { 
this.name = name; 
} 
}

提示：JPA规范中并没有明确指定那种标注方法，只要两种标注方式任选其一都可以。这根据个人的喜好来选择，本人习惯使用第一种方法。

下面举几个小例子：

示例一：指定字段“contact_name”的长度是“512”，并且值不能为null。
private String name;
 
@Column(name="contact_name",nullable=false,length=512)
public String getName() {
         return name;
}
创建的SQL语句如下所示。
CREATE TABLE contact (
id integer not null,
contact_name varchar (512) not null,
primary key (id)
)
示例二：指定字段“monthly_income”月收入的类型为double型，精度为12位，小数点位数为2位。
         private BigDecimal monthlyIncome;
 
         @Column(name="monthly_income",precision=12, scale=2)
         public BigDecimal getMonthlyIncome() {
                   return monthlyIncome;
         }
创建的SQL语句如下所示。
CREATE TABLE contact (
id integer not null,
monthly_income double(12,2),
primary key (id)
)
示例三：自定义生成CLOB类型字段的SQL语句。
private String  name;
 
@Column(name=" contact_name ",columnDefinition="clob not null")
public String getName() {
                  return name;
}
生成表的定义SQL语句如下所示。
CREATE TABLE contact (
id integer not null,
contact_name clob (200) not null,
primary key (id)
)
其中，加粗的部分为columnDefinition属性设置的值。若不指定该属性，通常使用默认的类型建表，若此时需要自定义建表的类型时，可在该属性中设置。
   
提示：通过Entity定义生成表，还是通过表配置Entity，这两种ORM的策略。有关两种方法的映射策略好坏，将在本书的章节中“JPA工具的使用”一章进行详细的比较。
示例四：字段值为只读的，不允许插入和修改。通常用于主键和外键。
         private Integer id;
        
         @Column(name="id",insertable=false,updatable=false)
         public Integer getId() {
                   return id;
         }