Lang (common-core 1.12.0 API)

java.lang.Object
- cn.featherfly.common.lang.Lang

```
public final class Lang
extends java.lang.Object
```
A utility class that encapsulates some common operations that are syntactically cumbersome.
对一些在语法上显得拖沓的常用操作进行封装的工具类 .

Since:

1.8.6

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static <T> T[]`	`array(T... array)` create new array.
`static <T> void`	`each(java.lang.Iterable<T> iterable, java.util.function.ObjIntConsumer<T> consumer)` Each.
`static <T> void`	`each(java.util.function.ObjIntConsumer<T> consumer, T... array)` Each.
`static <T> void`	`each(T[] array, java.util.function.ObjIntConsumer<T> consumer)` Each.
`static boolean`	`equals(java.lang.Object target, java.lang.Object otherTarget)` 安全的equals，防止空指针异常 .
`static java.lang.StackTraceElement`	`getInvoker()` 获取调用getInvoker方法所在的方法被调用的信息（即调用方法、类等）.
`static java.lang.StackTraceElement`	`getInvoker(int depth)` 获取调用getInvoker方法所在的方法被调用的信息（即调用方法、类等） .
`static java.util.List<java.lang.StackTraceElement>`	`getInvokers()` 获取调用此方法的调用方法栈 .
`static int`	`hashCode(java.lang.Object o)` 返回hash code，如果传入参数为null,返回0.
`static <O,R extends O> O`	`ifEmpty(O object, java.lang.Iterable<java.util.function.Supplier<R>> suppliers)` 判断传入对象是否为empty，使用`isEmpty(Object)`判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifEmpty(O object, R defaultObject)` 判断传入对象是否为empty,使用`isEmpty(Object)`判断.
`static <O,R extends O> O`	`ifEmpty(O object, java.util.function.Supplier<R>... suppliers)` 判断传入对象是否为empty，使用`isEmpty(Object)`判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifEmpty(O object, java.util.function.Supplier<R> supplier)` 判断传入对象是否为empty,使用`isEmpty(Object)`判断.
`static <O,R extends O> O`	`ifEmpty(java.util.function.Supplier<O> object, java.lang.Iterable<java.util.function.Supplier<R>> suppliers)` 判断传入对象是否为empty，使用`isEmpty(Object)`判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifEmpty(java.util.function.Supplier<O> object, java.util.function.Supplier<R>... suppliers)` 判断传入对象是否为empty，使用`isEmpty(Object)`判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifEmpty(java.util.function.Supplier<O> object, java.util.function.Supplier<R> supplier)` 判断传入对象是否为empty,使用`isEmpty(Object)`判断.
`static <O,R> R`	`ifEmptyOrElse(O object, java.util.function.Function<O,R> emptyFunction, java.util.function.Function<O,R> notEmptyFunction)` 判断传入对象是否为空，使用`isEmpty(Object)`判断，如果为空返回参数emptyFunction的执行结果，否则返回参数notEmptyFunction的执行结果.
`static <O,R> R`	`ifEmptyOrElse(O object, java.util.function.Supplier<R> emptySupplier, java.util.function.Function<O,R> notEmptyFunction)` 判断传入对象是否为空，使用`isEmpty(Object)`判断，如果为空返回参数nullSupplier的执行结果，否则返回参数notEmptyFunction的执行结果.
`static void`	`ifExists(java.io.File file, java.util.function.Consumer<java.io.File> consumer)` 判断传入文件对象代表的物理文件是否存在，存在则执行传入方法 .
`static <R> R`	`ifExists(java.io.File file, java.util.function.Function<java.io.File,R> exists, java.util.function.Function<java.io.File,R> notExists)` 判断传入文件对象代表的物理文件是否存在，存在则执行传入方法 .
`static <R> R`	`ifFalse(boolean bool, java.util.function.Supplier<R> isFalse, java.util.function.Supplier<R> isTrue)` ifTrue.
`static <R> R`	`ifFalse(java.util.function.BooleanSupplier decideSupplier, java.util.function.Supplier<R> isFalse, java.util.function.Supplier<R> isTrue)` ifTrue.
`static <O> void`	`ifNotEmpty(O object, java.util.function.Consumer<O> consumer)` 判断传入对象是否不为空，（String、Collection、Map、Array还要判断长度是否为0），如果不为空则执行传入的方法 .
`static <O,R> R`	`ifNotEmpty(O object, java.util.function.Function<O,R> notEmptyFunction)` Check (`isNotEmpty(Object)`) whether the passed object is not empty.
`static <T> T`	`ifNotEmptyFirst(T... objects)` 返回第一个非空的对象，使用`isNotEmpty(Object)`判断逻辑.
`static <T> T`	`ifNotEmptyFirst(T first, java.util.function.Supplier<T>... suppliers)` 返回第一个非空的对象，使用`isNotEmpty(Object)`判断逻辑.
`static <O,R> R`	`ifNotEmptyOrElse(O object, java.util.function.Function<O,R> notEmptyFunction, java.util.function.Function<O,R> emptyFunction)` Check (`isNotEmpty(Object)`) whether the passed object is not empty.
`static <O,R> R`	`ifNotEmptyOrElse(O object, java.util.function.Function<O,R> notEmptyFunction, java.util.function.Supplier<R> emptySupplier)` Check (`isNotEmpty(Object)`) whether the passed object is not empty.
`static void`	`ifNotExists(java.io.File file, java.util.function.Consumer<java.io.File> consumer)` 判断传入文件对象代表的物理文件是否不存在，不存在则执行传入方法 .
`static <R> R`	`ifNotExists(java.io.File file, java.util.function.Function<java.io.File,R> notExists, java.util.function.Function<java.io.File,R> exists)` 判断传入文件对象代表的物理文件是否不存在，不存在则执行传入方法 .
`static <R> R`	`ifNotExists(java.io.File file, java.util.function.Supplier<R> supplier)` 判断传入文件对象代表的物理文件是否不存在，不存在则执行传入方法 .
`static <O,R> R`	`ifNotNull(O object, java.util.function.Function<O,R> notNull)` Determines whether the passed object is not null.
`static <T> T`	`ifNotNullFirst(java.lang.Iterable<T> objects)` 返回第一个非空的对象，使用!=null判断逻辑.
`static <T> T`	`ifNotNullFirst(T... objects)` 返回第一个非空的对象，使用!=null判断逻辑.
`static <O,R> R`	`ifNotNullOrElse(O object, java.util.function.Function<O,R> notNullFunction, java.util.function.Supplier<R> nullSupplier)` Determines(`isNotEmpty(Object)`) whether the passed object is not empty.
`static <O,R extends O> O`	`ifNull(O object, java.lang.Iterable<java.util.function.Supplier<R>> suppliers)` 判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifNull(O object, R defaultObject)` 如果第一个参数为空(null），返回第二个参数，否则返回第一个参数 .
`static <O,R extends O> O`	`ifNull(O object, java.util.function.Supplier<R>... suppliers)` 判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifNull(O object, java.util.function.Supplier<R> supplier)` 判断传入对象是否为null，如果为空则执行传入的supplier, 并返回其返回值,否则直接返回传入对象.
`static <O,R extends O> O`	`ifNull(java.util.function.Supplier<O> object, java.lang.Iterable<java.util.function.Supplier<R>> suppliers)` 判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifNull(java.util.function.Supplier<O> object, java.util.function.Supplier<R>... suppliers)` 判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
`static <O,R extends O> O`	`ifNull(java.util.function.Supplier<O> object, java.util.function.Supplier<R> supplier)` 判断传入对象是否为null，如果为空则执行传入的方法, 并返回其返回值.
`static <O,R> R`	`ifNullOrElse(O object, java.util.function.Supplier<R> nullSupplier, java.util.function.Function<O,R> notNullFunction)` 判断传入对象是否为null，如果为null返回参数nullSupplier的执行结果，否则返回参数notNullFunction的执行结果.
`static <R> R`	`ifTrue(boolean bool, java.util.function.Supplier<R> isTrue, java.util.function.Supplier<R> isFalse)` ifTrue.
`static <R> R`	`ifTrue(java.util.function.BooleanSupplier decideSupplier, java.util.function.Supplier<R> isTrue, java.util.function.Supplier<R> isFalse)` ifTrue.
`static boolean`	`isEmpty(java.util.Collection<?> collection)` 返回传入集合是否为空（是null或size=0） .
`static boolean`	`isEmpty(java.util.Map<?,?> map)` 返回传入map是否为空（是null或size=0） .
`static boolean`	`isEmpty(java.lang.Object object)` 返回传入对象是否为空，（String、Collection、Map、Array还要判断长度是否为0） .
`static boolean`	`isEmpty(java.lang.Object[] array)` 返回数组是否为空（是null或是空数组） .
`static boolean`	`isEmpty(java.util.Optional<?> optional)` 返回传入Optional是否为空（是null或者内部数据为null） .
`static boolean`	`isEmpty(java.lang.String string)` 返回传入字符串是否为空（是null或是空字符串） .
`static boolean`	`isEmpty(java.util.function.Supplier<?> supplier)` 返回传入Supplier是否为空（是null或者get()返回值为null） .
`static boolean`	`isExists(java.io.File file)` 判断传入文件对象代表的物理文件是否存在 .
`static boolean`	`isFalse(java.lang.Boolean value)` Checks if is false.
`static boolean`	`isNotEmpty(java.util.Collection<?> collection)` 返回传入集合是否不为空（不是null或size>0） .
`static boolean`	`isNotEmpty(java.util.Map<?,?> map)` 返回传入map是否不为空（不是null或size>0） .
`static boolean`	`isNotEmpty(java.lang.Object object)` 返回传入对象是否不为空（String、Collection、Map、Array还要判断长度是否为0） .
`static boolean`	`isNotEmpty(java.lang.Object[] array)` 返回数组是否不为空（null或空数组） .
`static boolean`	`isNotEmpty(java.util.Optional<?> optional)` 返回传入Optional是否不为空（不是null或者内部数据不为null） .
`static boolean`	`isNotEmpty(java.lang.String string)` 返回传入字符串是否不为空（不是null或不是空字符串） .
`static boolean`	`isNotEmpty(java.util.function.Supplier<?> supplier)` 返回传入Supplier是否不为空（不是null或者get()返回值不为null） .
`static boolean`	`isNotExists(java.io.File file)` 判断传入文件对象代表的物理文件是否不存在 .
`static boolean`	`isNullOrFalse(java.lang.Boolean value)` Checks if is null or false.
`static boolean`	`isNullOrTrue(java.lang.Boolean value)` Checks if is null or true.
`static boolean`	`isTrue(java.lang.Boolean value)` Checks if is true.
`static <E> java.util.List<E>`	`list(E... elements)` craete new list.
`static <T> T`	`pick(T target, java.util.function.Supplier<T> defaultTarget)` Deprecated. use `ifNull(Object, Supplier)` instead
`static <T> T`	`pick(T target, T defaultTarget)` Deprecated. `ifNull(Object, Object)`
`static <T> T`	`pickFirst(java.lang.Iterable<T> objects)` Deprecated. use `ifNotNullFirst(Iterable)` instead
`static <T> T`	`pickFirst(T... objects)` Deprecated. use `ifNotNullFirst(Object...)` instead
`static <T> T`	`pickLast(java.util.List<T> pickedItems)` 返回最后一个非空的对象，!=null .
`static <T> T`	`pickLast(T... pickedItems)` 返回最后一个非空的对象，!=null .
`static <E> java.util.Set<E>`	`set(E... elements)` create new set.
`static <A> A[]`	`toArray(java.util.Collection<A> collection)` 转换为数组.
`static <A> A[]`	`toArray(java.util.Collection<A> collection, java.lang.Class<A> type)` 转换为数组.
`static <T extends java.lang.Enum<T>> T`	`toEnum(java.lang.Class<T> toClass, java.lang.Object object)` 将传入对象转换为枚举 .
`static <T extends java.lang.Enum<T>> T`	`toEnum0(java.lang.Class<T> toClass, java.lang.Object object)` 将传入对象转换为枚举 .
`static <A> java.util.List<A>`	`toList(A[] arrays)` 转换为列表
`static <A> java.util.Map<java.lang.Integer,A>`	`toMap(A[] arrays)` 转换为以数组索引为key,数组值为value的map.
`static <A> java.util.Map<java.lang.String,A>`	`toMap2(A[] arrays)` Deprecated. use `toMapStringKey(Object...)` instead
`static <A> java.util.Map<java.lang.String,A>`	`toMapStringKey(A... arrays)` 转换为以数组索引为key(string类型),数组值为value的map.
`static java.lang.String`	`toString(java.lang.Object obj)` 转换为String，如果不能转换（null）则返回null .
`static java.lang.String`	`toString(java.lang.Object obj, java.lang.String defaultValue)` 转换为String，如果不能转换（null）则使用默认值 .
`static void`	`wrapThrow(java.io.IOException ioException)` Wrap throw.
`static void`	`wrapThrow(java.lang.Throwable throwable)` Wrap throw.
`static <E extends java.lang.RuntimeException> void`	`wrapThrow(java.lang.Throwable throwable, java.lang.Class<E> wrappedRuntimeException)` Wrap throw.

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

- Method Detail
  - pick
```
@Deprecated
public static <T> T pick(T target,
                                      T defaultTarget)
```
    Deprecated. ifNull(Object, Object)
    
    如果第一个参数为空(null），返回第二个参数，否则返回第一个参数 .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    target - the target
    
    defaultTarget - the default target
    
    Returns:
    
    第一个参数为空(null），返回第二个参数，否则返回第一个参数
  - pick
```
@Deprecated
public static <T> T pick(T target,
                                      java.util.function.Supplier<T> defaultTarget)
```
    Deprecated. use ifNull(Object, Supplier) instead
    
    如果第一个参数为空(null），返回第二个参数，否则返回第一个参数 .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    target - the target
    
    defaultTarget - the default target
    
    Returns:
    
    第一个参数为空(null），返回第二个参数，否则返回第一个参数
  - pickFirst
```
@Deprecated
public static <T> T pickFirst(T... objects)
```
    Deprecated. use ifNotNullFirst(Object...) instead
    
    返回第一个非空的项，!=null .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    objects - the objects
    
    Returns:
    
    第一个非空的对象
  - pickFirst
```
@Deprecated
public static <T> T pickFirst(java.lang.Iterable<T> objects)
```
    Deprecated. use ifNotNullFirst(Iterable) instead
    
    返回第一个非空的对象，!=null .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    objects - the objects
    
    Returns:
    
    第一个非空的对象
  - pickLast
```
public static <T> T pickLast(T... pickedItems)
```
    返回最后一个非空的对象，!=null .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    pickedItems - the picked items
    
    Returns:
    
    最后一个非空的对象
  - pickLast
```
public static <T> T pickLast(java.util.List<T> pickedItems)
```
    返回最后一个非空的对象，!=null .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    pickedItems - the picked items
    
    Returns:
    
    最后一个非空的对象
  - isEmpty
```
public static boolean isEmpty(java.lang.Object object)
```
    返回传入对象是否为空，（String、Collection、Map、Array还要判断长度是否为0） .
    
    Parameters:
    
    object - the object
    
    Returns:
    
    传入对象是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(java.lang.Object object)
```
    返回传入对象是否不为空（String、Collection、Map、Array还要判断长度是否为0） .
    
    Parameters:
    
    object - the object
    
    Returns:
    
    传入对象是否不为空
  - ifTrue
```
public static <R> R ifTrue(boolean bool,
                           java.util.function.Supplier<R> isTrue,
                           java.util.function.Supplier<R> isFalse)
```
    ifTrue.
    
    Type Parameters:
    
    R - the generic type
    
    Parameters:
    
    bool - the bool
    
    isTrue - the is true
    
    isFalse - the is false
    
    Returns:
    
    obj
  - ifTrue
```
public static <R> R ifTrue(java.util.function.BooleanSupplier decideSupplier,
                           java.util.function.Supplier<R> isTrue,
                           java.util.function.Supplier<R> isFalse)
```
    ifTrue.
    
    Type Parameters:
    
    R - the generic type
    
    Parameters:
    
    decideSupplier - the decide supplier
    
    isTrue - the is true
    
    isFalse - the is false
    
    Returns:
    
    obj
  - ifFalse
```
public static <R> R ifFalse(boolean bool,
                            java.util.function.Supplier<R> isFalse,
                            java.util.function.Supplier<R> isTrue)
```
    ifTrue.
    
    Type Parameters:
    
    R - the generic type
    
    Parameters:
    
    bool - the bool
    
    isFalse - the is false
    
    isTrue - the is true
    
    Returns:
    
    obj
  - ifFalse
```
public static <R> R ifFalse(java.util.function.BooleanSupplier decideSupplier,
                            java.util.function.Supplier<R> isFalse,
                            java.util.function.Supplier<R> isTrue)
```
    ifTrue.
    
    Type Parameters:
    
    R - the generic type
    
    Parameters:
    
    decideSupplier - the decide supplier
    
    isFalse - the is false
    
    isTrue - the is true
    
    Returns:
    
    obj
  - ifEmpty
```
public static <O,R extends O> O ifEmpty(O object,
                                        R defaultObject)
```
    判断传入对象是否为empty,使用isEmpty(Object)判断. 如果为空则返回defaultObject, 否则直接返回传入对象.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    defaultObject - the default object
    
    Returns:
    
    object
  - ifEmpty
```
public static <O,R extends O> O ifEmpty(O object,
                                        java.util.function.Supplier<R> supplier)
```
    判断传入对象是否为empty,使用isEmpty(Object)判断. 如果为空则执行传入的supplier, 并返回其返回值, 否则直接返回传入对象.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    supplier - the supplier
    
    Returns:
    
    object
  - ifEmpty
```
@SafeVarargs
public static <O,R extends O> O ifEmpty(O object,
                                                      java.util.function.Supplier<R>... suppliers)
```
    判断传入对象是否为empty，使用isEmpty(Object)判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    object
  - ifEmpty
```
public static <O,R extends O> O ifEmpty(O object,
                                        java.lang.Iterable<java.util.function.Supplier<R>> suppliers)
```
    判断传入对象是否为empty，使用isEmpty(Object)判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    object
  - ifEmpty
```
public static <O,R extends O> O ifEmpty(java.util.function.Supplier<O> object,
                                        java.util.function.Supplier<R> supplier)
```
    判断传入对象是否为empty,使用isEmpty(Object)判断. 如果为空则执行传入supplier,并返回其执行值,否则直接返回传入对象.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    supplier - the supplier
    
    Returns:
    
    object
  - ifEmpty
```
@SafeVarargs
public static <O,R extends O> O ifEmpty(java.util.function.Supplier<O> object,
                                                      java.util.function.Supplier<R>... suppliers)
```
    判断传入对象是否为empty，使用isEmpty(Object)判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    object
  - ifEmpty
```
public static <O,R extends O> O ifEmpty(java.util.function.Supplier<O> object,
                                        java.lang.Iterable<java.util.function.Supplier<R>> suppliers)
```
    判断传入对象是否为empty，使用isEmpty(Object)判断，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    object
  - ifEmptyOrElse
```
public static <O,R> R ifEmptyOrElse(O object,
                                    java.util.function.Function<O,R> emptyFunction,
                                    java.util.function.Function<O,R> notEmptyFunction)
```
    判断传入对象是否为空，使用isEmpty(Object)判断，如果为空返回参数emptyFunction的执行结果，否则返回参数notEmptyFunction的执行结果.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    emptyFunction - the empty function
    
    notEmptyFunction - the not empty function
    
    Returns:
    
    emptyFunction or notEmptyFunction execute result
  - ifEmptyOrElse
```
public static <O,R> R ifEmptyOrElse(O object,
                                    java.util.function.Supplier<R> emptySupplier,
                                    java.util.function.Function<O,R> notEmptyFunction)
```
    判断传入对象是否为空，使用isEmpty(Object)判断，如果为空返回参数nullSupplier的执行结果，否则返回参数notEmptyFunction的执行结果.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    emptySupplier - the empty supplier
    
    notEmptyFunction - the not empty function
    
    Returns:
    
    object
  - ifNotNullFirst
```
public static <T> T ifNotNullFirst(T... objects)
```
    返回第一个非空的对象，使用!=null判断逻辑.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    objects - the objects
    
    Returns:
    
    第一个非空的对象
  - ifNotNullFirst
```
public static <T> T ifNotNullFirst(java.lang.Iterable<T> objects)
```
    返回第一个非空的对象，使用!=null判断逻辑.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    objects - the objects
    
    Returns:
    
    第一个非空的对象
  - ifNotNull
```
public static <O,R> R ifNotNull(O object,
                                java.util.function.Function<O,R> notNull)
```
    Determines whether the passed object is not null. If it is not null, the passed function is executed; otherwise, null is returned.
    判断传入对象是否不为null，不为空则执行传入的function，否则返回null.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    notNull - the not null
    
    Returns:
    
    null or notNull function return type
  - ifNotNullOrElse
```
public static <O,R> R ifNotNullOrElse(O object,
                                      java.util.function.Function<O,R> notNullFunction,
                                      java.util.function.Supplier<R> nullSupplier)
```
    Determines(isNotEmpty(Object)) whether the passed object is not empty. If it is not empty, the result of the function parameter is returned. If it is not empty, the result of the supplier parameter is returned.
    判断(isNotEmpty(Object))传入对象是否不为空，不为空则返回参数function的执行结果，否则返回参数supplier的执行结果.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    notNullFunction - the not null function
    
    nullSupplier - the null supplier
    
    Returns:
    
    notNullFunction or nullSupplier execute result
  - ifNull
```
public static <O,R extends O> O ifNull(O object,
                                       R defaultObject)
```
    如果第一个参数为空(null），返回第二个参数，否则返回第一个参数 .
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    defaultObject - the default object
    
    Returns:
    
    object
  - ifNull
```
public static <O,R extends O> O ifNull(O object,
                                       java.util.function.Supplier<R> supplier)
```
    判断传入对象是否为null，如果为空则执行传入的supplier, 并返回其返回值,否则直接返回传入对象.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    supplier - the supplier
    
    Returns:
    
    object
  - ifNull
```
@SafeVarargs
public static <O,R extends O> O ifNull(O object,
                                                     java.util.function.Supplier<R>... suppliers)
```
    判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    object
  - ifNull
```
public static <O,R extends O> O ifNull(O object,
                                       java.lang.Iterable<java.util.function.Supplier<R>> suppliers)
```
    判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    object
  - ifNull
```
public static <O,R extends O> O ifNull(java.util.function.Supplier<O> object,
                                       java.util.function.Supplier<R> supplier)
```
    判断传入对象是否为null，如果为空则执行传入的方法, 并返回其返回值.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    supplier - the supplier
    
    Returns:
    
    object
  - ifNull
```
@SafeVarargs
public static <O,R extends O> O ifNull(java.util.function.Supplier<O> object,
                                                     java.util.function.Supplier<R>... suppliers)
```
    判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    the o
  - ifNull
```
public static <O,R extends O> O ifNull(java.util.function.Supplier<O> object,
                                       java.lang.Iterable<java.util.function.Supplier<R>> suppliers)
```
    判断传入对象是否为null，如果为空则迭代suppliers并执行，如果其返回对象不是null，则返回.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    suppliers - the suppliers
    
    Returns:
    
    the o
  - ifNullOrElse
```
public static <O,R> R ifNullOrElse(O object,
                                   java.util.function.Supplier<R> nullSupplier,
                                   java.util.function.Function<O,R> notNullFunction)
```
    判断传入对象是否为null，如果为null返回参数nullSupplier的执行结果，否则返回参数notNullFunction的执行结果.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    nullSupplier - the null supplier
    
    notNullFunction - the not null function
    
    Returns:
    
    nullSupplier or notNullFunction execute result
  - ifNotEmptyFirst
```
public static <T> T ifNotEmptyFirst(T... objects)
```
    返回第一个非空的对象，使用isNotEmpty(Object)判断逻辑.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    objects - the objects
    
    Returns:
    
    第一个非空的对象
  - ifNotEmptyFirst
```
public static <T> T ifNotEmptyFirst(T first,
                                    java.util.function.Supplier<T>... suppliers)
```
    返回第一个非空的对象，使用isNotEmpty(Object)判断逻辑.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    first - the first
    
    suppliers - the suppliers
    
    Returns:
    
    第一个非空的对象
  - ifNotEmpty
```
public static <O,R> R ifNotEmpty(O object,
                                 java.util.function.Function<O,R> notEmptyFunction)
```
    Check (isNotEmpty(Object)) whether the passed object is not empty. If it is not empty, the passed function is executed; otherwise, null is returned. 判断(isNotEmpty(Object))传入对象是否不为空，不为空则执行传入的function，否则返回null.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    notEmptyFunction - the not empty function
    
    Returns:
    
    null or notEmptyFunction function return type
  - ifNotEmptyOrElse
```
public static <O,R> R ifNotEmptyOrElse(O object,
                                       java.util.function.Function<O,R> notEmptyFunction,
                                       java.util.function.Function<O,R> emptyFunction)
```
    Check (isNotEmpty(Object)) whether the passed object is not empty. If it is not empty, the result of the first argument (notEmptyFunction) is returned. * Otherwise, the result of the second argument (emptyFunction) is returned.
    判断(isNotEmpty(Object))传入对象是否不为空，不为空则返回第一个参数(notEmptyFunction)的执行结果，否则返回第二个参数(emptyFunction)的执行结果.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    notEmptyFunction - the not empty function
    
    emptyFunction - the empty function
    
    Returns:
    
    notEmptyFunction or emptyFunction execute result
  - ifNotEmptyOrElse
```
public static <O,R> R ifNotEmptyOrElse(O object,
                                       java.util.function.Function<O,R> notEmptyFunction,
                                       java.util.function.Supplier<R> emptySupplier)
```
    Check (isNotEmpty(Object)) whether the passed object is not empty. If it is not empty, the result of the first argument (notEmptyFunction) is returned. * Otherwise, the result of the second argument (emptySupplier) is returned.
    判断(isNotEmpty(Object))传入对象是否不为空，不为空则返回第一个参数(notEmptyFunction)的执行结果，否则返回第二个参数(emptySupplier)的执行结果.
    
    Type Parameters:
    
    O - the generic type
    
    R - the generic type
    
    Parameters:
    
    object - the object
    
    notEmptyFunction - the not empty function
    
    emptySupplier - the empty supplier
    
    Returns:
    
    notEmptyFunction or emptySupplier execute result
  - ifNotEmpty
```
public static <O> void ifNotEmpty(O object,
                                  java.util.function.Consumer<O> consumer)
```
    判断传入对象是否不为空，（String、Collection、Map、Array还要判断长度是否为0），如果不为空则执行传入的方法 .
    
    Type Parameters:
    
    O - the generic type
    
    Parameters:
    
    object - 传入的对象
    
    consumer - 需要执行的方法
  - isEmpty
```
public static boolean isEmpty(java.util.Optional<?> optional)
```
    返回传入Optional是否为空（是null或者内部数据为null） .
    
    Parameters:
    
    optional - the optional
    
    Returns:
    
    传入Optional是否为空
  - isEmpty
```
public static boolean isEmpty(java.util.function.Supplier<?> supplier)
```
    返回传入Supplier是否为空（是null或者get()返回值为null） .
    
    Parameters:
    
    supplier - the supplier
    
    Returns:
    
    传入Optional是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(java.util.Optional<?> optional)
```
    返回传入Optional是否不为空（不是null或者内部数据不为null） .
    
    Parameters:
    
    optional - the optional
    
    Returns:
    
    传入Optional是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(java.util.function.Supplier<?> supplier)
```
    返回传入Supplier是否不为空（不是null或者get()返回值不为null） .
    
    Parameters:
    
    supplier - the supplier
    
    Returns:
    
    Supplier is not empty
  - isEmpty
```
public static boolean isEmpty(java.lang.String string)
```
    返回传入字符串是否为空（是null或是空字符串） .
    
    Parameters:
    
    string - the string
    
    Returns:
    
    传入字符串是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(java.lang.String string)
```
    返回传入字符串是否不为空（不是null或不是空字符串） .
    
    Parameters:
    
    string - the string
    
    Returns:
    
    传入字符串是否不为空
  - isEmpty
```
public static boolean isEmpty(java.lang.Object[] array)
```
    返回数组是否为空（是null或是空数组） .
    
    Parameters:
    
    array - the array
    
    Returns:
    
    传入数组是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(java.lang.Object[] array)
```
    返回数组是否不为空（null或空数组） .
    
    Parameters:
    
    array - the array
    
    Returns:
    
    传入数组是否不为空
  - isEmpty
```
public static boolean isEmpty(java.util.Collection<?> collection)
```
    返回传入集合是否为空（是null或size=0） .
    
    Parameters:
    
    collection - the collection
    
    Returns:
    
    传入集合是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(java.util.Collection<?> collection)
```
    返回传入集合是否不为空（不是null或size>0） .
    
    Parameters:
    
    collection - the collection
    
    Returns:
    
    传入集合是否不为空
  - isEmpty
```
public static boolean isEmpty(java.util.Map<?,?> map)
```
    返回传入map是否为空（是null或size=0） .
    
    Parameters:
    
    map - the map
    
    Returns:
    
    传入map是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(java.util.Map<?,?> map)
```
    返回传入map是否不为空（不是null或size>0） .
    
    Parameters:
    
    map - the map
    
    Returns:
    
    传入map是否不为空
  - isTrue
```
public static boolean isTrue(java.lang.Boolean value)
```
    Checks if is true.
    
    Parameters:
    
    value - the value
    
    Returns:
    
    true, if is true
  - isNullOrTrue
```
public static boolean isNullOrTrue(java.lang.Boolean value)
```
    Checks if is null or true.
    
    Parameters:
    
    value - the value
    
    Returns:
    
    true, if is null or true
  - isFalse
```
public static boolean isFalse(java.lang.Boolean value)
```
    Checks if is false.
    
    Parameters:
    
    value - the value
    
    Returns:
    
    true, if is false
  - isNullOrFalse
```
public static boolean isNullOrFalse(java.lang.Boolean value)
```
    Checks if is null or false.
    
    Parameters:
    
    value - the value
    
    Returns:
    
    true, if is null or false
  - isExists
```
public static boolean isExists(java.io.File file)
```
    判断传入文件对象代表的物理文件是否存在 .
    
    Parameters:
    
    file - the file
    
    Returns:
    
    传入文件对象代表的物理文件是否存在
  - isNotExists
```
public static boolean isNotExists(java.io.File file)
```
    判断传入文件对象代表的物理文件是否不存在 .
    
    Parameters:
    
    file - the file
    
    Returns:
    
    传入文件对象代表的物理文件是否存在
  - ifExists
```
public static void ifExists(java.io.File file,
                            java.util.function.Consumer<java.io.File> consumer)
```
    判断传入文件对象代表的物理文件是否存在，存在则执行传入方法 .
    
    Parameters:
    
    file - 判断的文件
    
    consumer - 需要执行的方法
  - ifExists
```
public static <R> R ifExists(java.io.File file,
                             java.util.function.Function<java.io.File,R> exists,
                             java.util.function.Function<java.io.File,R> notExists)
```
    判断传入文件对象代表的物理文件是否存在，存在则执行传入方法 .
    
    Type Parameters:
    
    R - the generic type
    
    Parameters:
    
    file - the file
    
    exists - the exists
    
    notExists - the not exists
    
    Returns:
    
    obj
  - ifNotExists
```
public static void ifNotExists(java.io.File file,
                               java.util.function.Consumer<java.io.File> consumer)
```
    判断传入文件对象代表的物理文件是否不存在，不存在则执行传入方法 .
    
    Parameters:
    
    file - 判断的文件
    
    consumer - 需要执行的方法
  - ifNotExists
```
public static <R> R ifNotExists(java.io.File file,
                                java.util.function.Function<java.io.File,R> notExists,
                                java.util.function.Function<java.io.File,R> exists)
```
    判断传入文件对象代表的物理文件是否不存在，不存在则执行传入方法 .
    
    Type Parameters:
    
    R - the generic type
    
    Parameters:
    
    file - the file
    
    notExists - the not exists
    
    exists - the exists
    
    Returns:
    
    obj
  - ifNotExists
```
public static <R> R ifNotExists(java.io.File file,
                                java.util.function.Supplier<R> supplier)
```
    判断传入文件对象代表的物理文件是否不存在，不存在则执行传入方法 .
    
    Type Parameters:
    
    R - the generic type
    
    Parameters:
    
    file - the file
    
    supplier - the supplier
    
    Returns:
    
    obj
  - toEnum
```
public static <T extends java.lang.Enum<T>> T toEnum(java.lang.Class<T> toClass,
                                                     java.lang.Object object)
```
    将传入对象转换为枚举 .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    toClass - the to class
    
    object - the object
    
    Returns:
    
    转换后的枚举，如果是无法转换或不存在的枚举类型，则返回null
  - toEnum0
```
public static <T extends java.lang.Enum<T>> T toEnum0(java.lang.Class<T> toClass,
                                                      java.lang.Object object)
```
    将传入对象转换为枚举 .
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    toClass - the to class
    
    object - the object
    
    Returns:
    
    转换后的枚举，如果是无法转换或不存在的枚举类型，则返回null
  - equals
```
public static boolean equals(java.lang.Object target,
                             java.lang.Object otherTarget)
```
    安全的equals，防止空指针异常 .
    
    Parameters:
    
    target - the target
    
    otherTarget - the other target
    
    Returns:
    
    比较结果
  - hashCode
```
public static int hashCode(java.lang.Object o)
```
    返回hash code，如果传入参数为null,返回0.
    
    Parameters:
    
    o - the o
    
    Returns:
    
    hash code
    
    See Also:
    
    Object.hashCode()
  - toString
```
public static java.lang.String toString(java.lang.Object obj,
                                        java.lang.String defaultValue)
```
    转换为String，如果不能转换（null）则使用默认值 .
    
    Parameters:
    
    obj - the obj
    
    defaultValue - the default value
    
    Returns:
    
    string
  - toString
```
public static java.lang.String toString(java.lang.Object obj)
```
    转换为String，如果不能转换（null）则返回null .
    
    Parameters:
    
    obj - the obj
    
    Returns:
    
    string
  - getInvoker
```
public static java.lang.StackTraceElement getInvoker()
```
    获取调用getInvoker方法所在的方法被调用的信息（即调用方法、类等）. 在main方法中调用该方法会返回null,因为main方法是入口方法，没有其他方法会调用他.
    
    Returns:
    
    StackTraceElement
  - getInvoker
```
public static java.lang.StackTraceElement getInvoker(int depth)
```
    获取调用getInvoker方法所在的方法被调用的信息（即调用方法、类等） .
    
    Parameters:
    
    depth - the depth
    
    Returns:
    
    StackTraceElement
  - getInvokers
```
public static java.util.List<java.lang.StackTraceElement> getInvokers()
```
    获取调用此方法的调用方法栈 .
    
    Returns:
    
    List<StackTraceElement>
  - toArray
```
public static <A> A[] toArray(java.util.Collection<A> collection)
```
    转换为数组. 如果传入集合为空（null或者size=0）或者集合内的对象都是null,返回null.
    
    Type Parameters:
    
    A - the generic type
    
    Parameters:
    
    collection - the collection
    
    Returns:
    
    数组
  - toArray
```
public static <A> A[] toArray(java.util.Collection<A> collection,
                              java.lang.Class<A> type)
```
    转换为数组. 如果传入集合为空（null或者size=0），返回长度为0的数组（不会返回null）.
    
    Type Parameters:
    
    A - the generic type
    
    Parameters:
    
    collection - the collection
    
    type - the type
    
    Returns:
    
    数组
  - toList
```
public static <A> java.util.List<A> toList(A[] arrays)
```
    转换为列表
    .
    
    Type Parameters:
    
    A - the generic type
    
    Parameters:
    
    arrays - the arrays
    
    Returns:
    
    列表
  - toMap
```
public static <A> java.util.Map<java.lang.Integer,A> toMap(A[] arrays)
```
    转换为以数组索引为key,数组值为value的map.
    
    Type Parameters:
    
    A - the generic type
    
    Parameters:
    
    arrays - the arrays
    
    Returns:
    
    map
  - toMap2
```
@Deprecated
public static <A> java.util.Map<java.lang.String,A> toMap2(A[] arrays)
```
    Deprecated. use toMapStringKey(Object...) instead
    
    转换为以数组索引为key,数组值为value的map.
    
    Type Parameters:
    
    A - the generic type
    
    Parameters:
    
    arrays - the arrays
    
    Returns:
    
    map
  - toMapStringKey
```
public static <A> java.util.Map<java.lang.String,A> toMapStringKey(A... arrays)
```
    转换为以数组索引为key(string类型),数组值为value的map.
    
    Type Parameters:
    
    A - the generic type
    
    Parameters:
    
    arrays - the arrays
    
    Returns:
    
    列表
  - wrapThrow
```
public static void wrapThrow(java.lang.Throwable throwable)
```
    Wrap throw.
    
    Parameters:
    
    throwable - the throwable
  - wrapThrow
```
public static void wrapThrow(java.io.IOException ioException)
```
    Wrap throw.
    
    Parameters:
    
    ioException - the io exception
  - wrapThrow
```
public static <E extends java.lang.RuntimeException> void wrapThrow(java.lang.Throwable throwable,
                                                                    java.lang.Class<E> wrappedRuntimeException)
```
    Wrap throw.
    
    Type Parameters:
    
    E - the element type
    
    Parameters:
    
    throwable - the throwable
    
    wrappedRuntimeException - the wrapped runtime exception
  - each
```
public static <T> void each(T[] array,
                            java.util.function.ObjIntConsumer<T> consumer)
```
    Each.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    array - the array
    
    consumer - the consumer
  - each
```
public static <T> void each(java.util.function.ObjIntConsumer<T> consumer,
                            T... array)
```
    Each.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    consumer - the consumer
    
    array - the array
  - each
```
public static <T> void each(java.lang.Iterable<T> iterable,
                            java.util.function.ObjIntConsumer<T> consumer)
```
    Each.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    iterable - the iterable
    
    consumer - the consumer
  - array
```
public static <T> T[] array(T... array)
```
    create new array.
    
    Type Parameters:
    
    T - the generic type
    
    Parameters:
    
    array - the array
    
    Returns:
    
    the t[]
  - list
```
public static <E> java.util.List<E> list(E... elements)
```
    craete new list.
    
    Type Parameters:
    
    E - the element type
    
    Parameters:
    
    elements - the elements
    
    Returns:
    
    the list
  - set
```
public static <E> java.util.Set<E> set(E... elements)
```
    create new set.
    
    Type Parameters:
    
    E - the element type
    
    Parameters:
    
    elements - the elements
    
    Returns:
    
    the list

Class Lang

Method Summary

Methods inherited from class java.lang.Object

Method Detail

pick

pick

pickFirst

pickFirst

pickLast

pickLast

isEmpty

isNotEmpty

ifTrue

ifTrue

ifFalse

ifFalse

ifEmpty

ifEmpty

ifEmpty

ifEmpty

ifEmpty

ifEmpty

ifEmpty

ifEmptyOrElse

ifEmptyOrElse

ifNotNullFirst

ifNotNullFirst

ifNotNull

ifNotNullOrElse

ifNull

ifNull

ifNull

ifNull

ifNull

ifNull

ifNull

ifNullOrElse

ifNotEmptyFirst

ifNotEmptyFirst

ifNotEmpty

ifNotEmptyOrElse

ifNotEmptyOrElse

ifNotEmpty

isEmpty

isEmpty

isNotEmpty

isNotEmpty

isEmpty

isNotEmpty

isEmpty

isNotEmpty

isEmpty

isNotEmpty

isEmpty

isNotEmpty

isTrue

isNullOrTrue

isFalse

isNullOrFalse

isExists

isNotExists

ifExists

ifExists

ifNotExists

ifNotExists

ifNotExists

toEnum

toEnum0

equals

hashCode

toString

toString

getInvoker

getInvoker

getInvokers

toArray

toArray

toList

toMap

toMap2