FaceUtilits (common-base 2.8.4 API)

java.lang.Object
- net.gdface.utils.FaceUtilits

已过时。
replace by BinaryUtils,SimpleTypes,MiscellaneousUtils
```
public class FaceUtilits
extends java.lang.Object
```
作者:

guyadong

构造器概要

构造器
构造器和说明

FaceUtilits()
已过时。

构造器
构造器和说明
`FaceUtilits()` 已过时。

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`static java.net.URI`	`createURI(java.lang.String urlStr)` 已过时。 replaced by `MiscellaneousUtils.createURI(String)`
`static java.util.List<java.lang.String>`	`elementsOf(java.lang.String input)` 已过时。 replaced by `MiscellaneousUtils.elementsOf(String)`
`static <K,V> boolean`	`equals(java.util.Map<K,V> m1, java.util.Map<K,V> m2)` 已过时。 replaced by `MiscellaneousUtils.equals(Map,Map)`
`static <T> java.nio.ByteBuffer`	`getByteBuffer(T src)` 已过时。 replaced by `BinaryUtils.getByteBuffer(Object)`
`static <T> java.nio.ByteBuffer`	`getByteBufferNotEmpty(T src)` 已过时。 replaced by `BinaryUtils.getByteBufferNotEmpty(Object)`
`static <T> java.nio.ByteBuffer`	`getByteBufferOrNull(T src)` 已过时。 replaced by `BinaryUtils.getByteBuffer(Object)`
`static <T> byte[]`	`getBytes(T src)` 已过时。 replaced by `BinaryUtils.getBytes(Object)`
`static byte[]`	`getBytesInBuffer(java.nio.ByteBuffer buffer)` 已过时。 replaced by `BinaryUtils.getBytesInBuffer(ByteBuffer)`
`static <T> byte[]`	`getBytesNotEmpty(T src)` 已过时。 replaced by `BinaryUtils.getBytesNotEmpty(Object)`
`static <T> byte[]`	`getBytesOrNull(T src)` 已过时。 replaced by `BinaryUtils.getBytes(Object)`
`static java.lang.Throwable`	`getCause(java.lang.Throwable e)` 已过时。 replaced by `SimpleTypes.getCause(Throwable)`
`static <T> java.io.InputStream`	`getInputStream(T src)` 已过时。 replaced by `BinaryUtils.getInputStream(Object)`
`static byte[]`	`getMD5(byte[] source)` 已过时。 replaced by `BinaryUtils.getMD5(byte[])`
`static java.nio.ByteBuffer`	`getMD5(java.nio.ByteBuffer source)` 已过时。 replaced by `BinaryUtils.getMD5(ByteBuffer)`
`static java.lang.String`	`getMD5String(byte[] source)` 已过时。 replaced by `BinaryUtils.getMD5String(byte[])`
`static java.lang.String`	`getMD5String(java.nio.ByteBuffer source)` 已过时。 replaced by `BinaryUtils.getMD5String(ByteBuffer)`
`static java.lang.Class<?>[]`	`getParameterizedType(java.lang.Class<?> clazz)` 已过时。 replaced by `SimpleTypes.getParameterizedType(Class)`
`static java.lang.Class<?>[]`	`getParameterizedTypeNoThrow(java.lang.Class<?> clazz)` 已过时。 replaced by `SimpleTypes.getParameterizedTypeNoThrow(Class)`
`static java.lang.Class<?>`	`getRawClass(java.lang.reflect.Type type)` 已过时。 replaced by `SimpleTypes.getRawClass(Type)`
`static java.lang.Class<?>[]`	`getRawClassOfSuperPamamType(java.lang.Class<?> type)` 已过时。 replaced by `SimpleTypes.getRawClassOfSuperPamamType(Class)`
`static java.lang.Class<?>[]`	`getRawClassOfSuperPamamType(java.lang.Object obj)` 已过时。 replaced by `SimpleTypes.getRawClassOfSuperPamamType(Object)`
`static java.nio.ByteBuffer`	`hex2ByteBuffer(java.lang.String src)` 已过时。 replaced by `BinaryUtils.hex2ByteBuffer(String)`
`static byte[]`	`hex2Bytes(java.lang.String src)` 已过时。 replaced by `BinaryUtils.hex2Bytes(String)`
`static boolean`	`isNetworkError(java.lang.Throwable e)` 已过时。 replaced by `SimpleTypes.isNetworkError(Throwable)`
`static byte[]`	`readBytes(java.io.FileInputStream fin)` 已过时。 replaced by `BinaryUtils.readBytes(FileInputStream)`
`static byte[]`	`readBytes(java.io.InputStream in)` 已过时。 replaced by `BinaryUtils.readBytes(InputStream)`
`static java.io.File`	`saveBytes(byte[] data, java.io.File file, boolean overwrite)` 已过时。 replaced by `BinaryUtils.saveBytes(byte[], File, boolean)`
`static java.io.File`	`saveImage(java.io.InputStream img, java.io.File folder)` 已过时。
`static java.io.File`	`saveImageAutoName(byte[] img, java.io.File folder)` 已过时。
`static void`	`storeSortedMap(java.util.Map<java.lang.String,java.lang.String> map, java.io.Writer writer, java.lang.String lineSeparator)` 已过时。 replaced by `MiscellaneousUtils.storeSortedMap(Map,Writer,String)`
`static void`	`storeSortedSet(java.util.Collection<java.lang.String> collection, java.io.Writer writer, java.lang.String lineSeparator)` 已过时。 replaced by `MiscellaneousUtils.storeSortedSet(Collection,Writer,String)`
`static java.lang.Throwable`	`stripThrowableShell(java.lang.Throwable e, java.lang.Class<? extends java.lang.Throwable> shellClass)` 已过时。 replaced by `SimpleTypes.stripThrowableShell(Throwable, Class)`
`static java.lang.String`	`toHex(byte[] buffer)` 已过时。 replaced by `BinaryUtils.toHex(byte[])`
`static java.lang.String`	`toHex(java.nio.ByteBuffer buffer)` 已过时。 replaced by `BinaryUtils.toHex(ByteBuffer)`
`boolean`	`validHEX(java.lang.String input)` 已过时。 replaced by `BinaryUtils.validHEX(String)`
`static boolean`	`validMd5(java.lang.String md5)` 已过时。 replaced by `BinaryUtils.validMd5(String)`

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

