JPA基本註解

 JPA:Java Persistence API.

JPA通過註解或XML的形式來描述對象-關係表的映射關係(ORM),通過服務器部署運行後,將實體對象持久化到數據庫中。(JPA的宗旨是爲POJO提供持久化標準規範)
JPA包括以下3方面的技術:
        (1)ORM映射元數據
        JPA支持XML和JDK 5.0註解兩種元數據的形式,元數據描述對象和表之間的映射關係,框架據此將實體對象持久化到數據庫表中;
        (2)JPA 的API
        用來操作實體對象,執行CRUD操作,框架在後臺替我們完成所有的事情,開發者從繁瑣的JDBC和SQL代碼中解脫出來。
        (3)查詢語言
        這是持久化操作中很重要的一個方面,通過面向對象而非面向數據庫的查詢語言查詢數據,避免程序的SQL語句緊密耦合。
JPA個標籤的含義    

1.基本屬性標籤 
@Entity     //標識這個pojo是一個jpa實體      
@Table(name = "users") //指定表名爲users       
public class Users implements Serializable {   

    @Id       //設置主鍵

    @GeneratedValue(strategy=GenerationType.SEQUENCE)

//主鍵生成策略,自增。這裏的策略依賴於具體的數據庫,不同數據庫生成策略有所不用(IDENTITY或TABLE)

sequence與identity 自動識別數據庫,但是table還要設置其他屬性較麻煩,要藉助一個表來實現主鍵自增, 通過一個表來實現主鍵id的自增,這種方式不依賴於具體的數據庫,可以解決數據遷移的問題。

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

private String userCode;

@Column(nullable = false, name = "USERNAME")   

private StringuserName;

/**通過@Column註解設置,包含的可設置屬性如下  
*name:字段名  
*unique:是否唯一  
*nullable:是否可以爲空  
*inserttable:是否可以插入  

*length : 字段長度
*updateable:是否可以更新  
*columnDefinition: 定義建表時創建此列的DDL  
*secondaryTable: 從表名。如果此列不建在主表上(默認建在主表),該屬性定義該列所在從表的名字。

**/

@Temporal(TemporalTypr.DATE)//設置時間類型

private Date joinDate;   

/**
 * 註解時間類型要用@Temporal,通過設置@Temporal的value來設置註解時間的類型
 * @Temporal的value一共有三種,分別是:
 * TemporalType.DATE map as java.sql.Date    

    *日期型 精確到日  EG:2008-08-08
 * TemporalType.TIME  map as  java.sql.Time  

   * 時間型 精確到秒  EG:20:00:00
 * TemporalType.TIMESTAMP map as java.sql.Timestamp

   * 時間型 精確到納秒 EG:2008-08-08 20:00:00.000000001  
 * 所以根據自己不同的需求來設置TemporalType的值  */

@OrderBy(name = "group_name ASC, name DESC")     //字段排序   
private List books = new ArrayList();

 }        

 2.映射關係標籤

(1)一對多雙向映射關係  
有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;
      
  
說明:

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

  
(2)多對多映射關係  
貌似多對多關係不需要設置級聯,估計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;
      

(3).一對一外鍵映射關係  

(主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;
      
  
 /* cascade屬性
默認值:空 CascadeType 數組。
默認情況下,JPA 不會將任何持續性操作層疊到關聯的目標。
如果希望某些或所有持續性操作層疊到關聯的目標,請將 cascade 設置爲一個或多個 CascadeType 實例,其中包括:
 ALL - 針對擁有實體執行的任何持續性操作均層疊到關聯的目標。
 MERGE - 如果合併了擁有實體,則將 merge 層疊到關聯的目標。
 PERSIST - 如果持久保存擁有實體,則將 persist 層疊到關聯的目標。
 REFRESH - 如果刷新了擁有實體,則 refresh 爲關聯的層疊目標。
 REMOVE - 如果刪除了擁有實體,則還刪除關聯的目標。

fetch屬性
默認值: FetchType.EAGER。
默認情況下,JPA 持續性提供程序使用獲取類型 EAGER:它要求持續性提供程序運行時必須急性獲取數據。
如果這不適合於應用程序或特定的持久字段,請將 fetch 設置爲FetchType.LAZY:它提示持續性提供程序在首次訪問數據(如果可以)時應惰性獲取數據。

mappedBy屬性
默認值:JPA 持續性提供程序從被引用的對象類型推斷出關聯的目標實體
如果持續性提供程序無法推斷關聯的目標實體,則將關聯的相反(非擁有)方上的mappedBy 元素設置爲擁有此關係的字段或屬性的 String 名稱(如 示例 1-64)所示。

optional屬性
默認值: true。
默認情況下,JPA 持續性提供程序假設所有(非基元)字段和屬性的值可以爲空。
如果這並不適合於您的應用程序,請將 optional 設置爲 false。

targetEntity屬性
默認值:JPA 持續性提供程序從被引用的對象類型推斷出關聯的目標實體
如果持續性提供程序無法推斷出目標實體的類型,則將關聯的擁有方上的targetEntity 元素設置爲作爲關係目標的實體的 Class。 */
  
 大字段    
@Lob //對應Blob字段類型  (圖片格式)       
@Lob //對應Clob字段類型    (文本格式)     
瞬時字段  :不需要與數據庫映射的字段,在保存的時候不需要保存倒數據庫  
@Transient       
     

類的繼承映射

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

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

JOINED:父子類相同的部分保存在同一個表中,不同的部門分開存放,通過連接不同的表獲取完整數據。

TABLE_PER_CLASS:每一個類對應自己的表,一般不推薦採用這種方式。


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章