cn.nxtools.common

类 CollectionUtil

java.lang.Object

cn.nxtools.common.CollectionUtil

public class CollectionUtil
extends java.lang.Object

方法概要

限定符和类型	方法和说明
static <T extends java.util.Collection<E>,E> T	defaultIfEmpty(T collection, java.util.function.Supplier<? extends T> supplier) 当参数集合为null或[]时返回默认值, 否则返回目标参数 // 实例: HashSet<String> hashSet = Sets.newHashSet(); HashSet<String> objects = CollectionUtil.defaultIfEmpty(hashSet, () -> Sets.newHashSet("1"));
static <T extends java.util.Map<K,V>,K,V> T	defaultIfEmpty(T map, java.util.function.Supplier<? extends T> supplier) 当map为null或{}时返回默认值, 否则返回目标参数 LinkedHashMap<String, String> map2 = Maps.newLinkedHashMap(); LinkedHashMap<String, String> map4 = Maps.newLinkedHashMap(); map4.put("1","1"); HashMap<String, String> map3 = CollectionUtil.defaultIfEmpty(map2, () -> map4);
static <T extends java.util.Collection<E>,E> T	defaultIfNull(T collection, java.util.function.Supplier<? extends T> supplier) 当参数集合为null时返回默认值, 不为null时返回目标参数 // 实例: HashSet<Integer> set = null; HashSet<Integer> set1 = CollectionUtil.defaultIfNull(set, () -> new HashSet<>());
static <T extends java.util.Map<K,V>,K,V> T	defaultIfNull(T map, java.util.function.Supplier<? extends T> supplier) 当map为null时返回默认值, 否则返回目标参数 HashMap<String, Integer> map = null; HashMap<String, Integer> map1 = CollectionUtil.defaultIfNull(map, () -> Maps.newHashMap());
static boolean	isEmpty(java.util.Collection<?> collection) 判断集合是否为null或者[] null = true; [] = true;
static boolean	isEmpty(java.util.Map<?,?> map) 判断map是否为null或{} null = true; {} = true; {"name":"zhang"} = false;
static boolean	isNotEmpty(java.util.Collection<?> collection) 判断集合不是null和[] null = false; [] = false;
static boolean	isNotEmpty(java.util.Map<?,?> map) 判断map是否不为null和{} null = false; {} = false; {"name":"zhang"} = true;
static boolean	isNotNull(java.util.Collection<?> collection) 判断集合是否不为null null = false; [] = true;
static boolean	isNotNull(java.util.Map<?,?> map) 判断map是否不为null null = false; {} = true;
static boolean	isNull(java.util.Collection<?> collection) 判断集合是否为null null = true; [] = false;
static boolean	isNull(java.util.Map<?,?> map) 判断map是否为null null = true; {} = false;
static <T> java.util.List<T>	sub(java.util.Collection<T> collection, int start, int length) 截取集合中的内容 1.当start(截取起始位置)小于0时, 截取起始位置等于0 2.当start(截取起始位置)大于或等于被截取集合size时, 返回空数组/[] 3.当length(截取长度)小于或等于0时, 返回空数组 4.截取后的集合长度小于或等于length参数 5.被截取集合为空或空数组, 返回空数组/[]
static <T> java.util.List<T>	sub(java.util.List<T> list, int start, int length) 截取集合中的内容 1.当start(截取起始位置)小于0时, 截取起始位置等于0 2.当start(截取起始位置)大于或等于被截取集合size时, 返回空数组/[] 3.当length(截取长度)小于或等于0时, 返回空数组 4.截取后的集合长度小于或等于length参数 5.被截取集合为空或空数组, 返回空数组/[]
static <T,K,V> java.util.Map<K,V>	toMap(java.lang.Iterable<T> iterable, java.util.function.Function<T,K> key, java.util.function.Function<T,V> value) 集合转Map, 指定集合对象中的字段作为key或value List<User> list = Lists.newArrayList(); User user = new User(); user.setId(1L); list.add(user); Map<Long, User> map = CollectionUtil.toMap(list, User::getId, v -> v);
static <T,K,V> java.util.Map<K,V>	toMap(java.util.Map<K,V> map, java.lang.Iterable<T> iterable, java.util.function.Function<T,K> key, java.util.function.Function<T,V> value) 集合转Map, 指定集合对象中的字段作为key或value 如果map为空，会调用Maps.newHashMap();方法初始化map List<User> list = Lists.newArrayList(); User user = new User(); user.setId(1L); list.add(user); Map<Long, User> map = Maps.newHashMap(); map = CollectionUtil.toMap(map, list, k -> k.getId(), v -> v);

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

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