- 构造器详细资料
  - FaceUtilits
```
public FaceUtilits()
```
    已过时。
- 方法详细资料
  - getMD5
```
public static byte[] getMD5(byte[] source)
```
    已过时。 replaced by BinaryUtils.getMD5(byte[])
    
    生成MD5校验码
    
    参数:
    
    source -
    
    返回:
    
    MD5
  - getBytesInBuffer
```
public static final byte[] getBytesInBuffer(java.nio.ByteBuffer buffer)
```
    已过时。 replaced by BinaryUtils.getBytesInBuffer(ByteBuffer)
    
    返回buffer中所有字节(position~limit),不改变buffer状态
    
    参数:
    
    buffer -
    
    返回:
    
    buffer 为 null 时返回 null
  - getMD5
```
public static java.nio.ByteBuffer getMD5(java.nio.ByteBuffer source)
```
    已过时。 replaced by BinaryUtils.getMD5(ByteBuffer)
    
    生成MD5校验码
    
    参数:
    
    source -
    
    返回:
    
    MD5 ByteBuffer
    
    另请参阅:
    
    getMD5(byte[])
  - toHex
```
public static java.lang.String toHex(byte[] buffer)
```
    已过时。 replaced by BinaryUtils.toHex(byte[])
    
    将16位byte[] 转换为32位的HEX格式的字符串String
    
    参数:
    
    buffer -
    
    返回:
    
    HEX string
  - toHex
```
public static java.lang.String toHex(java.nio.ByteBuffer buffer)
```
    已过时。 replaced by BinaryUtils.toHex(ByteBuffer)
    
    参数:
    
    buffer -
    
    另请参阅:
    
    toHex(byte[])
  - validHEX
