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：每一個類對應自己的表，一般不推薦采用這種方式。