Repository 查詢關鍵詞

支援的查詢方法主題關鍵詞

下表列出了 Spring Data 倉庫查詢派生機制通常支援的用於表達謂詞的主題關鍵詞。請查閱特定儲存的文件以獲取受支援關鍵詞的精確列表，因為此處列出的某些關鍵詞可能不受特定儲存的支援。

表 1. 查詢主題關鍵詞
關鍵詞	描述
`find…By`, `read…By`, `get…By`, `query…By`, `search…By`, `stream…By`	通常返回倉庫型別、`Collection` 或 `Streamable` 子型別，或結果包裝器（如 `Page`、`GeoResults` 或任何其他特定於儲存的結果包裝器）的通用查詢方法。可以作為 `findBy…`、`findMyDomainTypeBy…` 使用，或與其他關鍵詞組合使用。
`exists…By`	存在性投影，通常返回 `boolean` 結果。
`count…By`	計數投影，返回一個數值結果。
`delete…By`, `remove…By`	刪除查詢方法，返回無結果 (`void`) 或刪除計數。
`…First<number>…`, `…Top<number>…`	將查詢結果限制為前 `<number>` 個結果。此關鍵詞可以出現在主題中 `find`（及其他關鍵詞）和 `by` 之間的任何位置。
`…Distinct…`	使用 DISTINCT 查詢只返回唯一結果。請查閱特定儲存的文件以瞭解該功能是否受支援。此關鍵詞可以出現在主題中 `find`（及其他關鍵詞）和 `by` 之間的任何位置。

下表列出了使用預定義功能（如 CrudRepository 中定義）的保留方法。這些方法直接在倉庫代理的後端（特定於儲存）實現上呼叫。另請參閱“定義查詢方法”。

表 2. 保留方法
`deleteAllById(Iterable<ID> identifiers)`
`deleteById(ID identifier)`
`existsById(ID identifier)`
`findAllById(Iterable<ID> identifiers)`
`findById(ID identifier)`

下表列出了 Spring Data 倉庫查詢派生機制通常支援的謂詞關鍵詞。但是，請查閱特定儲存的文件以獲取受支援關鍵詞的精確列表，因為此處列出的某些關鍵詞可能不受特定儲存的支援。

表 3. 查詢謂詞關鍵詞
邏輯關鍵詞	關鍵詞表達
`AND`	`And`
`OR`	`Or`
`AFTER`	`After`, `IsAfter`
`BEFORE`	`Before`, `IsBefore`
`CONTAINING`	`Containing`, `IsContaining`, `Contains`
`BETWEEN`	`Between`, `IsBetween`
`ENDING_WITH`	`EndingWith`, `IsEndingWith`, `EndsWith`
`EXISTS`	`Exists`
`FALSE`	`False`, `IsFalse`
`GREATER_THAN`	`GreaterThan`, `IsGreaterThan`
`GREATER_THAN_EQUALS`	`GreaterThanEqual`, `IsGreaterThanEqual`
`IN`	`In`, `IsIn`
`IS`	`Is`, `Equals`, (或無關鍵詞)
`IS_EMPTY`	`IsEmpty`, `Empty`
`IS_NOT_EMPTY`	`IsNotEmpty`, `NotEmpty`
`IS_NOT_NULL`	`NotNull`, `IsNotNull`
`IS_NULL`	`Null`, `IsNull`
`LESS_THAN`	`LessThan`, `IsLessThan`
`LESS_THAN_EQUAL`	`LessThanEqual`, `IsLessThanEqual`
`LIKE`	`Like`, `IsLike`
`NEAR`	`Near`, `IsNear`
`NOT`	`Not`, `IsNot`
`NOT_IN`	`NotIn`, `IsNotIn`
`NOT_LIKE`	`NotLike`, `IsNotLike`
`REGEX`	`Regex`, `MatchesRegex`, `Matches`
`STARTING_WITH`	`StartingWith`, `IsStartingWith`, `StartsWith`
`TRUE`	`True`, `IsTrue`
`WITHIN`	`Within`, `IsWithin`

除了過濾謂詞外，還支援以下修飾符列表

表 4. 查詢謂詞修飾符關鍵詞
關鍵詞	描述
`IgnoreCase`, `IgnoringCase`	與謂詞關鍵詞一起使用，用於不區分大小寫的比較。
`AllIgnoreCase`, `AllIgnoringCase`	對所有適用的屬性忽略大小寫。用於查詢方法謂詞中的某個位置。
`OrderBy…`	指定靜態排序順序，後跟屬性路徑和方向（例如 `OrderByFirstnameAscLastnameDesc`）。