1. 程式人生 > >JPA常用註解

JPA常用註解

jdb 一對一 lec imp 標準規範 分開 ejb asc rec

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. 設置字段類型

[email protected],包含的可設置屬性如下
.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.字段排序

在加載數據的時候可以為其指定順序,[email protected]
@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 = [email protected](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:每一個類對應自己的表,一般不推薦采用這種方式。

JPA常用註解