Spring?Data?JPA注解Entity使用示例詳解
1、JPA協(xié)議中關于Entity的相關規(guī)定
(1)實體是直接進行數(shù)據(jù)庫持久化操作的領域對象(即一個簡單的POJO),必須通過@Entity注解進行標示。
(2)實體必須有一個 public 或者 projected的無參數(shù)構造方法.
(3)持久化映射的注解可以標示在Entity的字段field上(比較適合使用Lombok的情況),如下所示
@Id @GeneratedValue(strategy = GenerationType.IDENTITY) @Column(columnDefinition = "int(11) NOT NULL COMMENT '主鍵' ") private Integer id; @Column(columnDefinition = "varchar(30) DEFAULT '' COMMENT '書名'") private String bookName; @Column(columnDefinition = "int(11) DEFAULT 0 COMMENT '數(shù)量'") private Integer amount;
除此之外,也可以將持久化注解運用在Entity里面的get/set方法上,通過我們放在get方法中,如下所示:
需要注意的是: 在實體類get方法中加注解時,必須保證set方法的存在,否則會報錯
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@Column(columnDefinition = "int(11) NOT NULL COMMENT '主鍵' ")
public Integer getId() {
return id;
}
@Column(columnDefinition = "varchar(30) DEFAULT '' COMMENT '寵物名'")
public String getName() {
return name;
}
@Column(columnDefinition = "int(11) DEFAULT NULL COMMENT '年齡'")
public Integer getAge() {
return age;
}
需要注意的是:
在同一個Entity里面只能有一種方式生效,也就是說注解要么全部寫在field上面,要么就全部寫在get/set方法上
- 只要是在@Entity的實體里面被注解標注的字段,都會被映射到數(shù)據(jù)庫中,除了使用@Transient注解的字段之外。
- 實體里面必須有一個主鍵。主鍵表示的字段可以是單個字段,也可以是復合主鍵字段。
2、常用注解
2.1 JPA支持的注解

2.2 常用注解
@Entity必填項。用于定義對象將會成為被JPA管理的實體,將字段映射到指定的數(shù)據(jù)庫表中,使用起來很簡單,直接用在實體類上面即可。
@Target(TYPE) // 表示此注解只能用在class上面
@Retention(RUNTIME)
public @interface Entity {
// 默認是實體類的名字
String name() default "";
}
@Table非必填項。 用于指定數(shù)據(jù)庫的表名,表示此實體對應的數(shù)據(jù)庫里面的表名。 默認表名和entity名字一樣
@Target(TYPE) // 表示此注解只能用在class上面
@Retention(RUNTIME)
public @interface Table {
// 表的名字,默認表名和entity名字一樣
String name() default "";
// 表的目錄
String catalog() default "";
// 此表所在schema
String schema() default "";
// 唯一性約束,在創(chuàng)建表的時候有用,表創(chuàng)建好之后后面就不需要了
UniqueConstraint[] uniqueConstraints() default {};
// 索引,在創(chuàng)建表的時候使用,表創(chuàng)建之后后面就不需要了
Index[] indexes() default {};
}
// 單一字段唯一性約束
uniqueConstraints = {@UniqueConstraint(name = "unique_age",columnNames = "age")}
// 聯(lián)合約束
uniqueConstraints = {@UniqueConstraint(name = "unique_name",columnNames = {"name","age"})}
// 索引
indexes = {@Index(name = "nameIndex",columnList = "name")})
@Access非必填項。 用于指定entity里面的注解是寫在字段上面,還是get/set方法上面生效。如果默認不填寫的情況下,當實體里面的第一個注解出現(xiàn)在字段上或者 get/set方法上面,就以第一次出現(xiàn)的方式為準。
@Target( { TYPE, METHOD, FIELD }) // 表示此注解可以運用在類上(可以指定實體的默認注解生成策略),也可以用在方法上或字段上(表示可以獨立設置某一個字段或者方法的生效策略)
@Retention(RUNTIME)
public @interface Access {
AccessType value();
}
public enum AccessType {
FIELD,
PROPERTY
}
@Access(value = AccessType.FIELD)
@Id定義屬性為數(shù)據(jù)庫的主鍵,一個實體里面必須有一個主鍵,但不一定是這個注解??梢院虭GeneratedValue配合使用或成對出現(xiàn)。
@GeneratedValue主鍵生成策略,如下所示:
public @interface GeneratedValue {
// Id的生成策略
GenerationType strategy() default AUTO;
// 通過Sequences生成Id,常見的是Oracle數(shù)據(jù)庫ID生成規(guī)則,這個時候需要配合@SequenceGenerator使用
String generator() default "";
}
// 生成策略
public enum GenerationType {
// 通過表產(chǎn)生主鍵,框架借由表模擬序列產(chǎn)生主鍵,使用該策略可以使應用更易于數(shù)據(jù)庫移植
TABLE,
// 通過序列產(chǎn)生主鍵,通過@SequenceGenerator 注解指定序列名,MySql不支持這種方式
SEQUENCE,
// 采用數(shù)據(jù)庫Id自增長,一般用于Mysql數(shù)據(jù)庫
IDENTITY,
// 自動選擇合適的策略,是默認選項;
AUTO
}
@Enumerated對Enum枚舉類映射到數(shù)據(jù)庫提供下標和name兩種方式,用法就是直接映射在enum枚舉類型的字段上。
@Target({METHOD, FIELD})
@Retention(RUNTIME)
public @interface Enumerated {
EnumType value() default ORDINAL;
}
public enum EnumType {
// 映射枚舉字段的下標
ORDINAL,
// 映射枚舉的Name
STRING
}
@Basic表示屬性是到數(shù)據(jù)表字段的映射。如果實體的字段上沒有任何注解,默認即為@Basic。也就是說默認所有的字段肯定是和數(shù)據(jù)庫進行映射的,并且默認為Eager類型。
public @interface Basic {
// EAGER 立即記載;LAZY 延遲加載;
FetchType fetch() default EAGER;
// 這個字段是否可以為null,默認是true
boolean optional() default true;
}
@Transient表示非持久化屬性。 JPA映射數(shù)據(jù)庫的時候忽略它,與@Basic有相反的作用。
@Column 定義該屬性對應數(shù)據(jù)庫中的
public @interface Column {
// 定義了被標注字段在數(shù)據(jù)庫表中所對應字段的名稱;
String name() default "";
// 表示該字段是否為唯一標識
boolean unique() default false;
// 數(shù)據(jù)字段是否允許為空,默認為空
boolean nullable() default true;
// 表示在使用“INSERT”腳本插入數(shù)據(jù)時,是否需要插入該字段的值。
boolean insertable() default true;
// 表示在使用“UPDATE”腳本插入數(shù)據(jù)時,是否需要更新該字段的值
boolean updatable() default true;
// 表示創(chuàng)建表時,該字段創(chuàng)建的SQL語句,一般用于通過Entity生成表定義時使用
String columnDefinition() default "";
// 表示當映射多個表時,指定表的表中的字段。默認值為主表的表名。
String table() default "";
// 表示字段的長度,當字段的類型為varchar時,該屬性才有效,默認為255個字符。
int length() default 255;
// 表示數(shù)值的總長度
int precision() default 0;
// 表示小數(shù)點所占的位數(shù),必須和precision搭配使用
int scale() default 0;
}
3、聯(lián)合主鍵
3.1 @IdClass
第一步:新建一個UserInfo類里面的屬性是聯(lián)合主鍵
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class UserInfoID implements Serializable {
private String name;
private String telephone;
}
第二步 :再新建一個UserInfo的實體,采用@IdClass引用聯(lián)合主鍵類
@Entity
@Data
@Builder
@IdClass(UserInfoID.class)
@AllArgsConstructor
@NoArgsConstructor
public class UserInfo {
private Integer ages;
@Id
private String name;
@Id
private String telephone;
}
第三步:新增一個UserInfoRepo類來做持久化操作
public interface UserInfoRepo extends JpaRepository<UserInfo, UserInfoID> {
}
第四步:測試用例
@Test
public void queryIndex2(){
userInfoRepo.save(UserInfo.builder()
.ages(1)
.name("jack")
.telephone("123456789").build());
userInfoRepo.findById(UserInfoID.builder()
.name("jack")
.telephone("123456789").build());
}
通過上面例子我們可以發(fā)現(xiàn),我們的表的主鍵是primary key(name,telephone),而Entity里面不再是一個@Id字段。

