Repository PagingAndSortingRepository

1. Spring Date: 在数据访问控制层上提供了一套数据访问层(DAO)的解决方案, 致力于减少数据访问层的开发量,

它使用一个叫做Repository的接口类为基础, 被定义为访问底层数据模型的超级接口.

而对于某种具体的数据访问操作, 则在其子接口中定义

public interface Repository<T, ID extends Seria;izable> {

}

我们只要定义接口, 遵循spring data的规范, 就无需写实现类

2.Repository(资源库): 通过用来访问领域对象的一个类似集合的接口

在领域中与数据映射层之间进行协调, 又叫DAO层 Repository

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

Repository: 仅仅是一个标识, 表明任何继承它的均为仓库接口类, 方便Spring自动扫描识别

CrudRepository: 继承Repository, 实现了一组CRUD相关方法

PagingAndSortingRepository: 继承CrudRepository, 实现了一组分页排序相关方法

JpaRepository: 继承PagingAndSortingRepository, 实现一组JPA规范相关方法

3.JpaRepository所提供的基本功能

      1.CrudRepository<T, ID extends Serializable>: 这个接口提供最基本的对实体类的增删改查操作

T save(T entity); // 保存单个实体

Iterable <T> save(Iterable<? extends T > entities); // 保存集合

T findOne(ID id); // 根据id 查找实体

boolean existes (ID id); // 根据id判断实体是否存在

Iterable <T> findAll(); // 查询所有实体, 尽量别用

long count(); // 查询实体数量

void delete(ID id); // 根据id 删除实体

void delete (T entity); // 删除一个实体

void delete (Interable < ? extends T > entityies); // 删除一个实体的集合

void deleteAll(); // 删除所有的实体, 尽量别用

2. PaginAndSortingRepository<T, ID extend Serializable>这个接口提供了分页与排序的功能

     Iterable<T> findAll (Sort sort);  // 排序

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

3.  JpaRepository<T, ID extends Serializable> 这个接口提供了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);//删除一个实体集合

4.Spring data 查询 简单条件查询: 查询某个实体类或者集合

按照Spring data定义的规则, 查询方法以find|read|get开头

涉及条件查询, 条件的属性用条件关键字连接, 要注意的是: 调价属性以首字母大写其余字母小写为规定.

例如: 定义一个Entity实体类

class User｛

private String firstname;

private String lastname;

｝

使用And条件连接时，应这样写：

findByLastnameAndFirstname(String lastname,String firstname);

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

5. 使用JPA NamedQueries (标准规范实现)

这种查询是标准的JPA 规范所定义的, 直接声明在Entity实体类上

调用时采用在接口中定义与命名查询对应的method, 由Spring Data根据方法命名法自动完成命名查询的查找

（1）在Entity实体类上使用@NamedQuery注解直接声明命名查询。

@Entity

@NamedQuery(name = "User.findByEmailAddress", 

 query = "select u from User u where u.emailAddress = ?1")

public class User {

}

注：定义多个时使用下面的注解

@NamedQueries(value = { 

        @NamedQuery(name = User.QUERY_FIND_BY_LOGIN,

                    query = "select u from User u where u." + User.PROP_LOGIN

                        + " = :username"),

    @NamedQuery(name = "getUsernamePasswordToken",

            query = "select new com.aceona.weibo.vo.TokenBO(u.username,u.password) from User u where u." + User.PROP_LOGIN

              + " = :username")})

（2）在interface中定义与(1)对应的方法

public interface UserRepository extends JpaRepository<User, Long> {

 List<User> findByLastname(String lastname);

 User findByEmailAddress(String emailAddress);

}

5. 使用Query自定义查询(Spring Data提供)

这种查询可以声明在Repository方法中, 摆脱像命名查询那样的约束, 将查询直接在相应的接口方法中声明. 结构更为清晰, 这是Spring Data的特有实现 

public interface UserRepository extends JpaRepository<User, Long> {

 @Query("select u from User u where u.emailAddress = ?1")

 User findByEmailAddress(String emailAddress);

}

@Query与 @Modifying 执行更新操作

这两个annotation一起声明，可定义个性化更新操作，例如只涉及某些字段更新时最为常用，示例如下：

@Modifying

@Query("update User u set u.firstname = ?1 where u.lastname = ?2")

int setFixedFirstnameFor(String firstname, String lastname);

索引参数与命名参数

（1）索引参数如下所示，索引值从1开始，查询中 ”?X” 个数需要与方法定义的参数个数相一致，并且顺序也要一致

@Modifying

@Query("update User u set u.firstname = ?1 where u.lastname = ?2")

int setFixedFirstnameFor(String firstname, String lastname);

（2）命名参数（推荐使用这种方式）

可以定义好参数名，赋值时采用@Param("参数名")，而不用管顺序。如下所示：

public interface UserRepository extends JpaRepository<User, Long> {

 @Query("select u from User u where u.firstname = :firstname or u.lastname = :lastname")

 User findByLastnameOrFirstname(@Param("lastname") String lastname,

                 @Param("firstname") String firstname);

}

6.Transactionalitty (事务)

  操作单个对象的事务

Spring Data 提供了默认的事务处理方式, 即所有的查询均为声明为只读事务, 对于持久化, 更新与删除对象声明为有事务

@org.springframework.stereotype.Repository

@Transactional(readOnly = true)

public class SimpleJpaRepository<T, ID extends Serializable> implements JpaRepository<T, ID>,

        JpaSpecificationExecutor<T> {

……

@Transactional

    public void delete(ID id) {

        delete(findOne(id));

    }

……

}

对于自定仪的方法, 如需改变spring data提供的事务默认方式, 可以在方法上注释@Transactional声明

涉及多个Repository的事务处理

进行多个Repository操作时，也应该使它们在同一个事务中处理，按照分层架构的思想，这部分属于业务逻辑层，因此，需要在Service层实现对多个Repository的调用，并在相应的方法上声明事务。

例如：

@Service(“userManagement”)

class UserManagementImpl implements UserManagement {

 private final UserRepository userRepository;

 private final RoleRepository roleRepository;

 @Autowired

 public UserManagementImpl(UserRepository userRepository, 

  RoleRepository roleRepository) {

  this.userRepository = userRepository;

  this.roleRepository = roleRepository;

 }

 @Transactional

 public void addRoleToAllUsers(String roleName) {

  Role role = roleRepository.findByName(roleName);

  for (User user : userRepository.readAll()) {

   user.addRole(role);

   userRepository.save(user);

  }

}

关于DAO层的规范

对于不需要写实现类的情况：

定义XxxxRepository 接口并继承JpaRepository接口，

如果Spring data所提供的默认接口方法不够用，可以使用@Query在其中定义个性化的接口方法。

对于需要写实现类的情况：

定义XxxxDao 接口并继承com.aceona.appleframework.persistent.data.GenericDao

书写XxxxDaoImpl实现类并继承com.aceona.appleframework.persistent.data.GenericJpaDao，

同时实现XxxxDao接口中的方法

在Service层调用XxxxRepository接口与XxxxDao接口完成相应的业务逻辑