org.springframework.data spring-data-releasetrain  ${release-train} import pom  

如果你正在使用Spring Boot时，它已经给你选择了一个最近的Spring Data版本。

Spring Data仓库抽象化的中心接口是Repository，它使用域的类和ID的类型作为泛型参数。这个接口作为标记接口的角色，捕获你要使用的类型，并帮助你发现继承此类型的接口，CrudRepository为管理的实体类提供了复杂的CRUD功能。

public interface CrudRepository extends Repository {   S save(S entity);  Optional findById(ID primaryKey);  Iterable findAll();  long count();  void delete(T entity);  boolean existsById(ID primaryKey);  // … more functionality omitted. }

我们也提供了特殊技术的持久化抽象，例如：JpaRepository、MongoRepository等。这些接口都继承了CrudRepository，并且输出了各自持久化技术的能力。

PagingAndSortingRepository接口继承了CrudRepository，并添加了一些额外的分页功能：

public interface PagingAndSortingRepository extends CrudRepository {  Iterable findAll(Sort sort);  Page findAll(Pageable pageable); }

访问一个实体第二页的例子如下：

PagingAndSortingRepository repository = // … get access to a bean Page users = repository.findAll(new PageRequest(1, 20));

通过这些方法，还衍生出了删除和统计的功能，如下：

interface UserRepository extends CrudRepository {  long countByLastname(String lastname); }

interface UserRepository extends CrudRepository {  long deleteByLastname(String lastname);  List removeByLastname(String lastname); }

查询方法：

标准的CRUD方法在底层的数据存储上都有对应的查询，使用SpringData，声明这些查询分为4步：

1、声明接口继承Repository或者Repository的子类，并标注实体类型和ID类型

interface PersonRepository extends Repository { … }

interface PersonRepository extends Repository {  List findByLastname(String lastname); }

3、设置Spring生成接口代理

import org.springframework.data.jpa.repository.config.EnableJpaRepositories; @EnableJpaRepositories class Config {}

或者使用xml的方式：

上面的例子中，使用了Jpa的命名空间，如果你使用其他仓库的抽象，换成其他仓库对应的命名空间即可，例如：你正在使用MongoDB，可以换成MongoDB对应的命名空间。

值得注意的是，JavaConfig并没有默认配置注解类的路径作为包路径，在xml中，扫描包路径的参数配置在base-package参数中，对应的javaConfig将使用注解@Enable-*。

4、获取注入的Repository实例，并使用它

class SomeClient {  private final PersonRepository repository;  SomeClient(PersonRepository repository) {  this.repository = repository;  }  void doSomething() {  List persons = repository.findByLastname("Matthews");  } }

接下来我们将详细介绍每一步。

定义仓库接口

第一步，你定义一个指定实体类的仓库接口，这个接口必须继承Repository并且定义了实体类型和ID类型，如果你想输出Crud方法，你要继承CrudRepository，不要继承Repository。

典型的，你的仓库接口继承Repository, CrudRepository 或者 PagingAndSortingRepository。要不然，如果你不想继承Spring Data的接口，你也可以使用@RepositoryDefinition注解你自己的仓库接口。继承CrudRepository将输出一套完成的方法集来操作你的实体，如果你想选择一些方法输出，最简单的方法是从CrudRepository中复制你想要输出的方法到你自己的仓库中。这些将允许你在Spring Data仓库方法中的最顶端定义你自己的抽象。

@NoRepositoryBean

interface MyBaseRepository extends Repository {

Optional findById(ID id);

S save(S entity);

}

interface UserRepository extends MyBaseRepository {

User findByEmailAddress(EmailAddress emailAddress);

}

在第一步中，你定义了一个公用的基础接口，并且输出了findById和save方法。这些方法将路由到你选择的存储的基础仓库实现中。这个例子中，如果你定义了SimpleJpaRepository，因为它匹配了CrudRepository方法中的特性，所以UserRepository可以保存users，通过id查找users或者通过email查找users。值得注意的是，中间仓库接口使用@NoRepositoryBean注解，确保你给所有的仓库接口添加注解，Spring Data在运行期将不会创建实例。

仓库方法中的null处理

作为Spring Data2.0，CRUD方法返回一个使用java8的Optional的独立的聚合实例，标明值的潜在缺少。除此之外，Spring Data支持在查询方法上返回其他的封装类型。或者，查询方法可以选择根本不使用封装类型。缺少查询接口将通过返回null标明。仓库方法返回集合、封装类型和流来保护不返回null。

空值注解

你可以使用Spring的空值注解来表达仓库的空值约束。它提供了在运行期的空值检查。

• @NonNullApi 在包级别使用，标明参数的默认行为，返回的结果不接受和生成null值。

• @NonNull 在参数或者返回值上使用，他们不允许为null。

• @Nullabe 在参数或者返回值上使用，他们允许为null。

Spring注解是用JSR305的元注解，JSR 305允许工具方IDEA、Eclipse等在通用的方法中提供空安全性的支持，不必提供Spring注解的硬编码支持。为了提供运行期的空值约束检查，你需要使非空值活动在包级别中，在package-info.java中使用@NonNullApi。

@org.springframework.lang.NonNullApi package com.acme;

一旦非空定义在这个地方，仓库的查询方法在运行期将得到一个空约束的验证。如果查询结果违反了约束，将会抛出异常，例如，在一些条件下方法返回了null，但是已经声明了非空。如果你想选择性的使用空结果，选择@Nullable注解，使用前面提到的封装类型将继续按照希望的那样工作，例如空结果将会转入到那个值中。

使用不同空约束的例子：

package com.acme; import org.springframework.lang.Nullable; interface UserRepository extends Repository {  User getByEmailAddress(EmailAddress emailAddress);  @Nullable User findByEmailAddress(@Nullable EmailAddress emailAdress);  Optional findOptionalByEmailAddress(EmailAddress emailAddress); }

在前面的例子中，我们已经在package-info.java中，定义了非空的行为。

第一个方法，查询的执行没有产生结果，将抛出EmptyResultDataAccessException异常，emailAddress如果传入空，将抛出IllegalArgumentException。

第二个方法如果没有查询结果将返回null，传入的参数也接受null。

第三个方法如果没有查询结果将返回Optional.empty()，如果传入空参数将抛出IllegalArgumentException。

在你的项目中使用唯一的Spring Data模块是非常简单的，定义范围内的所有仓库接口都绑定到Spring Data模块。有时，应用需要使用多个Spring Data模块。这种情况下，需要仓库定义区分不同的持久化技术。Spring Data记录严格的仓库配置模型，因为它在类路径下检测到多个仓库配置元素。严格的配置需要在仓库或者实体类上的细节决定Spring Data绑定哪个仓库定义。

如果仓库定义继承了指定的模块仓库，它是一个有效的特殊的Spring Data模块的申请者。

如果实体类中使用了指定模块的注解，它是一个有效的特殊的Spring Data模块的申请者。Spring Data接受第三方的注解（如：jpa）或者自己提供的注解（如：mongodb）。

仓库定义使用指定模块接口：

interface MyRepository extends JpaRepository { } @NoRepositoryBean interface MyBaseRepository extends JpaRepository { … } interface UserRepository extends MyBaseRepository { … }

MyBaseRepository和UserRepository都继承了JpaRepository，所以他们都是有效的Jpa模块的申请者。

仓库定义使用通用的接口：

interface AmbiguousRepository extends Repository { … } @NoRepositoryBean interface MyBaseRepository extends CrudRepository { … } interface AmbiguousUserRepository extends MyBaseRepository { … }

AmbiguousRepository和AmbiguousUserRepository只继承了Repository和CrudRepository，这种情况在使用了唯一的Spring Data模块时是可行的，在多模块的情况，它是不能区分使用哪个具体模块的。

仓库定义使用实体类注解:

interface PersonRepository extends Repository { … } @Entity class Person { … } interface UserRepository extends Repository { … } @Document class User { … }

PersonRepository相关的Person使用了Jpa的@Entity注解，所以，它的仓库属于Jpa。UserRepository使用注解了@Document的User，所以它属于MongoDB。

仓库定义使用混合注解实体类：

interface JpaPersonRepository extends Repository { … } interface MongoDBPersonRepository extends Repository { … } @Entity @Document class Person { … }

这个例子中，实体类即使用了Jpa注解，又使用了MongoDB注解。它定义了两个仓库：JpaPersonRepository和MongoDBPersonRepository。一个给Jpa使用，另一个给MongoDB使用。这种导致未定义的行为使Spring Data不再有能力区分仓库的类型。

仓库类型详情和指定实体类注解，用来严格区分仓库指向哪一个Spring Data模块。在一个实体类中使用多个实体技术注解可以服用实体类，但是Spring Data将不能指定仓库绑定哪一个Spring Data模块。区分仓库的最后一个方法是规范仓库基础包的路径。基础包定义了扫描的开始点，仓库接口都在适合的包中。

基础包的注解驱动配置：

@EnableJpaRepositories(basePackages = "com.acme.repositories.jpa") @EnableMongoRepositories(basePackages = "com.acme.repositories.mongo") interface Configuration { }

定义查询方法

仓库代理有两种方式导出指定仓库的查询。它可以从名字直接导出查询，或者使用手工定义的查询。可用的选项取决于实际的存储。可是，它有一个策略决定哪一个查询被生成。

查询查找策略

下面的策略是可用的仓库解决查询的基础。你可以在命名空间配置策略，通过xml文件中的query-lookup-strategy参数或者Enable*的注解中的queryLookupStrategy参数。一些策略在特殊的存储中不被支持。

• CREATE尝试从方法名中构造指定仓库的查询方法，大概的方法是从方法名中移除一个给定的众所周知的前缀，然后解析剩余的部分。

• USE_DECLARED_QUERY尝试找到声明的查询，如果找不到，将抛出异常。查询通过注解或其他方法的声明定义。查看指定存储的文档找到可用的选项。如果仓库不能找到存储声明的查询，它将失败。

• CREATE_IF_NOT_FOUND结合了CREATE和USE_DECLARED_QUERY。它首先查找声明的查询，如果不能找到，它将生成一个基于命名的查询。这是默认的查询策略。它可以通过方法名字快速的生成查询，也可以通过查询的声明生成查询。

由于公共模块是Spring Data的基础，内容比较多，所以这章先介绍到这里，命名的具体规则将在下一篇介绍。

閱讀更多 溫榆河大咖 的文章

關鍵字: Eclipse 公共 NoSQL