執(zhí)行的SQL如下:

3.2 @Embeddable與@EmbeddedId注解使用
第一步:在上面例子中的UserInfoID里面添加@Embeddable注解
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
@Embeddable
public class UserInfoID implements Serializable {
private String name;
private String telephone;
}
第二步:在UserInfo類中,刪除@IdClass,添加@EmbeddeId注解,如下:
@Entity
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class UserInfo {
private Integer ages;
@EmbeddedId
private UserInfoID userInfoID;
@Column(unique = true)
private String uniqueNumber;
}
第三步:UserInfoRepo保持不變 第四步:測試用例
@Test
public void queryIndex(){
userInfoRepo.save(UserInfo.builder()
.ages(1)
.userInfoID(UserInfoID.builder()
.name("jack")
.telephone("123456789").build()).build());
userInfoRepo.findById(UserInfoID.builder()
.name("jack")
.telephone("123456789").build());
}
執(zhí)行的SQL如下所示:

3.3 兩者的區(qū)別是什么?
- @Embedded用的是對象,@IdClass用的具體的某一個字段
以上就是Spring Data JPA注解Entity使用示例詳解的詳細內(nèi)容,更多關于Spring Data JPA注解Entity的資料請關注腳本之家其它相關文章!
相關文章
Java 的雙重分發(fā)與 Visitor 模式實例詳解
這篇文章主要介紹了Java 的雙重分發(fā)與 Visitor 模式實例詳解,本文給大家介紹的非常詳細,具有一定的參考借鑒價值,需要的朋友可以參考下2018-07-07
如何利用Java實現(xiàn)MySQL的數(shù)據(jù)變化監(jiān)聽
在高并發(fā)和大數(shù)據(jù)環(huán)境下,實時獲取?MySQL?數(shù)據(jù)庫的增量變化對數(shù)據(jù)同步、數(shù)據(jù)分析、緩存更新等場景至關重要,下面我們就來看看如何通過Java實現(xiàn)MySQL的數(shù)據(jù)變化監(jiān)聽吧2025-02-02
SparkSQL使用IDEA快速入門DataFrame與DataSet的完美教程
本文給大家介紹使用idea開發(fā)Spark SQL 的詳細過程,本文通過實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友參考下吧2021-08-08

