Lang

概述

软件包

类

树

已过时

索引

帮助

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

org.nutz.lang
类 Lang

java.lang.Object
  org.nutz.lang.Lang

public abstract class Lang
extends java.lang.Object
extends java.lang.Object

这些帮助函数让 Java 的某些常用功能变得更简单

作者：: zozoh(zozohtnt@gmail.com), wendal(wendal1985@gmail.com), bonyfish(mc02cxj@gmail.com)

构造方法摘要
`Lang()`

方法摘要

static



<T> T[]

array(T... eles)
较方便的创建一个数组，比如： Pet[] pets = Lang.array(pet1, pet2, pet3);

static java.lang.Object array2array(java.lang.Object array, java.lang.Class<?> eleType)
将数组转换成另外一种类型的数组。

static



<T,E> java.util.List<E>

array2list(java.lang.Object array,
           java.lang.Class<E> eleType)

将数组转换成一个列表。

static



<T> java.util.List<T>

array2list(T[] array)
将数组转换成一个列表。

static



<T extends java.util.Map<java.lang.Object,java.lang.Object>> 


java.util.Map<?,?>

array2map(java.lang.Class<T> mapClass,
          java.lang.Object array,
          java.lang.String keyFieldName)

将一个数组变成 Map

static



<T> java.lang.Object[]

array2ObjectArray(T[] args,
                  java.lang.Class<?>[] pts)

将数组转换成Object[] 数组。

static



<T> T[]

arrayFirst(T e,
           T[] eles)

将一个对象添加成为一个数组的第一个元素，从而生成一个新的数组

static



<T> T[]

arrayLast(T[] eles,
          T e)

将一个对象添加成为一个数组的最后一个元素，从而生成一个新的数组

static void Break()
打断 each 循环

static



<E> E[]

collection2array(java.util.Collection<?> col,
                 java.lang.Class<E> eleType)

将集合变成指定类型的数组

static



<E> E[]

collection2array(java.util.Collection<E> coll)
将集合变成数组，数组的类型为集合的第一个元素的类型。

static



<E> java.util.List<E>

collection2list(java.util.Collection<?> col,
                java.lang.Class<E> eleType)

将集合编程变成指定类型的列表

static



<E> java.util.List<E>

collection2list(java.util.Collection<E> col)
将集合变成 ArrayList

static



<T extends java.util.Map<java.lang.Object,java.lang.Object>> 


java.util.Map<?,?>

collection2map(java.lang.Class<T> mapClass,
               java.util.Collection<?> coll,
               java.lang.String keyFieldName)

将一个集合变成 Map。

static ComboException comboThrow(java.lang.Throwable... es)

static



<T> java.lang.StringBuilder

concat(int offset,
       int len,
       java.lang.Object c,
       T[] objs)

将一个数组的部分元素转换成字符串每个元素之间，都会用一个给定的字符分隔

static



<T> java.lang.StringBuilder

concat(int offset,
       int len,
       T[] array)

将一个数组部分元素拼合成一个字符串

static



<T> java.lang.StringBuilder

concat(java.lang.Object c,
       java.util.Collection<T> coll)

将一个集合转换成字符串每个元素之间，都会用一个给定的字符分隔

static java.lang.StringBuilder concat(java.lang.Object c, int[] vals)
将一个整型数组转换成字符串每个元素之间，都会用一个给定的字符分隔

static java.lang.StringBuilder concat(java.lang.Object c, long[] vals)
将一个长整型数组转换成字符串每个元素之间，都会用一个给定的字符分隔

static



<T> java.lang.StringBuilder

concat(java.lang.Object c,
       T[] objs)

将一个数组转换成字符串每个元素之间，都会用一个给定的字符分隔

static



<T> java.lang.StringBuilder

concat(T[] objs)
将一个数组所有元素拼合成一个字符串

static



<T> java.lang.StringBuilder

concatBy(java.lang.String ptn,
         java.lang.Object c,
         T[] objs)

将一个数组转换成字符串所有的元素都被格式化字符串包裹。

static



<T> java.lang.StringBuilder

concatBy(java.lang.String fmt,
         T[] objs)

将一个数组转换成字符串所有的元素都被格式化字符串包裹。