```
public boolean validHEX(java.lang.String input)
```
    已过时。 replaced by BinaryUtils.validHEX(String)
    
    字符串验证器,根据正则表达式判断字符串是否为十六进制(HEX)字符串输入为null或空或正则表达式不匹配则返回false
    
    参数:
    
    input -
  - hex2Bytes
```
public static byte[] hex2Bytes(java.lang.String src)
```
    已过时。 replaced by BinaryUtils.hex2Bytes(String)
    
    convert HEX string to byte array
    
    参数:
    
    src -
    
    返回:
    
    byte array or null if src is null
  - hex2ByteBuffer
```
public static java.nio.ByteBuffer hex2ByteBuffer(java.lang.String src)
```
    已过时。 replaced by BinaryUtils.hex2ByteBuffer(String)
    
    convert HEX string to ByteBuffer
    
    参数:
    
    src -
    
    返回:
    
    byte array or null if src is null
  - getMD5String
```
public static java.lang.String getMD5String(byte[] source)
```
    已过时。 replaced by BinaryUtils.getMD5String(byte[])
    
    生成MD5校验码字符串
    
    参数:
    
    source -
    
    返回:
    
    MD5 hex string
    
    另请参阅:
    
    getMD5(byte[]), toHex(byte[])
  - getMD5String
```
public static java.lang.String getMD5String(java.nio.ByteBuffer source)
```
    已过时。 replaced by BinaryUtils.getMD5String(ByteBuffer)
    
    生成MD5校验码字符串
    
    参数:
    
    source -
    
    返回:
    
    MD5 hex string
    
    另请参阅:
    
    getMD5(byte[]), toHex(byte[])
  - validMd5
```
public static final boolean validMd5(java.lang.String md5)
```
    已过时。 replaced by BinaryUtils.validMd5(String)
    
    判断是否为有效的MD5字符串
    
    返回:
    
    true/false
  - readBytes
```
public static byte[] readBytes(java.io.InputStream in)
                        throws java.io.IOException,
                               java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.readBytes(InputStream)
    
    从InputStream读取字节数组
    当in为FileInputStream时，调用readBytes(FileInputStream)(NIO方式)读取
    结束时会关闭InputStream
    
    参数:
    
    in -
    
    返回:
    
    读取的字节数组
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException - in为null
  - readBytes
```
public static byte[] readBytes(java.io.FileInputStream fin)
                        throws java.io.IOException
```
    已过时。 replaced by BinaryUtils.readBytes(FileInputStream)
    
    NIO方式从FileInputStream读取字节数组
    结束时会关闭InputStream
    
    参数:
    
    fin - FileInputStream
    
    返回:
    
    返回读取的字节数当fin为null时返回null;
    
    抛出:
    
    java.io.IOException
  - getInputStream
```
public static <T> java.io.InputStream getInputStream(T src)
                                              throws java.io.IOException,
                                                     java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.getInputStream(Object)
    
    将对象转换为InputStream
    类型可以是byte[],ByteBuffer,InputStream,String(base64编码),File,URL,URI,否则抛出RuntimeException
    
    参数:
    
    src - 获取InputStream的源对象
    
    返回:
    
    返回获取的InputStream对象,src为null失败返回null或抛出异常
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException - 无法从src获取InputStream
  - getBytes
