com.dynamic.sql.core.dml.select

接口 FetchResult<R>

类型参数:

R - 结果对象的类型

所有已知实现类:

AbstractFetchResult, FetchResultImpl

public interface FetchResult<R>

定义查询结果的封装接口，提供多种格式的结果转换方法。

该接口允许将查询结果转换为单个对象、列表、集合等，以尽量满足不同场景下的数据处理需求。

方法概要

限定符和类型	方法和说明
<K> Map<K,List<R>>	toGroupingBy(Function<R,? extends K> keyMapper) 根据给定的键映射函数，将集合中的元素分组，并返回一个键值对的映射。
<K,V,C extends Collection<V>,M extends Map<K,C>> M	toGroupingBy(Function<R,? extends K> keyMapper, Function<R,? extends V> valueMapper, Supplier<C> collectionSupplier, Supplier<M> mapSupplier) 根据给定的键映射函数、值映射函数、集合生成器和 Map 生成器，将集合中的元素分组，并返回一个键值对的映射。
<K,C extends Collection<R>> Map<K,C>	toGroupingBy(Function<R,? extends K> keyMapper, Supplier<C> collectionSupplier) 根据给定的键映射函数和集合生成器，将集合中的元素分组，并返回一个键值对的映射。
<K,C extends Collection<R>,M extends Map<K,C>> M	toGroupingBy(Function<R,? extends K> keyMapper, Supplier<C> collectionSupplier, Supplier<M> mapSupplier) 根据给定的键映射函数、集合生成器和 Map 生成器，将集合中的元素分组，并返回一个键值对的映射。
List<R>	toList() 将查询结果转换为一个 List 列表，默认使用ArrayList进行封装
<L extends List<R>> L	toList(Supplier<L> listSupplier) 将查询结果转换为一个列表，使用指定的 Supplier 来创建列表实例。
<K,V,M extends Map<K,V>> M	toMap(Function<R,? extends K> keyMapper, Function<R,? extends V> valueMapper) 将集合中的元素转换为一个 Map，键和值由指定的函数生成。
<K,V,M extends Map<K,V>> M	toMap(Function<R,? extends K> keyMapper, Function<R,? extends V> valueMapper, BinaryOperator<V> mergeFunction) 将集合中的元素转换为一个 Map，键和值由指定的函数生成。
<K,V,M extends Map<K,V>> M	toMap(Function<R,? extends K> keyMapper, Function<R,? extends V> valueMapper, BinaryOperator<V> mergeFunction, Supplier<M> mapSupplier) 将集合中的元素转换为一个 Map，键和值由指定的函数生成。
R	toOne() 将查询结果转换为单个对象
Set<R>	toSet() 将查询结果转换为一个 Set 集合，默认使用HashSet进行封装
<S extends Set<R>> S	toSet(Supplier<S> setSupplier) 将查询结果转换为一个 Set 集合，使用指定的 Supplier 来创建集合实例。

方法详细资料

toOne

R toOne()

将查询结果转换为单个对象

返回:

查询结果的单个对象，如果没有匹配结果则返回 null

抛出:

IllegalStateException - 如果查询结果包含多条记录

toList

List<R> toList()

将查询结果转换为一个 List 列表，默认使用ArrayList进行封装

返回:

包含查询结果的 List，如果没有匹配结果则返回空列表

toList

<L extends List<R>> L toList(Supplier<L> listSupplier)

将查询结果转换为一个列表，使用指定的 Supplier 来创建列表实例。

类型参数:

L - 列表类型，与 listSupplier 传入的类型一致

参数:

listSupplier - 用于创建列表实例的 Supplier

返回:

包含查询结果的列表实例

toSet

Set<R> toSet()

将查询结果转换为一个 Set 集合，默认使用HashSet进行封装

返回:

包含查询结果的 Set，如果没有匹配结果则返回空集合

toSet

<S extends Set<R>> S toSet(Supplier<S> setSupplier)

将查询结果转换为一个 Set 集合，使用指定的 Supplier 来创建集合实例。

类型参数:

S - 集合类型，与 setSupplier 传入的类型一致

参数:

setSupplier - 用于创建集合实例的 Supplier

返回:

包含查询结果的集合实例

toMap

<K,V,M extends Map<K,V>> M toMap(Function<R,? extends K> keyMapper,
                                 Function<R,? extends V> valueMapper)

将集合中的元素转换为一个 Map，键和值由指定的函数生成。

类型参数:

K - Map 中键的类型

V - Map 中值的类型

参数:

keyMapper - 用于生成键的函数

valueMapper - 用于生成值的函数

返回:

返回一个包含映射结果的 Map，如果集合为空则返回空的 Map

