Spring Data Jpa --- 入门

一、概述

Spring Data是Spring下的一个子项目,用于简化数据库访问,并支持云服务的开源框架。Spring Data支持NoSQL和 关系数据存储,其主要目标是使得数据库的访问变得方便快捷。并支持map-reduce框架和云计算数据服务。对于拥有海量数据的项目,可以用Spring Data来简化项目的开发。 然而针对不同的数据储存访问使用相对的类库来操作访问。Spring Data中已经为我们提供了很多业务中常用的一些接口和实现类来帮我们快速构建项目,比如分页、排序、DAO一些常用的操作。 


二、环境搭建

1.1 导入jar包



1.2 applicationContext.xml配置

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"
  4. xmlns:context= "http://www.springframework.org/schema/context"
  5. xmlns:tx= "http://www.springframework.org/schema/tx"
  6. xmlns:jpa= "http://www.springframework.org/schema/data/jpa"
  7. xsi:schemaLocation= "http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
  8. http://www.springframework.org/schema/data/jpa http://www.springframework.org/schema/data/jpa/spring-jpa-1.3.xsd
  9. http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
  10. http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd">
  11. <!-- 配置自动扫描的包 -->
  12. <context:component-scan base-package="com.test.springdata"> </context:component-scan>
  13. <!-- 1. 配置数据源 -->
  14. <context:property-placeholder location="classpath:config.properties"/>
  15. <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
  16. <property name="driverClass" value="${jdbc.driver}" />
  17. <property name="jdbcUrl" value="${jdbc.url}" />
  18. <property name="user" value="${jdbc.user}" />
  19. <property name="password" value="${jdbc.password}" />
  20. </bean>
  21. <!-- 2. 配置 JPA 的 EntityManagerFactory -->
  22. <bean id="entityManagerFactory"
  23. class= "org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
  24. <property name="dataSource" ref="dataSource"> </property>
  25. <property name="jpaVendorAdapter">
  26. <bean class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter"> </bean>
  27. </property>
  28. <property name="packagesToScan" value="com.test.springdata"> </property>
  29. <property name="jpaProperties">
  30. <props>
  31. <!-- 二级缓存相关 -->
  32. <!-- <prop key="hibernate.cache.region.factory_class">org.hibernate.cache.ehcache.EhCacheRegionFactory</prop>
  33. <prop key="net.sf.ehcache.configurationResourceName">ehcache-hibernate.xml</prop> -->
  34. <!-- 生成的数据表的列的映射策略 -->
  35. <prop key="hibernate.ejb.naming_strategy">org.hibernate.cfg.ImprovedNamingStrategy </prop>
  36. <!-- hibernate 基本属性 -->
  37. <prop key="hibernate.dialect">org.hibernate.dialect.Oracle10gDialect </prop>
  38. <prop key="hibernate.show_sql">true </prop>
  39. <prop key="hibernate.format_sql">true </prop>
  40. <prop key="hibernate.hbm2ddl.auto">update </prop>
  41. </props>
  42. </property>
  43. </bean>
  44. <!-- 3. 配置事务管理器 -->
  45. <bean id="transactionManager"
  46. class= "org.springframework.orm.jpa.JpaTransactionManager">
  47. <property name="entityManagerFactory" ref="entityManagerFactory"> </property>
  48. </bean>
  49. <!-- 4. 配置支持注解的事务 -->
  50. <tx:annotation-driven transaction-manager="transactionManager"/>
  51. <!-- 5. 配置 SpringData -->
  52. <!-- 加入 jpa 的命名空间 -->
  53. <!-- base-package: 扫描 Repository Bean 所在的 package -->
  54. <jpa:repositories base-package="com.test.springdata"
  55. entity-manager-factory-ref= "entityManagerFactory"> </jpa:repositories>
  56. </beans>


三、Repository接口

Repository 接口是 Spring Data 的一个核心接口,它不提供任何方法,开发者需要在自己定义的接口中声明需要的方法。

public interface Repository<T, ID extends Serializable> {}


说明:

  • Repository是一个空接口,即是一个标记接口
  • 若我们定义的接口继承了Repository,则该接口会被IOC容器识别为一个Repository Bean注入到IOC容器中,只要遵循Spring Data的方法定义规范,就无需写实现类。
  • 与继承 Repository 等价的一种方式,就是在持久层接口上使用 @RepositoryDefinition 注解,并为其指定 domainClass 和 idClass 属性。如下两种方式是完全等价的

