详解SpringBoot JPA常用注解的使用方法

1. 简介
2. 常用注解
2.1 @Entity
2.2 @Table
2.3 @Id 、@GeneratedValue、@SequenceGenerator、@Column
2.3.1 @Id
2.3.2 @GeneratedValue
2.3.3 @SequenceGenerator
2.3.4 @Column
2.4 @Transient
2.5 @Temproal
3. EntityManagerFactory
4. EntityManager 实体的四种状态
4.1 find(Class entityClass, Object primaryKey)
4.2 getReference(Class entityClass, Object primaryKey)
4.3 persist
4.4 remove
4.5 merge(T entity)
4.6 flush()
4.6 refresh()
5. EntityTransaction
5.1 begin
5.2 commit
5.3 rollback
6. 映射关系
6.1 单向一对多
6.2 单向多对一
6.3 双向多对一
6.4 双向一对一
6.5 双向多对多
7. 二级缓存
8. JPQL
8.1 查询接口
8.1.1 createQuery
8.1.2 createNamedQuery
8.1.3 createNativeQuery
8.2 关联查询

1. 简介

Jpa 是一套ORM 的规范

hibernate 不就是一个 ORM 框架也提供了对于 JPA 的实现

JPA（Java Persistence API）：java 持久化 API

2. 常用注解

2.1 @Entity

标注当前类为实体类，将映射到指定的数据库表中

@Entity
public class Users {
		
}

2.2 @Table

一般与 @Entity 注解一起使用，如果数据库表名和类名一致时不使用 @Table 注解也是可以的,

否则需要使用 @Table 注解来指定表名

@Entity
@Table(name="t_users")
public class Users {
		
}

2.3 @Id 、@GeneratedValue、@SequenceGenerator、@Column

2.3.1 @Id

用于将实体类的属性映射为主键

2.3.2 @GeneratedValue

指定主键生成策略

package javax.persistence;
/**
 * 策略类型
 */
public enum GenerationType {
  /**
   * 通过表产生主键，框架借由表模拟序列产生主键，使用该策略可以使应用更易于数据库移植
   */
  TABLE,
  /**
   * 通过序列产生主键，通过 @SequenceGenerator 注解指定序列名
   * MySql 不支持这种方式
   * Oracle 支持
   */
  SEQUENCE,
  /**
   * 采用数据库 ID自增长的方式来自增主键字段
   * Oracle 不支持这种方式；
   */
  IDENTITY,
  /**
   * 缺省值，JPA 根据数据库自动选择
   */
  AUTO;

  private GenerationType() {
  }
}

2.3.3 @SequenceGenerator

2.3.4 @Column

当实体类属性名和数据库列名不一致时必须要使用此注解

@Entity
@Table(name="t_users")
public class Users {

  @Id
  @Column(name = "user_id")
  @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_seq")
  @SequenceGenerator(name = "user_seq", sequenceName = "user_seq")
  private Long userId;
		
}

2.4 @Transient

表示当前属性无需映射到数据库中

2.5 @Temproal

主要针对 Date 类型的属性使用，可以通过该注解指定时间的精度

@Entity
@Table(name="t_users")
public class Users {

  @Temporal(TemporalType.DATE) 
  private Date time;
  
  @Temporal(TemporalType.TIME)
  private Date time;
  
  @Temporal(TemporalType.TIMESTAMP)
  private Date time;
}

3. EntityManagerFactory

类似与 hibernate 的 SessionFactory

4. EntityManager 实体的四种状态

新建状态： 新创建还未拥有持久性主键持久化状态： 已经拥有持久性主键并和持久化建立了上下文关系游离状态： 拥有持久性主键，但没有和持久化建立上下文关系删除状态： 拥有持久性主键，并且和持久化建立了上下文关系，但是从数据库中删除了

4.1 find(Class entityClass, Object primaryKey)

类似于 hibernate 中 session 的 get()

find 如果没有查询到会返回 null

4.2 getReference(Class entityClass, Object primaryKey)

类似与 hibernate 中 session 的 load()

只有当真正获取对象中的属性时，才会去执行查询的 sql 语句，getReference() 只是返回了一个代理对象

getReference 如果没有查询到不会返回 null , 会抛出 EntityNotFoundException

注意：使用此方法可能出现懒加载异常的情况，也就是我们还没有去获取实体类中的属性值，结果 EntityManager 就已经被关闭了

4.3 persist

类似与 hibernate 中 session 的 save()

注意：执行方法时传入的对象不能为主键设置值会抛出异常

4.4 remove

类似与 hibernate 中 session 的 delete()

