SpringBoot中JPA的学习

准备环境和项目配置

　　写一下学习JPA的过程，主要是结合之前SpringBoot + Vue的项目和网上的博客学习一下。

　　首先，需要配置一下maven文件，有这么两个依赖：

<dependency>

    <groupId>org.springframework.boot</groupId>

    <artifactId>spring-boot-starter-data-jpa</artifactId>

</dependency>

<dependency>

    <groupId>mysql</groupId>

    <artifactId>mysql-connector-java</artifactId>

    <version>6.0.6</version>

</dependency>

　　然后是application中的配置问题，JPA有这么一些常见的参数：

　　spring.jpa.show-sql 配置在日志中打印出执行的 SQL 语句信息。

　　spring.jpa.hibernate.ddl-auto配置了实体类维护数据库表结构的具体行为，update表示当实体类的属性发生变化时，表结构跟着更新，也可以取值create，create表示启动的时候删除上一次生成的表，并根据实体类重新生成表，这个时候之前表中的数据就会被清空；还可以取值create-drop，这个表示启动时根据实体类生成表，但是当sessionFactory关闭的时候表会被删除；validate表示启动时验证实体类和数据表是否一致；none则什么都不做。

　spring.jpa.database-platform=org.hibernate.dialect.MySQL5InnoDBDialect 。在 SrpingBoot 2.0 版本中，Hibernate 创建数据表的时候，默认的数据库存储引擎选择的是 MyISAM （之前好像是 InnoDB，这点比较诡异）。这个参数是在建表的时候，将默认的存储引擎切换为 InnoDB 用的。

　　spring.jackson.serialization.indent_output=true表示格式化输出的json字符串,方便查看。

定义数据实体类

　　在这个项目里，数据实体类的定义方式大同小异：

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;

import javax.persistence.*;

@Entity

@Table(name = "book")

@JsonIgnoreProperties({"handler","hibernateLazyInitializer"})

public class Book {

    @Id

    @GeneratedValue(strategy = GenerationType.IDENTITY)

    @Column(name = "id")

    int id;

    //把 category 对象的 id 属性作为 cid 进行了查询

    @ManyToOne

    @JoinColumn(name="cid")

    private Category category;

    String cover;

    String title;

    String author;

    String date;

    String press;

    String abs;

    public Category getCategory() {

        return category;

    }

    public void setCategory(Category category) {

        this.category = category;

    }

    public String getDate() {

        return date;

    }

    public void setDate(String date) {

        this.date = date;

    }

    ...

}

　　下面分别写一下这些注释的作用以及和其他部分关联：

　　@Entity 是一个必选的注解，声明这个类对应了一个数据库表。

　　@Table(name = "book") 是一个可选的注解。声明了数据库实体对应的表信息。包括表名称、索引信息等。这里声明这个实体类对应的表名是 book。如果没有指定，则表名和实体的名称保持一致。

　　可以看一下对应的在MySQL中的数据表：

　　其中8个属性分别表示序号、封面（存放图床的url或者本地的url地址）、标题、作者、出版日期、出版社、简介、表示类别的外键。

　　@JsonIgnoreProperties因为是做前后端分离，而前后端数据交互用的是 json 格式。那么对象就会被转换为 json 数据。而本项目使用 jpa 来做实体类的持久化，jpa 默认会使用 hibernate,在 jpa 工作过程中，就会创造代理类来继承该类，并添加 handler 和 hibernateLazyInitializer 这两个无须 json 化的属性，所以这里需要用 JsonIgnoreProperties 把这两个属性忽略掉。这里我看好多博主都没有写，在后面会对这个注解多做一些测试相关的内容。

　　@Id表示该字段是一个id　　

　　@GeneratedValue注解存在的意义主要就是为一个实体生成一个唯一标识的主键、@GeneratedValue提供了主键的生成策略。@GeneratedValue注解有两个属性,分别是strategy和generator。generator属性的值是一个字符串,默认为"",其声明了主键生成器的名称。strategy属性提供四种值:1.AUTO主键由程序控制, 是默认选项 ,不设置就是这个；2.IDENTITY 主键由数据库生成, 采用数据库自增长, Oracle不支持这种方；3.SEQUENCE 通过数据库的序列产生主键, MYSQL不支持；4.Table提供特定的数据库产生主键, 该方式更有利于数据库的移植。需要注意的是很多博主将MySQL建表时设置自增属性，这里采用默认值表示自增。但是想运用到neo4j上可能要注意。