@RepositoryDefinition(domainClass=Person.class,idClass=Integer.class)


3.1 Repository的子接口

基础的 Repository 提供了最基本的数据访问功能,其几个子接口则扩展了一些功能。它们的继承关系如下: 

  • Repository: 仅仅是一个标识,表明任何继承它的均为仓库接口类
  • CrudRepository: 继承 Repository,实现了一组 CRUD 相关的方法 
  • PagingAndSortingRepository: 继承 CrudRepository,实现了一组分页排序相关的方法 
  • JpaRepository: 继承 PagingAndSortingRepository,实现一组 JPA 规范相关的方法 


3.2 Spring Data方法定义规范

查询方法以find | read | get开头,设计条件查询时,条件的属性用条件关键字连接,要注意的是:条件属性以首字母大写。 

例如:定义一个 Entity 实体类 

  1. class User
  2. private String firstName;
  3. private String lastName;

使用And条件连接时,应这样写: 

findByLastNameAndFirstName(String lastName,String firstName); 

条件的属性名称与个数要与参数的位置与个数一一对应 


直接在接口中定义查询方法,如果是符合规范的,可以不用写实现,目前支持的关键字写法如下:



三、CrudRepository接口

CrudRepository 接口提供了最基本的对实体类的添删改查操作 

  • T save(T entity);//保存单个实体 
  • Iterable<T> save(Iterable<? extends T> entities);//保存集合        
  • T findOne(ID id);//根据id查找实体         
  • boolean exists(ID id);//根据id判断实体是否存在         
  • Iterable<T> findAll();//查询所有实体,不用或慎用!         
  • long count();//查询实体数量         
  • void delete(ID id);//根据Id删除实体         
  • void delete(T entity);//删除一个实体 
  • void delete(Iterable<? extends T> entities);//删除一个实体的集合         
  • void deleteAll();//删除所有实体,不用或慎用! 


四、PagingAndSortingRepository接口

PagingAndSortingRepository接口提供了分页与排序的功能:

  • Iterable<T> findAll(Sort sort); //排序 
  • Page<T> findAll(Pageable pageable); //分页查询(含排序功能) 


五、JpaRepository接口

JpaRepository接口提供了JPA的相关功能: 

  • List<T> findAll(); //查找所有实体 
  • List<T> findAll(Sort sort); //排序、查找所有实体 
  • List<T> save(Iterable<? extends T> entities);//保存集合 
  • void flush();//执行缓存与数据库同步 
  • T saveAndFlush(T entity);//强制执行持久化 
  • void deleteInBatch(Iterable<T> entities);//删除一个实体集合 


示例代码

Person实体类

  1. package com.test.springdata;
  2. import java.util.Date;
  3. import javax.persistence.Column;
  4. import javax.persistence.Entity;
  5. import javax.persistence.GeneratedValue;
  6. import javax.persistence.Id;
  7. import javax.persistence.JoinColumn;
  8. import javax.persistence.ManyToOne;
  9. import javax.persistence.Table;
  10. @Table(name= "JPA_PERSONS")
  11. @Entity
  12. public class Person {
  13. private Integer id;
  14. private String lastName;
  15. private String email;
  16. private Date birth;
  17. private Address address;
  18. private Integer addressId;
  19. @GeneratedValue
  20. @Id
  21. public Integer getId() {
  22. return id;
  23. }
  24. public void setId(Integer id) {
  25. this.id = id;
  26. }
  27. public String getLastName() {
  28. return lastName;
  29. }
  30. public void setLastName(String lastName) {
  31. this.lastName = lastName;
  32. }
  33. public String getEmail() {
  34. return email;
  35. }
  36. public void setEmail(String email) {
  37. this.email = email;
  38. }
  39. public Date getBirth() {
  40. return birth;
  41. }
  42. public void setBirth(Date birth) {
  43. this.birth = birth;
  44. }
  45. @Column(name= "ADD_ID")
  46. public Integer getAddressId() {
  47. return addressId;
  48. }
  49. public void setAddressId(Integer addressId) {
  50. this.addressId = addressId;
  51. }
  52. @JoinColumn(name= "ADDRESS_ID")
  53. @ManyToOne
  54. public Address getAddress() {
  55. return address;
  56. }
  57. public void setAddress(Address address) {
  58. this.address = address;
  59. }
  60. @Override
  61. public String toString() {
  62. return "Person [id=" + id + ", lastName=" + lastName + ", email="
  63. + email + ", brith=" + birth + "]";
  64. }
  65. }