```
public static final <T> byte[] getBytes(T src)
                                 throws java.io.IOException,
                                        java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.getBytes(Object)
    
    将数据对象src转换为字节数组(byte[])
    src的数据类型可以是byte[],InputStream,ByteBuffer,String(base64编码),File,URL,URI 否则抛出IllegalArgumentException
    对象转换为InputStream或byte[]时,可能会抛出IOException 当src为File或FileInputStream时，使用NIO方式(readBytes(FileInputStream))读取
    
    参数:
    
    src - 获取byte[]的源对象
    
    返回:
    
    返回字节数组,参数为null或类型不对则抛出异常
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException - src为null或无法从src获取InputStream
    
    另请参阅:
    
    readBytes(InputStream), readBytes(FileInputStream), getInputStream(Object), Base64Utils.decode(String)
  - getBytesOrNull
```
public static final <T> byte[] getBytesOrNull(T src)
                                       throws java.io.IOException,
                                              java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.getBytes(Object)
    
    将数据对象src转换为字节数组(byte[])
    
    参数:
    
    src - 获取byte[]的源对象
    
    返回:
    
    返回字节数组,参数为null则返回null
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException - 无法从src获取InputStream
    
    另请参阅:
    
    getBytes(Object)
  - getBytesNotEmpty
```
public static final <T> byte[] getBytesNotEmpty(T src)
                                         throws java.io.IOException,
                                                java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.getBytesNotEmpty(Object)
    
    调用 getBytes(Object)返回非空字节数组
    如果返回null或空字节数组，则抛出IOException
    
    参数:
    
    src - 获取byte[]的源对象
    
    返回:
    
    返回非空字节数组
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException
    
    另请参阅:
    
    getBytes(Object)
  - getByteBuffer
```
public static final <T> java.nio.ByteBuffer getByteBuffer(T src)
                                                   throws java.io.IOException,
                                                          java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.getByteBuffer(Object)
    
    将数据对象src转换为ByteBuffer
    
    参数:
    
    src - 获取byte[]的源对象
    
    返回:
    
    返回字节数组,参数为null或类型不对则抛出异常
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException - 无法从src获取InputStream
    
    另请参阅:
    
    getBytes(Object)
  - getByteBufferOrNull
```
public static final <T> java.nio.ByteBuffer getByteBufferOrNull(T src)
                                                         throws java.io.IOException,
                                                                java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.getByteBuffer(Object)
    
    将数据对象src转换为ByteBuffer
    
    参数:
    
    src - 获取byte[]的源对象
    
    返回:
    
    返回字节数组,参数为null则返回null
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException - 无法从src获取InputStream
    
    另请参阅:
    
    getBytes(Object)
  - getByteBufferNotEmpty
```
public static final <T> java.nio.ByteBuffer getByteBufferNotEmpty(T src)
                                                           throws java.io.IOException,
                                                                  java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.getByteBufferNotEmpty(Object)
    
    调用 getByteBuffer(Object)返回非空ByteBuffer
    如果返回null或空，则抛出IOException
    
    参数:
    
    src -
    
    返回:
    
    返回非空字节数组
    
    抛出:
    
    java.io.IOException
    
    java.lang.IllegalArgumentException
  - saveImageAutoName
```
public static java.io.File saveImageAutoName(byte[] img,
                                             java.io.File folder)
                                      throws java.io.IOException,
                                             java.lang.IllegalArgumentException
```
    已过时。
    
    将图片数据保存在folder指定的文件夹下,文件名用图片的md5校验码命名,自动判断文件后缀
    
    参数:
    
    img - 图像数据
    
    folder - 文件保存的位置
    
    返回:
    
    返回保存的文件名,如果img中无法获取格式名，则视为无效数据，不保存，返回null;
    
    抛出:
    
    java.io.IOException - 调用FaceUtilitsX.getFormatName(byte[])获取图像格式名称出错或其他IO异常
    
    java.lang.IllegalArgumentException - data为null或空时
    
    另请参阅:
    
    saveBytes(byte[], File, boolean)
  - saveImage
```
public static java.io.File saveImage(java.io.InputStream img,
                                     java.io.File folder)
                              throws java.io.IOException,
                                     java.lang.IllegalArgumentException
```
    已过时。
    
    参数:
    
    img -
    
    folder - 文件保存位置
    
    返回:
    
    返回保存的文件,如果从img中读取的数据为空返回null
    
    抛出:
    
    java.io.IOException - 数据非可识别的图像格式或其他IO异常
    
    java.lang.IllegalArgumentException - img为null
    
    另请参阅:
    
    saveImageAutoName(byte[], File)
  - createURI