static



<T> boolean

contains(T[] array,
         T ele)

判断一个数组内是否包括某一个对象。

static Context context()

static Context context(java.util.Map<java.lang.String,java.lang.Object> map)
根据一个 Map 包裹成一个上下文对象

static Context context(java.lang.String str)
根据一段 JSON 字符串，生产一个新的上下文对象

static void Continue()
继续 each 循环，如果再递归，则停止递归

static



<T> void

each(java.lang.Object obj,
     boolean loopMap,
     Each<T> callback)

用回调的方式，遍历一个对象，可以支持遍历数组集合 Map 单一元素

static



<T> void

each(java.lang.Object obj,
     Each<T> callback)

用回调的方式，遍历一个对象，可以支持遍历数组集合 Map 单一元素

static



<T extends java.util.Collection<E>,E> 


T

enum2collection(java.util.Enumeration<E> enums,
                T cols)

将枚举对象，变成集合

static



<T> java.util.Enumeration<T>

enumeration(java.util.Collection<T> col)
返回一个集合对象的枚举对象。

static boolean equals(java.lang.Object a1, java.lang.Object a2)
判断两个对象是否相等。

static



<C extends java.util.Collection<T>,T> 


C

fill(C coll,
     T[]... objss)

将一个或者多个数组填入一个集合。

static



<T> T

first(java.util.Collection<T> coll)
获取集合中的第一个元素，如果集合为空，返回 null

static



<K,V> java.util.Map.Entry<K,V>

first(java.util.Map<K,V> map)
获得表中的第一个名值对

static java.lang.Object first(java.lang.Object obj)
如果是数组或集合取得第一个对象。

static



<T> java.lang.Class<T>

forName(java.lang.String name,
        java.lang.Class<T> type)

强制从字符串转换成一个 Class，将 ClassNotFoundException 包裹成 RuntimeException

static



<T> T

get(T[] array,
    int index)

安全的从一个数组获取一个元素，容忍 null 数组，以及支持负数的 index 如果该下标越界，则返回 null

static java.lang.reflect.Type getFieldType(Mirror<?> me, java.lang.reflect.Field field)
当一个类使用来定义泛型时,本方法返回类的一个字段的具体类型。

static java.lang.reflect.Type getFieldType(Mirror<?> me, java.lang.String field)
当一个类使用来定义泛型时,本方法返回类的一个字段的具体类型。

static java.lang.reflect.Type getGenericsType(Mirror<?> me, java.lang.reflect.Type type)
当一个类使用来定义泛型时,本方法返回类的一个字段的具体类型。

static java.lang.reflect.Type[] getGenericsTypes(java.lang.reflect.Type type)
返回一个type的泛型数组, 如果没有, 则直接返回null

static java.lang.reflect.Type[] getMethodParamTypes(Mirror<?> me, java.lang.reflect.Method method)
当一个类使用来定义泛型时, 本方法返回类的一个方法所有参数的具体类型

static java.lang.Object getPrimitiveDefaultValue(java.lang.Class<?> pClass)
获取基本类型的默认值

static java.lang.String getStackTrace(java.lang.Throwable e)
将一个抛出对象的异常堆栈，显示成一个字符串

static java.lang.Class<?> getTypeClass(java.lang.reflect.Type type)
获取一个Type类型实际对应的Class

static java.lang.RuntimeException impossible()

static java.io.Reader inr(java.lang.CharSequence cs)
根据一段文本模拟出一个文本输入流对象

static java.io.InputStream ins(java.lang.CharSequence cs)
根据一段文本模拟出一个输入流对象

static boolean isEmpty(java.lang.Object obj)
判断一个对象是否为空。

static



<T> boolean

isEmptyArray(T[] ary)
判断一个数组是否是空数组

static boolean isJDK6()

static boolean isWin()
判断当前系统是否为Windows

static int length(java.lang.Object obj)
获得一个对象的长度。

static



<T> java.util.ArrayList<T>

list(T... eles)
较方便的创建一个列表，比如： List《Pet》 pets = Lang.list(pet1, pet2, pet3); 注，这里的 List，是 ArrayList 的实例

