附录

附录 A：命名空间参考

这`<repositories />`元素

这<repositories />元素触发 Spring Data 存储库基础设施的设置。最重要的属性是base-package，它定义了要扫描 Spring Data 存储库接口的包。请参阅“[repositories.create-instances.spring]”。下表描述了<repositories />元素：spring-doc.cadn.net.cn

表 6.属性
名称	描述
`base-package`spring-doc.cadn.net.cn	定义要扫描的软件包，以查找扩展的存储库接口`*Repository`（实际接口由具体的 Spring Data 模块决定）在自动检测模式下。配置的包下的所有包也会被扫描。允许使用通配符。spring-doc.cadn.net.cn
`repository-impl-postfix`spring-doc.cadn.net.cn	定义后缀以自动检测自定义存储库实现。名称以配置的后缀结尾的类被视为候选类。默认为`Impl`.spring-doc.cadn.net.cn
`query-lookup-strategy`spring-doc.cadn.net.cn	确定用于创建查找器查询的策略。有关详细信息，请参阅“[repositories.query-methods.query-lookup-strategies]”。默认为`create-if-not-found`.spring-doc.cadn.net.cn
`named-queries-location`spring-doc.cadn.net.cn	定义搜索包含外部定义查询的属性文件的位置。spring-doc.cadn.net.cn
`consider-nested-repositories`spring-doc.cadn.net.cn	是否应考虑嵌套存储库接口定义。默认为`false`.spring-doc.cadn.net.cn

附录 B：填充器命名空间引用

<填充器 /> 元素

这<populator />元素允许通过 Spring Data 存储库基础设施填充数据存储。^[1]spring-doc.cadn.net.cn

表7.属性
名称	描述
`locations`spring-doc.cadn.net.cn	应填充从存储库中读取对象的文件的位置。spring-doc.cadn.net.cn

附录 C：仓库查询关键字

支持的查询方法主题关键字

下表列出了 Spring Data 存储库查询派生机制通常支持的主题关键字，以表达谓词。有关受支持关键字的确切列表，请参阅特定于商店的文档，因为此处列出的某些关键字在特定商店中可能不受支持。spring-doc.cadn.net.cn

表8.查询主题关键字
关键词	描述
`find…By`,`read…By`,`get…By`,`query…By`,`search…By`,`stream…By`spring-doc.cadn.net.cn	常规查询方法通常返回存储库类型，`Collection`或`Streamable`子类型或结果包装器，例如`Page`,`GeoResults`或任何其他特定于商店的结果包装器。可用作`findBy…`,`findMyDomainTypeBy…`或与其他关键字结合使用。spring-doc.cadn.net.cn
`exists…By`spring-doc.cadn.net.cn	存在投影，通常返回`boolean`结果。spring-doc.cadn.net.cn
`count…By`spring-doc.cadn.net.cn	返回数字结果的计数投影。spring-doc.cadn.net.cn
`delete…By`,`remove…By`spring-doc.cadn.net.cn	删除查询方法，不返回任何结果（`void`）或删除计数。spring-doc.cadn.net.cn
`…First<number>…`,`…Top<number>…`spring-doc.cadn.net.cn	将查询结果限制为第一个`<number>`结果。此关键字可以出现在主题的任何地方`find`（和其他关键字）和`by`.spring-doc.cadn.net.cn
`…Distinct…`spring-doc.cadn.net.cn	使用非重复查询仅返回唯一结果。请参阅特定于商店的文档，了解是否支持该功能。此关键字可以出现在主题的任何地方`find`（和其他关键字）和`by`.spring-doc.cadn.net.cn

支持的查询方法谓词关键字和修饰符

下表列出了 Spring Data 存储库查询派生机制通常支持的谓词关键字。但是，请参阅特定于商店的文档，了解受支持关键字的确切列表，因为此处列出的某些关键字在特定商店中可能不受支持。spring-doc.cadn.net.cn