toMap

<K,V,M extends Map<K,V>> M toMap(Function<R,? extends K> keyMapper,
                                 Function<R,? extends V> valueMapper,
                                 BinaryOperator<V> mergeFunction)

将集合中的元素转换为一个 Map，键和值由指定的函数生成。 当遇到重复键时，使用提供的合并函数来合并值。

类型参数:

K - Map 中键的类型

V - Map 中值的类型

参数:

keyMapper - 用于生成键的函数

valueMapper - 用于生成值的函数

mergeFunction - 用于处理重复键的合并函数

返回:

返回一个包含映射结果的 Map，如果集合为空则返回空的 Map

toMap

<K,V,M extends Map<K,V>> M toMap(Function<R,? extends K> keyMapper,
                                 Function<R,? extends V> valueMapper,
                                 BinaryOperator<V> mergeFunction,
                                 Supplier<M> mapSupplier)

将集合中的元素转换为一个 Map，键和值由指定的函数生成。 当遇到重复键时，使用提供的合并函数来合并值。 该方法允许用户自定义返回的 Map 类型。

类型参数:

K - Map 中键的类型

V - Map 中值的类型

M - 继承自 Map 的类型

参数:

keyMapper - 用于生成键的函数

valueMapper - 用于生成值的函数

mergeFunction - 用于处理重复键的合并函数

mapSupplier - 用于创建 Map 实例的供应商

返回:

返回一个包含映射结果的 Map，如果集合为空则返回由 mapSupplier 创建的 Map

toGroupingBy

<K> Map<K,List<R>> toGroupingBy(Function<R,? extends K> keyMapper)

根据给定的键映射函数，将集合中的元素分组，并返回一个键值对的映射。 映射中的键由 keyMapper 函数计算得到，值是一个包含了分组元素的集合。

类型参数:

K - 映射中的键的类型

参数:

keyMapper - 用于计算分组键的函数

返回:

一个以分组键为键，以分组后的集合为值的 Map

toGroupingBy

<K,C extends Collection<R>> Map<K,C> toGroupingBy(Function<R,? extends K> keyMapper,
                                                  Supplier<C> collectionSupplier)

根据给定的键映射函数和集合生成器，将集合中的元素分组，并返回一个键值对的映射。 映射中的键由 keyMapper 函数计算得到，值是一个包含了分组元素的集合。 集合的类型由 collectionSupplier 提供。

类型参数:

K - 映射中的键的类型

C - 存储每组元素的集合类型

参数:

keyMapper - 用于计算分组键的函数

collectionSupplier - 用于提供分组集合的生成器

返回:

一个以分组键为键，以分组后的集合为值的 Map

toGroupingBy

<K,C extends Collection<R>,M extends Map<K,C>> M toGroupingBy(Function<R,? extends K> keyMapper,
                                                              Supplier<C> collectionSupplier,
                                                              Supplier<M> mapSupplier)

根据给定的键映射函数、集合生成器和 Map 生成器，将集合中的元素分组，并返回一个键值对的映射。 映射中的键由 keyMapper 函数计算得到，值是一个包含了分组元素的集合。 集合的类型由 collectionSupplier 提供，Map 的类型由 mapSupplier 提供。

类型参数:

K - 映射中的键的类型

C - 存储每组元素的集合类型

M - 返回的 Map 类型

参数:

keyMapper - 用于计算分组键的函数

collectionSupplier - 用于提供分组集合的生成器

mapSupplier - 用于提供返回 Map 的生成器

返回:

一个以分组键为键，以分组后的集合为值的 Map

toGroupingBy

<K,V,C extends Collection<V>,M extends Map<K,C>> M toGroupingBy(Function<R,? extends K> keyMapper,
                                                                Function<R,? extends V> valueMapper,
                                                                Supplier<C> collectionSupplier,
                                                                Supplier<M> mapSupplier)

根据给定的键映射函数、值映射函数、集合生成器和 Map 生成器，将集合中的元素分组，并返回一个键值对的映射。
此方法允许在分组时对元素进行额外的值转换。

映射中的键由 keyMapper 函数计算得到，
值由 valueMapper 函数计算得到。
集合的类型由 collectionSupplier 提供，
Map 的类型由 mapSupplier 提供。

类型参数:

K - 映射中的键的类型

V - 映射中的值的类型

C - 存储每组元素的集合类型

M - 返回的 Map 类型

参数:

keyMapper - 用于计算分组键的函数

valueMapper - 用于计算每个元素值的函数

collectionSupplier - 用于提供分组集合的生成器

mapSupplier - 用于提供返回 Map 的生成器

返回:

一个以分组键为键，以转换后的值集合为值的 Map