static java.util.List<java.lang.Object> list4(java.lang.String str)
根据一段字符串，生成一个List 对象。

static java.lang.Class<?> loadClass(java.lang.String className)
使用当前线程的ClassLoader加载给定的类

static



<T extends java.lang.Throwable> 


T

makeThrow(java.lang.Class<T> classOfT,
          java.lang.String format,
          java.lang.Object... args)

根据格式化字符串，生成一个指定的异常。

static java.lang.RuntimeException makeThrow(java.lang.String format, java.lang.Object... args)
根据格式化字符串，生成运行时异常

static java.util.Map<java.lang.String,java.lang.Object> map(java.lang.String str)
根据一段字符串，生成一个 Map 对象。

static



<T> T

map2Object(java.util.Map<?,?> src,
           java.lang.Class<T> toType)

根据一个 Map，和给定的对象类型，创建一个新的 JAVA 对象

static java.util.Map<java.lang.String,java.lang.Object> mapf(java.lang.String fmt, java.lang.Object... args)
根据一个格式化字符串，生成 Map 对象

static java.lang.String md5(java.lang.String str)

static



<T> T[]

merge(T[]... arys)
将多个数组，合并成一个数组。

static java.lang.RuntimeException noImplement()

static java.util.Map<java.lang.String,java.lang.Object> obj2map(java.lang.Object obj)
将对象转换成 Map

static



<T extends java.util.Map<java.lang.String,java.lang.Object>> 


T

obj2map(java.lang.Object obj,
        java.lang.Class<T> mapType)

将对象转换成 Map

static StringOutputStream ops(java.lang.StringBuilder sb)
根据一个 StringBuilder 模拟一个输出流对象

static java.io.Writer opw(java.lang.StringBuilder sb)
根据一个 StringBuilder 模拟一个文本输出流对象

static boolean parseBoolean(java.lang.String s)
将字符串解析成 boolean 值，支持更多的字符串 1 | 0 yes | no on | off true | false

void quiteSleep(long millisecond)
对Thread.sleep(long)的简单封装,不抛出任何异常

static java.lang.String readAll(java.io.Reader reader)
从一个文本输入流读取所有内容，并将该流关闭

static java.lang.Number str2number(java.lang.String s)
将字符串，变成数字对象，现支持的格式为： null - 整数 0 23.78 - 浮点 Float 0x45 - 16进制整数 Integer 78L - 长整数 Long 69 - 普通整数 Integer

static byte[] toBytes(char[] cs)
将字符数组强制转换成字节数组。

static byte[] toBytes(int[] is)
将整数数组强制转换成字节数组。

static java.lang.Throwable unwrapThrow(java.lang.Throwable e)

static java.lang.RuntimeException wrapThrow(java.lang.Throwable e)
用运行时异常包裹抛出对象，如果抛出对象本身就是运行时异常，则直接返回。

static



<T extends java.lang.Throwable> 


T

wrapThrow(java.lang.Throwable e,
          java.lang.Class<T> wrapper)

用一个指定可抛出类型来包裹一个抛出对象。

static java.lang.RuntimeException wrapThrow(java.lang.Throwable e, java.lang.String fmt, java.lang.Object... args)
将抛出对象包裹成运行时异常，并增加自己的描述

static void writeAll(java.io.Writer writer, java.lang.String str)
将一段字符串写入一个文本输出流，并将该流关闭

static javax.xml.parsers.DocumentBuilder xmls()
帮你快速获得一个 DocumentBuilder，方便 XML 解析。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

Lang

public Lang()

方法详细信息

comboThrow

public static ComboException comboThrow(java.lang.Throwable... es)

noImplement

public static java.lang.RuntimeException noImplement()

返回：: 一个未实现的运行时异常

impossible

public static java.lang.RuntimeException impossible()

返回：: 一个不可能的运行时异常

makeThrow

public static java.lang.RuntimeException makeThrow(java.lang.String format,
                                                   java.lang.Object... args)

根据格式化字符串，生成运行时异常

参数：: format - 格式; args - 参数
返回：: 运行时异常

makeThrow

public static <T extends java.lang.Throwable> T makeThrow(java.lang.Class<T> classOfT,
                                                          java.lang.String format,
                                                          java.lang.Object... args)