表 9.查询谓词关键字
逻辑关键字	关键字表达式
`AND`spring-doc.cadn.net.cn	`And`spring-doc.cadn.net.cn
`OR`spring-doc.cadn.net.cn	`Or`spring-doc.cadn.net.cn
`AFTER`spring-doc.cadn.net.cn	`After`,`IsAfter`spring-doc.cadn.net.cn
`BEFORE`spring-doc.cadn.net.cn	`Before`,`IsBefore`spring-doc.cadn.net.cn
`CONTAINING`spring-doc.cadn.net.cn	`Containing`,`IsContaining`,`Contains`spring-doc.cadn.net.cn
`BETWEEN`spring-doc.cadn.net.cn	`Between`,`IsBetween`spring-doc.cadn.net.cn
`ENDING_WITH`spring-doc.cadn.net.cn	`EndingWith`,`IsEndingWith`,`EndsWith`spring-doc.cadn.net.cn
`EXISTS`spring-doc.cadn.net.cn	`Exists`spring-doc.cadn.net.cn
`FALSE`spring-doc.cadn.net.cn	`False`,`IsFalse`spring-doc.cadn.net.cn
`GREATER_THAN`spring-doc.cadn.net.cn	`GreaterThan`,`IsGreaterThan`spring-doc.cadn.net.cn
`GREATER_THAN_EQUALS`spring-doc.cadn.net.cn	`GreaterThanEqual`,`IsGreaterThanEqual`spring-doc.cadn.net.cn
`IN`spring-doc.cadn.net.cn	`In`,`IsIn`spring-doc.cadn.net.cn
`IS`spring-doc.cadn.net.cn	`Is`,`Equals`，（或无关键字）spring-doc.cadn.net.cn
`IS_EMPTY`spring-doc.cadn.net.cn	`IsEmpty`,`Empty`spring-doc.cadn.net.cn
`IS_NOT_EMPTY`spring-doc.cadn.net.cn	`IsNotEmpty`,`NotEmpty`spring-doc.cadn.net.cn
`IS_NOT_NULL`spring-doc.cadn.net.cn	`NotNull`,`IsNotNull`spring-doc.cadn.net.cn
`IS_NULL`spring-doc.cadn.net.cn	`Null`,`IsNull`spring-doc.cadn.net.cn
`LESS_THAN`spring-doc.cadn.net.cn	`LessThan`,`IsLessThan`spring-doc.cadn.net.cn
`LESS_THAN_EQUAL`spring-doc.cadn.net.cn	`LessThanEqual`,`IsLessThanEqual`spring-doc.cadn.net.cn
`LIKE`spring-doc.cadn.net.cn	`Like`,`IsLike`spring-doc.cadn.net.cn
`NEAR`spring-doc.cadn.net.cn	`Near`,`IsNear`spring-doc.cadn.net.cn
`NOT`spring-doc.cadn.net.cn	`Not`,`IsNot`spring-doc.cadn.net.cn
`NOT_IN`spring-doc.cadn.net.cn	`NotIn`,`IsNotIn`spring-doc.cadn.net.cn
`NOT_LIKE`spring-doc.cadn.net.cn	`NotLike`,`IsNotLike`spring-doc.cadn.net.cn
`REGEX`spring-doc.cadn.net.cn	`Regex`,`MatchesRegex`,`Matches`spring-doc.cadn.net.cn
`STARTING_WITH`spring-doc.cadn.net.cn	`StartingWith`,`IsStartingWith`,`StartsWith`spring-doc.cadn.net.cn
`TRUE`spring-doc.cadn.net.cn	`True`,`IsTrue`spring-doc.cadn.net.cn
`WITHIN`spring-doc.cadn.net.cn	`Within`,`IsWithin`spring-doc.cadn.net.cn

除了筛选谓词外，还支持以下修饰符列表：spring-doc.cadn.net.cn

表 10.查询谓词修饰符关键字
关键词	描述
`IgnoreCase`,`IgnoringCase`spring-doc.cadn.net.cn	与谓词关键字一起使用，以进行不区分大小写的比较。spring-doc.cadn.net.cn
`AllIgnoreCase`,`AllIgnoringCase`spring-doc.cadn.net.cn	忽略所有合适属性的大小写。在查询方法谓词中的某个位置使用。spring-doc.cadn.net.cn
`OrderBy…`spring-doc.cadn.net.cn	指定静态排序顺序，后跟属性路径和方向（例如`OrderByFirstnameAscLastnameDesc`).spring-doc.cadn.net.cn

附录 D：存储库查询返回类型

支持的查询返回类型

下表列出了 Spring Data 存储库通常支持的返回类型。但是，请参阅特定于存储的文档以获取受支持的返回类型的确切列表，因为此处列出的某些类型可能在特定存储中不受支持。spring-doc.cadn.net.cn

地理空间类型（例如GeoResult,GeoResults和GeoPage）仅适用于支持地理空间查询的数据存储。某些存储模块可能会定义自己的结果包装器类型。

