IterUtils (bus-core 3.0.0 API)

java.lang.Object
- org.aoju.bus.core.utils.IterUtils

```
public class IterUtils
extends Object
```
Iterable 和 Iterator 相关工具类

Since:

JDK 1.8

Version:

3.0.0

Author:

Kimi Liu

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class IterUtils.EnumerationIter<E>

Nested Classes
Modifier and Type	Class and Description
`static class`	`IterUtils.EnumerationIter<E>`

Constructor Summary

Constructors
Constructor and Description

IterUtils()

Constructors
Constructor and Description
`IterUtils()`

Method Summary

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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - IterUtils
```
public IterUtils()
```
- Method Detail
  - isEmpty
```
public static boolean isEmpty(Iterable<?> iterable)
```
    Iterable是否为空
    
    Parameters:
    
    iterable - Iterable对象
    
    Returns:
    
    是否为空
  - isEmpty
```
public static boolean isEmpty(Iterator<?> Iterator)
```
    Iterator是否为空
    
    Parameters:
    
    Iterator - Iterator对象
    
    Returns:
    
    是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(Iterable<?> iterable)
```
    Iterable是否为空
    
    Parameters:
    
    iterable - Iterable对象
    
    Returns:
    
    是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(Iterator<?> Iterator)
```
    Iterator是否为空
    
    Parameters:
    
    Iterator - Iterator对象
    
    Returns:
    
    是否为空
  - hasNull
```
public static boolean hasNull(Iterable<?> iter)
```
    是否包含null元素
    
    Parameters:
    
    iter - 被检查的Iterable对象，如果为null 返回false
    
    Returns:
    
    是否包含null元素
  - hasNull
```
public static boolean hasNull(Iterator<?> iter)
```
    是否包含null元素
    
    Parameters:
    
    iter - 被检查的Iterator对象，如果为null 返回false
    
    Returns:
    
    是否包含null元素
  - isAllNull
```
public static boolean isAllNull(Iterable<?> iter)
```
    是否全部元素为null
    
    Parameters:
    
    iter - iter 被检查的Iterable对象，如果为null 返回true
    
    Returns:
    
    是否全部元素为null
    
    Since:
    
    3.3.0
  - isAllNull
```
public static boolean isAllNull(Iterator<?> iter)
```
    是否全部元素为null
    
    Parameters:
    
    iter - iter 被检查的Iterator对象，如果为null 返回true
    
    Returns:
    
    是否全部元素为null
    
    Since:
    
    3.3.0
  - countMap
```
public static <T> Map<T,Integer> countMap(Iterable<T> iter)
```
    根据集合返回一个元素计数的 Map
    所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value
    例如：[a,b,c,c,c] 得到：
    a: 1
    b: 1
    c: 3
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iter - Iterable，如果为null返回一个空的Map
    
    Returns:
    
    Map
  - countMap
```
public static <T> Map<T,Integer> countMap(Iterator<T> iter)
```
    根据集合返回一个元素计数的 Map
    所谓元素计数就是假如这个集合中某个元素出现了n次，那将这个元素做为key，n做为value
    例如：[a,b,c,c,c] 得到：
    a: 1
    b: 1
    c: 3
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iter - Iterator，如果为null返回一个空的Map
    
    Returns:
    
    Map
  - fieldValueMap
```
public static <K,V> Map<K,V> fieldValueMap(Iterable<V> iter,
                                           String fieldName)
```
    字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况
    例如：车牌号 =》车
    
    Type Parameters:
    
    K - 字段名对应值得类型，不确定请使用Object
    
    V - 对象类型
    
    Parameters:
    
    iter - 对象列表
    
    fieldName - 字段名（会通过反射获取其值）
    
    Returns:
    
    某个字段值与对象对应Map
    
    Since:
    
    4.0.4
  - fieldValueMap
