SpingData的学习

Spring Data : Spring 的一个子项目,类似于Sping MVC 一样是Spring的另一个模块,所以还需要下载其jar ,它需要的jar有:

spring-data-jpa-1.11.8.RELEASE.jar

spring-data-commons-1.13.8.RELEASE.jar

slf4j-api-1.7.5.jar

没有添加slf4j会报错,Spring Data的版本不兼容也会报错,我在 使用SpringData出现java.lang.AbstractMethodError 这篇笔记中记载了,这里就不复述了。

Spring Data是用于简化数据库访问,支持NoSQL 和 关系数据存储。其主要目标是使数据库的访问变得方便快捷

SpringData 项目所支持 NoSQL 存储:

  • MongoDB (文档数据库)
  • Neo4j(图形数据库)
  • Redis(键/值存储)
  • Hbase(列族数据库)

SpringData 项目所支持的关系数据存储技术:

  • JDBC
  • JPA(我们一般将Spring Data与JPA配合使用)

JPA +Spring Data : 致力于减少数据访问层 (DAO) 的开发量. 开发者唯一要做的,就只是声明持久层的接口,其他都交给 Spring Data JPA 来帮你完成,很类似于Mybatis的mapper接口吧,但是我们一般使用的JPA实现产品都是Hibernate,所以并不像Mybatis那样还需要写SQL,最多写的就是JPQL(面向对象的写法)。

框架怎么会知道要使用什么样的业务逻辑呢?

比如:当有一个 UserDao.findUserById()  这样一个方法声明,大致应该能判断出这是根据给定条件的 ID 查询出满足条件的 User  对象。没错,Spring Data可以通过规范方法名字的方式,来确定方法具体需要实现什么样的逻辑。

准备工作

使用 Spring Data JPA 进行持久层开发需要的四个步骤:

1.配置 Spring 整合 JPA,添加jar包

2.在 Spring 配置文件中配置 Spring Data,让 Spring 为声明的接口创建代理对象。配置了 <jpa:repositories> 后(不要忘了在applicationContext.xml文件中添加jpa的约束),Spring 初始化容器时将会扫描 base-package  指定的包目录及其子目录,为继承 Repository 或其子接口的接口创建代理对象,并将代理对象注册为 Spring Bean,业务层便可以通过 Spring 自动注入的特性来直接使用该对象。

        <!-- 配置SpringDate -->
        <!-- 记得要加入jpa的约束 -->
        <!-- base-package: 扫描 Repository Bean 所在的 package
              自定义Repository中的方法是要注意Spring Data 会在 base-package 中查找 "接口名Impl" 作为实现类.
         entity-manager-factory-ref:引用EntityManagerFactory
         transaction-manager-ref:引用transactionManager-->
        <jpa:repositories base-package="cn.lynu.repository"
                   entity-manager-factory-ref="entityManagerFactory"
                   transaction-manager-ref="transactionManager"></jpa:repositories>

3.声明持久层的接口,该接口继承  Repository,Repository 是一个标记型接口,它不包含任何方法,如必要,Spring Data 可实现 Repository 其他子接口,其中定义了一些常用的增删改查,以及分页相关的方法。 在接口中声明需要的方法,在实际使用中我们让自定义的repository接口继承Repository的子接口,可以方便我们开发。

4.Spring Data 将根据给定的策略(也就是根据方法名)来生成实现代码。

Repository 接口

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

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

Spring Data可以让我们只定义接口,只要遵循 Spring Data的规范,就无需写实现类。

与继承 Repository 等价的一种方式,就是在持久层接口上使用 @RepositoryDefinition 注解,并为其指定 domainClass 和 idClass 属性。如下两种方式是完全等价的:

1.
@RepositoryDefinition(domainClass=Person.class,idClass=Integer.class)
public interface PersonRepository{}


2.
public interface PersonRepository extends Repository<Person, Integer>{}

Repository 的子接口

我们刚才说了,Repository接口中没有任何方法,所以我们可以继承其子接口,其子接口中提供了CRUD和分页的操作,开始了解一些这些子接口吧:

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

这些repository自下而上是一种继承关系。

CrudRepository接口

  • T save(T entity);//保存或更新单个实体(保存还是更新区别于是否有id)  
  • 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接口

