Spring Data JPA注解Entity使用示例详解
1、JPA协议中关于Entity的相关规定
(1)实体是直接进行数据库持久化操作的领域对象(即一个简单的POJO),必须通过@Entity注解进行标示。
(2)实体必须有一个 public 或者 projected的无参数构造方法.
(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 '数量'") 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的实体里面被注解标注的字段,都会被映射到数据库中,除了使用@Transient注解的字段之外。
- 实体里面必须有一个主键。主键表示的字段可以是单个字段,也可以是复合主键字段。
2、常用注解
2.1 JPA支持的注解
2.2 常用注解
@Entity必填项。用于定义对象将会成为被JPA管理的实体,将字段映射到指定的数据库表中,使用起来很简单,直接用在实体类上面即可。
@Target(TYPE) // 表示此注解只能用在class上面 @Retention(RUNTIME) public @interface Entity { // 默认是实体类的名字 String name() default ""; }
@Table非必填项。 用于指定数据库的表名,表示此实体对应的数据库里面的表名。 默认表名和entity名字一样
@Target(TYPE) // 表示此注解只能用在class上面 @Retention(RUNTIME) public @interface Table { // 表的名字,默认表名和entity名字一样 String name() default ""; // 表的目录 String catalog() default ""; // 此表所在schema String schema() default ""; // 唯一性约束,在创建表的时候有用,表创建好之后后面就不需要了 UniqueConstraint[] uniqueConstraints() default {}; // 索引,在创建表的时候使用,表创建之后后面就不需要了 Index[] indexes() default {}; }
// 单一字段唯一性约束 uniqueConstraints = {@UniqueConstraint(name = "unique_age",columnNames = "age")} // 联合约束 uniqueConstraints = {@UniqueConstraint(name = "unique_name",columnNames = {"name","age"})} // 索引 indexes = {@Index(name = "nameIndex",columnList = "name")})
@Access非必填项。 用于指定entity里面的注解是写在字段上面,还是get/set方法上面生效。如果默认不填写的情况下,当实体里面的第一个注解出现在字段上或者 get/set方法上面,就以第一次出现的方式为准。
@Target( { TYPE, METHOD, FIELD }) // 表示此注解可以运用在类上(可以指定实体的默认注解生成策略),也可以用在方法上或字段上(表示可以独立设置某一个字段或者方法的生效策略) @Retention(RUNTIME) public @interface Access { AccessType value(); } public enum AccessType { FIELD, PROPERTY } @Access(value = AccessType.FIELD)
@Id定义属性为数据库的主键,一个实体里面必须有一个主键,但不一定是这个注解。可以和@GeneratedValue配合使用或成对出现。
@GeneratedValue主键生成策略,如下所示:
public @interface GeneratedValue { // Id的生成策略 GenerationType strategy() default AUTO; // 通过Sequences生成Id,常见的是Oracle数据库ID生成规则,这个时候需要配合@SequenceGenerator使用 String generator() default ""; } // 生成策略 public enum GenerationType { // 通过表产生主键,框架借由表模拟序列产生主键,使用该策略可以使应用更易于数据库移植 TABLE, // 通过序列产生主键,通过@SequenceGenerator 注解指定序列名,MySql不支持这种方式 SEQUENCE, // 采用数据库Id自增长,一般用于Mysql数据库 IDENTITY, // 自动选择合适的策略,是默认选项; AUTO }
@Enumerated对Enum枚举类映射到数据库提供下标和name两种方式,用法就是直接映射在enum枚举类型的字段上。
@Target({METHOD, FIELD}) @Retention(RUNTIME) public @interface Enumerated { EnumType value() default ORDINAL; } public enum EnumType { // 映射枚举字段的下标 ORDINAL, // 映射枚举的Name STRING }
@Basic表示属性是到数据表字段的映射。如果实体的字段上没有任何注解,默认即为@Basic。也就是说默认所有的字段肯定是和数据库进行映射的,并且默认为Eager类型。
public @interface Basic { // EAGER 立即记载;LAZY 延迟加载; FetchType fetch() default EAGER; // 这个字段是否可以为null,默认是true boolean optional() default true; }
@Transient表示非持久化属性。 JPA映射数据库的时候忽略它,与@Basic有相反的作用。
@Column 定义该属性对应数据库中的
public @interface Column { // 定义了被标注字段在数据库表中所对应字段的名称; String name() default ""; // 表示该字段是否为唯一标识 boolean unique() default false; // 数据字段是否允许为空,默认为空 boolean nullable() default true; // 表示在使用“INSERT”脚本插入数据时,是否需要插入该字段的值。 boolean insertable() default true; // 表示在使用“UPDATE”脚本插入数据时,是否需要更新该字段的值 boolean updatable() default true; // 表示创建表时,该字段创建的SQL语句,一般用于通过Entity生成表定义时使用 String columnDefinition() default ""; // 表示当映射多个表时,指定表的表中的字段。默认值为主表的表名。 String table() default ""; // 表示字段的长度,当字段的类型为varchar时,该属性才有效,默认为255个字符。 int length() default 255; // 表示数值的总长度 int precision() default 0; // 表示小数点所占的位数,必须和precision搭配使用 int scale() default 0; }
3、联合主键
3.1 @IdClass
第一步:新建一个UserInfo类里面的属性是联合主键
@Data @Builder @AllArgsConstructor @NoArgsConstructor public class UserInfoID implements Serializable { private String name; private String telephone; }
第二步 :再新建一个UserInfo的实体,采用@IdClass引用联合主键类
@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()); }
通过上面例子我们可以发现,我们的表的主键是primary key(name,telephone),而Entity里面不再是一个@Id字段。
执行的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()); }
执行的SQL如下所示:
3.3 两者的区别是什么?
- @Embedded用的是对象,@IdClass用的具体的某一个字段
以上就是Spring Data JPA注解Entity使用示例详解的详细内容,更多关于Spring Data JPA注解Entity的资料请关注猪先飞其它相关文章!
原文出处:https://juejin.cn/post/7143048935739752484
相关文章
Spring Data JPA 关键字Exists的用法说明
这篇文章主要介绍了Spring Data JPA 关键字Exists的用法说明,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-06-10JPA如何使用nativequery多表关联查询返回自定义实体类
这篇文章主要介绍了JPA如何使用nativequery多表关联查询返回自定义实体类,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-11-18- 这篇文章主要介绍了Spring JPA配置文件Eclipse报错如何解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-10-21
springdata jpa使用Example快速实现动态查询功能
这篇文章主要介绍了springdata jpa使用Example快速实现动态查询功能,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-11-18解决Spring Data Jpa 实体类自动创建数据库表失败问题
这篇文章主要介绍了解决Spring Data Jpa 实体类自动创建数据库表失败问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-12- 这篇文章主要介绍了SpringBoot2 Jpa 批量删除功能的实现,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-01-29
- 这篇文章主要介绍了JPA使用乐观锁应对高并发方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-10-15
SpringCloud的JPA连接PostgreSql的教程
这篇文章主要介绍了SpringCloud的JPA接入PostgreSql 教程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-06-26Springboot使用Spring Data JPA实现数据库操作
Spring Data JPA 是 Spring 基于 Spring Data 框架、在JPA 规范的基础上开发的一个框架,使用 Spring Data JPA 可以极大地简化JPA 的写法,本章我们将详细介绍在Springboot中使用 Spring Data JPA 来实现对数据库的操作...2021-06-30- 这篇文章主要介绍了解决JPA @OneToMany及懒加载无效的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-10-15
解决Spring JPA 使用@transaction注解时产生CGLIB代理冲突问题
这篇文章主要介绍了解决Spring JPA 使用@transaction注解时产生CGLIB代理冲突问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-08-05Spring Boot JPA Repository之existsBy查询方法失效的解决
这篇文章主要介绍了Spring Boot JPA Repository之existsBy查询方法失效的解决方法,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-06-10聊聊Spring data jpa @query使用原生SQl,需要注意的坑
这篇文章主要介绍了Spring data jpa@query使用原生SQl,需要注意的坑,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-08-27Spring Security+Spring Data Jpa如何进行安全管理
这篇文章主要介绍了Spring Security+Spring Data Jpa如何进行安全管理,帮助大家更好的理解和学习Spring Security框架,感兴趣的朋友可以了解下...2020-09-03- 这篇文章主要介绍了SpringBoot2 JPA解决懒加载异常的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-01-29
- 最近在项目中使用了一下jpa,发现还是挺好用的。这里就来讲一下jpa以及在spring boot中的使用。在这里我们先来了解一下jpa,希望能给你带来帮助...2021-08-11
- 这篇文章主要介绍了JPA findById方法和getOne方法的区别,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教。...2021-08-14
Jpa 如何使用@EntityListeners 实现实体对象的自动赋值
这篇文章主要介绍了Jpa 如何使用@EntityListeners 实现实体对象的自动赋值,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-08-03- 这篇文章主要介绍了Java之jpa入门教程讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下...2021-08-11
- 这篇文章主要介绍了解决springjpa的局部更新字段问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-01-29