此版本仍在开发中,尚未被视为稳定版本。如需最新稳定版本,请使用 Spring Data Cassandra 5.0.4spring-doc.cadn.net.cn

仓库查询关键字

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

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

表1. 查询主题关键字
关键字 描述

find…By, read…By, get…By, query…By, search…By, stream…Byspring-doc.cadn.net.cn

通用查询方法,通常返回仓库类型、CollectionStreamable 的子类型,或诸如 PageGeoResults 等任意特定于数据存储的结果包装器。可作为 findBy…findMyDomainTypeBy… 使用,或与其他关键字组合使用。spring-doc.cadn.net.cn

exists…Byspring-doc.cadn.net.cn

Exists 投影,通常返回一个 boolean 类型的结果。spring-doc.cadn.net.cn

count…Byspring-doc.cadn.net.cn

返回数值结果的计数投影。spring-doc.cadn.net.cn

delete…By, remove…Byspring-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

使用一个 distinct 查询仅返回唯一的结果。请查阅特定数据存储的文档,以确认是否支持该特性。此关键字可以出现在主题中 find(以及其他关键字)和 by 之间的任意位置。spring-doc.cadn.net.cn

保留方法

下表列出了使用预定义功能的保留方法(如 CrudRepository 中所定义)。 这些方法会直接在仓库代理的底层(特定于存储)实现上调用。 另请参阅“定义查询方法”。spring-doc.cadn.net.cn

表2. 保留方法

deleteAllById(Iterable<ID> identifiers)spring-doc.cadn.net.cn

deleteById(ID identifier)spring-doc.cadn.net.cn

existsById(ID identifier)spring-doc.cadn.net.cn

findAllById(Iterable<ID> identifiers)spring-doc.cadn.net.cn

findById(ID identifier)spring-doc.cadn.net.cn

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

下表列出了 Spring Data 仓库查询派生机制通常支持的谓词关键字。 然而,请查阅特定数据存储的文档以获取确切支持的关键字列表,因为此处列出的某些关键字在特定的数据存储中可能不受支持。spring-doc.cadn.net.cn

表3. 查询谓词关键字
逻辑关键字 关键字表达式

ANDspring-doc.cadn.net.cn

Andspring-doc.cadn.net.cn

ORspring-doc.cadn.net.cn

Orspring-doc.cadn.net.cn

AFTERspring-doc.cadn.net.cn

After, IsAfterspring-doc.cadn.net.cn

BEFOREspring-doc.cadn.net.cn

Before, IsBeforespring-doc.cadn.net.cn

CONTAININGspring-doc.cadn.net.cn

Containing, IsContaining, Containsspring-doc.cadn.net.cn

BETWEENspring-doc.cadn.net.cn

Between, IsBetweenspring-doc.cadn.net.cn

ENDING_WITHspring-doc.cadn.net.cn

EndingWith, IsEndingWith, EndsWithspring-doc.cadn.net.cn

EXISTSspring-doc.cadn.net.cn

Existsspring-doc.cadn.net.cn

FALSEspring-doc.cadn.net.cn

False, IsFalsespring-doc.cadn.net.cn

GREATER_THANspring-doc.cadn.net.cn

GreaterThan, IsGreaterThanspring-doc.cadn.net.cn

GREATER_THAN_EQUALSspring-doc.cadn.net.cn

GreaterThanEqual, IsGreaterThanEqualspring-doc.cadn.net.cn

INspring-doc.cadn.net.cn

In, IsInspring-doc.cadn.net.cn

ISspring-doc.cadn.net.cn

IsEquals(或无关键字)spring-doc.cadn.net.cn

IS_EMPTYspring-doc.cadn.net.cn

IsEmpty, Emptyspring-doc.cadn.net.cn

IS_NOT_EMPTYspring-doc.cadn.net.cn

IsNotEmpty, NotEmptyspring-doc.cadn.net.cn

IS_NOT_NULLspring-doc.cadn.net.cn

NotNull, IsNotNullspring-doc.cadn.net.cn

IS_NULLspring-doc.cadn.net.cn

Null, IsNullspring-doc.cadn.net.cn

LESS_THANspring-doc.cadn.net.cn

LessThan, IsLessThanspring-doc.cadn.net.cn

LESS_THAN_EQUALspring-doc.cadn.net.cn

LessThanEqual, IsLessThanEqualspring-doc.cadn.net.cn

LIKEspring-doc.cadn.net.cn

Like, IsLikespring-doc.cadn.net.cn

NEARspring-doc.cadn.net.cn

Near, IsNearspring-doc.cadn.net.cn

NOTspring-doc.cadn.net.cn

Not, IsNotspring-doc.cadn.net.cn

NOT_INspring-doc.cadn.net.cn

NotIn, IsNotInspring-doc.cadn.net.cn

NOT_LIKEspring-doc.cadn.net.cn

NotLike, IsNotLikespring-doc.cadn.net.cn

REGEXspring-doc.cadn.net.cn

Regex, MatchesRegex, Matchesspring-doc.cadn.net.cn

STARTING_WITHspring-doc.cadn.net.cn

StartingWith, IsStartingWith, StartsWithspring-doc.cadn.net.cn

TRUEspring-doc.cadn.net.cn

True, IsTruespring-doc.cadn.net.cn

WITHINspring-doc.cadn.net.cn

Within, IsWithinspring-doc.cadn.net.cn

除了过滤谓词外,还支持以下修饰符列表:spring-doc.cadn.net.cn

表4. 查询谓词修饰符关键字
关键字 描述

IgnoreCase, IgnoringCasespring-doc.cadn.net.cn

与谓词关键字一起使用,用于不区分大小写的比较。spring-doc.cadn.net.cn

AllIgnoreCase, AllIgnoringCasespring-doc.cadn.net.cn

忽略所有合适属性的大小写。在查询方法谓词中的某处使用。spring-doc.cadn.net.cn

OrderBy…spring-doc.cadn.net.cn

指定一个静态排序顺序,后跟属性路径和方向(例如:OrderByFirstnameAscLastnameDesc)。spring-doc.cadn.net.cn