@Column

@Column標記表示所持久化屬性所映射表中的字段，該註釋的屬性定義以下：

@Target({METHOD, FIELD}) @Retention(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標記時，須要注意如下幾個問題：

l         此標記能夠標註在getter方法或屬性前，例如如下的兩種標註方法都是正確的：

標註在屬性前：

@Entity

@Table(name = "contact")

public class ContactEO{

@Column(name=" contact_name ")

private String name;

}

標註在getter方法前：

@Entity

@Table(name = "contact")

public class ContactEO{

@Column(name=" contact_name ")

public String getName() {

         return name;

}

}

 

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」，而且值不能爲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屬性設置的值。若不指定該屬性，一般使用默認的類型建表，若此時須要自定義建表的類型時，可在該屬性中設置。

示例四：字段值爲只讀的，不容許插入和修改。一般用於主鍵和外鍵。

         private Integer id;

        

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

         public Integer getId() {

                   return id;

         }