top.xiajibagao.crane.core.helper

类 CollUtils

java.lang.Object

top.xiajibagao.crane.core.helper.CollUtils

public final class CollUtils
extends Object

Collection与Map集合工具类

作者:

huangchengxing

方法概要

限定符和类型	方法和说明
static Collection<?>	adaptToCollection(Object target) 将Object数据适配为Collection集合 null: 返回Collections.emptyList() Object: 适配为Collections.singletonList(Object) Map: 适配为Map.entrySet()； Collection: 强转为Collection集合 Array: 使用Arrays.asList(Object[])转为集合；
static <T> boolean	allMatch(Collection<T> source, Predicate<T> predicate, boolean ifEmpty) 集合中的非空元素是否全部符合条件，若集合为空，则返回false
static <T> boolean	allMatch(Predicate<T> predicate, boolean ifEmpty, T... targets) 集合中的非空元素是否全部符合条件，若集合为空，则返回false
static <T> boolean	anyMatch(Collection<T> source, Predicate<T> predicate, boolean ifEmpty) 集合中的非空元素是否有任意一项符合条件，若集合为空，则返回false
static <T> boolean	anyMatch(Predicate<T> predicate, boolean ifEmpty, T... targets) 集合中的非空元素是否有任意一项符合条件，若集合为空，则返回false
static <T> List<T>	asList(T... targets)
static <T,R> void	biForEach(Iterable<T> source1, Iterable<R> source2, BiConsumer<T,R> consumer) 遍历两个集合中的非空元素
static <T> void	flatForEach(Iterable<Iterable<T>> source, Consumer<T> consumer) 遍历集合中的非空元素
static <T> void	forEach(Iterable<T> source, Consumer<T> consumer) 遍历集合中的非空元素
static <K,V> void	forEach(Map<K,? extends Collection<V>> source, BiConsumer<K,V> consumer) 遍历集合中的非空元素
static <R,C,V> void	forEach(Map<R,? extends Map<C,V>> source, cn.hutool.core.lang.func.Consumer3<R,C,V> consumer) 遍历两个集合中的非空元素
static <T> boolean	noneMatch(Collection<T> source, Predicate<T> predicate, boolean ifEmpty) 集合中的非空元素是否全部不符合条件，若集合为空，则返回true
static <T> boolean	noneMatch(Predicate<T> predicate, boolean ifEmpty, T... targets) 集合中的非空元素是否全部不符合条件，若集合为空，则返回true
static <T> Stream<T>	of(Collection<T> source)
static <S,T,C extends Collection<T>> C	toCollection(Collection<S> source, Supplier<C> collFactory, Function<S,T> mapper) 将一个集合转为另一指定集合, 总是过滤转换源集合与转换后的集合中为null的元素 eg: List<String> stringList = Arrays.asList("123", null, "424", "233", null); System.out.println(stringList); // [123, null, 424, 233, null] Set<Integer> integerSet = CollUtils.toCollection(stringList, LinkedHashSet::new, Integer::parseInt); System.out.println(integerSet); // [123, 424, 233]
static <T,C extends Collection<T>> C	toCollection(Supplier<C> collFactory, T... array) 将数组适配为集合
static <T> List<T>	toList(Collection<T> source) 将一个集合转为ArrayList集合
static <T> List<T>	toList(T... array) 将数组适配为List集合
static <S,T> Set<T>	toSet(Collection<S> source, Function<S,T> mapper) 将一个集合转为另一HashSet集合
static <T> Set<T>	toSet(Collection<T> source) 将一个集合转为HashSet集合
static <T> Set<T>	toSet(T... source) 将一个数组转为HashSet集合

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

of

public static <T> Stream<T> of(Collection<T> source)

asList

@SafeVarargs
public static <T> List<T> asList(T... targets)

anyMatch

public static <T> boolean anyMatch(Collection<T> source,
                                   Predicate<T> predicate,
                                   boolean ifEmpty)

集合中的非空元素是否有任意一项符合条件，若集合为空，则返回false

参数:

source - 源集合

predicate - 校验

ifEmpty - 当集合为空的时返回值

返回:

boolean

anyMatch

@SafeVarargs
public static <T> boolean anyMatch(Predicate<T> predicate,
                                                 boolean ifEmpty,
                                                 T... targets)

集合中的非空元素是否有任意一项符合条件，若集合为空，则返回false

参数:

targets - 源集合

predicate - 校验

ifEmpty - 当集合为空的时返回值

返回:

boolean

allMatch

public static <T> boolean allMatch(Collection<T> source,
                                   Predicate<T> predicate,
                                   boolean ifEmpty)

集合中的非空元素是否全部符合条件，若集合为空，则返回false

参数:

source - 源集合

predicate - 校验

ifEmpty - 当集合为空的时返回值

返回:

boolean

allMatch

