JPA 經常使用註解 (hibernate)

 一、@Entity(name="EntityName")

　　　　必須,name爲可選,對應數據庫中一的個表

 

二、@Table(name="",catalog="",schema="")

　　　　可選,一般和@Entity配合使用,只能標註在實體的class定義處,表示實體對應的數據庫表的信息

　　　　　　name:　   可選,表示表的名稱.默認地,表名和實體名稱一致,只有在不一致的狀況下才須要指定表名

　　　　　　catalog:　 可選,表示Catalog名稱,默認爲Catalog("").

　　　　　　schema:   可選,表示Schema名稱,默認爲Schema("").

 

三、@id必須

　　　　@id定義了映射到數據庫表的主鍵的屬性,一個實體只能有一個屬性被映射爲主鍵.置於getXxxx()前.

 

四、@GeneratedValue(strategy=GenerationType,generator="")可選

　　　　strategy:    表示主鍵生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4種,

　　　　　　　　　　分別表示讓ORM框架自動選擇,根據數據庫的Identity字段生成,

　　　　　　　　　　根據數據庫表的Sequence字段生成,以有根據一個額外的表生成主鍵,默認爲AUTO

　　　　generator:  表示主鍵生成器的名稱,這個屬性一般和ORM框架相關,例如,Hibernate能夠指定uuid等主鍵生成方式.

　　示例:

@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE)
public int getPk() {
　　return pk;
}

@GeneratedValue(generator="pk")
@GenericGenerator(name="pk",strategy="uuid.hex")
public String getSno() {
    return sno;
}

 

 

五、@Basic(fetch=FetchType,optional=true)

　　可選

　　　　@Basic    表示一個簡單的屬性到數據庫表的字段的映射,對於沒有任何標註的getXxxx()方法,默認即爲@Basic

　　　　fetch:      表示該屬性的讀取策略,有EAGER和LAZY兩種,分別表示主支抓取和延遲加載,默認爲EAGER.

　　　　optional: 表示該屬性是否容許爲null,默認爲true

　　示例:

@Basic(optional=false)

public String getAddress() {

   return address;

}

 

 

六、@Column

　　可選

@Column	描述了數據庫表中該字段的詳細定義,這對於根據JPA註解生成數據庫表結構的工具很是有做用.
name:	表示數據庫表中該字段的名稱,默認情形屬性名稱一致
nullable:	表示該字段是否容許爲null,默認爲true
unique:	表示該字段是不是惟一標識,默認爲false
length:	表示該字段的大小,僅對String類型的字段有效
insertable:	表示在ORM框架執行插入操做時,該字段是否應出現INSETRT語句中,默認爲true
updateable:	表示在ORM框架執行更新操做時,該字段是否應該出如今UPDATE語句中,默認爲true. 　　對於一經建立就不能夠更改的字段,該屬性很是有用,如對於birthday字段.
columnDefinition:	表示該字段在數據庫中的實際類型.一般ORM框架能夠根據屬性類型自動判斷數據庫中字段的類型,　　　　　　　　 　　可是對於Date類型仍沒法肯定數據庫中字段類型到底是DATE,TIME仍是TIMESTAMP.此外,String的默認映射類型爲VARCHAR,　　　　 　　若是要將String類型映射到特定數據庫的BLOB或TEXT字段類型,該屬性很是有用.

 

　　示例:

    @Column(name="BIRTH",nullable="false",columnDefinition="DATE")

    public String getBithday() {

       return birthday;

    }

 

  

七、@Transient

　　可選

　　　　@Transient表示該屬性並不是一個到數據庫表的字段的映射,ORM框架將忽略該屬性.

　　　　若是一個屬性並不是數據庫表的字段映射,就務必將其標示爲@Transient,不然,ORM框架默認其註解爲@Basic

　　示例:

    //根據birth計算出age屬性

    @Transient

    public int getAge() {

       return getYear(new Date()) - getYear(birth);

    }

 

 

八、@ManyToOne(fetch=FetchType,cascade=CascadeType)

　　可選

