大家好,又见面了,我是你们的朋友全栈君。
目录
使用数据库是开发基本应用的基础,借助于开发框架,我们已经不用编写原始的访问数据库的代码,也不用调用JDBC(Java Data Base Connectivity)或者连接池等诸如此类的被称作底层的代码,我们将从更高的层次上访问数据库,这在Springboot中更是如此,本章我们将详细介绍在Springboot中使用 Spring Data JPA 来实现对数据库的操作。
JPA & Spring Data JPA
JPA是Java Persistence API的简称,中文名Java持久层API,是Sun官方提出的Java持久化规范,其设计目标主要是为了简化现有的持久化开发工作和整合ORM技术。JPA使用XML文件或注解(JDK 5.0或更高版本)来描述对象-关联表的映射关系,能够将运行期的实体对象持久化到数据库,它为Java开发人员提供了一种ORM工具来管理Java应用中的关系数据。 简单地说,JPA就是为POJO(Plain Ordinary Java Object)提供持久化的标准规范,即将Java的普通对象通过对象关系映射(Object-Relational Mapping,ORM)持久化到数据库中。由于JPA是在充分吸收了现有Hibernate,TopLink,JDO等ORM框架的基础上发展而来的,因而具有易于使用、伸缩性强等优点。
Spring Data JPA 是 Spring 基于 Spring Data 框架、在JPA 规范的基础上开发的一个框架,使用 Spring Data JPA 可以极大地简化JPA 的写法,可以在几乎不用写实现的情况下实现对数据库的访问和操作,除了CRUD外,还包括分页和排序等一些常用的功能。
配置Maven依赖
以MySQL数据库为例,为了使用JPA和MySQL,首先在工程中引入它们的Maven依赖。
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.1.RELEASE</version>
</parent>
<dependencies>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
</dependency>
</dependencies>
配置数据源和JPA
在Springboot核心配置文件 application.properties 中配置MySQL数据源和JPA。
########################################################
### Spring datasource -- Datasource configuration.
########################################################
spring.datasource.url = jdbc:mysql://localhost:3306/mybatis?characterEncoding=UTF-8
spring.datasource.username = root
spring.datasource.password = 123456
spring.datasource.driverClassName = com.mysql.jdbc.Driver
spring.datasource.type = org.apache.tomcat.jdbc.pool.DataSource
########################################################
### Java Persistence Api -- Spring jpa configuration.
########################################################
# Specify the DBMS
spring.jpa.database = MYSQL
# Show or not log for each sql query
spring.jpa.show-sql = true
# Hibernate ddl auto (create, create-drop, update, validate, none)
spring.jpa.hibernate.ddl-auto = update
# Naming strategy
#[org.hibernate.cfg.ImprovedNamingStrategy #org.hibernate.cfg.DefaultNamingStrategy]
spring.jpa.hibernate.naming-strategy = org.hibernate.cfg.ImprovedNamingStrategy
# stripped before adding them to the entity manager)
spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.MySQL5Dialect
其中,spring.jpa.hibernate.ddl-auto 参数用来配置是否开启自动更新数据库表结构,可取create、create-drop、update、validate、none五个值。
- create 每次加载hibernate时,先删除已存在的数据库表结构再重新生成;
- create-drop 每次加载hibernate时,先删除已存在的数据库表结构再重新生成,并且当 sessionFactory关闭时自动删除生成的数据库表结构;
- update 只在第一次加载hibernate时自动生成数据库表结构,以后再次加载hibernate时根据model类自动更新表结构;
- validate 每次加载hibernate时,验证数据库表结构,只会和数据库中的表进行比较,不会创建新表,但是会插入新值。
- none 关闭自动更新
创建POJO实体
首先创建一些普通对象,用来与数据库的表建立映射关系,在此我们只定义了员工和部门两个实体来进行示例。
@Entity
@Table(name = "tbl_employee") // 指定关联的数据库的表名
public class Employee implements Serializable {
private static final long serialVersionUID = 1L;
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id; // 主键ID
private String name; // 姓名
@ManyToOne
@JoinColumn(name = "department_id")
private Department department; // 部门
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Department getDepartment() {
return department;
}
public void setDepartment(Department department) {
this.department = department;
}
}
@Entity
@Table(name = "tbl_department")
public class Department implements Serializable{
private static final long serialVersionUID = 1L;
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id; // 主键ID
private String name; // 部门名称
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
其中,注解@Entity用来标记该类是一个JPA实体类,并使用了注解@Table指定关联的数据库的表名;注解@Id用来定义记录的唯一标识,并结合注解@GeneratedValue将其设置为自动生成。
数据持久化
使用 JPA 进行数据持久化有两种实现方式。
- 方式一:使用Spring Data JPA 提供的接口默认实现,
- 方式二:自定义符合Spring Data JPA规则的查询方法,由框架将其自动解析为SQL。
使用Spring Data JPA接口(方式一)
Spring Data JPA提供了一些实现了基本的数据库操作的接口类,如下图所示。
CrudRepository
CrudRepository提供了一些简单的增删查改功能,接口定义如下。
package org.springframework.data.repository;
import java.io.Serializable;
@NoRepositoryBean
public interface CrudRepository<T, ID extends Serializable> extends Repository<T, ID> {
<S extends T> S save(S entity); // 保存并返回(修改后的)实体
<S extends T> Iterable<S> save(Iterable<S> entities); // 保存并返回(修改后的)实体集合
T findOne(ID id); // 根据ID获取实体
boolean exists(ID id); // 判断指定ID的实体是否存在
Iterable<T> findAll(); // 查询所有实体
Iterable<T> findAll(Iterable<ID> ids); // 根据ID集合查询实体
long count(); // 获取实体的数量
void delete(ID id); // 删除指定ID的实体
void delete(T entity); // 删除实体
void delete(Iterable<? extends T> entities); // 删除实体集合
void deleteAll(); // 删除所有实体
}
PagingAndSortingRepository
PagingAndSortingRepository继承于CrudRepository,除了具有CrudRepository接口的能力外,还新增了分页和排序的功能,接口定义如下。
package org.springframework.data.repository;
import java.io.Serializable;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Sort;
@NoRepositoryBean
public interface PagingAndSortingRepository<T, ID extends Serializable> extends CrudRepository<T, ID> {
Iterable<T> findAll(Sort sort); // 查询所有实体并排序
Page<T> findAll(Pageable pageable); // 分页查询实体
}
JpaRepository
JpaRepository继承于PagingAndSortingRepository,所以它传递性地拥有了以上接口的所有方法,同时,它还继承了另外一个QueryByExampleExecutor接口,拥有了该接口匹配指定样例的能力,JpaRepository接口定义如下。
package org.springframework.data.jpa.repository;
import java.io.Serializable;
import java.util.List;
import javax.persistence.EntityManager;
import org.springframework.data.domain.Example;
import org.springframework.data.domain.Sort;
import org.springframework.data.repository.NoRepositoryBean;
import org.springframework.data.repository.PagingAndSortingRepository;
import org.springframework.data.repository.query.QueryByExampleExecutor;
@NoRepositoryBean
public interface JpaRepository<T, ID extends Serializable>
extends PagingAndSortingRepository<T, ID>, QueryByExampleExecutor<T> {
List<T> findAll(); // 查询所有实体
List<T> findAll(Sort sort); // 查询所有实体并排序
List<T> findAll(Iterable<ID> ids); // 根据ID集合查询实体
<S extends T> List<S> save(Iterable<S> entities); // 保存并返回(修改后的)实体集合
void flush(); // 提交事务
<S extends T> S saveAndFlush(S entity); // 保存实体并立即提交事务
void deleteInBatch(Iterable<T> entities); // 批量删除实体集合
void deleteAllInBatch();// 批量删除所有实体
T getOne(ID id); // 根据ID查询实体
@Override
<S extends T> List<S> findAll(Example<S> example); // 查询与指定Example匹配的所有实体
@Override
<S extends T> List<S> findAll(Example<S> example, Sort sort);// 查询与指定Example匹配的所有实体并排序
}
QueryByExampleExecutor
QueryByExampleExecutor接口允许开发者根据给定的样例执行查询操作,接口定义如下。
package org.springframework.data.repository.query;
import org.springframework.data.domain.Example;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Sort;
public interface QueryByExampleExecutor<T> {
<S extends T> S findOne(Example<S> example); // 查询与指定Example匹配的唯一实体
<S extends T> Iterable<S> findAll(Example<S> example); // 查询与指定Example匹配的所有实体
<S extends T> Iterable<S> findAll(Example<S> example, Sort sort); // 查询与指定Example匹配的所有实体并排序
<S extends T> Page<S> findAll(Example<S> example, Pageable pageable);// 分页查询与指定Example匹配的所有实体
<S extends T> long count(Example<S> example); // 查询与指定Example匹配的实体数量
<S extends T> boolean exists(Example<S> example); // 判断与指定Example匹配的实体是否存在
}
以部门实体资源库接口DepartmentRepository为例,只需继承CrudRepository接口便会自动拥有基础的增删查改功能,无须编写一条SQL。
@Repository
public interface DepartmentRepository extends CrudRepository<Department, Long> {
}
自定义查询方法(方式二)
除了可以直接使用Spring Data JPA接口提供的基础功能外,Spring Data JPA还允许开发者自定义查询方法,对于符合以下命名规则的方法,Spring Data JPA能够根据其方法名为其自动生成SQL,除了使用示例中的 find 关键字,还支持的关键字有:query、get、read、count、delete等。
另外,Spring Data JPA 还提供了对分页查询、自定义SQL、查询指定N条记录、联表查询等功能的支持,以员工实体资源库接口EmployeeRepository为例,功能代码示意如下。
@Repository
public interface EmployeeRepository extends JpaRepository<Employee, Long> {
/**
* 根据部门ID获取员工数量
*/
int countByDepartmentId(Long departmentId);
/**
* 根据部门ID分页查询
*/
Page<Employee> queryByDepartmentId(Long departmentId, Pageable pageable);
/**
* 根据员工ID升序查询前10条
*/
List<Employee> readTop10ByOrderById();
/**
* 根据员工姓名取第一条记录
*/
Employee getFirstByName(String name, Sort sort);
/**
* 联表查询
*/
@Query("select e.id as employeeId,e.name as employeeName,d.id as departmentId,d.name as departmentName from Employee e , Department d where e.id= ?1 and d.id= ?2")
EmployeeDetail getEmployeeJoinDepartment(Long eid, Long did);
/**
* 修改指定ID员工的姓名
*/
@Modifying
@Transactional(timeout = 10)
@Query("update Employee e set e.name = ?1 where e.id = ?2")
int modifyEmployeeNameById(String name, Long id);
/**
* 删除指定ID的员工
*/
@Transactional(timeout = 10)
@Modifying
@Query("delete from Employee where id = ?1")
void deleteById(Long id);
}
JUnit测试
为例验证上面接口的正确性,我们使用JUnit来进行测试,先增加一个JPA的配置类,代码如下。
@Order(Ordered.HIGHEST_PRECEDENCE)
@Configuration
@EnableTransactionManagement(proxyTargetClass = true)
@EnableJpaRepositories(basePackages = {"com.pengjunlee.repository"})
@EntityScan(basePackages = {"com.pengjunlee.entity"})
@EnableAutoConfiguration
public class JpaConfiguration {
@Bean
PersistenceExceptionTranslationPostProcessor persistenceExceptionTranslationPostProcessor() {
return new PersistenceExceptionTranslationPostProcessor();
}
}
其中,@EnableTransactionManagement注解用来启用JPA事务管理,@EnableJpaRepositories注解用来启用JPA资源库发现,@EntityScan注解用来启用实体发现。
配置类定义好之后,编写一个JUnit Test Case测试程序。
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = JpaConfiguration.class)
@TestPropertySource(locations = { "classpath:application.properties" })
public class JpaTest {
@Autowired
DepartmentRepository departmentRepository;
@Autowired
EmployeeRepository employeeRepository;
@Test
public void addDepartmentTest() {
}
@Test
public void initData() {
// 清空员工表中的数据
employeeRepository.deleteAll();
// 清空部门表中的数据
departmentRepository.deleteAll();
// 部门表中添加一个开发部
Department dept1 = new Department();
dept1.setName("开发部");
departmentRepository.save(dept1);
// 部门表中添加一个测试部
Department dept2 = new Department();
dept2.setName("测试部");
departmentRepository.save(dept2);
String[] names = new String[] { "lucy", "tom", "hanmeime", "jacky", "francky", "lilly", "xiaoming", "smith",
"walt", "sherry" };
// 员工表中增加10条记录
for (int i = 0; i < 10; i++) {
Employee emp = new Employee();
emp.setName(names[i]);
if (i < 5) {
emp.setDepartment(dept1);
} else {
emp.setDepartment(dept2);
}
employeeRepository.save(emp);
}
}
@Test
public void testCountByDepartmentId() {
int count = employeeRepository.countByDepartmentId(19L);
System.out.println(count);
}
@Test
public void testQueryByDepartmentId() {
Pageable pageable = new PageRequest(0, 10, new Sort(Sort.Direction.ASC, "name"));
Page<Employee> emps = employeeRepository.queryByDepartmentId(19L, pageable);
for (Employee emp : emps.getContent()) {
System.out.println("员工姓名:" + emp.getName() + ",所属部门:" + emp.getDepartment().getName());
}
}
@Test
public void testReadTop10ByOrderById() {
List<Employee> emps = employeeRepository.readTop10ByOrderById();
for (Employee emp : emps) {
System.out.println("员工姓名:" + emp.getName() + ",所属部门:" + emp.getDepartment().getName());
}
}
@Test
public void testGetFirstByName() {
Employee emp = employeeRepository.getFirstByName("xiaoming", new Sort(Direction.ASC, "id"));
System.out.println("员工姓名:" + emp.getName() + ",所属部门:" + emp.getDepartment().getName());
}
@Test
public void testGetEmployeeJoinDepartment() {
EmployeeDetail empDetail = employeeRepository.getEmployeeJoinDepartment(5L, 19L);
System.out.println("员工姓名:" + empDetail.getEmployeeName() + ",部门名称:" + empDetail.getDepartmentName());
}
@Test
public void testModifyEmployeeNameById() {
employeeRepository.modifyEmployeeNameById("chris", 5L);
}
@Test
public void testDeleteById() {
employeeRepository.deleteById(11L);
}
}
本文项目源码已上传至CSDN,资源地址:https://download.csdn.net/download/pengjunlee/10366305
发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/151158.html原文链接:https://javaforall.cn
【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛
【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...