JPA註解介紹

原文章地址：http://blog.csdn.net/wanghuan203/article/details/8698102

JPA全稱Java Persistence API.JPA經過JDK 5.0註解或XML描述對象－關係表的映射關係，並將運行期的實體對象持久化到數據庫中。
        JPA由EJB 3.0軟件專家組開發，做爲JSR-220實現的一部分。但它不囿於EJB 3.0，你能夠在Web應用、甚至桌面應用中使用。JPA的宗旨是爲POJO提供持久化標準規範.
        JPA的整體思想和現有Hibernate、TopLink，JDO等ORM框架大致一致。總的來講，JPA包括如下3方面的技術：
        (1)ORM映射元數據
        JPA支持XML和JDK 5.0註解兩種元數據的形式，元數據描述對象和表之間的映射關係，框架據此將實體對象持久化到數據庫表中；
        (2)JPA 的API
        用來操做實體對象，執行CRUD操做，框架在後臺替咱們完成全部的事情，開發者從繁瑣的JDBC和SQL代碼中解脫出來。
        (3)查詢語言
        這是持久化操做中很重要的一個方面，經過面向對象而非面向數據庫的查詢語言查詢數據，避免程序的SQL語句緊密耦合。

        下面前後現看第一條"ORM映射元數據",總結一下JPA中經常使用的註解標籤. 
  
1.設置Pojo爲實體    
@Entity //標識這個pojo是一個jpa實體       
public class Users implements Serializable {       
}      
  
  
2.設置表名    
@Entity       
@Table(name = "users") //指定表名爲users       
public class Users implements Serializable {       
}      
  
  
3.設置主鍵   
public class Users implements Serializable {       
@Id       
private String userCode;      
  
  
4. 設置字段類型  
經過@Column註解設置，包含的可設置屬性以下  
    .name：字段名  
.unique：是否惟一  
.nullable：是否能夠爲空  
.inserttable：是否能夠插入  
.updateable：是否能夠更新  
.columnDefinition: 定義建表時建立此列的DDL  
.secondaryTable: 從表名。若是此列不建在主表上（默認建在主表），該屬性定義該列所在從表的名字。  
  
  
@Column(name = "user_code", nullable = false, length=32)//設置屬性userCode對應的字段爲user_code，長度爲32，非空       
private String userCode;       
@Column(name = "user_wages", nullable = true, precision=12, scale=2)//設置屬性wages對應的字段爲user_wages，12位數字可保留兩位小數，能夠爲空       
private double wages;       
@Temporal(TemporalType.DATE)//設置爲時間類型       
private Date joinDate;       
  
  
5.字段排序  
在加載數據的時候能夠爲其指定順序，使用@OrderBy註解實現    
@Table(name = "USERS")       
public class User {       
@OrderBy(name = "group_name ASC, name DESC")       
private List books = new ArrayList();       
}      
  
  
6.主鍵生成策略

       (1)identity主鍵自增,這種方式依賴於具體的數據庫，若是數據庫不支持自增主鍵，那麼這個類型是無法用的        

public class Users implements Serializable {       

@Id       
@GeneratedValue(strategy=GenerationType.IDENTITY) 
@Column(name = "user_id", nullable = false)       
private int userId;            
     

      (2)藉助一個表來實現主鍵自增, 經過一個表來實現主鍵id的自增，這種方式不依賴於具體的數據庫，能夠解決數據遷移的問題 

public class Users implements Serializable {       

@Id       
@GeneratedValue(strategy=GenerationType.TABLE)      
@Column(name = "user_code", nullable = false)       
private String userCode;          

     

     (3)sequence主鍵自增,經過Sequence來實現表主鍵自增，這種方式依賴於數據庫是否有SEQUENCE，若是沒有就不能用       

public class Users implements Serializable {       
@Id       
@GeneratedValue(strategy=GenerationType.SEQUENCE)
@SequenceGenerator(name="seq_user")       
@Column(name = "user_id", nullable = false)       
private int userId;      

       