```
public static <K,V> Map<K,V> fieldValueMap(Iterator<V> iter,
                                           String fieldName)
```
    字段值与列表值对应的Map，常用于元素对象中有唯一ID时需要按照这个ID查找对象的情况
    例如：车牌号 =》车
    
    Type Parameters:
    
    K - 字段名对应值得类型，不确定请使用Object
    
    V - 对象类型
    
    Parameters:
    
    iter - 对象列表
    
    fieldName - 字段名（会通过反射获取其值）
    
    Returns:
    
    某个字段值与对象对应Map
    
    Since:
    
    4.0.4
  - fieldValueAsMap
```
public static <K,V> Map<K,V> fieldValueAsMap(Iterator<?> iter,
                                             String fieldNameForKey,
                                             String fieldNameForValue)
```
    两个字段值组成新的Map
    
    Type Parameters:
    
    K - 字段名对应值得类型，不确定请使用Object
    
    V - 值类型，不确定使用Object
    
    Parameters:
    
    iter - 对象列表
    
    fieldNameForKey - 做为键的字段名（会通过反射获取其值）
    
    fieldNameForValue - 做为值的字段名（会通过反射获取其值）
    
    Returns:
    
    某个字段值与对象对应Map
    
    Since:
    
    4.0.10
  - fieldValueList
```
public static <V> List<Object> fieldValueList(Iterator<V> iter,
                                              String fieldName)
```
    获取指定Bean列表中某个字段，生成新的列表
    
    Type Parameters:
    
    V - 对象类型
    
    Parameters:
    
    iter - 对象列表
    
    fieldName - 字段名（会通过反射获取其值）
    
    Returns:
    
    某个字段值与对象对应Map
    
    Since:
    
    4.0.10
  - join
```
public static <T> String join(Iterable<T> iterable,
                              CharSequence conjunction)
```
    以 conjunction 为分隔符将集合转换为字符串
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iterable - Iterable
    
    conjunction - 分隔符
    
    Returns:
    
    连接后的字符串
  - join
```
public static <T> String join(Iterable<T> iterable,
                              CharSequence conjunction,
                              String prefix,
                              String suffix)
```
    以 conjunction 为分隔符将集合转换为字符串
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iterable - Iterable
    
    conjunction - 分隔符
    
    prefix - 每个元素添加的前缀，null表示不添加
    
    suffix - 每个元素添加的后缀，null表示不添加
    
    Returns:
    
    连接后的字符串
    
    Since:
    
    4.0.10
  - join
```
public static <T> String join(Iterator<T> iterator,
                              CharSequence conjunction)
```
    以 conjunction 为分隔符将集合转换为字符串
    如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iterator - 集合
    
    conjunction - 分隔符
    
    Returns:
    
    连接后的字符串
  - join
```
public static <T> String join(Iterator<T> iterator,
                              CharSequence conjunction,
                              String prefix,
                              String suffix)
```
    以 conjunction 为分隔符将集合转换为字符串
    如果集合元素为数组、Iterable或Iterator，则递归组合其为字符串
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iterator - 集合
    
    conjunction - 分隔符
    
    prefix - 每个元素添加的前缀，null表示不添加
    
    suffix - 每个元素添加的后缀，null表示不添加
    
    Returns:
    
    连接后的字符串
    
    Since:
    
    4.0.10
  - toMap
```
public static <K,V> HashMap<K,V> toMap(Iterable<Map.Entry<K,V>> entryIter)
```
    将Entry集合转换为HashMap
    
    Type Parameters:
    
    K - 键类型
    
    V - 值类型
    
    Parameters:
    
    entryIter - entry集合
    
    Returns:
    
    Map
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterable<K> keys,
                                   Iterable<V> values)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    Type Parameters:
    
    K - 键类型
    
    V - 值类型
    
    Parameters:
    
    keys - 键列表
    
    values - 值列表
    
    Returns:
    
    标题内容Map
    
    Since:
    
    3.1.0
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterable<K> keys,
                                   Iterable<V> values,
                                   boolean isOrder)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    Type Parameters:
    
    K - 键类型
    
    V - 值类型
    
    Parameters:
    
    keys - 键列表
    
    values - 值列表
    
    isOrder - 是否有序
    
    Returns:
    
    标题内容Map
    
    Since:
    
    4.1.12
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterator<K> keys,
                                   Iterator<V> values)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    Type Parameters:
    
    K - 键类型
    
    V - 值类型
    
    Parameters:
    
    keys - 键列表
    
    values - 值列表
    
    Returns:
    
    标题内容Map
    
    Since:
    
    3.1.0
  - toMap