```
public static java.net.URI createURI(java.lang.String urlStr)
                              throws java.net.MalformedURLException
```
    已过时。 replaced by MiscellaneousUtils.createURI(String)
    
    将URL字符串转换为URI对象
    在转换过程中会将自动对不符合URI规范的字符进行编码,
    在转换过程中先从字符串生成URL对象,如果String不能转换成URL对象，则抛出异常
    
    参数:
    
    urlStr -
    
    返回:
    
    URI对象
    
    抛出:
    
    java.net.MalformedURLException
  - saveBytes
```
public static java.io.File saveBytes(byte[] data,
                                     java.io.File file,
                                     boolean overwrite)
                              throws java.io.IOException,
                                     java.lang.IllegalArgumentException
```
    已过时。 replaced by BinaryUtils.saveBytes(byte[], File, boolean)
    
    NIO方式将data数据保存在file指定的文件中
    如果file所在文件夹不存在，则会自动创建所有的文件夹
    
    参数:
    
    data -
    
    file - 文件保存的位置
    
    overwrite - 同名文件存在时是否覆盖
    
    返回:
    
    返回保存的文件名
    
    抛出:
    
    java.io.IOException - file存在但不是文件或其他IO异常
    
    java.lang.IllegalArgumentException - data为null时
  - getParameterizedTypeNoThrow
```
public static java.lang.Class<?>[] getParameterizedTypeNoThrow(java.lang.Class<?> clazz)
```
    已过时。 replaced by SimpleTypes.getParameterizedTypeNoThrow(Class)
    
    返回clazz泛型超类的参数对象
    如果无法获取泛型参数对象，返回null
    
    参数:
    
    clazz -
    
    返回:
    
    参数类型数组
    
    另请参阅:
    
    getParameterizedType(Class)
  - getParameterizedType
```
public static java.lang.Class<?>[] getParameterizedType(java.lang.Class<?> clazz)
                                                 throws java.lang.reflect.MalformedParameterizedTypeException,
                                                        java.lang.IllegalArgumentException
```
    已过时。 replaced by SimpleTypes.getParameterizedType(Class)
    
    返回clazz泛型超类的参数对象
    如果超类不是泛型对象，则抛出IllegalArgumentException
    
    参数:
    
    clazz -
    
    返回:
    
    参数类型数组
    
    抛出:
    
    java.lang.reflect.MalformedParameterizedTypeException - 无法获取实际泛型参数对象类型
    
    java.lang.IllegalArgumentException - 超类不是泛型类
  - getRawClass
```
public static final java.lang.Class<?> getRawClass(java.lang.reflect.Type type)
```
    已过时。 replaced by SimpleTypes.getRawClass(Type)
    
    以递归方式返回指定类型(Type)的原始类型
    
    参数:
    
    type -
    
    返回:
    
    Class 实例
    
    抛出:
    
    java.lang.IllegalArgumentException - type 非 Class 或 ParameterizedType,无法获取原始类型
  - getRawClassOfSuperPamamType
```
public static final java.lang.Class<?>[] getRawClassOfSuperPamamType(java.lang.Class<?> type)
```
    已过时。 replaced by SimpleTypes.getRawClassOfSuperPamamType(Class)
    
    返回type的父类泛型参数的原始类型
    
    参数:
    
    type -
    
    返回:
    
    原始类型数组
    
    抛出:
    
    java.lang.IllegalArgumentException - type 非 Class 或 ParameterizedType,无法获取原始类型
  - getRawClassOfSuperPamamType
```
public static final java.lang.Class<?>[] getRawClassOfSuperPamamType(java.lang.Object obj)
```
    已过时。 replaced by SimpleTypes.getRawClassOfSuperPamamType(Object)
    
    返回obj的父类泛型参数的原始类型
    
    参数:
    
    obj -
    
    返回:
    
    原始类型数组
  - getCause