方法详细资料

isNull

public static boolean isNull(java.util.Collection<?> collection)

判断集合是否为null

null = true;
[] = false;

参数:

collection - 集合参数

返回:

返回true或者false

isNotNull

public static boolean isNotNull(java.util.Collection<?> collection)

判断集合是否不为null

null = false;
[] = true;

参数:

collection - 集合参数

返回:

返回true或者false

isEmpty

public static boolean isEmpty(java.util.Collection<?> collection)

判断集合是否为null或者[]

null = true;
[] = true;

参数:

collection - 集合参数

返回:

返回true或者false

isNotEmpty

public static boolean isNotEmpty(java.util.Collection<?> collection)

判断集合不是null和[]

null = false;
[] = false;

参数:

collection - 集合参数

返回:

返回true或者false

isNull

public static boolean isNull(java.util.Map<?,?> map)

判断map是否为null

null = true;
{} = false;

参数:

map - map参数

返回:

返回true或者false

isNotNull

public static boolean isNotNull(java.util.Map<?,?> map)

判断map是否不为null

null = false;
{} = true;

参数:

map - map参数

返回:

返回true或者false

isEmpty

public static boolean isEmpty(java.util.Map<?,?> map)

判断map是否为null或{}

null = true;
{} = true;
{"name":"zhang"} = false;

参数:

map - map参数

返回:

返回true或者false

isNotEmpty

public static boolean isNotEmpty(java.util.Map<?,?> map)

判断map是否不为null和{}

null = false;
{} = false;
{"name":"zhang"} = true;

参数:

map - map参数

返回:

返回true或者false

toMap

public static <T,K,V> java.util.Map<K,V> toMap(java.lang.Iterable<T> iterable,
                                               java.util.function.Function<T,K> key,
                                               java.util.function.Function<T,V> value)

集合转Map, 指定集合对象中的字段作为key或value

      List<User> list = Lists.newArrayList();
      User user = new User();
      user.setId(1L);
      list.add(user);
      Map<Long, User> map = CollectionUtil.toMap(list, User::getId, v -> v);
 

类型参数:

T - T

K - K

V - V

参数:

iterable - 集合

key - map的key

value - map的value

返回:

转换后的结果Map

从以下版本开始:

1.0.4

toMap

public static <T,K,V> java.util.Map<K,V> toMap(java.util.Map<K,V> map,
                                               java.lang.Iterable<T> iterable,
                                               java.util.function.Function<T,K> key,
                                               java.util.function.Function<T,V> value)

集合转Map, 指定集合对象中的字段作为key或value
如果map为空，会调用Maps.newHashMap();方法初始化map

      List<User> list = Lists.newArrayList();
     User user = new User();
     user.setId(1L);
     list.add(user);
     Map<Long, User> map = Maps.newHashMap();
     map = CollectionUtil.toMap(map, list, k -> k.getId(), v -> v);
 

类型参数:

T - T

K - K

V - V

参数:

map - 转换的Map

iterable - 集合

key - key

value - value

返回:

转换后的结果Map

从以下版本开始:

1.0.4

defaultIfNull

public static <T extends java.util.Collection<E>,E> T defaultIfNull(T collection,
                                                                    java.util.function.Supplier<? extends T> supplier)

当参数集合为null时返回默认值, 不为null时返回目标参数

 // 实例:
 HashSet<Integer> set = null;
 HashSet<Integer> set1 = CollectionUtil.defaultIfNull(set, () -> new HashSet<>());
 
 