Address实体类

  1. package com.test.springdata;
  2. import javax.persistence.Entity;
  3. import javax.persistence.GeneratedValue;
  4. import javax.persistence.Id;
  5. import javax.persistence.Table;
  6. @Table(name= "JPA_ADDRESSES")
  7. @Entity
  8. public class Address {
  9. private Integer id;
  10. private String province;
  11. private String city;
  12. @GeneratedValue
  13. @Id
  14. public Integer getId() {
  15. return id;
  16. }
  17. public void setId(Integer id) {
  18. this.id = id;
  19. }
  20. public String getProvince() {
  21. return province;
  22. }
  23. public void setProvince(String province) {
  24. this.province = province;
  25. }
  26. public String getCity() {
  27. return city;
  28. }
  29. public void setCity(String city) {
  30. this.city = city;
  31. }
  32. }

JpaRepsotory类 --- PersonRepsotory类

  1. package com.test.springdata;
  2. import java.util.Date;
  3. import java.util.List;
  4. import org.springframework.data.jpa.repository.JpaRepository;
  5. import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
  6. import org.springframework.data.jpa.repository.Modifying;
  7. import org.springframework.data.jpa.repository.Query;
  8. import org.springframework.data.repository.CrudRepository;
  9. import org.springframework.data.repository.PagingAndSortingRepository;
  10. import org.springframework.data.repository.Repository;
  11. import org.springframework.data.repository.RepositoryDefinition;
  12. import org.springframework.data.repository.query.Param;
  13. /**
  14. * 1、Repository 是一个空接口,即使一个标记接口
  15. * 2、若我们定义的接口继承了Repository,则该接口会被IOC容器识别为一个Repository Bean
  16. * 纳入到IOC容器中,进而可以在该接口中定义满足一定规范的方法
  17. * 3、可以通过注解的方式标记Repository接口
  18. */
  19. /**
  20. * 方式一:继承Repository <Person,Integer>接口
  21. * public interface PersonRepsotory extends Repository <Person,Integer>{
  22. * */
  23. /**
  24. * 方式二:注解@RepositoryDefinition(domainClass=Person.class,idClass=Integer.class)
  25. *
  26. */
  27. /**
  28. * 在Repository子接口中声明方法
  29. * 1、不是随便声明的,而需要符合一定的规范
  30. * 2、查询方法以find | read | get开头
  31. * 3、涉及条件查询时,条件的属性用条件关键字连接
  32. * 4、要注意的是:条件属性以首字母大写
  33. * 5、支持属性的级联查询,若当前类有符合条件的属性,则优先使用,而不使用级联属性。若需要使用级联属性,则属性之间使用_连接
  34. *
  35. */
  36. // @RepositoryDefinition(domainClass=Person.class,idClass=Integer.class)
  37. //public interface PersonRepsotory extends Repository <Person, Integer>{
  38. //public interface PersonRepsotory extends CrudRepository <Person, Integer>{
  39. //public interface PersonRepsotory extends JpaRepository <Person, Integer>,JpaSpecificationExecutor <Person>{
  40. public interface PersonRepsotory extends Repository <Person, Integer>{
  41. // 根据lastName来获取对应的Person
  42. Person getByLastName(String lastName);
  43. // Where lastName like ?% And id < ?
  44. List< Person> getByLastNameStartingWithAndIdLessThan(String lastName, Integer id);
  45. // Where lastName like %? And id < ?
  46. List< Person> getByLastNameEndingWithAndIdLessThan(String lastName, Integer id);
  47. //WHERE email IN (?, ?, ?) OR birth < ?
  48. List< Person> getByEmailInAndBirthLessThan(List <String> emails, Date birth);
  49. //WHERE a.id > ?
  50. List <Person> getByAddress_IdGreaterThan(Integer id);
  51. //查询 id 值最大的那个 Person
  52. //使用 @Query 注解可以自定义 JPQL 语句以实现更灵活的查询
  53. @Query("SELECT p FROM Person p WHERE p.id = (SELECT max(p2.id) FROM Person p2)")
  54. Person getMaxIdPerson();
  55. //为 @Query 注解传递参数的方式1: 使用占位符.
  56. @Query("SELECT p FROM Person p WHERE p.lastName = ?1 AND p.email = ?2")
  57. List <Person> testQueryAnnotationParams1(String lastName, String email);
  58. //为 @Query 注解传递参数的方式1: 命名参数的方式.
  59. @Query("SELECT p FROM Person p WHERE p.lastName = :lastName AND p.email = :email")
  60. List <Person> testQueryAnnotationParams2(@Param("email") String email, @Param("lastName") String lastName);
  61. //SpringData 允许在占位符上添加 %%.
  62. @Query("SELECT p FROM Person p WHERE p.lastName LIKE %?1% OR p.email LIKE %?2%")
  63. List <Person> testQueryAnnotationLikeParam(String lastName, String email);
  64. //SpringData 允许在占位符上添加 %%.
  65. @Query("SELECT p FROM Person p WHERE p.lastName LIKE %:lastName% OR p.email LIKE %:email%")
  66. List <Person> testQueryAnnotationLikeParam2(@Param("email") String email, @Param("lastName") String lastName);
  67. //设置 nativeQuery=true 即可以使用原生的 SQL 查询
  68. @Query(value="SELECT count(id) FROM jpa_persons", nativeQuery=true)
  69. long getTotalCount();
  70. //可以通过自定义的 JPQL 完成 UPDATE 和 DELETE 操作. 注意: JPQL 不支持使用 INSERT
  71. //在 @Query 注解中编写 JPQL 语句, 但必须使用 @Modifying 进行修饰. 以通知 SpringData, 这是一个 UPDATE 或 DELETE 操作
  72. //UPDATE 或 DELETE 操作需要使用事务, 此时需要定义 Service 层. 在 Service 层的方法上添加事务操作.
  73. //默认情况下, SpringData 的每个方法上有事务, 但都是一个只读事务. 他们不能完成修改操作!
  74. @Modifying
  75. @Query("UPDATE Person p SET p.email = :email WHERE id = :id")
  76. void updatePersonEmail(@Param("id") Integer id, @Param("email") String email);
  77. }