根据格式化字符串，生成一个指定的异常。

参数：: classOfT - 异常类型，需要有一个字符串为参数的构造函数; format - 格式; args - 参数
返回：: 异常对象

wrapThrow

public static java.lang.RuntimeException wrapThrow(java.lang.Throwable e,
                                                   java.lang.String fmt,
                                                   java.lang.Object... args)

将抛出对象包裹成运行时异常，并增加自己的描述

参数：: e - 抛出对象; fmt - 格式; args - 参数
返回：: 运行时异常

wrapThrow

public static java.lang.RuntimeException wrapThrow(java.lang.Throwable e)

用运行时异常包裹抛出对象，如果抛出对象本身就是运行时异常，则直接返回。

如果是 InvocationTargetException，那么将其剥离，只包裹其 TargetException

参数：: e - 抛出对象
返回：: 运行时异常

wrapThrow

public static <T extends java.lang.Throwable> T wrapThrow(java.lang.Throwable e,
                                                          java.lang.Class<T> wrapper)

用一个指定可抛出类型来包裹一个抛出对象。这个指定的可抛出类型需要有一个构造函数接受 Throwable 类型的对象

参数：: e - 抛出对象; wrapper - 包裹类型
返回：: 包裹后对象

unwrapThrow

public static java.lang.Throwable unwrapThrow(java.lang.Throwable e)

equals

public static boolean equals(java.lang.Object a1,
                             java.lang.Object a2)

判断两个对象是否相等。这个函数用处是:

可以容忍 null
可以容忍不同类型的 Number
对数组，集合， Map 会深层比较

当然，如果你重写的 equals 方法会优先

参数：: a1 - 比较对象1; a2 - 比较对象2
返回：: 是否相等

contains

public static <T> boolean contains(T[] array,
                                   T ele)

判断一个数组内是否包括某一个对象。它的比较将通过 equals(Object,Object) 方法

参数：: array - 数组; ele - 对象
返回：: true 包含 false 不包含

readAll

public static java.lang.String readAll(java.io.Reader reader)

从一个文本输入流读取所有内容，并将该流关闭

参数：: reader - 文本输入流
返回：: 输入流所有内容

writeAll

public static void writeAll(java.io.Writer writer,
                            java.lang.String str)

将一段字符串写入一个文本输出流，并将该流关闭

参数：: writer - 文本输出流; str - 字符串

ins

public static java.io.InputStream ins(java.lang.CharSequence cs)

根据一段文本模拟出一个输入流对象

参数：: cs - 文本
返回：: 输出流对象

inr

public static java.io.Reader inr(java.lang.CharSequence cs)

根据一段文本模拟出一个文本输入流对象

参数：: cs - 文本
返回：: 文本输出流对象

opw

public static java.io.Writer opw(java.lang.StringBuilder sb)

根据一个 StringBuilder 模拟一个文本输出流对象

参数：: sb - StringBuilder 对象
返回：: 文本输出流对象

ops

public static StringOutputStream ops(java.lang.StringBuilder sb)

根据一个 StringBuilder 模拟一个输出流对象

参数：: sb - StringBuilder 对象
返回：: 输出流对象

array

public static <T> T[] array(T... eles)

较方便的创建一个数组，比如：

 Pet[] pets = Lang.array(pet1, pet2, pet3);

参数：: eles - 可变参数
返回：: 数组对象

isEmpty

public static boolean isEmpty(java.lang.Object obj)

判断一个对象是否为空。它支持如下对象类型：

null : 一定为空
数组
集合
Map
其他对象 : 一定不为空

参数：: obj - 任意对象
返回：: 是否为空

isEmptyArray

public static <T> boolean isEmptyArray(T[] ary)

判断一个数组是否是空数组

参数：: ary - 数组
返回：: null 或者空数组都为 true 否则为 false

list

public static <T> java.util.ArrayList<T> list(T... eles)

较方便的创建一个列表，比如：

 List《Pet》 pets = Lang.list(pet1, pet2, pet3);

注，这里的 List，是 ArrayList 的实例

参数：: eles - 可变参数
返回：: 列表对象

merge