@ManyToOne	表示一個多對一的映射,該註解標註的屬性一般是數據庫表的外鍵
optional:	是否容許該字段爲null,該屬性應該根據數據庫表的外鍵約束來肯定,默認爲true
fetch:	表示抓取策略,默認爲FetchType.EAGER
cascade:	表示默認的級聯操做策略,能夠指定爲ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干組合,默認爲無級聯操做
targetEntity:	表示該屬性關聯的實體類型.該屬性一般沒必要指定,ORM框架根據屬性類型自動判斷targetEntity.

 

　　示例:

    //訂單Order和用戶User是一個ManyToOne的關係

    //在Order類中定義

    @ManyToOne()

    @JoinColumn(name="USER")

    public User getUser() {

       return user;

    }

 

 

九、@JoinColumn

　　可選

　　　　@JoinColumn和@Column相似,介量描述的不是一個簡單字段,而一一個關聯字段,例如.描述一個@ManyToOne的字段.

　　　　name:　　該字段的名稱.因爲@JoinColumn描述的是一個關聯字段,如ManyToOne,則默認的名稱由其關聯的實體決定.

　　　　例如,實體Order有一個user屬性來關聯實體User,則Order的user屬性爲一個外鍵,

　　　　其默認的名稱爲實體User的名稱+下劃線+實體User的主鍵名稱

　　示例:

   　　 見@ManyToOne

 

十、@OneToMany(fetch=FetchType,cascade=CascadeType)

　　可選

　　　　@OneToMany 描述一個一對多的關聯,該屬性應該爲集體類型,在數據庫中並無實際字段.

　　　　fetch:  　　表示抓取策略,默認爲FetchType.LAZY,由於關聯的多個對象一般沒必要從數據庫預先讀取到內存

　　　　cascade:　 表示級聯操做策略,對於OneToMany類型的關聯很是重要,一般該實體更新或刪除時,其關聯的實體也應當被更新或刪除

　　例如:  實體User和Order是OneToMany的關係,則實體User被刪除時,其關聯的實體Order也應該被所有刪除

 

　　示例:

    @OneTyMany(cascade=ALL)

    public List getOrders() {

       return orders;

    }

 

 

十一、@OneToOne(fetch=FetchType,cascade=CascadeType)

　　可選

　　　　@OneToOne  描述一個一對一的關聯

　　　　fetch:　　表示抓取策略,默認爲FetchType.LAZY

　　　　cascade:  表示級聯操做策略

　　示例:

    @OneToOne(fetch=FetchType.LAZY)

    public Blog getBlog() {

       return blog;

    }

 

 

十二、@ManyToMany

　　可選

　　　　@ManyToMany 描述一個多對多的關聯.多對多關聯上是兩個一對多關聯,可是在ManyToMany描述中,中間表是由ORM框架自動處理

　　　　targetEntity:　 表示多對多關聯的另外一個實體類的全名,例如:package.Book.class

　　　　mappedBy:　　表示多對多關聯的另外一個實體類的對應集合屬性名稱

示例:

    User實體表示用戶,Book實體表示書籍,爲了描述用戶收藏的書籍,能夠在User和Book之間創建ManyToMany關聯

    @Entity
    public class User {

       private List books;

       @ManyToMany(targetEntity=package.Book.class)
       public List getBooks() {
           return books;
       }

       public void setBooks(List books) {
           this.books=books;
       }

    }  

    @Entity
    public class Book {

       private List users;

       @ManyToMany(targetEntity=package.Users.class, mappedBy="books")
       public List getUsers() {
           return users;
       }

       public void setUsers(List users) {
           this.users=users;
       }

    }

 

　　兩個實體間相互關聯的屬性必須標記爲@ManyToMany,並相互指定targetEntity屬性,

　　須要注意的是,有且只有一個實體的@ManyToMany註解須要指定mappedBy屬性,指向targetEntity的集合屬性名稱

　　利用ORM工具自動生成的表除了User和Book表外,還自動生成了一個User_Book表,用於實現多對多關聯