PersonService类

  1. package com.test.springdata;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.stereotype.Service;
  5. import org.springframework.transaction.annotation.Transactional;
  6. @Service
  7. public class PersonService {
  8. @Autowired
  9. private PersonRepsotory personRepsotory;
  10. @Transactional
  11. public void savePersons(List<Person> persons){
  12. personRepsotory.save(persons);
  13. }
  14. @Transactional
  15. public void updatePersonEmail(String email, Integer id){
  16. personRepsotory.updatePersonEmail(id, email);
  17. }
  18. }

Test类

  1. package com.test.springdata.test;
  2. import java.io.FileNotFoundException;
  3. import java.io.IOException;
  4. import java.sql.SQLException;
  5. import java.util.ArrayList;
  6. import java.util.Arrays;
  7. import java.util.Date;
  8. import java.util.List;
  9. import javax.persistence.criteria.CriteriaBuilder;
  10. import javax.persistence.criteria.CriteriaQuery;
  11. import javax.persistence.criteria.Path;
  12. import javax.persistence.criteria.Predicate;
  13. import javax.persistence.criteria.Root;
  14. import javax.sql.DataSource;
  15. import org.junit.Test;
  16. import org.springframework.context.ApplicationContext;
  17. import org.springframework.context.support.ClassPathXmlApplicationContext;
  18. import org.springframework.data.domain.Page;
  19. import org.springframework.data.domain.PageRequest;
  20. import org.springframework.data.domain.Sort;
  21. import org.springframework.data.domain.Sort.Direction;
  22. import org.springframework.data.domain.Sort.Order;
  23. import org.springframework.data.jpa.domain.Specification;
  24. import com.test.springdata.Person;
  25. import com.test.springdata.PersonRepsotory;
  26. import com.test.springdata.PersonService;
  27. public class SpringDataTest {
  28. private ApplicationContext ctx = null;
  29. private PersonRepsotory personRepsotory = null;
  30. private PersonService personService;
  31. {
  32. ctx = new ClassPathXmlApplicationContext( "applicationContext.xml");
  33. personRepsotory = ctx.getBean(PersonRepsotory.class);
  34. personService = ctx.getBean(PersonService.class);
  35. }
  36. /*@Test
  37. public void testCommonCustomRepositoryMethod(){
  38. ApplicationContext ctx2 = new ClassPathXmlApplicationContext("classpath:com/atguigu/springdata/commonrepositorymethod/applicationContext2.xml");
  39. AddressRepository addressRepository = ctx2.getBean(AddressRepository.class);
  40. addressRepository.method();
  41. }
  42. @Test
  43. public void testCustomRepositoryMethod(){
  44. personRepsotory.test();
  45. }*/
  46. /**
  47. * 目标: 实现带查询条件的分页. id > 5 的条件
  48. *
  49. * 调用 JpaSpecificationExecutor 的 Page<T> findAll(Specification<T> spec, Pageable pageable);
  50. * Specification: 封装了 JPA Criteria 查询的查询条件
  51. * Pageable: 封装了请求分页的信息: 例如 pageNo, pageSize, Sort
  52. */
  53. /*@Test
  54. public void testJpaSpecificationExecutor(){
  55. int pageNo = 3 - 1;
  56. int pageSize = 5;
  57. PageRequest pageable = new PageRequest(pageNo, pageSize);
  58. //通常使用 Specification 的匿名内部类
  59. Specification<Person> specification = new Specification<Person>() {
  60. */ /**
  61. * @param *root: 代表查询的实体类.
  62. * @param query: 可以从中可到 Root 对象, 即告知 JPA Criteria 查询要查询哪一个实体类. 还可以
  63. * 来添加查询条件, 还可以结合 EntityManager 对象得到最终查询的 TypedQuery 对象.
  64. * @param *cb: CriteriaBuilder 对象. 用于创建 Criteria 相关对象的工厂. 当然可以从中获取到 Predicate 对象
  65. * @return: *Predicate 类型, 代表一个查询条件.
  66. */ /*
  67. @Override
  68. public Predicate toPredicate(Root<Person> root,
  69. CriteriaQuery<?> query, CriteriaBuilder cb) {
  70. Path path = root.get("id");
  71. Predicate predicate = cb.gt(path, 5);
  72. return predicate;
  73. }
  74. };
  75. Page<Person> page = personRepsotory.findAll(specification, pageable);
  76. System.out.println("总记录数: " + page.getTotalElements());
  77. System.out.println("当前第几页: " + (page.getNumber() + 1));
  78. System.out.println("总页数: " + page.getTotalPages());
  79. System.out.println("当前页面的 List: " + page.getContent());
  80. System.out.println("当前页面的记录数: " + page.getNumberOfElements());
  81. }*/
  82. /*@Test
  83. public void testJpaRepository(){
  84. Person person = new Person();
  85. person.setBirth(new Date());
  86. person.setEmail("[email protected]");
  87. person.setLastName("xyz");
  88. Person person2 = personRepsotory.saveAndFlush(person);
  89. System.out.println(person == person2);
  90. }*/
  91. /*@Test
  92. public void testPagingAndSortingRespository(){
  93. //pageNo 从 0 开始.
  94. int pageNo = 0;
  95. int pageSize = 5;
  96. //Pageable 接口通常使用的其 PageRequest 实现类. 其中封装了需要分页的信息
  97. //排序相关的. Sort 封装了排序的信息
  98. //Order 是具体针对于某一个属性进行升序还是降序.
  99. Order order1 = new Order(Direction.DESC, "id");
  100. Order order2 = new Order(Direction.ASC, "email");
  101. Sort sort = new Sort(order1, order2);
  102. PageRequest pageable = new PageRequest(pageNo, pageSize, sort);
  103. Page<Person> page = personRepsotory.findAll(pageable);
  104. System.out.println("总记录数: " + page.getTotalElements());
  105. System.out.println("当前第几页: " + (page.getNumber() + 1));
  106. System.out.println("总页数: " + page.getTotalPages());
  107. System.out.println("当前页面的 List: " + page.getContent());
  108. System.out.println("当前页面的记录数: " + page.getNumberOfElements());
  109. }*/
  110. @Test
  111. public void testCrudReposiory(){
  112. List<Person> persons = new ArrayList<>();
  113. for( int i = 'a'; i <= 'z'; i++){
  114. Person person = new Person();
  115. person.setAddressId(i + 1);
  116. person.setBirth( new Date());
  117. person.setEmail(( char)i + "" + ( char)i + "@atguigu.com");
  118. person.setLastName(( char)i + "" + ( char)i);
  119. persons.add(person);
  120. }
  121. personService.savePersons(persons);
  122. }
  123. @Test
  124. public void testModifying(){
  125. // personRepsotory.updatePersonEmail(1, "[email protected]");
  126. personService.updatePersonEmail( "[email protected]", 1);
  127. }
  128. @Test
  129. public void testNativeQuery(){
  130. long count = personRepsotory.getTotalCount();
  131. System.out.println(count);
  132. }
  133. @Test
  134. public void testQueryAnnotationLikeParam(){
  135. // List<Person> persons = personRepsotory.testQueryAnnotationLikeParam("%A%", "%bb%");
  136. // System.out.println(persons.size());
  137. // List<Person> persons = personRepsotory.testQueryAnnotationLikeParam("A", "bb");
  138. // System.out.println(persons.size());
  139. List<Person> persons = personRepsotory.testQueryAnnotationLikeParam2( "bb", "A");
  140. System.out.println(persons.size());
  141. }
  142. @Test
  143. public void testQueryAnnotationParams2(){
  144. List<Person> persons = personRepsotory.testQueryAnnotationParams2( "[email protected]", "AA");
  145. System.out.println(persons);
  146. }
  147. @Test
  148. public void testQueryAnnotationParams1(){
  149. List<Person> persons = personRepsotory.testQueryAnnotationParams1( "AA", "[email protected]");
  150. System.out.println(persons);
  151. }
  152. @Test
  153. public void testQueryAnnotation(){
  154. Person person = personRepsotory.getMaxIdPerson();
  155. System.out.println(person);
  156. }
  157. @Test
  158. public void testKeyWords2(){
  159. List<Person> persons = personRepsotory.getByAddress_IdGreaterThan( 1);
  160. System.out.println(persons);
  161. }
  162. @Test
  163. public void testKeyWords(){
  164. List<Person> persons = personRepsotory.getByLastNameStartingWithAndIdLessThan( "X", 10);
  165. System.out.println(persons);
  166. persons = personRepsotory.getByLastNameEndingWithAndIdLessThan( "X", 10);
  167. System.out.println(persons);
  168. persons = personRepsotory.getByEmailInAndBirthLessThan(Arrays.asList( "[email protected]", "[email protected]",
  169. "[email protected]"), new Date());
  170. System.out.println(persons.size());
  171. }
  172. @Test
  173. public void testHelloWorldSpringData() throws FileNotFoundException, IOException, InstantiationException, IllegalAccessException{
  174. System.out.println(personRepsotory.getClass().getName());
  175. Person person = personRepsotory.getByLastName( "AA");
  176. System.out.println(person);
  177. }
  178. @Test
  179. public void testJpa(){
  180. }
  181. @Test
  182. public void testDataSource() throws SQLException {
  183. DataSource dataSource = ctx.getBean(DataSource.class);
  184. System.out.println(dataSource.getConnection());
  185. }
  186. }