该接口再上一个接口的基础上还提供了分页与排序功能 :

  • Iterable<T> findAll(Sort sort); //排序  
  • Page<T> findAll(Pageable pageable); //分页查询(含排序功能) 
    //使用继承了PagingAndSortingRepository的Repository
    @Test
    public void testPgae() {
        int pageNo=2-1;   //注意  这里是当前页要减1(从0开始)
        int size=5;
        Sort sort=new Sort(Direction.DESC, "age");   //指定排序方式和排序的属性
        //PageRequest是从Pageable接口的实现类
//        PageRequest pr=new PageRequest(pageNo, size);
        PageRequest pr=new PageRequest(pageNo, size,sort);  //还可以指定排序
        Page<Person> page = personRepository.findAll(pr);
        System.out.println("当前页:"+(page.getNumber()+1));  //而显示当前页时需要加1
        System.out.println("每页大小:"+page.getSize());
        System.out.println("总记录数:"+page.getTotalElements());
        System.out.println("总页数:"+page.getTotalPages());
        System.out.println("当前页的数据:"+page.getContent());
    }

JpaRepository接口

该接口在上一个接口的基础上还提供了这样的方法:

  • 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);//删除一个实体集合 
    //使用继承了JpaRepository的Repository
    //类似于JPA的merge方法  Hibernate的saveOrUpdate
    @Test
    public void testJPARepository() {
        Person person=new Person();
        person.setAge(21);
        person.setBirth(new Date());
        person.setpName("lz");
        
        Person person2 = personRepository.saveAndFlush(person);
        System.out.println(person==person2);
    }

我们自定义的 XxxxRepository 需要继承 JpaRepository,这样的 XxxxRepository 接口就具备了通用的数据访问控制层的能力。还有一个接口,它不属于Repository的体系中,但是它提供带查询条件的分页,很强大,它就是 JpaSpecificationExecutor 接口。普通分页我们使用继承了JpaRepository接口中的findAll方法进行开发即可,如果要进行带查询条件的分页,就还需要继承JpaSpecificationExecutor 接口,使用其内部的的findAll方法:

public interface PersonRepository extends JpaRepository<Person, Integer>,JpaSpecificationExecutor<Person>{}

 

   //实现带查询条件的分页要使用继承了JpaSpecificationExecutor的Repository
    @Test
    public void testCirPage() {
        int pageNo=2-1;   //注意  这里是当前页要减1(从0开始)
        int size=5;
        PageRequest pageable=new PageRequest(pageNo, size);

        //通常使用 Specification 的匿名内部类
        Specification<Person> specification=new Specification<Person>() {
            /**
             * @param *root: 代表查询的实体类. 
             * @param query: 可以从中可到 Root 对象, 即告知 JPA Criteria 查询要查询哪一个实体类. 还可以
             * 来添加查询条件, 还可以结合 EntityManager 对象得到最终查询 的 TypedQuery 对象. 
             * @param *cb: CriteriaBuilder 对象. 用于创建 Criteria 相关对象的工厂. 当然可以从中获取到 Predicate 对象
             * @return: *Predicate 类型, 代表一个查询条件. 
             */
            @Override
            public Predicate toPredicate(Root<Person> root, CriteriaQuery<?> query, CriteriaBuilder cb) {
                Path path = root.get("id");
                Predicate predicate=cb.gt(path, 5);   //gt表示> 大于  lt表示< 小于
                return predicate;
            }
        };
        
        Page<Person> page = personRepository.findAll(specification, pageable);
        System.out.println("当前页:"+(page.getNumber()+1));  //而显示当前页时需要加1
        System.out.println("每页大小:"+page.getSize());
        System.out.println("总记录数:"+page.getTotalElements());
        System.out.println("总页数:"+page.getTotalPages());
        System.out.println("当前页的数据:"+page.getContent());
        
    }

SpringData 方法规范

简单条件查询: 查询某一个实体类或者集合  按照 Spring Data 的规范,查询方法以 findBy | readBy | getBy 开头,注意By关键字也不要丢失哦。 涉及条件查询时,条件的属性用条件关键字连接,要注意的是:条件属性以首字母大写。 

例如:

//根据id查用户
    Person findById(Integer id);

    Person findById(Integer id);
    
    Person readById(Integer id);

