2021-10-10

Spring Data JPA（二）：常用方法和注解

---

前言

前文已经分析了Spring Data JPA的适用性以及操作的便宜性，我们再来分析Spring Data JPA的常用方法和注解。

---

一、Spring Data JPA的常用方法

1.persist()：将临时状态的对象保存进数据库。
这个操作其实就是插入了一条新数据。

entityManager.persist(modelObject);
//由于涉及数据库增删改，执行该语句前需启用事务  

2.merge()：将对象存入数据库。
merger()对于操作的对象，如果对象存在于数据库则对对象进行修改，这不同于persist()用于插入新数据。但是如果对象在数据库中不存在，则将该对象作为一条新记录插入数据库。

entityManager.merge(modelObject);
//由于涉及数据库增删改，执行该语句前需启用事务

3.find()与getReference()：查找对象。不同点：当对象不存在时，find()返回null, getReference()会抛出javax.persistence.EntityNotFoundException异常。

entityManager.find(Class<T> ModelObject.class , int key); 
//参数一是实体类的class,参数二是实体主键对象  

4.remove()：将对象从数据库中删除。

entityManager.remove(entityManager.getReference(ModelObject.class,key));

5.refresh(Object obj)：重新从数据库中读取数据。

6.contains(Object obj)：判断对象是否在数据库中存在，返回true ,false。

7.flush()：立即写入数据库。
执行persist()、merger()时，数据并不是立即写入数据库中，而是由JPA缓存起来，在执行flush()时写入。在事务提交的时候，JPA会自动执行flush()一次性保存所有数据。如果需要立即保存，可手动执行flush()。

8.setFlushModel()：修改EntityManager的Flush模式。
EntityManager的Flush模式默认为FlushModel.AUTO，这种模式下,在执行查询（指使用JPQL语句查询时，不包括find()和getReference()查询）或事务提交时自动执行flush()。通过setFlushModel( FlushModel f )设置为FlushModel.COMMIT，该模式下只有在事务提交时才会执行flush()写入数据库。

9.clear()：清除对象。
默认情况下，EntityManager会检视所有的实体类对象的修改，在事务提交时，会自动将修改保存进数据库，相应的会消耗部分内容。可以用clear()清除所有被监视的实体类对象。但需要注意，clear()之后，对实体类所做的修改将会丢失。

二、常用注解

1.@Entity
被Entity标注的实体类将会被JPA管理控制，在程序运行时，JPA会识别并映射到指定的数据库表唯一参数name:指定实体类名称，默认为当前实体类的非限定名称。若给了name属性，即@Entity(name=“XXX”)，则jpa在仓储层(数据层)进行自定义查询，所查的表名应是XXX。如：select s from XXX 。

2 . @Table
当你想生成的数据库表名与实体类名称不同时，使用 @Table(name=“数据库表名”),与@Entity标注并列使用，置于实体类声明语句之前 。

@Entity
@Table(name="t_student")
public class student{
  ...
}

3 .@Id
用于实体类的一个属性或者属性对应的getter方法的标注，被标注的的属性将映射为数据库主键 。

4 .@GeneratedValue
与@Id一同使用，用于标注主键的生成策略，通过 strategy 属性指定。默认是JPA自动选择合适的策略
在 javax.persistence.GenerationType 中定义了以下几种可供选择的策略：

• IDENTITY：采用数据库ID自增长的方式产生主键，Oracle 不支持这种方式。
• AUTO： JPA 自动选择合适的策略，是默认选项。
• SEQUENCE：通过序列产生主键，通过@SequenceGenerator标注指定序列名，MySQL 不支持这种方式。
• TABLE：通过表产生主键，框架借由表模拟序列产生主键，使用该策略更易于做数据库移植。

@Entity
@Table(name = "banner")
public class Banner {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY) // 自动递增
}

5 .@Basic
表示一个简单的属性到数据库表的字段的映射,对于没有任何标注的 getXxxx() 方法,默认即为@Basic(fetch=FetechType.EAGER)
@Basic参数：

1. fetch 表示该属性的加载读取策略
   1.1 EAGER 主动抓取 （默认为EAGER）
   1.2 LAZY 延迟加载,只有用到该属性时才会去加载
2. optional (默认为 true)
   表示该属性是否允许为null

6 .@Column
通常置于实体的属性声明之前，可与 @Id 标注一起使用
@Column参数：

1. name: 指定映射到数据库中的字段名
2. unique: 是否唯一，默认为false
3. nullable: 是否允许为null，默认为true
4. insertable: 是否允许插入，默认为true
5. updatetable: 是否允许更新，默认为true
6. columnDefinition: 指定该属性映射到数据库中的实际类型，通常是自动判断。

---