public static <T> T[] merge(T[]... arys)

将多个数组，合并成一个数组。如果这些数组为空，则返回 null

参数：: arys - 数组对象
返回：: 合并后的数组对象

arrayFirst

public static <T> T[] arrayFirst(T e,
                                 T[] eles)

将一个对象添加成为一个数组的第一个元素，从而生成一个新的数组

参数：: e - 对象; eles - 数组
返回：: 新数组

arrayLast

public static <T> T[] arrayLast(T[] eles,
                                T e)

将一个对象添加成为一个数组的最后一个元素，从而生成一个新的数组

参数：: e - 对象; eles - 数组
返回：: 新数组

concatBy

public static <T> java.lang.StringBuilder concatBy(java.lang.String fmt,
                                                   T[] objs)

将一个数组转换成字符串

所有的元素都被格式化字符串包裹。这个格式话字符串只能有一个占位符， %s, %d 等，均可，请视你的数组内容而定

参数：: fmt - 格式; objs - 数组
返回：: 拼合后的字符串

concatBy

public static <T> java.lang.StringBuilder concatBy(java.lang.String ptn,
                                                   java.lang.Object c,
                                                   T[] objs)

将一个数组转换成字符串

所有的元素都被格式化字符串包裹。这个格式话字符串只能有一个占位符， %s, %d 等，均可，请视你的数组内容而定

每个元素之间，都会用一个给定的字符分隔

参数：: ptn - 格式; c - 分隔符; objs - 数组
返回：: 拼合后的字符串

concat

public static <T> java.lang.StringBuilder concat(java.lang.Object c,
                                                 T[] objs)

将一个数组转换成字符串

每个元素之间，都会用一个给定的字符分隔

参数：: c - 分隔符; objs - 数组
返回：: 拼合后的字符串

concat

public static java.lang.StringBuilder concat(java.lang.Object c,
                                             long[] vals)

将一个长整型数组转换成字符串

每个元素之间，都会用一个给定的字符分隔

参数：: c - 分隔符; vals - 数组
返回：: 拼合后的字符串

concat

public static java.lang.StringBuilder concat(java.lang.Object c,
                                             int[] vals)

将一个整型数组转换成字符串

每个元素之间，都会用一个给定的字符分隔

参数：: c - 分隔符; vals - 数组
返回：: 拼合后的字符串

concat

public static <T> java.lang.StringBuilder concat(int offset,
                                                 int len,
                                                 java.lang.Object c,
                                                 T[] objs)

将一个数组的部分元素转换成字符串

每个元素之间，都会用一个给定的字符分隔

参数：: offset - 开始元素的下标; len - 元素数量; c - 分隔符; objs - 数组
返回：: 拼合后的字符串

concat

public static <T> java.lang.StringBuilder concat(T[] objs)

将一个数组所有元素拼合成一个字符串

参数：: objs - 数组
返回：: 拼合后的字符串

concat

public static <T> java.lang.StringBuilder concat(int offset,
                                                 int len,
                                                 T[] array)

将一个数组部分元素拼合成一个字符串

参数：: offset - 开始元素的下标; len - 元素数量; array - 数组
返回：: 拼合后的字符串

concat

public static <T> java.lang.StringBuilder concat(java.lang.Object c,
                                                 java.util.Collection<T> coll)

将一个集合转换成字符串

每个元素之间，都会用一个给定的字符分隔

参数：: c - 分隔符; coll - 集合
返回：: 拼合后的字符串

fill

public static <C extends java.util.Collection<T>,T> C fill(C coll,
                                                           T[]... objss)

将一个或者多个数组填入一个集合。

类型参数：: C - 集合类型; T - 数组元素类型
参数：: coll - 集合; objss - 数组（数目可变）
返回：: 集合对象

collection2map

public static <T extends java.util.Map<java.lang.Object,java.lang.Object>> java.util.Map<?,?> collection2map(java.lang.Class<T> mapClass,
                                                                                                             java.util.Collection<?> coll,
                                                                                                             java.lang.String keyFieldName)

将一个集合变成 Map。

参数：: mapClass - Map 的类型; coll - 集合对象; keyFieldName - 采用集合中元素的哪个一个字段为键。
返回：: Map 对象