@SafeVarargs
public static <T> boolean allMatch(Predicate<T> predicate,
                                                 boolean ifEmpty,
                                                 T... targets)

集合中的非空元素是否全部符合条件，若集合为空，则返回false

参数:

targets - 源集合

predicate - 校验

ifEmpty - 当集合为空的时返回值

返回:

boolean

noneMatch

public static <T> boolean noneMatch(Collection<T> source,
                                    Predicate<T> predicate,
                                    boolean ifEmpty)

集合中的非空元素是否全部不符合条件，若集合为空，则返回true

参数:

source - 源集合

predicate - 校验

ifEmpty - 当集合为空的时返回值

返回:

boolean

noneMatch

@SafeVarargs
public static <T> boolean noneMatch(Predicate<T> predicate,
                                                  boolean ifEmpty,
                                                  T... targets)

集合中的非空元素是否全部不符合条件，若集合为空，则返回true

参数:

predicate - 校验

ifEmpty - 当集合为空的时返回值

targets - 源集合

返回:

boolean

toCollection

@NonNull
public static <S,T,C extends Collection<T>> C toCollection(@NonNull
                                                                     Collection<S> source,
                                                                     @NonNull
                                                                     Supplier<C> collFactory,
                                                                     @NonNull
                                                                     Function<S,T> mapper)

将一个集合转为另一指定集合, 总是过滤转换源集合与转换后的集合中为null的元素
eg:

 		List<String> stringList = Arrays.asList("123", null, "424", "233", null);
 		System.out.println(stringList); // [123, null, 424, 233, null]
 		Set<Integer> integerSet = CollUtils.toCollection(stringList, LinkedHashSet::new, Integer::parseInt);
 		System.out.println(integerSet); // [123, 424, 233]
 

类型参数:

S - 源集合元素类型

T - 返回集合元素类型

C - 返回集合类型

参数:

source - 源集合

collFactory - 指定集合的生成方法, 生成的集合不能为null

mapper - 映射方法

返回:

C 转换集合

toSet

@NonNull
public static <S,T> Set<T> toSet(Collection<S> source,
                                           @NonNull
                                           Function<S,T> mapper)

将一个集合转为另一HashSet集合

类型参数:

S - 源集合元素类型

T - 返回集合元素类型

参数:

source - 源集合

mapper - 映射方法

返回:

java.util.Set 转换集合

toSet

@NonNull
public static <T> Set<T> toSet(Collection<T> source)

将一个集合转为HashSet集合

类型参数:

T - 集合元素类型

参数:

source - 源集合

返回:

java.util.Set 转换集合

toList

@NonNull
public static <T> List<T> toList(Collection<T> source)

将一个集合转为ArrayList集合

类型参数:

T - 返回集合元素类型

参数:

source - 源集合

返回:

java.util.Set 转换集合

toSet

@SafeVarargs
public static <T> Set<T> toSet(T... source)

将一个数组转为HashSet集合

类型参数:

T - 返回集合元素类型

参数:

source - 数组

返回:

java.util.Set 转换集合

adaptToCollection

public static Collection<?> adaptToCollection(Object target)

将Object数据适配为Collection集合

• null: 返回Collections.emptyList()
• Object: 适配为Collections.singletonList(Object)
• Map: 适配为Map.entrySet()；
• Collection: 强转为Collection集合
• Array: 使用Arrays.asList(Object[])转为集合；

参数:

target - 目标数据

返回:

java.util.Collection

forEach

public static <T> void forEach(Iterable<T> source,
                               Consumer<T> consumer)

遍历集合中的非空元素

参数:

source - 源集合

consumer - 操作

flatForEach

public static <T> void flatForEach(Iterable<Iterable<T>> source,
                                   Consumer<T> consumer)

遍历集合中的非空元素

参数:

source - 源集合

consumer - 操作

biForEach

public static <T,R> void biForEach(Iterable<T> source1,
                                   Iterable<R> source2,
                                   BiConsumer<T,R> consumer)

遍历两个集合中的非空元素

参数:

source1 - 源集合1

source2 - 源集合2

consumer - 操作

forEach

public static <R,C,V> void forEach(Map<R,? extends Map<C,V>> source,
                                   cn.hutool.core.lang.func.Consumer3<R,C,V> consumer)

遍历两个集合中的非空元素

参数:

source - 源集合

consumer - 操作

forEach

public static <K,V> void forEach(Map<K,? extends Collection<V>> source,
                                 BiConsumer<K,V> consumer)

遍历集合中的非空元素

参数:

source - 源集合

consumer - 操作

toCollection

public static <T,C extends Collection<T>> C toCollection(Supplier<C> collFactory,
                                                         T... array)

将数组适配为集合

参数:

collFactory - 创建集合的方法

array - 数组

返回:

C

toList

@SafeVarargs
public static <T> List<T> toList(T... array)

将数组适配为List集合

参数:

array - 数组

返回:

C