JPA是Java Persistence API的缩写,是Java的一个规范。它用于Java对象和关系数据库之间保存数据。 JPA充当面向对象的领域模型和关系数据库系统之间的桥梁。
由于JPA只是一种规范,本身没有任务操作,故需要一个实现。
一、JPA实体
JPA实体可以简单理解为一个类,这个类对应一个数据库中的一张表。
- 创建实体ENTITY
- 在类上添加@Entity,这个注解表明该类是一个实体。
- 在字段上添加@Id, 此注释位于持有持久标识属性的特定字段上。该字段被视为数据库中的主键。
import javax.persistence.*;
@Entity
public class Student {
@Id
private int id;
private String name;
private long fees;
public Student() {
}
public Student(int id) {
this.id = id;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public long getFees() {
return fees;
}
public void setFees(long fees) {
this.fees = fees;
}
}
在JPA中,可以通过EntityManager管理实体,其提供有如下方法:
- persist() 向表中插入数据
EntityManagerFactory emf = Persistence.createEntityManagerFactory("Student_details");
EntityManager em = emf.createEntityManager();
em.getTransaction().begin();
StudentEntity s1 = new StudentEntity();
s1.setS_id(1001);
s1.setS_name("Maxsu");
s1.setS_age(26);
StudentEntity s2 = new StudentEntity();
s2.setS_id(1102);
s2.setS_name("Yiibai");
s2.setS_age(23);
StudentEntity s3 = new StudentEntity();
s3.setS_id(1003);
s3.setS_name("James");
s3.setS_age(28);
em.persist(s1);
em.persist(s2);
em.persist(s3);
em.getTransaction().commit();
em.close();
emf.close();
- find():根据主键搜素一个元素
EntityManagerFactory emf = Persistence.createEntityManagerFactory("Student_details");
EntityManager em = emf.createEntityManager();
StudentEntity s = em.find(StudentEntity.class, 1001);
System.out.println("Student id = " + s.getS_id());
System.out.println("Student Name = " + s.getS_name());
System.out.println("Student Age = " + s.getS_age());
- 使用set+对应属性("新值")可以执行更新操作
EntityManagerFactory emf = Persistence.createEntityManagerFactory("Student_details");
EntityManager em = emf.createEntityManager();
StudentEntity s = em.find(StudentEntity.class, 1001);
System.out.println("Before Updation");
System.out.println("Student id = " + s.getS_id());
System.out.println("Student Name = " + s.getS_name());
System.out.println("Student Age = " + s.getS_age());
s.setS_age(30);
System.out.println("After Updation");
System.out.println("Student id = " + s.getS_id());
System.out.println("Student Name = " + s.getS_name());
System.out.println("Student Age = " + s.getS_age());
- 删除元素,可以使用remove(),其中传递参数为对应实体。
EntityManagerFactory emf = Persistence.createEntityManagerFactory("Student_details");
EntityManager em = emf.createEntityManager();
em.getTransaction().begin();
StudentEntity s = em.find(StudentEntity.class, 1001);
em.remove(s);
em.getTransaction().commit();
em.close();
emf.close();
二、JPA也支持集合映射
- 列表映射
- 在list属性上添加 @ElementCollection ,表示该属性有嵌入对象
- @Embeddable 添加到实体类上,表示被嵌入到List中的对象。
- Set映射,无序存入Set中
- 在Set集合上添加注解@ElementCollection
- 在要嵌入的类上添加@Embeddable ,表示要装入到Set集合中。
- Map映射
- 同样在属性上添加@ElementCollection 表示嵌入对象
- 在在要嵌入的类上添加@Embeddable ,表示要装入到Map集合中
由此可见@ElementCollection和@Embeddable 的强大功能,只需要在需要映射的集合上添加注解,便可装入另一个实体对象
三、JPA常用注解
1、@Entity 标注用于实体类声明语句之前,指出该Java 类为实体类,将映射到指定的数据库表。如声明一个实体类 OperatingLog,它将映射到数据库中的 MH_OPERATING_LOG表上。
2、@Table
当实体类与其映射的数据库表名不同名时需要使用 @Table 标注说明,该标注与 @Entity 标注并列使用,置于实体类声明语句之前,可写于单独语句行,也可与声明语句同行。
@Table 标注的常用选项是 name,用于指明数据库的表名 @Table标注还有一个两个选项 catalog 和 schema 用于设置表所属的数据库目录或模式,通常为数据库名。
3、@Id
@Id 标注用于声明一个实体类的属性映射为数据库的主键列。该属性通常置于属性声明语句之前,可与声明语句同行,也可写在单独行上。@Id标注也可置于属性的getter方法之前。
4、@GeneratedValue
@GeneratedValue 用于标注主键的生成策略,通过 strategy 属性指定。默认情况下,JPA 自动选择一个最适合底层数据库的主键生成策略:SqlServer 对应 identity,MySQL 对应 auto increment。 在 javax.persistence.GenerationType 中定义了以下几种可供选择的策略:
IDENTITY:采用数据库 ID自增长的方式来自增主键字段,Oracle 不支持这种方式;
AUTO: JPA自动选择合适的策略,是默认选项;
SEQUENCE:通过序列产生主键,通过 @SequenceGenerator 注解指定序列名,MySql 不支持这种方式
TABLE:通过表产生主键,框架借由表模拟序列产生主键,使用该策略可以使应用更易于数据库移植。
5、@Basic
@Basic 表示一个简单的属性到数据库表的字段的映射,对于没有任何标注的 getXxxx() 方法,默认即为
@Basic fetch: 表示该属性的读取策略,有 EAGER 和 LAZY 两种,分别表示主支抓取和延迟加载,默认为 EAGER.
optional:表示该属性是否允许为null, 默认为true
6、@Column
当实体的属性与其映射的数据库表的列不同名时需要使用@Column 标注说明,该属性通常置于实体的属性声明语句之前,还可与 @Id 标注一起使用。
@Column 标注的常用属性是 name,用于设置映射数据库表的列名。此外,该标注还包含其它多个属性,如:unique 、nullable、length 等。
@Column 标注的 columnDefinition 属性: 表示该字段在数据库中的实际类型.通常 ORM 框架可以根据属性类型自动判断数据库中字段的类型,但是对于Date类型仍无法确定数据库中字段类型究竟是DATE,TIME还是TIMESTAMP.此外,String的默认映射类型为VARCHAR, 如果要将 String 类型映射到特定数据库的 BLOB 或TEXT 字段类型.@Column标注也可置于属性的getter方法之前
7@Transient
表示该属性并非一个到数据库表的字段的映射,ORM框架将忽略该属性.
如果一个属性并非数据库表的字段映射,就务必将其标示为@Transient,否则,ORM框架默认其注解为@Basic
8@Temporal
在核心的 Java API 中并没有定义 Date 类型的精度(temporal precision). 而在数据库中,表示 Date 类型的数据有 DATE, TIME, 和 TIMESTAMP 三种精度(即单纯的日期,时间,或者两者 兼备).
在进行属性映射时可使用@Temporal注解来调整精度.
9.@OneToMany
指向多的那方的pojo的关联外键字段
10.@ManyToOne
设置在“一方”pojo的外键字段上
11.@ManyToMany 一对多映射
12.@OneToOne 一对一映射。
三、JPARepository
使用JPARepository可以访问数据库,简化了数据库的操作,方便编写代码。
其继承了CRUDRepository和PagingAndSortingRepository,因此,继承了JPaRepository的接口同时拥有了基本的CRUD和分页功能。
当需要自定义repository接口时,可以直接继承JpaRepository
public interface UserRepository extends JpaRepository{
}
可以查看API看JpaRepository包含的基本操作。
当然继承了JpaRepository的接口也可以自定义一些方法支撑对数据库的操作。
其方法命名需遵循一定的规则,如User类,想根据name去查询,可以命名方法为findUserByName.其具体的一些命名规则可以参考下图或浏览JPARepository官方文档:https://spring.io/projects/spring-data-jpa
JPA中还有CRUD的查询规范,包括单表查询,联表查询,简而言之,JPA能够使开发者很方便的对数据库进行操作,只需要建立与数据库中表对应的实体即可。