cn.hutool.core.collection

类 IterUtil

java.lang.Object

cn.hutool.core.collection.IterUtil

public class IterUtil
extends java.lang.Object

Iterable 和 Iterator 相关工具类

从以下版本开始:

3.1.0

作者:

Looly

构造器概要

构造器

构造器和说明
IterUtil()

方法概要

方法

限定符和类型	方法和说明
static <E> java.lang.Iterable<E>	asIterable(java.util.Iterator<E> iter) Iterator 转为 Iterable
static <E> java.util.Iterator<E>	asIterator(java.util.Enumeration<E> e) Enumeration转换为Iterator Adapt the specified Enumeration to the Iterator interface
static <T> java.util.Map<T,java.lang.Integer>	countMap(java.lang.Iterable<T> iter) 根据集合返回一个元素计数的 Map 所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value 例如：[a,b,c,c,c] 得到： a: 1 b: 1 c: 3
static <T> java.util.Map<T,java.lang.Integer>	countMap(java.util.Iterator<T> iter) 根据集合返回一个元素计数的 Map 所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value 例如：[a,b,c,c,c] 得到： a: 1 b: 1 c: 3
static <K,V> java.util.Map<K,V>	fieldValueAsMap(java.util.Iterator<?> iter, java.lang.String fieldNameForKey, java.lang.String fieldNameForValue) 两个字段值组成新的Map
static <V> java.util.List<java.lang.Object>	fieldValueList(java.util.Iterator<V> iter, java.lang.String fieldName) 获取指定Bean列表中某个字段，生成新的列表
static <K,V> java.util.Map<K,V>	fieldValueMap(java.lang.Iterable<V> iter, java.lang.String fieldName) 字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况 例如：车牌号 =》车
static <K,V> java.util.Map<K,V>	fieldValueMap(java.util.Iterator<V> iter, java.lang.String fieldName) 字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况 例如：车牌号 =》车
static java.lang.Class<?>	getElementType(java.lang.Iterable<?> iterable) 获得Iterable对象的元素类型（通过第一个非空元素判断） 注意，此方法至少会调用多次next方法
static java.lang.Class<?>	getElementType(java.util.Iterator<?> iterator) 获得Iterator对象的元素类型（通过第一个非空元素判断） 注意，此方法至少会调用多次next方法
static <T> T	getFirst(java.lang.Iterable<T> iterable) 获取集合的第一个元素
static <T> T	getFirst(java.util.Iterator<T> iterator) 获取集合的第一个元素
static boolean	hasNull(java.lang.Iterable<?> iter) 是否包含null元素
static boolean	hasNull(java.util.Iterator<?> iter) 是否包含null元素
static boolean	isAllNull(java.lang.Iterable<?> iter) 是否全部元素为null
static boolean	isAllNull(java.util.Iterator<?> iter) 是否全部元素为null
static boolean	isEmpty(java.lang.Iterable<?> iterable) Iterable是否为空
static boolean	isEmpty(java.util.Iterator<?> Iterator) Iterator是否为空
static boolean	isNotEmpty(java.lang.Iterable<?> iterable) Iterable是否为空
static boolean	isNotEmpty(java.util.Iterator<?> Iterator) Iterator是否为空
static <T> java.lang.String	join(java.lang.Iterable<T> iterable, java.lang.CharSequence conjunction) 以 conjunction 为分隔符将集合转换为字符串
static <T> java.lang.String	join(java.lang.Iterable<T> iterable, java.lang.CharSequence conjunction, java.lang.String prefix, java.lang.String suffix) 以 conjunction 为分隔符将集合转换为字符串
static <T> java.lang.String	join(java.util.Iterator<T> iterator, java.lang.CharSequence conjunction) 以 conjunction 为分隔符将集合转换为字符串 如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
static <T> java.lang.String	join(java.util.Iterator<T> iterator, java.lang.CharSequence conjunction, java.lang.String prefix, java.lang.String suffix) 以 conjunction 为分隔符将集合转换为字符串 如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
static <E> java.util.List<E>	toList(java.lang.Iterable<E> iter) Iterator转List 不判断，直接生成新的List
static <E> java.util.List<E>	toList(java.util.Iterator<E> iter) Iterator转List 不判断，直接生成新的List
static <K,V> java.util.Map<K,V>	toMap(java.lang.Iterable<K> keys, java.lang.Iterable<V> values) 将键列表和值列表转换为Map 以键为准，值与键位置需对应。
static <K,V> java.util.Map<K,V>	toMap(java.lang.Iterable<K> keys, java.lang.Iterable<V> values, boolean isOrder) 将键列表和值列表转换为Map 以键为准，值与键位置需对应。
static <K,V> java.util.HashMap<K,V>	toMap(java.lang.Iterable<java.util.Map.Entry<K,V>> entryIter) 将Entry集合转换为HashMap
static <K,V> java.util.Map<K,V>	toMap(java.util.Iterator<K> keys, java.util.Iterator<V> values) 将键列表和值列表转换为Map 以键为准，值与键位置需对应。
static <K,V> java.util.Map<K,V>	toMap(java.util.Iterator<K> keys, java.util.Iterator<V> values, boolean isOrder) 将键列表和值列表转换为Map 以键为准，值与键位置需对应。

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

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