注意：该方法只能删除持久化对象，而不能删除游离状态的对象（hibernate 可以）

	/**
	 * 删除游离态（失败）
	 */
	public void testRemove(){
		Users user = new Users();
		Users.setUserId();
		entityManager.remove(customer);
	}
	
	/**
	 * 删除持久化状态（成功）
	 */
	public void testRemove(){
		Users user = entityManager.find(Users.class,);
		entityManager.remove(user);
	}

4.5 merge(T entity)

类似与 hibernate 中 session 的 saveOrUpdate()

	// 新建状态
	public void testMerge	(){
		Users user= new Users();
		// 省略一系列的set
		// user.set.....
		Users newUser = entityManager.merge(user);
		// user.getUserId() == null  ==> true
		// newUser.getUserId() == null ==> false
	}

在这里插入图片描述

4.6 flush()

类似与 hibernate 中 session 的 flush()

将上下文中所有未保存的实体保存到数据库中

4.6 refresh()

类似与 hibernate 中 session 的 refresh()

刷新所有实体的属性值

5. EntityTransaction

EntityManager.getTransaction()

5.1 begin

5.2 commit

5.3 rollback

6. 映射关系

6.1 单向一对多

以用户和订单之间的关系为例，一个用户有多个订单，一个订单只属于一个用户

对于一对多关系的 insert，无论是先插入多的一方还是一的一方都会产生额外的 update 语句，因为多的一端在 insert 时不会插入外键的列

/**
 * 订单和用户是多对一的关系
 */
@Entity
@Table(name="t_order")
public class Order {
	// lazy为懒加载，默认为eager立即查询
	@ManyToOne(fetch=FetchType.Lazy)
	// @JoinColumn标注字段是一个类，userId为该类的主键
	@JoinColumn(name="user_id")
	private Users user;
}

6.2 单向多对一

以用户和订单之间的关系为例，一个用户有多个订单，一个订单只属于一个用户

对于多对一关系的 insert，最好先保存一的一端然后在保存多的一端。

如果先保存多的一端再保存一的一端，为了维护外键的关系，需要对多的一端进行额外的update的操作

/**
 * 订单和用户是多对一的关系
 */
@Entity
@Table(name="t_order")
public class Order {
	// lazy为懒加载，默认为eager立即查询
	@ManyToOne(fetch=FetchType.Lazy)
	// @JoinColumn标注字段是一个类，userId为该类的主键
	@JoinColumn(name="user_id")
	private Users user;
}

6.3 双向多对一

以用户和订单之间的关系为例，一个用户有多个订单，一个订单只属于一个用户

双向多对一就是以上两个的结合，同时使用 @OneToMany 和 @ManyToOne

/**
 * 用户和订单是一对多的关系
 */
@Entity
@Table(name="t_users")
public class User {
	// 如果两侧都要描述关联关系的话，维护关联关系的任务要交给多的一方
	// 使用 @OneToMany 了 mappedBy 的代表不维护关联关系，也就是不会产生额外的update语句
	// @OneToMany 和 @JoinColumn 不能同时使用会报错
	@OneToMany(mappedBy="user")
	private Set<Orders> orders;
}

/**
 * 订单和用户是多对一的关系
 */
@Entity
@Table(name="t_orders")
public class Order {
	// lazy为懒加载，默认为eager立即查询
	@ManyToOne(fetch=FetchType.Lazy)
	// @JoinColumn标注字段是一个类，userId为该类的主键
	@JoinColumn(name="user_id")
	private Users user;
}

在这里插入图片描述

6.4 双向一对一

以学校和校长之间的关系为例，一个学校只有一个校长，一个校长也只属于一个学校

一方使用 @OneToMany + @JoinColumn，另一方使用 @OneToOne(mappedBy=“xx”)

具体由哪一方维护关联关系都可以，这里我们以学校一端维护关联关系为例

保存时先保存不维护关联关系的一方（也就是使用@OneToOne(mappedBy=“xx”)的一方），否则会产生额外的 update 语句

/**
 * 学校
 */
@Entity
@Table(name="t_school")
public class School {
	// 默认为eager立即查询
	@OneToOne
	// 添加唯一约束
	@JoinColumn(name="school_master_id", unique = true)
	private SchoolMaster schoolMaster;
}

/**
 * 校长
 */
@Entity
@Table(name="t_school_master")
public class SchoolMaster {
	// 不维护关联关系要使用 mappedBy
	@OneToOne(mappedBy="schoolMaster")
	private School school;
}

6.5 双向多对多

以学生和课程之间的关系为例，一个学生可以选多门课，一个课程也有多个学生，多对多需要一个中间表，也就是选课表

维护关联关系的一方需要使用 @JoinTable

关联关系也是只有一方维护即可，这里我们由学生表进行维护

