程序包 gu.sql2java.store

类 BinaryUtils

java.lang.Object

gu.sql2java.store.BinaryUtils

public class BinaryUtils
extends Object

二进制数据(byte[],ByteBuffer)工具类

作者:

guyadong

构造器概要

构造器

构造器	说明
BinaryUtils()

方法概要

修饰符和类型	方法	说明
static final <T> ByteBuffer	getByteBuffer(T src)	将数据对象src转换为ByteBuffer
static final <T> ByteBuffer	getByteBufferNotEmpty(T src)	调用 getByteBuffer(Object)返回非空ByteBuffer 如果返回null或空，则抛出IOException
static final <T> byte[]	getBytes(T src)	将数据对象src转换为字节数组(byte[]) src的数据类型可以是byte[],InputStream,ByteBuffer,String(base64编码),File,URL,URI 否则抛出IllegalArgumentException 对象转换为InputStream或byte[]时,可能会抛出IOException 当src为File或FileInputStream时，使用NIO方式(readBytes(FileInputStream))读取
static final byte[]	getBytesInBuffer(ByteBuffer buffer)	返回buffer中所有字节(position~limit),不改变buffer状态
static final <T> byte[]	getBytesNotEmpty(T src)	调用 getBytes(Object)返回非空字节数组 如果返回null或空字节数组，则抛出IOException
static final <T> InputStream	getInputStream(T src)	将对象转换为InputStream 类型可以是byte[],ByteBuffer,InputStream,String(base64编码),File,URL,URI,否则抛出RuntimeException
static final byte[]	getMD5(byte[] source)	生成MD5校验码
static final ByteBuffer	getMD5(ByteBuffer source)	生成MD5校验码
static final String	getMD5String(byte[] source)	生成MD5校验码字符串
static final String	getMD5String(ByteBuffer source)	生成MD5校验码字符串
static final ByteBuffer	hex2ByteBuffer(String src)	convert HEX string to ByteBuffer
static final byte[]	hex2Bytes(String src)	convert HEX string to byte array
static final byte[]	readBytes(FileInputStream fin)	NIO方式从FileInputStream读取字节数组 结束时会关闭InputStream
static final byte[]	readBytes(InputStream in)	从InputStream读取字节数组 当in为FileInputStream时，调用readBytes(FileInputStream)(NIO方式)读取 结束时会关闭InputStream
static final File	saveBytes(byte[] data, File file, boolean overwrite)	NIO方式将data数据保存在file指定的文件中 如果file所在文件夹不存在，则会自动创建所有的文件夹
static final String	toHex(byte[] buffer)	将16位byte[] 转换为32位的HEX格式的字符串String
static final String	toHex(ByteBuffer buffer)
static final boolean	validHEX(String input)	字符串验证器,根据正则表达式判断字符串是否为十六进制(HEX)字符串 输入为null或空或正则表达式不匹配则返回false
static final boolean	validMd5(String md5)	判断是否为有效的MD5字符串

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

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

构造器详细资料

BinaryUtils

public BinaryUtils()

方法详细资料

getMD5

public static final byte[] getMD5(byte[] source)

生成MD5校验码

参数:

source -

getBytesInBuffer

public static final byte[] getBytesInBuffer(ByteBuffer buffer)

返回buffer中所有字节(position~limit),不改变buffer状态

参数:

buffer -

返回:

buffer 为 null 时返回 null

getMD5

public static final ByteBuffer getMD5(ByteBuffer source)

生成MD5校验码

参数:

source -

另请参阅:

• getMD5(byte[])

toHex

public static final String toHex(byte[] buffer)

将16位byte[] 转换为32位的HEX格式的字符串String

参数:

buffer -

toHex

public static final String toHex(ByteBuffer buffer)

另请参阅:

• toHex(byte[])

validHEX

public static final boolean validHEX(String input)

字符串验证器,根据正则表达式判断字符串是否为十六进制(HEX)字符串 输入为null或空或正则表达式不匹配则返回false

hex2Bytes

public static final byte[] hex2Bytes(String src)

convert HEX string to byte array

参数:

src -

返回:

byte array or null if src is null

hex2ByteBuffer