类型参数:

T - 集合类型

E - 集合中的元素类型

参数:

collection - 目标参数

supplier - 默认值, 懒加载函数

返回:

null时返回defaultCollection, 否则返回collection

从以下版本开始:

1.0.7

另请参阅:

Objects.defaultIfNull(Object, Supplier)

defaultIfEmpty

public static <T extends java.util.Collection<E>,E> T defaultIfEmpty(T collection,
                                                                     java.util.function.Supplier<? extends T> supplier)

当参数集合为null或[]时返回默认值, 否则返回目标参数

 // 实例:
 HashSet<String> hashSet = Sets.newHashSet();
 HashSet<String> objects = CollectionUtil.defaultIfEmpty(hashSet, () -> Sets.newHashSet("1"));
 
 

类型参数:

T - 集合类型

E - 集合元素类型

参数:

collection - 目标参数

supplier - 默认值, 懒加载函数

返回:

null或[]时返回defaultCollection, 否则返回collection

从以下版本开始:

1.0.7

defaultIfNull

public static <T extends java.util.Map<K,V>,K,V> T defaultIfNull(T map,
                                                                 java.util.function.Supplier<? extends T> supplier)

当map为null时返回默认值, 否则返回目标参数

 HashMap<String, Integer> map = null;
 HashMap<String, Integer> map1 = CollectionUtil.defaultIfNull(map, () -> Maps.newHashMap());
 
 

类型参数:

T - map类型

K - map key类型

V - map value类型

参数:

map - 目标参数

supplier - 默认值, 懒加载函数

返回:

null时返回map, 否则返回defaultMap

从以下版本开始:

1.0.7

另请参阅:

Objects.defaultIfNull(Object, Supplier)

defaultIfEmpty

public static <T extends java.util.Map<K,V>,K,V> T defaultIfEmpty(T map,
                                                                  java.util.function.Supplier<? extends T> supplier)

当map为null或{}时返回默认值, 否则返回目标参数

 LinkedHashMap<String, String> map2 = Maps.newLinkedHashMap();
 LinkedHashMap<String, String> map4 = Maps.newLinkedHashMap();
 map4.put("1","1");
 HashMap<String, String> map3 = CollectionUtil.defaultIfEmpty(map2, () -> map4);
 
 

类型参数:

T - map类型

K - map key类型

V - map value类型

参数:

map - 目标参数

supplier - 默认值, 懒加载函数

返回:

null或{}时返回map, 否则返回defaultMap

从以下版本开始:

1.0.7

另请参阅:

Objects.defaultIfNull(Object, Supplier)

sub

public static <T> java.util.List<T> sub(java.util.List<T> list,
                                        int start,
                                        int length)

截取集合中的内容

     1.当start(截取起始位置)小于0时, 截取起始位置等于0
     2.当start(截取起始位置)大于或等于被截取集合size时, 返回空数组/[]
     3.当length(截取长度)小于或等于0时, 返回空数组
     4.截取后的集合长度小于或等于length参数
     5.被截取集合为空或空数组, 返回空数组/[]
 

类型参数:

T - 集合中元素类型

参数:

list - 被截取内容

start - 截取起始位置, 包含该位置

length - 截取长度

返回:

截取后的集合

从以下版本开始:

1.0.7

sub

public static <T> java.util.List<T> sub(java.util.Collection<T> collection,
                                        int start,
                                        int length)

截取集合中的内容

     1.当start(截取起始位置)小于0时, 截取起始位置等于0
     2.当start(截取起始位置)大于或等于被截取集合size时, 返回空数组/[]
     3.当length(截取长度)小于或等于0时, 返回空数组
     4.截取后的集合长度小于或等于length参数
     5.被截取集合为空或空数组, 返回空数组/[]
 

类型参数:

T - 集合中元素类型

参数:

collection - 被截取内容

start - 截取起始位置, 包含该位置

length - 截取长度

返回:

截取后的集合

从以下版本开始:

1.0.7