六、JpaSpecificationExecutor接口

不属于Repository体系,实现一组 JPA Criteria 查询相关的方法 


Specification:封装  JPA Criteria 查询条件。

通常使用匿名内部类的方式来创建该接口的对象


示例代码:

Test代码,其他代码参考JpaRepository

  1. /**
  2. * 目标: 实现带查询条件的分页. id > 5 的条件
  3. *
  4. * 调用 JpaSpecificationExecutor 的 Page<T> findAll(Specification<T> spec, Pageable pageable);
  5. * Specification: 封装了 JPA Criteria 查询的查询条件
  6. * Pageable: 封装了请求分页的信息: 例如 pageNo, pageSize, Sort
  7. */
  8. @Test
  9. public void testJpaSpecificationExecutor(){
  10. int pageNo = 3 - 1;
  11. int pageSize = 5;
  12. PageRequest pageable = new PageRequest(pageNo, pageSize);
  13. //通常使用 Specification 的匿名内部类
  14. Specification<Person> specification = new Specification<Person>() {
  15. /**
  16. * @param *root: 代表查询的实体类.
  17. * @param query: 可以从中可到 Root 对象, 即告知 JPA Criteria 查询要查询哪一个实体类. 还可以
  18. * 来添加查询条件, 还可以结合 EntityManager 对象得到最终查询的 TypedQuery 对象.
  19. * @param *cb: CriteriaBuilder 对象. 用于创建 Criteria 相关对象的工厂. 当然可以从中获取到 Predicate 对象
  20. * @return: *Predicate 类型, 代表一个查询条件.
  21. */
  22. @Override
  23. public Predicate toPredicate(Root<Person> root,
  24. CriteriaQuery<?> query, CriteriaBuilder cb) {
  25. Path path = root.get( "id");
  26. Predicate predicate = cb.gt(path, 5);
  27. return predicate;
  28. }
  29. };
  30. Page<Person> page = personRepsotory.findAll(specification, pageable);
  31. System.out.println( "总记录数: " + page.getTotalElements());
  32. System.out.println( "当前第几页: " + (page.getNumber() + 1));
  33. System.out.println( "总页数: " + page.getTotalPages());
  34. System.out.println( "当前页面的 List: " + page.getContent());
  35. System.out.println( "当前页面的记录数: " + page.getNumberOfElements());
  36. }