public static final ByteBuffer hex2ByteBuffer(String src)

convert HEX string to ByteBuffer

参数:

src -

返回:

byte array or null if src is null

getMD5String

public static final String getMD5String(byte[] source)

生成MD5校验码字符串

参数:

source -

另请参阅:

• getMD5(byte[])
• toHex(byte[])

getMD5String

public static final String getMD5String(ByteBuffer source)

生成MD5校验码字符串

参数:

source -

另请参阅:

• getMD5(byte[])
• toHex(byte[])

validMd5

public static final boolean validMd5(String md5)

判断是否为有效的MD5字符串

readBytes

public static final byte[] readBytes(InputStream in)
                              throws IOException,
IllegalArgumentException

从InputStream读取字节数组
当in为FileInputStream时，调用readBytes(FileInputStream)(NIO方式)读取
结束时会关闭InputStream

参数:

in - 为null返回null

返回:

字节数组，如果输入为null返回null

抛出:

IOException

IllegalArgumentException - in为null

readBytes

public static final byte[] readBytes(FileInputStream fin)
                              throws IOException

NIO方式从FileInputStream读取字节数组
结束时会关闭InputStream

参数:

fin - FileInputStream

返回:

返回读取的字节数 当fin为null时返回null;

抛出:

IOException

getInputStream

public static final <T> InputStream getInputStream(T src)
                                            throws IOException,
IllegalArgumentException

将对象转换为InputStream
类型可以是byte[],ByteBuffer,InputStream,String(base64编码),File,URL,URI,否则抛出RuntimeException

参数:

src - 获取InputStream的源对象

返回:

返回获取的InputStream对象,src为null返回null,类型错误抛出异常

抛出:

IOException

IllegalArgumentException - 无法从src获取InputStream

getBytes

public static final <T> byte[] getBytes(T src)
                                 throws IOException,
IllegalArgumentException

将数据对象src转换为字节数组(byte[])
src的数据类型可以是byte[],InputStream,ByteBuffer,String(base64编码),File,URL,URI 否则抛出IllegalArgumentException
对象转换为InputStream或byte[]时,可能会抛出IOException 当src为File或FileInputStream时，使用NIO方式(readBytes(FileInputStream))读取

参数:

src - 获取byte[]的源对象

返回:

返回字节数组,参数为null返回null,类型不对则抛出异常

抛出:

IOException

IllegalArgumentException - src为null或无法从src获取InputStream

另请参阅:

• readBytes(InputStream)
• readBytes(FileInputStream)
• getInputStream(Object)
• Base64Utils.decode(String)

getBytesNotEmpty

public static final <T> byte[] getBytesNotEmpty(T src)
                                         throws IOException

调用 getBytes(Object)返回非空字节数组
如果返回null或空字节数组，则抛出IOException

参数:

src - 获取byte[]的源对象

返回:

返回非空字节数组

抛出:

IOException

另请参阅:

• getBytes(Object)

getByteBuffer

public static final <T> ByteBuffer getByteBuffer(T src)
                                          throws IOException,
IllegalArgumentException

将数据对象src转换为ByteBuffer

参数:

src - 获取byte[]的源对象

返回:

返回字节数组,参数为null返回null,类型不对则抛出异常

抛出:

IOException

IllegalArgumentException - 无法从src获取InputStream

另请参阅:

• getBytes(Object)

getByteBufferNotEmpty

public static final <T> ByteBuffer getByteBufferNotEmpty(T src)
                                                  throws IOException,
IllegalArgumentException

调用 getByteBuffer(Object)返回非空ByteBuffer
如果返回null或空，则抛出IOException

参数:

src -

返回:

返回非空字节数组

抛出:

IOException

IllegalArgumentException

saveBytes

public static final File saveBytes(byte[] data,
 File file,
 boolean overwrite)
                            throws IOException,
IllegalArgumentException

NIO方式将data数据保存在file指定的文件中
如果file所在文件夹不存在，则会自动创建所有的文件夹

参数:

data -

file - 文件保存的位置

overwrite - 同名文件存在时是否覆盖

返回:

返回保存的文件名

抛出:

IOException - file存在但不是文件或其他IO异常

IllegalArgumentException - data为null时