      此外,一些實現了JPA規範的ORM映射框架,還提供了本身支持的主鍵生成策略,好比使用Hibernate-Annotation來實現持久化映射,就可使用Hibernate提供的UUID主鍵生成策略.

  
  
7.一對多雙向映射關係  
有T_One和T_Many兩個表，他們是一對多的關係，註解範例以下  

 

主Pojo    

@Entity       
@Table(name = "T_ONE")       
public class One implements Serializable {       
private static final long serialVersionUID = 1L;       
@Id       
@Column(name = "ONE_ID", nullable = false)       
private String oneId;       
@Column(name = "DESCRIPTION")       
private String description;       
@OneToMany(cascade = CascadeType.ALL, mappedBy = "oneId")//指向多的那方的pojo的關聯外鍵字段  對應的另外一個類的屬性名稱     
private Collection<Many> manyCollection;       
  
  
子Pojo    
@Entity       
@Table(name = "T_MANY")       
public class Many implements Serializable {       
private static final long serialVersionUID = 1L;       
@Id       
@Column(name = "MANY_ID", nullable = false)       
private String manyId;       
@Column(name = "DESCRIPTION")       
private String description;       
     
@JoinColumn(name = "ONE_ID", referencedColumnName = "ONE_ID")//設置對應數據表的列名和引用的數據表的列名       
@ManyToOne//設置在「一方」pojo的外鍵字段上       
private One oneId;       
  
說明:

   一對多雙向關聯跟多對一是同樣的,在多端生成一個外鍵,不生成第三張表來管理對應關係,由外鍵來管理對應關係 

  
8.多對多映射關係  
貌似多對多關係不須要設置級聯，之前用hibernate的時候着實爲多對多的級聯頭疼了一陣子，JPA的多對多還須要實際的嘗試一下才能有所體會。  
估計JPA的多對多也是能夠轉換成兩個一對多的。  
  
第一個Pojo    
@Entity       
@Table(name = "T_MANYA")       
public class ManyA implements Serializable {       
private static final long serialVersionUID = 1L;       
@Id       
@Column(name = "MANYA_ID", nullable = false)       
private String manyaId;       
@Column(name = "DESCRIPTION")       
private String description;       
@ManyToMany       
@JoinTable(name = "TMANY1_TMANY2", joinColumns = {@JoinColumn(name = "MANYA_ID", referencedColumnName = "MANYA_ID")}  
private Collection<ManyB> manybIdCollection;       
  
  
第二個Pojo    
@Entity       
@Table(name = "T_MANYB")       
public class ManyB implements Serializable {       
private static final long serialVersionUID = 1L;       
@Id       
@Column(name = "MANYB_ID", nullable = false)       
private String manybId;       
@Column(name = "DESCRIPTION")       
private String description;       
@ManyToMany(mappedBy = "manybIdCollection")       
private Collection<ManyA> manyaIdCollection;       
  
  
  

9.一對一外鍵映射關係  

 

主Pojo    
@Entity       
@Table(name = "T_ONEA")       
public class OneA implements Serializable {       
private static final long serialVersionUID = 1L;       
@Id       
@Column(name = "ONEA_ID", nullable = false)       
private String oneaId;       
@Column(name = "DESCRIPTION")       
private String description;       
@OneToOne(cascade = CascadeType.ALL, mappedBy = "oneA")//主Pojo這方的設置比較簡單，只要設置好級聯和映射到從Pojo的外鍵就能夠了。       
private OneB oneB;      

 

從Pojo  
@Entity       
@Table(name = "T_ONEB")       
public class OneB implements Serializable {       
private static final long serialVersionUID = 1L;       
@Id       
@Column(name = "ONEA_ID", nullable = false)       
private String oneaId;       
@Column(name = "DESCRIPTION")       
private String description;       
@JoinColumn(name = "ONEA_ID", unique=ture referencedColumnName = "ONEA_ID", insertable = false)//設置從方指向主方的關聯外鍵，這個ONEA_ID

實際上是表T_ONEA的主鍵       
@OneToOne       
private OneA oneA;       
  
  
  
10 大字段    
@Lob //對應Blob字段類型       
@Column(name = "PHOTO")       
private Serializable photo;       
@Lob //對應Clob字段類型       
@Column(name = "DESCRIPTION")       
private String description;      
  
  
  
11.瞬時字段  :不須要與數據庫映射的字段，在保存的時候不須要保存倒數據庫  
  
  
@Transient       
private int tempValue;       
     
public int getTempValue(){       
get tempValue;       
}       
     
public void setTempValue(int value){       
this.tempValue = value;       

}      

 

12.類的繼承映射 

 

 

JPA對於具備父子關係的類，對於父類必須聲明繼承實體的映射策略，對於繼承實體，java.persistence.InheritanceType定義了3種映射策略(跟Hibernate類繼承的映射原理相同)：

SINGLE_TABLE：父子類都保存在同一個表中，經過字段值進行區分。此方法推薦使用

JOINED：父子類相同的部分保存在同一個表中，不一樣的部門分開存放，經過鏈接不一樣的表獲取完整數據。

TABLE_PER_CLASS：每個類對應本身的表，通常不推薦採用這種方式。