/**
 * 学生
 */
@Entity
@Table(name="t_student")
public class Student {
	@GeneratedValue
	@Id
	private Long student_id;
	
	// 要使用 set 集合接收
	// 默认为lazy懒加载
	@ManyToMany
	// name 为中间表的表名
	@JoinTable(name="t_student_choose_course",
			// name 为与中间表与当前表所关联的字段的名称，referencedColumnName 为当前表中与中间表关联的字段的名称
			joinColumns={@JoinColumn(name="student_id", referencedColumnName="student_id")},
			// name 为与中间表与多对多另一方表所关联的字段的名称，referencedColumnName 为多对多另一方与中间表关联的字段的名称
			inverseJoinColumns={@JoinColumn(name="course_id", referencedColumnName="course_id")})
	private Set<Course> courses;
}

/**
 * 课程
 */
@Entity
@Table(name="t_course")
public class Course {
	@GeneratedValue
	@Id
	private Long course_id;
	
	// 要使用 set 集合接收
	// 默认为lazy懒加载
	@ManyToMany(mappedBy="courses")
	private Set<Student> students;
}

7. 二级缓存

开启了二级缓存之后，缓存是可以跨越 EntityManager 的，

默认是一级缓存也就是在一个 EntityManager 中是有缓存的

二级缓存可以实现，关闭了 EntityManager 之后缓存不会被清除

使用 @Cacheable(true) 开启二级缓存

8. JPQL

8.1 查询接口

8.1.1 createQuery

	public void testCreateQuery(){
		// 这里我们使用了一个 new Student，因为我们是查询 Student 中的部分属性，如果不适用 new Student 查询返回的结果就不是 Student 类型而是一个 Object[] 类型的 List
		// 也可以在实体类中创建对应的构造器，然后使用如下这种 new Student 的方式，来把返回结果封装为Student 对象
		String jpql = "SELECT new Student(s.name, s.age) FROM t_student s WHERE s.student_id > ?";
		// setParameter 时下标是从开始的
		List result = entityManager.createQuery(jpql).setParameter(, 1).getResultList();
	}

8.1.2 createNamedQuery

需要在类上使用 @NamedQuery 注解，事先声明 sql 语句

@NamedQuery(name="testNamedQuery", query="select * from t_student WHERE student_id = ?")
@Entity
@Table(name="t_student")
public class Student {
	@GeneratedValue
	@Id
	private Long student_id;
	
	@Column
	private String name;
	
	@Column
	private int age;
}
	public void testCreateNamedQuery(){
		Query query = entityManager.createNamedQuery("testNamedQuery").setParameter(, 3);
		Student student = (Student) query.getSingleResult();
	}

8.1.3 createNativeQuery

	public void testCreateNativeQuery(){
		// 本地sql的意思是只能在数据库中执行的sql语句
		String sql = "SELECT age FROM t_student WHERE student_id = ?";
		Query query = entityManager.createNativeQuery(sql).setParameter(, 18);
		Object result = query.getSingleResult();
	}

8.2 关联查询

存在一对多关系时，当我们查询一的一端时，默认多的一端是懒加载。此时我们如果想要一次性查询出所有的数据就需要使用关联查询

注意：下面 sql 中的重点就是要加上 fetch u.orders，表示要查询出用户所关联的所有订单

	public void testLeftOuterJoinFetch(){
		String jpql = "FROM t_users u LEFT OUTER JOIN FETCH u.orders WHERE u.id = ?";
		
		Users user = (Users) entityManager.createQuery(jpql).setParameter(, 123).getSingleResult();
	}

详解SpringBoot JPA常用注解的使用方法

目录

1. 简介

2. 常用注解

2.1 @Entity

2.2 @Table

2.3 @Id 、@GeneratedValue、@SequenceGenerator、@Column

2.3.1 @Id

2.3.2 @GeneratedValue

2.3.3 @SequenceGenerator

2.3.4 @Column

2.4 @Transient

2.5 @Temproal

3. EntityManagerFactory

4. EntityManager 实体的四种状态

4.1 find(Class entityClass, Object primaryKey)

4.2 getReference(Class entityClass, Object primaryKey)

4.3 persist

4.4 remove

4.5 merge(T entity)

4.6 flush()

4.6 refresh()

5. EntityTransaction

5.1 begin

5.2 commit

5.3 rollback

6. 映射关系

6.1 单向一对多

6.2 单向多对一

6.3 双向多对一

6.4 双向一对一

6.5 双向多对多

7. 二级缓存

8. JPQL

8.1 查询接口

8.1.1 createQuery

8.1.2 createNamedQuery

8.1.3 createNativeQuery

8.2 关联查询