七、自定义Repository接口

步骤:

  • 定义一个接口: 声明要添加的, 并自实现的方法
  • 提供该接口的实现类: 类名需在要声明的 Repository 后添加 Impl, 并实现方法
  • 声明 Repository 接口, 并继承 1) 声明的接口使用。
注意:  默认情况下, Spring Data 会在 base-package 中查找 "接口名Impl" 作为实现类. 也可以通过repository-impl-postfix 声明后缀


示例代码:

PersonDao接口

  1. package com.test.springdata;
  2. public interface PersonDao {
  3. void test();
  4. }

PersonDao实现类

  1. package com.test.springdata;
  2. import javax.persistence.EntityManager;
  3. import javax.persistence.PersistenceContext;
  4. public class PersonRepsotoryImpl implements PersonDao {
  5. @PersistenceContext
  6. private EntityManager entityManager;
  7. @Override
  8. public void test() {
  9. Person person = entityManager.find(Person.class, 11);
  10. System.out.println( "-->" + person);
  11. }
  12. }

PersonRepository类需要继承PersonDao接口


Test方法

  1. @Test
  2. public void testCustomRepositoryMethod(){
  3. personRepsotory.test();
  4. }


八、@Query注解

8.1 使用@Query自定义查询,这种查询可以声明在Repository方法中,摆脱像命名查询那样的约束,将查询直接在响应的接口方法中声明,结构更为清晰,这是Spring data的特有实现。

  1. //为 @Query 注解传递参数的方式1: 命名参数的方式.
  2. @Query( "SELECT p FROM Person p WHERE p.lastName = :lastName AND p.email = :email")
  3. List<Person> testQueryAnnotationParams2(@Param("email") String email, @Param("lastName") String lastName);