collection2list

public static <E> java.util.List<E> collection2list(java.util.Collection<E> col)

将集合变成 ArrayList

参数：: col - 集合对象
返回：: 列表对象

collection2list

public static <E> java.util.List<E> collection2list(java.util.Collection<?> col,
                                                    java.lang.Class<E> eleType)

将集合编程变成指定类型的列表

参数：: col - 集合对象; eleType - 列表类型
返回：: 列表对象

collection2array

public static <E> E[] collection2array(java.util.Collection<E> coll)

将集合变成数组，数组的类型为集合的第一个元素的类型。如果集合为空，则返回 null

参数：: coll - 集合对象
返回：: 数组

collection2array

public static <E> E[] collection2array(java.util.Collection<?> col,
                                       java.lang.Class<E> eleType)

将集合变成指定类型的数组

参数：: col - 集合对象; eleType - 数组元素类型
返回：: 数组

array2map

public static <T extends java.util.Map<java.lang.Object,java.lang.Object>> java.util.Map<?,?> array2map(java.lang.Class<T> mapClass,
                                                                                                        java.lang.Object array,
                                                                                                        java.lang.String keyFieldName)

将一个数组变成 Map

参数：: mapClass - Map 的类型; array - 数组; keyFieldName - 采用集合中元素的哪个一个字段为键。
返回：: Map 对象

array2list

public static <T> java.util.List<T> array2list(T[] array)

将数组转换成一个列表。

参数：: array - 原始数组
返回：: 新列表
另请参见：: Castors

array2list

public static <T,E> java.util.List<E> array2list(java.lang.Object array,
                                                 java.lang.Class<E> eleType)

将数组转换成一个列表。将会采用 Castor 来深层转换数组元素

参数：: array - 原始数组; eleType - 新列表的元素类型
返回：: 新列表
另请参见：: Castors

array2array

public static java.lang.Object array2array(java.lang.Object array,
                                           java.lang.Class<?> eleType)
                                    throws FailToCastObjectException

将数组转换成另外一种类型的数组。将会采用 Castor 来深层转换数组元素

参数：: array - 原始数组; eleType - 新数组的元素类型
返回：: 新数组
抛出：: FailToCastObjectException
另请参见：: Castors

array2ObjectArray

public static <T> java.lang.Object[] array2ObjectArray(T[] args,
                                                       java.lang.Class<?>[] pts)
                                            throws FailToCastObjectException

将数组转换成Object[] 数组。将会采用 Castor 来深层转换数组元素

参数：: args - 原始数组; pts - 新数组的元素类型
返回：: 新数组
抛出：: FailToCastObjectException
另请参见：: Castors

map2Object

public static <T> T map2Object(java.util.Map<?,?> src,
                               java.lang.Class<T> toType)
                    throws FailToCastObjectException

根据一个 Map，和给定的对象类型，创建一个新的 JAVA 对象

参数：: src - Map 对象; toType - JAVA 对象类型
返回：: JAVA 对象
抛出：: FailToCastObjectException

map

public static java.util.Map<java.lang.String,java.lang.Object> map(java.lang.String str)

根据一段字符串，生成一个 Map 对象。

参数：: str - 参照 JSON 标准的字符串，但是可以没有前后的大括号
返回：: Map 对象

mapf

public static java.util.Map<java.lang.String,java.lang.Object> mapf(java.lang.String fmt,
                                                                    java.lang.Object... args)

根据一个格式化字符串，生成 Map 对象

参数：: fmt - 格式化字符串; args - 字符串参数
返回：: Map 对象

context

public static Context context()

返回：: 一个新创建的上下文对象

context

public static Context context(java.util.Map<java.lang.String,java.lang.Object> map)

根据一个 Map 包裹成一个上下文对象

参数：: map - Map 对象
返回：: 一个新创建的上下文对象

context

public static Context context(java.lang.String str)

根据一段 JSON 字符串，生产一个新的上下文对象

返回：: 一个新创建的上下文对象

list4

public static java.util.List<java.lang.Object> list4(java.lang.String str)

根据一段字符串，生成一个List 对象。

