@Column 注解详情

@Column标记表示所持久化属性所映射表中的字段，该注释的属性定义如下：

@Target（{METHOD，FIELD}）@Retention（RUNTIME）

public @interface Column {

字符串名称（）默认“”;

boolean unique（）默认为false;

boolean nullable（）默认为true;

boolean insertable（）默认为true;

boolean updatable（）默认为true;

String columnDefinition（）默认为“”;

String table（）默认为“”;

int length（）默认为255;

int precision（）默认为0;

int scale（）默认为0;

}

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

l此标记可以标注在getter方法或属性前，例如以下的两种标注方法都是正确的：

标注在属性前：

@实体

@Table（name =“contact”）

公共课ContactEO {

@Column（name =“contact_name”）

私有字符串名称;

}

标注在吸气方法前：

@实体

@Table（name =“contact”）

公共课ContactEO {

@Column（name =“contact_name”）

public String getName（）{

     return name;

}

}

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

l unique属性表示该字段是否为唯一标识，默认为false。如果表中有一个字段需要唯一标识，则既可以使用该标记，也可以使用@Table标记中的@UniqueConstraint。

l nullable属性表示该字段是否可以为null值，默认为true。

l insertable属性表示在使用“INSERT”脚本插入数据时，是否需要插入该字段的值。

l updatable属性表示在使用“UPDATE”脚本插入数据时，是否需要更新该字段的值.insertable和updatable属性一般多用于只读的属性，例如主键和外键等。这些字段的值通常是自动生成的。

l columnDefinition属性表示创建表时，该字段创建的SQL语句，一般用于通过Entity生成表定义时使用。

l table属性表示当映射多个表时，指定表的表中的字段。默认值为主表的表名。有关多个表的映射将在本章的5.6小节中详细讲述。

l length属性表示字段的长度，当字段的类型为varchar时，该属性才有效，默认为255个字符。

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

下面举几个小例子：

示例一：指定字段“CONTACT_NAME”的长度是“512”，并且值不能为空。

私有字符串名称;

@Column（名称=” CONTACT_NAME”，可为空=假，长度= 512）

public String getName（）{

     return name;

}

创建的SQL语句如下所示。

CREATE TABLE联系人（

id整数不为null，

contact_name varchar（512）not null，

主键（id）

）

示例二：指定字段“monthly_income”月收入的类型为双型，精度为12位，小数点位数为2位。

     private BigDecimal monthlyIncome;



     @Column(name="monthly_income",precision=12, scale=2)

     public BigDecimal getMonthlyIncome() {

               return monthlyIncome;

     }

创建的SQL语句如下所示。

CREATE TABLE联系人（

id整数不为null，

month_income double（12,2），

主键（id）

）

示例三：自定义生成CLOB类型字段的SQL语句。

私有字符串名称;

@Column（name =“contact_name”，columnDefinition =“clob not null”）

public String getName（）{

              return name;

}

生成表的定义SQL语句如下所示。

CREATE TABLE联系人（

id整数不为null，

contact_name clob（200）not null，

主键（id）

）

其中，加粗的部分为columnDefinition属性设置的值。若不指定该属性，通常使用默认的类型建表，若此时需要自定义建表的类型时，可在该属性中设置。

提示：通过实体定义生成表，还是通过表配置实体，这两种ORM的策略有关两种方法的映射策略好坏，将在本书的章节中“JPA工具的使用”一章进行详细的比较。

示例四：字段值为只读的，不允许插入和修改通常用于主键和外键。

     private Integer id;



     @Column(name="id",insertable=false,updatable=false)

     public Integer getId() {

               return id;

     }