```
public static final java.lang.Throwable getCause(java.lang.Throwable e)
```
    已过时。 replaced by SimpleTypes.getCause(Throwable)
    
    返回导致异常的原因(cause)
    
    参数:
    
    e -
    
    返回:
    
    Throwable object or e if cause is null
  - stripThrowableShell
```
public static final java.lang.Throwable stripThrowableShell(java.lang.Throwable e,
                                                            java.lang.Class<? extends java.lang.Throwable> shellClass)
```
    已过时。 replaced by SimpleTypes.stripThrowableShell(Throwable, Class)
    
    以递归方式返回被shellClass多层封装的异常
    
    参数:
    
    e -
    
    shellClass - 封装异常的类
    
    返回:
    
    剥离封装的异常对象
  - isNetworkError
```
public static final boolean isNetworkError(java.lang.Throwable e)
```
    已过时。 replaced by SimpleTypes.isNetworkError(Throwable)
    
    递归方式判断一个RuntimeException异常的原因是不是来自网络通信异常(超时，连接错误)
    SocketTimeoutException,ConnectException
    
    参数:
    
    e -
    
    返回:
    
    true/false
  - storeSortedMap
```
public static void storeSortedMap(java.util.Map<java.lang.String,java.lang.String> map,
                                  java.io.Writer writer,
                                  java.lang.String lineSeparator)
                           throws java.io.IOException
```
    已过时。 replaced by MiscellaneousUtils.storeSortedMap(Map,Writer,String)
    
    对Map中元素以key排序后，每行以{key}={value}形式输出到Writer
    map为空或null时则不向writer写入任何内容
    
    参数:
    
    map -
    
    writer - 为null抛出IllegalArgumentException
    
    lineSeparator - 换行符,为null则使用系统默认的换行符(windows \n linux \r\n)
    
    抛出:
    
    java.io.IOException
  - storeSortedSet
```
public static void storeSortedSet(java.util.Collection<java.lang.String> collection,
                                  java.io.Writer writer,
                                  java.lang.String lineSeparator)
                           throws java.io.IOException
```
    已过时。 replaced by MiscellaneousUtils.storeSortedSet(Collection,Writer,String)
    
    对 Collection中元素排序后(去除重复)，元素分行输出到Writer
    collection为空或null时则不向writer写入任何内容
    
    参数:
    
    collection -
    
    writer - 为null抛出IllegalArgumentException
    
    lineSeparator - 换行符,为null则使用系统默认的换行符(windows \n linux \r\n)
    
    抛出:
    
    java.io.IOException
  - equals
```
public static <K,V> boolean equals(java.util.Map<K,V> m1,
                                   java.util.Map<K,V> m2)
```
    已过时。 replaced by MiscellaneousUtils.equals(Map,Map)
    
    比较两个Map是否相等
    
    参数:
    
    m1 -
    
    m2 -
    
    返回:
    
    相等返回true,否则返回false
  - elementsOf
```
public static java.util.List<java.lang.String> elementsOf(java.lang.String input)
```
    已过时。 replaced by MiscellaneousUtils.elementsOf(String)
    
    将input用分隔符;,\t\r\f\n切分为不含空格和分隔符的一组字符串
    
    参数:
    
    input -
    
    返回:
    
    input为null时返回空表

类 FaceUtilits

构造器概要

方法概要

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

构造器详细资料

FaceUtilits

方法详细资料

getMD5

getBytesInBuffer

getMD5

toHex

toHex

validHEX

hex2Bytes

hex2ByteBuffer

getMD5String

getMD5String

validMd5

readBytes

readBytes

getInputStream

getBytes

getBytesOrNull

getBytesNotEmpty

getByteBuffer

getByteBufferOrNull

getByteBufferNotEmpty

saveImageAutoName

saveImage

createURI

saveBytes

getParameterizedTypeNoThrow

getParameterizedType

getRawClass

getRawClassOfSuperPamamType

getRawClassOfSuperPamamType

getCause

stripThrowableShell

isNetworkError

storeSortedMap

storeSortedSet

equals

elementsOf