```
public static <K,V> Map<K,V> toMap(Iterator<K> keys,
                                   Iterator<V> values,
                                   boolean isOrder)
```
    将键列表和值列表转换为Map
    以键为准，值与键位置需对应。如果键元素数多于值元素，多余部分值用null代替。
    如果值多于键，忽略多余的值。
    
    Type Parameters:
    
    K - 键类型
    
    V - 值类型
    
    Parameters:
    
    keys - 键列表
    
    values - 值列表
    
    isOrder - 是否有序
    
    Returns:
    
    标题内容Map
    
    Since:
    
    4.1.12
  - toList
```
public static <E> List<E> toList(Iterable<E> iter)
```
    Iterator转List
    不判断，直接生成新的List
    
    Type Parameters:
    
    E - 元素类型
    
    Parameters:
    
    iter - Iterator
    
    Returns:
    
    List
    
    Since:
    
    4.0.6
  - toList
```
public static <E> List<E> toList(Iterator<E> iter)
```
    Iterator转List
    不判断，直接生成新的List
    
    Type Parameters:
    
    E - 元素类型
    
    Parameters:
    
    iter - Iterator
    
    Returns:
    
    List
    
    Since:
    
    4.0.6
  - asIterable
```
public static <E> Iterable<E> asIterable(Iterator<E> iter)
```
    Iterator 转为 Iterable
    
    Type Parameters:
    
    E - 元素类型
    
    Parameters:
    
    iter - Iterator
    
    Returns:
    
    Iterable
  - getFirst
```
public static <T> T getFirst(Iterable<T> iterable)
```
    获取集合的第一个元素
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iterable - Iterable
    
    Returns:
    
    第一个元素
  - getFirst
```
public static <T> T getFirst(Iterator<T> iterator)
```
    获取集合的第一个元素
    
    Type Parameters:
    
    T - 集合元素类型
    
    Parameters:
    
    iterator - Iterator
    
    Returns:
    
    第一个元素
  - getElementType
```
public static Class<?> getElementType(Iterable<?> iterable)
```
    获得Iterable对象的元素类型（通过第一个非空元素判断）
    注意，此方法至少会调用多次next方法
    
    Parameters:
    
    iterable - Iterable
    
    Returns:
    
    元素类型，当列表为空或元素全部为null时，返回null
  - getElementType
```
public static Class<?> getElementType(Iterator<?> iterator)
```
    获得Iterator对象的元素类型（通过第一个非空元素判断）
    注意，此方法至少会调用多次next方法
    
    Parameters:
    
    iterator - Iterator
    
    Returns:
    
    元素类型，当列表为空或元素全部为null时，返回null
  - asIterator
```
public static <E> Iterator<E> asIterator(Enumeration<E> e)
```
    Enumeration转换为Iterator
    Adapt the specified Enumeration to the Iterator interface
    
    Type Parameters:
    
    E - 集合元素类型
    
    Parameters:
    
    e - Enumeration
    
    Returns:
    
    Iterator

Class IterUtils

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

IterUtils

Method Detail

isEmpty

isEmpty

isNotEmpty

isNotEmpty

hasNull

hasNull

isAllNull

isAllNull

countMap

countMap

fieldValueMap

fieldValueMap

fieldValueAsMap

fieldValueList

join

join

join

join

toMap

toMap

toMap

toMap

toMap

toList

toList

asIterable

getFirst

getFirst

getElementType

getElementType

asIterator