　　@Column(length = 32) 用来声明实体属性的表字段的定义。默认的实体每个属性都对应了表的一个字段。字段的名称默认和属性名称保持一致（并不一定相等）。字段的类型根据实体属性类型自动推断。这里主要是声明了字符字段的长度。如果不这么声明，则系统会采用 255 作为该字段的长度。这里的话个人感觉原来博主的定义不够严谨，应该是：

@Column(length = 20)

String date;

　　@JoinColumn 注解的作用：用来指定与所操作实体或实体集合相关联的数据库表中的列字段。由于 @OneToOne（一对一）、@OneToMany（一对多）、@ManyToOne（多对一）、@ManyToMany（多对多）等注解只能确定实体之间几对几的关联关系，它们并不能指定与实体相对应的数据库表中的关联字段，因此，需要与 @JoinColumn 注解来配合使用。我们也可以不写@JoinColumn，Hibernate会自动生成一张中间表来进行绑定，通常并不推荐让Hibernate自动去自动生成中间表，而是使用@JoinTable注解来指定中间表：

　　然后就是各个属性的get和set方法，注意下属性前面一般要加上private限制，但是这个博主没有加，不太规范这里。

实现持久层服务

public interface BookDAO extends JpaRepository<Book,Integer> {

    List<Book> findAllByCategory(Category category);

    /*

    这个 findAllByTitleLikeOrAuthorLike，翻译过来就是“根据标题或作者进行模糊查询”，

    参数是两个 String，分别对应标题或作者。

    记住这个写法，我想当然的以为是 findAllByTitleOrAuthorLike，只设置一个参数就行，结果瞎折腾了好久。

    因为 DAO 里是两个参数，所以在 Service 里把同一个参数写了两遍。

    用户在搜索时无论输入的是作者还是书名，都会对两个字段进行匹配。

     */

    List<Book> findAllByTitleLikeOrAuthorLike(String keyword1, String keyword2);

}

　　声明BookDAO接口，继承JpaRepository，默认支持简单的 CRUD 操作，非常方便。　　

　　注意这里JpaRepository的第一个参数是刚刚定义的实体类，第二个参数是那个主键的类型，很多博客这里是有问题的。　　

　　然后可以放心的使用以下函数操作数据库：

<S extends T> S save(S entity);

<S extends T> Iterable<S> saveAll(Iterable<S> entities);(

Optional<T> findById(ID id);

boolean existsById(ID id);

Iterable<T> findAll();

Iterable<T> findAllById(Iterable<ID> ids);

long count();

void deleteById(ID id);

void delete(T entity);

void deleteAll(Iterable<? extends T> entities);

void deleteAll();

　　关于这里JpaRepository的原理，可以参考这篇博客的内容：

　　https://segmentfault.com/a/1190000015047290

　　这里写一下自定义JPA对应的函数名：

Keyword	Sample	JPQL snippet
And	findByLastnameAndFirstname	… where x.lastname = ?1 and x.firstname = ?2
Or	findByLastnameOrFirstname	… where x.lastname = ?1 or x.firstname = ?2
Is,Equals	findByFirstnameIs,findByFirstnameEquals	… where x.firstname = ?1
Between	findByStartDateBetween	… where x.startDate between ?1 and ?2
LessThan	findByAgeLessThan	… where x.age < ?1
LessThanEqual	findByAgeLessThanEqual	… where x.age <= ?1
GreaterThan	findByAgeGreaterThan	… where x.age > ?1
GreaterThanEqual	findByAgeGreaterThanEqual	… where x.age >= ?1
After	findByStartDateAfter	… where x.startDate > ?1
Before	findByStartDateBefore	… where x.startDate < ?1
IsNull	findByAgeIsNull	… where x.age is null
IsNotNull,NotNull	findByAge(Is)NotNull	… where x.age not null
Like	findByFirstnameLike	… where x.firstname like ?1
NotLike	findByFirstnameNotLike	… where x.firstname not like ?1
StartingWith	findByFirstnameStartingWith	… where x.firstname like ?1 (parameter bound with appended %)
EndingWith	findByFirstnameEndingWith	… where x.firstname like ?1 (parameter bound with prepended %)
Containing	findByFirstnameContaining	… where x.firstname like ?1 (parameter bound wrapped in %)
OrderBy	findByAgeOrderByLastnameDesc	… where x.age = ?1 order by x.lastname desc
Not	findByLastnameNot	… where x.lastname <> ?1
In	findByAgeIn(Collection<age> ages)</age>	… where x.age in ?1
NotIn	findByAgeNotIn(Collection<age> age)</age>	… where x.age not in ?1
TRUE	findByActiveTrue()	… where x.active = true
FALSE	findByActiveFalse()	… where x.active = false
IgnoreCase	findByFirstnameIgnoreCase	… where UPPER(x.firstame) = UPPER(?1)