参数：: str - 参照 JSON 标准的字符串，但是可以没有前后的中括号
返回：: List 对象

length

public static int length(java.lang.Object obj)

获得一个对象的长度。它可以接受:

null : 0
数组
集合
Map
一般 Java 对象。返回 1

如果你想让你的 Java 对象返回不是 1 ，请在对象中声明 length() 函数

参数：: obj -
返回：: 对象长度

first

public static java.lang.Object first(java.lang.Object obj)

如果是数组或集合取得第一个对象。否则返回自身

参数：: obj - 任意对象
返回：: 第一个代表对象

first

public static <T> T first(java.util.Collection<T> coll)

获取集合中的第一个元素，如果集合为空，返回 null

参数：: coll - 集合
返回：: 第一个元素

first

public static <K,V> java.util.Map.Entry<K,V> first(java.util.Map<K,V> map)

获得表中的第一个名值对

参数：: map - 表
返回：: 第一个名值对

Break

public static void Break()
                  throws ExitLoop

打断 each 循环

抛出：: ExitLoop

Continue

public static void Continue()
                     throws ExitLoop

继续 each 循环，如果再递归，则停止递归

抛出：: ExitLoop

each

public static <T> void each(java.lang.Object obj,
                            Each<T> callback)

用回调的方式，遍历一个对象，可以支持遍历

数组
集合
Map
单一元素

参数：: obj - 对象; callback - 回调

each

public static <T> void each(java.lang.Object obj,
                            boolean loopMap,
                            Each<T> callback)

用回调的方式，遍历一个对象，可以支持遍历

数组
集合
Map
单一元素

参数：: obj - 对象; loopMap - 是否循环 Map，如果循环 Map 则主要看 callback 的 T，如果是 Map.Entry 则循环 Entry 否循环 value。如果本值为 false，则将 Map 当作一个完整的对象来看待; callback - 回调

get

public static <T> T get(T[] array,
                        int index)

安全的从一个数组获取一个元素，容忍 null 数组，以及支持负数的 index

如果该下标越界，则返回 null

类型参数：: T -
参数：: array - 数组，如果为 null 则直接返回 null; index - 下标，-1 表示倒数第一个， -2 表示倒数第二个，以此类推
返回：: 数组元素

getStackTrace

public static java.lang.String getStackTrace(java.lang.Throwable e)

将一个抛出对象的异常堆栈，显示成一个字符串

参数：: e - 抛出对象
返回：: 异常堆栈文本

parseBoolean

public static boolean parseBoolean(java.lang.String s)

将字符串解析成 boolean 值，支持更多的字符串

1 | 0
yes | no
on | off
true | false

参数：: s -
返回：: 布尔值

xmls

public static javax.xml.parsers.DocumentBuilder xmls()
                                              throws javax.xml.parsers.ParserConfigurationException

帮你快速获得一个 DocumentBuilder，方便 XML 解析。

返回：: 一个 DocumentBuilder 对象
抛出：: javax.xml.parsers.ParserConfigurationException

quiteSleep

public void quiteSleep(long millisecond)

对Thread.sleep(long)的简单封装,不抛出任何异常

参数：: millisecond - 休眠时间

str2number

public static java.lang.Number str2number(java.lang.String s)

将字符串，变成数字对象，现支持的格式为：

null - 整数 0
23.78 - 浮点 Float
0x45 - 16进制整数 Integer
78L - 长整数 Long
69 - 普通整数 Integer

参数：: s - 参数
返回：: 数字对象

obj2map

public static java.util.Map<java.lang.String,java.lang.Object> obj2map(java.lang.Object obj)

将对象转换成 Map

参数：: obj - POJO 对象
返回：: Map 对象

obj2map

public static <T extends java.util.Map<java.lang.String,java.lang.Object>> T obj2map(java.lang.Object obj,
                                                                                     java.lang.Class<T> mapType)

将对象转换成 Map

类型参数：: T -
参数：: obj - POJO 对象; mapType - Map 的类型
返回：: Map 对象

enumeration

public static <T> java.util.Enumeration<T> enumeration(java.util.Collection<T> col)

返回一个集合对象的枚举对象。实际上就是对 Iterator 接口的一个封装