构造器详细资料

IterUtil

public IterUtil()

方法详细资料

isEmpty

public static boolean isEmpty(java.lang.Iterable<?> iterable)

Iterable是否为空

参数:

iterable - Iterable对象

返回:

是否为空

isEmpty

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

Iterator是否为空

参数:

Iterator - Iterator对象

返回:

是否为空

isNotEmpty

public static boolean isNotEmpty(java.lang.Iterable<?> iterable)

Iterable是否为空

参数:

iterable - Iterable对象

返回:

是否为空

isNotEmpty

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

Iterator是否为空

参数:

Iterator - Iterator对象

返回:

是否为空

hasNull

public static boolean hasNull(java.lang.Iterable<?> iter)

是否包含null元素

参数:

iter - 被检查的Iterable对象，如果为null 返回false

返回:

是否包含null元素

hasNull

public static boolean hasNull(java.util.Iterator<?> iter)

是否包含null元素

参数:

iter - 被检查的Iterator对象，如果为null 返回false

返回:

是否包含null元素

isAllNull

public static boolean isAllNull(java.lang.Iterable<?> iter)

是否全部元素为null

参数:

iter - iter 被检查的Iterable对象，如果为null 返回true

返回:

是否全部元素为null

从以下版本开始:

3.3.0

isAllNull

public static boolean isAllNull(java.util.Iterator<?> iter)

是否全部元素为null

参数:

iter - iter 被检查的Iterator对象，如果为null 返回true

返回:

是否全部元素为null

从以下版本开始:

3.3.0

countMap

public static <T> java.util.Map<T,java.lang.Integer> countMap(java.lang.Iterable<T> iter)

根据集合返回一个元素计数的 Map
所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value
例如：[a,b,c,c,c] 得到：
a: 1
b: 1
c: 3

类型参数:

T - 集合元素类型

参数:

iter - Iterable，如果为null返回一个空的Map

返回:

Map

countMap

public static <T> java.util.Map<T,java.lang.Integer> countMap(java.util.Iterator<T> iter)

根据集合返回一个元素计数的 Map
所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value
例如：[a,b,c,c,c] 得到：
a: 1
b: 1
c: 3

类型参数:

T - 集合元素类型

参数:

iter - Iterator，如果为null返回一个空的Map

返回:

Map

fieldValueMap

public static <K,V> java.util.Map<K,V> fieldValueMap(java.lang.Iterable<V> iter,
                                     java.lang.String fieldName)

字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况
例如：车牌号 =》车

类型参数:

K - 字段名对应值得类型，不确定请使用Object

V - 对象类型

参数:

iter - 对象列表

fieldName - 字段名（会通过反射获取其值）

返回:

某个字段值与对象对应Map

从以下版本开始:

4.0.4

fieldValueMap

public static <K,V> java.util.Map<K,V> fieldValueMap(java.util.Iterator<V> iter,
                                     java.lang.String fieldName)

字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况
例如：车牌号 =》车

类型参数:

K - 字段名对应值得类型，不确定请使用Object

V - 对象类型

参数:

iter - 对象列表

fieldName - 字段名（会通过反射获取其值）

返回:

某个字段值与对象对应Map

从以下版本开始:

4.0.4

fieldValueAsMap

public static <K,V> java.util.Map<K,V> fieldValueAsMap(java.util.Iterator<?> iter,
                                       java.lang.String fieldNameForKey,
                                       java.lang.String fieldNameForValue)

两个字段值组成新的Map

类型参数:

K - 字段名对应值得类型，不确定请使用Object

V - 值类型，不确定使用Object

参数:

iter - 对象列表

fieldNameForKey - 做为键的字段名（会通过反射获取其值）

fieldNameForValue - 做为值的字段名（会通过反射获取其值）

返回:

某个字段值与对象对应Map

从以下版本开始:

4.0.10

fieldValueList

public static <V> java.util.List<java.lang.Object> fieldValueList(java.util.Iterator<V> iter,
                                                  java.lang.String fieldName)

获取指定Bean列表中某个字段，生成新的列表

类型参数:

V - 对象类型

参数:

iter - 对象列表

fieldName - 字段名（会通过反射获取其值）

返回:

某个字段值与对象对应Map

从以下版本开始:

4.0.10

join

public static <T> java.lang.String join(java.lang.Iterable<T> iterable,
                        java.lang.CharSequence conjunction)

以 conjunction 为分隔符将集合转换为字符串

类型参数:

T - 集合元素类型

参数:

iterable - Iterable

conjunction - 分隔符

返回:

连接后的字符串

join

public static <T> java.lang.String join(java.lang.Iterable<T> iterable,
                        java.lang.CharSequence conjunction,
                        java.lang.String prefix,
                        java.lang.String suffix)

以 conjunction 为分隔符将集合转换为字符串

类型参数:

T - 集合元素类型

参数:

iterable - Iterable