表 11.查询返回类型
返回类型	描述
`void`spring-doc.cadn.net.cn	表示没有返回值。spring-doc.cadn.net.cn
原spring-doc.cadn.net.cn	Java 原语。spring-doc.cadn.net.cn
包装器类型spring-doc.cadn.net.cn	Java 包装器类型。spring-doc.cadn.net.cn
`T`spring-doc.cadn.net.cn	唯一实体。期望查询方法最多返回一个结果。如果未找到结果，`null`返回。多个结果触发`IncorrectResultSizeDataAccessException`.spring-doc.cadn.net.cn
`Iterator<T>`spring-doc.cadn.net.cn	一`Iterator`.spring-doc.cadn.net.cn
`Collection<T>`spring-doc.cadn.net.cn	一个`Collection`.spring-doc.cadn.net.cn
`List<T>`spring-doc.cadn.net.cn	一个`List`.spring-doc.cadn.net.cn
`Optional<T>`spring-doc.cadn.net.cn	Java 8 或番石榴`Optional`. 期望查询方法最多返回一个结果。如果未找到结果，`Optional.empty()`或`Optional.absent()`返回。多个结果触发`IncorrectResultSizeDataAccessException`.spring-doc.cadn.net.cn
`Option<T>`spring-doc.cadn.net.cn	Scala 或 Vavr`Option`类型。语义上与 Java 8 的行为相同`Optional`，前面描述。spring-doc.cadn.net.cn
`Stream<T>`spring-doc.cadn.net.cn	Java 8`Stream`.spring-doc.cadn.net.cn
`Streamable<T>`spring-doc.cadn.net.cn	便利的扩展`Iterable`该 Directy 公开了流式传输、映射和过滤结果、连接它们等的方法。spring-doc.cadn.net.cn
实现的类型`Streamable`并采取一个`Streamable`构造函数或工厂方法参数spring-doc.cadn.net.cn	公开构造函数或`….of(…)`/`….valueOf(…)`工厂方法采用`Streamable`作为参数。有关详细信息，请参阅 [repositories.collections-and-iterables.streamable-wrapper]。spring-doc.cadn.net.cn
瓦夫尔`Seq`,`List`,`Map`,`Set`spring-doc.cadn.net.cn	Vavr 集合类型。有关详细信息，请参阅 [repositories.collections-and-iterables.vavr]。spring-doc.cadn.net.cn
`Future<T>`spring-doc.cadn.net.cn	一个`Future`. 期望一个方法被注释`@Async`并且需要启用 Spring 的异步方法执行能力。spring-doc.cadn.net.cn
`CompletableFuture<T>`spring-doc.cadn.net.cn	Java 8`CompletableFuture`. 期望一个方法被注释`@Async`并且需要启用 Spring 的异步方法执行能力。spring-doc.cadn.net.cn
`ListenableFuture`spring-doc.cadn.net.cn	一个`org.springframework.util.concurrent.ListenableFuture`. 期望一个方法被注释`@Async`并且需要启用 Spring 的异步方法执行能力。spring-doc.cadn.net.cn
`Slice<T>`spring-doc.cadn.net.cn	一个大小的数据块，指示是否有更多可用数据。需要一个`Pageable`method 参数。spring-doc.cadn.net.cn
`Page<T>`spring-doc.cadn.net.cn	一个`Slice`，以及其他信息，例如结果总数。需要`Pageable`method 参数。spring-doc.cadn.net.cn
`GeoResult<T>`spring-doc.cadn.net.cn	包含附加信息（例如到参考位置的距离）的结果条目。spring-doc.cadn.net.cn
`GeoResults<T>`spring-doc.cadn.net.cn	列表`GeoResult<T>`以及附加信息，例如到参考位置的平均距离。spring-doc.cadn.net.cn
`GeoPage<T>`spring-doc.cadn.net.cn	一个`Page`跟`GeoResult<T>`，例如到参考位置的平均距离。spring-doc.cadn.net.cn
`Mono<T>`spring-doc.cadn.net.cn	项目反应堆`Mono`使用响应式存储库发出零个或一个元素。期望查询方法最多返回一个结果。如果未找到结果，`Mono.empty()`返回。多个结果触发`IncorrectResultSizeDataAccessException`.spring-doc.cadn.net.cn
`Flux<T>`spring-doc.cadn.net.cn	项目反应堆`Flux`使用响应式存储库发出零个、一个或多个元素。返回的查询`Flux`还可以发射无限数量的元素。spring-doc.cadn.net.cn
`Single<T>`spring-doc.cadn.net.cn	一个 RxJava`Single`使用响应式存储库发出单个元素。期望查询方法最多返回一个结果。如果未找到结果，`Mono.empty()`返回。多个结果触发`IncorrectResultSizeDataAccessException`.spring-doc.cadn.net.cn
`Maybe<T>`spring-doc.cadn.net.cn	一个 RxJava`Maybe`使用响应式存储库发出零个或一个元素。期望查询方法最多返回一个结果。如果未找到结果，`Mono.empty()`返回。多个结果触发`IncorrectResultSizeDataAccessException`.spring-doc.cadn.net.cn
`Flowable<T>`spring-doc.cadn.net.cn	一个 RxJava`Flowable`使用响应式存储库发出零个、一个或多个元素。返回的查询`Flowable`还可以发射无限数量的元素。spring-doc.cadn.net.cn

附录