参数：: col - 集合对象
返回：: 枚举对象

enum2collection

public static <T extends java.util.Collection<E>,E> T enum2collection(java.util.Enumeration<E> enums,
                                                                      T cols)

将枚举对象，变成集合

参数：: enums - 枚举对象; cols - 集合对象
返回：: 集合对象

toBytes

public static byte[] toBytes(char[] cs)

将字符数组强制转换成字节数组。如果字符为双字节编码，则会丢失信息

参数：: cs - 字符数组
返回：: 字节数组

toBytes

public static byte[] toBytes(int[] is)

将整数数组强制转换成字节数组。整数的高位将会被丢失

参数：: is - 整数数组
返回：: 字节数组

isWin

public static boolean isWin()

判断当前系统是否为Windows

返回：: true 如果当前系统为Windows系统

loadClass

public static java.lang.Class<?> loadClass(java.lang.String className)
                                    throws java.lang.ClassNotFoundException

使用当前线程的ClassLoader加载给定的类

参数：: className - 类的全称
返回：: 给定的类
抛出：: java.lang.ClassNotFoundException - 如果无法用当前线程的ClassLoader加载

isJDK6

public static boolean isJDK6()

getPrimitiveDefaultValue

public static java.lang.Object getPrimitiveDefaultValue(java.lang.Class<?> pClass)

获取基本类型的默认值

参数：: pClass -
返回：: 0/false,如果传入的pClass不是基本类型的类,则返回null

getFieldType

public static java.lang.reflect.Type getFieldType(Mirror<?> me,
                                                  java.lang.String field)
                                           throws java.lang.NoSuchFieldException

当一个类使用来定义泛型时,本方法返回类的一个字段的具体类型。

抛出：: java.lang.NoSuchFieldException

getMethodParamTypes

public static java.lang.reflect.Type[] getMethodParamTypes(Mirror<?> me,
                                                           java.lang.reflect.Method method)

当一个类使用来定义泛型时, 本方法返回类的一个方法所有参数的具体类型

参数：: me -; method -

getFieldType

public static java.lang.reflect.Type getFieldType(Mirror<?> me,
                                                  java.lang.reflect.Field field)

当一个类使用来定义泛型时,本方法返回类的一个字段的具体类型。

getGenericsType

public static java.lang.reflect.Type getGenericsType(Mirror<?> me,
                                                     java.lang.reflect.Type type)

当一个类使用来定义泛型时,本方法返回类的一个字段的具体类型。

getTypeClass

public static java.lang.Class<?> getTypeClass(java.lang.reflect.Type type)

获取一个Type类型实际对应的Class

getGenericsTypes

public static java.lang.reflect.Type[] getGenericsTypes(java.lang.reflect.Type type)

返回一个type的泛型数组, 如果没有, 则直接返回null

forName

public static <T> java.lang.Class<T> forName(java.lang.String name,
                                             java.lang.Class<T> type)

强制从字符串转换成一个 Class，将 ClassNotFoundException 包裹成 RuntimeException

类型参数：: T -
参数：: name - 类名; type - 这个类型的边界
返回：: 类对象

md5

public static java.lang.String md5(java.lang.String str)

概述

软件包

类

树

已过时

索引

帮助

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

org.nutz.lang 类 Lang

Lang

comboThrow

noImplement

impossible

makeThrow

makeThrow

wrapThrow

wrapThrow

wrapThrow

unwrapThrow

equals

contains

readAll

writeAll

ins

inr

opw

ops

array

isEmpty

isEmptyArray

list

merge

arrayFirst

arrayLast

concatBy

concatBy

concat

concat

concat

concat

concat

concat

concat

fill

collection2map

collection2list

collection2list

collection2array

collection2array

array2map

array2list

array2list

array2array

array2ObjectArray

map2Object

map

mapf

context

context

context

list4

length

first

first

first

Break

Continue

each

each

get

getStackTrace

parseBoolean

xmls

quiteSleep

str2number

obj2map

obj2map

enumeration

enum2collection

toBytes

toBytes

isWin

loadClass

isJDK6

getPrimitiveDefaultValue

getFieldType

getMethodParamTypes

getFieldType

org.nutz.lang
类 Lang