溫馨提示:您的每一次轉載,體現(xiàn)了我寫此文的意義!!!煩請您在轉載時注明出處http://www.aygfsteel.com/sxyx2008/謝謝合作!!!

          雪山飛鵠

          溫馨提示:您的每一次轉載,體現(xiàn)了我寫此文的意義!!!煩請您在轉載時注明出處http://www.aygfsteel.com/sxyx2008/謝謝合作!!!

          BlogJava 首頁 新隨筆 聯(lián)系 聚合 管理
            215 Posts :: 1 Stories :: 674 Comments :: 0 Trackbacks

           

          1@Entity(name="EntityName")

          必須,name為可選,對應數(shù)據(jù)庫中一的個表

           

          2@Table(name="",catalog="",schema="")

          可選,通常和@Entity配合使用,只能標注在實體的class定義處,表示實體對應的數(shù)據(jù)庫表的信息

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

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

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

           

          3@id

          必須

          @id定義了映射到數(shù)據(jù)庫表的主鍵的屬性,一個實體只能有一個屬性被映射為主鍵.置于getXxxx().

           

          4@GeneratedValue(strategy=GenerationType,generator="")

          可選

          strategy:表示主鍵生成策略,AUTO,INDENTITY,SEQUENCE TABLE 4,分別表示讓ORM框架自動選擇,

          根據(jù)數(shù)據(jù)庫的Identity字段生成,根據(jù)數(shù)據(jù)庫表的Sequence字段生成,以有根據(jù)一個額外的表生成主鍵,默認為AUTO

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

          示例:

              @Id

              @GeneratedValues(strategy=StrategyType.SEQUENCE)

              public int getPk() {

                 return pk;

              }

           

          5@Basic(fetch=FetchType,optional=true)

          可選

          @Basic表示一個簡單的屬性到數(shù)據(jù)庫表的字段的映射,對于沒有任何標注的getXxxx()方法,默認即為@Basic

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

          optional:表示該屬性是否允許為null,默認為true

          示例:

              @Basic(optional=false)

              public String getAddress() {

                 return address;

              }

           

          6@Column

          可選

          @Column描述了數(shù)據(jù)庫表中該字段的詳細定義,這對于根據(jù)JPA注解生成數(shù)據(jù)庫表結構的工具非常有作用.

          name:表示數(shù)據(jù)庫表中該字段的名稱,默認情形屬性名稱一致

          nullable:表示該字段是否允許為null,默認為true

          unique:表示該字段是否是唯一標識,默認為false

          length:表示該字段的大小,僅對String類型的字段有效

          insertable:表示在ORM框架執(zhí)行插入操作時,該字段是否應出現(xiàn)INSETRT語句中,默認為true

          updateable:表示在ORM框架執(zhí)行更新操作時,該字段是否應該出現(xiàn)在UPDATE語句中,默認為true.對于一經創(chuàng)建就不可以更改的字段,該屬性非常有用,如對于birthday字段.

          columnDefinition:表示該字段在數(shù)據(jù)庫中的實際類型.通常ORM框架可以根據(jù)屬性類型自動判斷數(shù)據(jù)庫中字段的類型,但是對于Date類型仍無法確定數(shù)據(jù)庫中字段類型究竟是DATE,TIME還是TIMESTAMP.此外,String的默認映射類型為VARCHAR,如果要將String類型映射到特定數(shù)據(jù)庫的BLOBTEXT字段類型,該屬性非常有用.

          示例:

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

              public String getBithday() {

                 return birthday;

              }

           

          7@Transient

          可選

          @Transient表示該屬性并非一個到數(shù)據(jù)庫表的字段的映射,ORM框架將忽略該屬性.

          如果一個屬性并非數(shù)據(jù)庫表的字段映射,就務必將其標示為@Transient,否則,ORM框架默認其注解為@Basic

          示例:

              //根據(jù)birth計算出age屬性

              @Transient

              public int getAge() {

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

              }

           

          8@ManyToOne(fetch=FetchType,cascade=CascadeType)

          可選

          @ManyToOne表示一個多對一的映射,該注解標注的屬性通常是數(shù)據(jù)庫表的外鍵

          optional:是否允許該字段為null,該屬性應該根據(jù)數(shù)據(jù)庫表的外鍵約束來確定,默認為true

          fetch:表示抓取策略,默認為FetchType.EAGER

          cascade:表示默認的級聯(lián)操作策略,可以指定為ALL,PERSIST,MERGE,REFRESHREMOVE中的若干組合,默認為無級聯(lián)操作

          targetEntity:表示該屬性關聯(lián)的實體類型.該屬性通常不必指定,ORM框架根據(jù)屬性類型自動判斷targetEntity.

          示例:

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

              //Order類中定義

              @ManyToOne()

              @JoinColumn(name="USER")

              public User getUser() {

                 return user;

              }

           

          9@JoinColumn

          可選

          @JoinColumn@Column類似,介量描述的不是一個簡單字段,而一一個關聯(lián)字段,例如.描述一個@ManyToOne的字段.

          name:該字段的名稱.由于@JoinColumn描述的是一個關聯(lián)字段,ManyToOne,則默認的名稱由其關聯(lián)的實體決定.

          例如,實體Order有一個user屬性來關聯(lián)實體User,Orderuser屬性為一個外鍵,

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

          示例:

              @ManyToOne

           

          10@OneToMany(fetch=FetchType,cascade=CascadeType)

          可選

          @OneToMany描述一個一對多的關聯(lián),該屬性應該為集體類型,在數(shù)據(jù)庫中并沒有實際字段.

          fetch:表示抓取策略,默認為FetchType.LAZY,因為關聯(lián)的多個對象通常不必從數(shù)據(jù)庫預先讀取到內存

          cascade:表示級聯(lián)操作策略,對于OneToMany類型的關聯(lián)非常重要,通常該實體更新或刪除時,其關聯(lián)的實體也應當被更新或刪除

          例如:實體UserOrderOneToMany的關系,則實體User被刪除時,其關聯(lián)的實體Order也應該被全部刪除

          示例:

              @OneTyMany(cascade=ALL)

              public List getOrders() {

                 return orders;

              }

           

          11@OneToOne(fetch=FetchType,cascade=CascadeType)

          可選

          @OneToOne描述一個一對一的關聯(lián)

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

          cascade:表示級聯(lián)操作策略

          示例:

              @OneToOne(fetch=FetchType.LAZY)

              public Blog getBlog() {

                 return blog;

              }

           

          12@ManyToMany

          可選

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

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

          mappedBy:表示多對多關聯(lián)的另一個實體類的對應集合屬性名稱

          示例:

              User實體表示用戶,Book實體表示書籍,為了描述用戶收藏的書籍,可以在UserBook之間建立ManyToMany關聯(lián)

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

                 }

              }

          兩個實體間相互關聯(lián)的屬性必須標記為@ManyToMany,并相互指定targetEntity屬性,

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

          利用ORM工具自動生成的表除了UserBook表外,還自動生成了一個User_Book,用于實現(xiàn)多對多關聯(lián)

           

          13@MappedSuperclass

          可選

          @MappedSuperclass可以將超類的JPA注解傳遞給子類,使子類能夠繼承超類的JPA注解

          示例:

              @MappedSuperclass

              public class Employee() {

                 ....

              }

             

              @Entity

              public class Engineer extends Employee {

                 .....

              }

              @Entity

              public class Manager extends Employee {

                 .....

              }

           

          14@Embedded

          可選

          @Embedded將幾個字段組合成一個類,并作為整個Entity的一個屬性.

          例如User包括id,name,city,street,zip屬性.

          我們希望city,street,zip屬性映射為Address對象.這樣,User對象將具有id,nameaddress這三個屬性.

          Address對象必須定義為@Embededable

          示例:

              @Embeddable

              public class Address {city,street,zip}

              @Entity

              public class User {

                 @Embedded

                 public Address getAddress() {

                     ..........

                 }

              }

           

          Hibernate驗證注解

          注解

           適用類型

           說明

           示例

           

          @Pattern

           String

           通過正則表達式來驗證字符串

           @attern(regex=”[a-z]{6}”)

           

          @Length

           String

           驗證字符串的長度

           @length(min=3,max=20)

           

          @Email

           String

           驗證一個Email地址是否有效

           @email

           

          @Range

           Long

           驗證一個整型是否在有效的范圍內

           @Range(min=0,max=100)

           

          @Min

           Long

           驗證一個整型必須不小于指定值

           @Min(value=10)

           

          @Max

           Long

           驗證一個整型必須不大于指定值

           @Max(value=20)

           

          @Size

           集合或數(shù)組

           集合或數(shù)組的大小是否在指定范圍內

           @Size(min=1,max=255)

           

          以上每個注解都可能性有一個message屬性,用于在驗證失敗后向用戶返回的消息,還可以三個屬性上使用多個注解

          posted on 2010-07-20 10:13 雪山飛鵠 閱讀(18102) 評論(2)  編輯  收藏 所屬分類: Hibernate

          Feedback

          # re: JPA注解 2010-07-30 14:23 紅黑騎士
          Very Good, 收藏先  回復  更多評論
            

          # re: JPA注解[未登錄] 2014-01-03 16:06 seal
          第二個示例中,應該是GenerationType  回復  更多評論
            

          主站蜘蛛池模板: 花莲县| 疏勒县| 秦安县| 宁陕县| 翼城县| 沂水县| 土默特右旗| 鲁甸县| 和林格尔县| 濮阳县| 楚雄市| 和平区| 晋州市| 蕉岭县| 河源市| 宜兰县| 溧阳市| 湖州市| 宜君县| 道真| 丰都县| 柯坪县| 遵化市| 游戏| 科技| 新化县| 韶关市| 连云港市| 信丰县| 灵石县| 康定县| 高安市| 乐昌市| 西安市| 广德县| 巴东县| 清苑县| 鹰潭市| 崇左市| 博兴县| 同江市|