如果有多个查询添加的话,需要使用And关键字连接:

//根据名称或年龄查询
    List<Person> findBypNameOrAge(String pName,Integer a);

对了,放心吧,方法的参数名可以自定义,但是其数据类型要与Entity的属性类型一致,不然会类型转换异常。

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

 

可能存在的一种特殊(很极端)情况:一个Emp实体类中有Dept 对象,Dept对象有Id属性,而Emp中有一个名为DeptId的属性,如何根据Dept的Id来查询?

如果写成  findByDeptId ,因为存在名为DeptId这个属性,所以就会按照这个属性来查询,如何区分这种同名的问题呢?这时可以明确在属性之间加上 "_" 以显式表达意图:findByDept_Id  表明是根据Emp实体中的Dept对象属性下的Id来查询 

这种根据方法名称查询的方法存在一定的命名约束,如果不按照该约束命名,还会以编译时异常的形式提示开发者,如何才能随心所欲的命名方法,而可以完成各种操作呢?这就需要@Query注解了。

@Query

@Query注解使用的是 org.springframework.data.jpa.repository.Query 包下的,注意不要导错了。我们就可以在Query注解中写JPQL语句了,这样既可以摆脱方法命名约束,还可以较为灵活的创建Dao方法。

    //使用@Query注解(可以不受命名约束)
    //使用占位符 方法的参数顺序需要与占位符一致(?号后必须指定当前参数位置,且从1开始)
    @Query("SELECT p from Person p where p.id=?1")
    Person testPersonById(Integer id);

了解过JPA的就知道了,这是使用?占位符的方式,可以指定?开始的顺序是从0还是1开始。当然,也可以使用名称占位符的形式:

    @Query("select p from Person p where p.id=:id or p.age=:age")
    List<Person> getIdOrAge(@Param("age")Integer age,@Param("id")Integer id);

使用名称占位符的时候,需要在方法的参数上使用@Param注解来指明该参数使用的是哪一个名称占位。

如果是 @Query 中有 LIKE 关键字,后面的参数需要前面或者后面加 %,这样在传递参数值的时候就可以不加 %:

    @Query("select p from Person p where p.pName like %?1%")
    List<Person> likepName(String name);
    
    @Query("select p from Person p where p.pName like %:name%")
    List<Person> likepName2(@Param("name")String name);

@Modifying 注解和事务

JPQL默认情况下只支持查询,不支持UPDATE和DELETE,这也是与HQL的不同之处,但是我们可以通过添加@Modifying注解来进行修饰. 以通知 SpringData, 这是一个 UPDATE 或 DELETE 操作。注意:不支持INSERT操作。

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

Spring Data默认给每个方法添加一个只读事务,注意是只读的事务,所以对于自定义的方法,如需改变 Spring Data 提供的事务默认方式,可以在方法上注解 @Transactional 声明 (这里说的就是在Service层加上事务).

为所有的 Repository 都添加自定义实现的方法

步骤:

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

 第一步:定义一个接口

package cn.lynu.dao;

/**
 * 自定义Repository使用(自定义方法的仓库接口)
 *在这个接口中写需要自定义的仓库方法
 */
public interface PersonDao {
    void test();
}

第二步:添加一个以Impl结尾的实现类

package cn.lynu.repository;

import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import cn.lynu.dao.PersonDao;
import cn.lynu.entity.Person;

//自定义repository使用(命名规范:仓库名+Impl)
//在这里实现自定义方法的仓库接口中的方法
public class PersonRepositoryImpl implements PersonDao {
    
    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public void test() {
        Person person = entityManager.find(Person.class, 11);
        System.out.println("--->>"+person.getpName()+"--->"+person.getAge());
    }

}

第三步:我们的repository也需要继承这个PersonDao接口

public interface PersonRepository extends 
            JpaRepository<Person, Integer>,JpaSpecificationExecutor<Person>,PersonDao{}

这样我们就可以在所有继承了PersonDao的repository中使用我们自定义的test方法了:

    //使用自定义的repository的方法
    @Test
    public void testMyRepository() {
        personRepository.test();
    }

Spring MVC Spring Data Spring JPA整合

配置:

在web.xml中的配置:

基本上都是Spring和Spring MVC的配置, 还需要配置一个OpenEntityManagerInViewFilter 来处理no session 的懒加载问题,类似于在SSH整合中配的OpenSessionInView:

    <!-- 处理no session(懒加载异常)问题 -->
    <filter>
      <filter-name>OpenEntityManagerInViewFilter</filter-name>
      <filter-class>org.springframework.orm.jpa.support.OpenEntityManagerInViewFilter</filter-class>
    </filter>
    <filter-mapping>
      <filter-name>OpenEntityManagerInViewFilter</filter-name>
      <url-pattern>/*</url-pattern>
    </filter-mapping>

applicationContext.xml中的配置:

其实在  JPA的学习  中 与Spring的整合都已经说过了,现在就是再添加一行整合Spring Data的代码,我在这里再贴一份吧:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:jpa="http://www.springframework.org/schema/data/jpa"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd
        http://www.springframework.org/schema/data/jpa http://www.springframework.org/schema/data/jpa/spring-jpa-1.8.xsd
        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.3.xsd">

        <!-- 配置数据源 -->
        <context:property-placeholder location="classpath:db.properties"/>
        <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
          <property name="user" value="${jdbc.user}"></property>
          <property name="password" value="${jdbc.password}"></property>
          <property name="driverClass" value="${jdbc.driverClass}"></property>
          <property name="jdbcUrl" value="${jdbc.jdbcUrl}"></property>
        </bean>
        
        <!-- 配置entitymanagerFactory -->
        <bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
          <property name="dataSource" ref="dataSource"></property>
          <property name="jpaVendorAdapter">
             <bean class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter"></bean>
          </property>
          <property name="packagesToScan" value="cn.lynu.entity"></property>
          <property name="jpaProperties">
            <props>
                  <prop key="hibernate.ejb.naming_strategy">org.hibernate.cfg.ImprovedNamingStrategy</prop>
                <prop key="hibernate.hbm2ddl.auto">update</prop>
                <prop key="hibernate.show_sql">true</prop>
                <prop key="hibernate.format_sql">true</prop>
                <prop key="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</prop>
                <!-- 二级缓存和查询缓存 -->
                <prop key="hibernate.cache.use_second_level_cache">true</prop>
                <prop key="hibernate.cache.region.factory_class">org.hibernate.cache.ehcache.EhCacheRegionFactory</prop>
                <prop key="hibernate.cache.use_query_cache">true</prop>
            </props>
          </property>
          <!-- 只有JPA的实体类上使用@Cacheable(true)才使用二级缓存-->
          <property name="sharedCacheMode" value="ENABLE_SELECTIVE"></property>
        </bean>
        
        <!-- 配置组件扫描 -->
        <context:component-scan base-package="cn.lynu">
          <!-- 不在扫描@Controller 和@ControllerAdvice.因为已经在springmvc.xml中配置 -->
          <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
          <context:exclude-filter type="annotation" expression="org.springframework.web.bind.annotation.ControllerAdvice"/>
        </context:component-scan>
        
        <!-- JPA事务管理器 -->
        <bean id="transactionManager" class="org.springframework.orm.jpa.JpaTransactionManager">
          <property name="entityManagerFactory" ref="entityManagerFactory"></property>
        </bean>
        
        <!-- 事务注解 -->
        <tx:annotation-driven transaction-manager="transactionManager"/>
        
        <!-- 配置springData -->
        <jpa:repositories base-package="cn.lynu.repository"></jpa:repositories>
        
</beans>

整合过程使用二级缓存

在整合过程中,使用ehcache做二级缓存(还是Hibernate作为JPA的实现产品)的时候,使用Repository中自带的方法无法使用二级缓存,只有使用自定义的方法才可以,这是值得注意的。

  1. applicationContext.xml中配置二级缓存
  2. 实体类上使用@Cacheable(true) 表明该实体类使用二级缓存
  3. 自定义Repository中的方法,并配置@QueryHints
    @QueryHints({@QueryHint(name=org.hibernate.jpa.QueryHints.HINT_CACHEABLE,value="true")})
    @Query("select dept from Department dept")
    public List<Department> getAll();

 

posted @ 2017-11-04 15:16  OverZeal  阅读(340)  评论(0编辑  收藏  举报