8.2 使用@Query的nativeQuery=true,这样可以使用原生的SQL查询

  1. //设置 nativeQuery=true 即可以使用原生的 SQL 查询
  2. @Query(value= "SELECT count(id) FROM jpa_persons", nativeQuery= true)
  3. long getTotalCount();

注:详细内容参考JpaRepository示例代码


九、@Modifying注解

在 @Query 注解中编写 JPQL 语句, 但必须使用 @Modifying 进行修饰. 以通知 SpringData, 这是一个 UPDATE 或 DELETE 操作

  1. //可以通过自定义的 JPQL 完成 UPDATE 和 DELETE 操作. 注意: JPQL 不支持使用 INSERT
  2. //在 @Query 注解中编写 JPQL 语句, 但必须使用 @Modifying 进行修饰. 以通知 SpringData, 这是一个 UPDATE 或 DELETE 操作
  3. //UPDATE 或 DELETE 操作需要使用事务, 此时需要定义 Service 层. 在 Service 层的方法上添加事务操作.
  4. //默认情况下, SpringData 的每个方法上有事务, 但都是一个只读事务. 他们不能完成修改操作!
  5. @Modifying
  6. @Query( "UPDATE Person p SET p.email = :email WHERE id = :id")
  7. void updatePersonEmail(@Param("id") Integer id, @Param("email") String email);

注意: 在调用的地方必须加事务,没有事务不能正常执行

猜你喜欢

转载自blog.csdn.net/M_Jack/article/details/80982363