conjunction - 分隔符

prefix - 每个元素添加的前缀，null表示不添加

suffix - 每个元素添加的后缀，null表示不添加

返回:

连接后的字符串

从以下版本开始:

4.0.10

join

public static <T> java.lang.String join(java.util.Iterator<T> iterator,
                        java.lang.CharSequence conjunction)

以 conjunction 为分隔符将集合转换为字符串
如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串

类型参数:

T - 集合元素类型

参数:

iterator - 集合

conjunction - 分隔符

返回:

连接后的字符串

join

public static <T> java.lang.String join(java.util.Iterator<T> iterator,
                        java.lang.CharSequence conjunction,
                        java.lang.String prefix,
                        java.lang.String suffix)

以 conjunction 为分隔符将集合转换为字符串
如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串

类型参数:

T - 集合元素类型

参数:

iterator - 集合

conjunction - 分隔符

prefix - 每个元素添加的前缀，null表示不添加

suffix - 每个元素添加的后缀，null表示不添加

返回:

连接后的字符串

从以下版本开始:

4.0.10

toMap

public static <K,V> java.util.HashMap<K,V> toMap(java.lang.Iterable<java.util.Map.Entry<K,V>> entryIter)

将Entry集合转换为HashMap

类型参数:

K - 键类型

V - 值类型

参数:

entryIter - entry集合

返回:

Map

toMap

public static <K,V> java.util.Map<K,V> toMap(java.lang.Iterable<K> keys,
                             java.lang.Iterable<V> values)

将键列表和值列表转换为Map
以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
如果值多于键，忽略多余的值。

类型参数:

K - 键类型

V - 值类型

参数:

keys - 键列表

values - 值列表

返回:

标题内容Map

从以下版本开始:

3.1.0

toMap

public static <K,V> java.util.Map<K,V> toMap(java.lang.Iterable<K> keys,
                             java.lang.Iterable<V> values,
                             boolean isOrder)

将键列表和值列表转换为Map
以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
如果值多于键，忽略多余的值。

类型参数:

K - 键类型

V - 值类型

参数:

keys - 键列表

values - 值列表

isOrder - 是否有序

返回:

标题内容Map

从以下版本开始:

4.1.12

toMap

public static <K,V> java.util.Map<K,V> toMap(java.util.Iterator<K> keys,
                             java.util.Iterator<V> values)

将键列表和值列表转换为Map
以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
如果值多于键，忽略多余的值。

类型参数:

K - 键类型

V - 值类型

参数:

keys - 键列表

values - 值列表

返回:

标题内容Map

从以下版本开始:

3.1.0

toMap

public static <K,V> java.util.Map<K,V> toMap(java.util.Iterator<K> keys,
                             java.util.Iterator<V> values,
                             boolean isOrder)

将键列表和值列表转换为Map
以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
如果值多于键，忽略多余的值。

类型参数:

K - 键类型

V - 值类型

参数:

keys - 键列表

values - 值列表

isOrder - 是否有序

返回:

标题内容Map

从以下版本开始:

4.1.12

toList

public static <E> java.util.List<E> toList(java.lang.Iterable<E> iter)

Iterator转List
不判断，直接生成新的List

类型参数:

E - 元素类型

参数:

iter - Iterator

返回:

List

从以下版本开始:

4.0.6

toList

public static <E> java.util.List<E> toList(java.util.Iterator<E> iter)

Iterator转List
不判断，直接生成新的List

类型参数:

E - 元素类型

参数:

iter - Iterator

返回:

List

从以下版本开始:

4.0.6

asIterator

public static <E> java.util.Iterator<E> asIterator(java.util.Enumeration<E> e)

Enumeration转换为Iterator

Adapt the specified Enumeration to the Iterator interface

类型参数:

E - 集合元素类型

参数:

e - Enumeration

返回:

Iterator

asIterable

public static <E> java.lang.Iterable<E> asIterable(java.util.Iterator<E> iter)

Iterator 转为 Iterable

类型参数:

E - 元素类型

参数:

iter - Iterator

返回:

Iterable

getFirst

public static <T> T getFirst(java.lang.Iterable<T> iterable)

获取集合的第一个元素

类型参数:

T - 集合元素类型

参数:

iterable - Iterable

返回:

第一个元素

getFirst

public static <T> T getFirst(java.util.Iterator<T> iterator)

获取集合的第一个元素

类型参数:

T - 集合元素类型

参数:

iterator - Iterator

返回:

第一个元素

getElementType

public static java.lang.Class<?> getElementType(java.lang.Iterable<?> iterable)

获得Iterable对象的元素类型（通过第一个非空元素判断）
注意，此方法至少会调用多次next方法

参数:

iterable - Iterable

返回:

元素类型，当列表为空或元素全部为null时，返回null

getElementType

public static java.lang.Class<?> getElementType(java.util.Iterator<?> iterator)

获得Iterator对象的元素类型（通过第一个非空元素判断）
注意，此方法至少会调用多次next方法

参数:

iterator - Iterator

返回:

元素类型，当列表为空或元素全部为null时，返回null