All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.xiaoleilu.hutool.crypto.digest.HMac Maven / Gradle / Ivy

package com.xiaoleilu.hutool.crypto.digest;

import java.io.File;
import java.io.IOException;
import java.io.InputStream;

import javax.crypto.Mac;
import javax.crypto.SecretKey;
import javax.crypto.spec.SecretKeySpec;

import com.xiaoleilu.hutool.crypto.CryptoException;
import com.xiaoleilu.hutool.crypto.SecureUtil;
import com.xiaoleilu.hutool.io.FileUtil;
import com.xiaoleilu.hutool.io.IoUtil;
import com.xiaoleilu.hutool.util.CharsetUtil;
import com.xiaoleilu.hutool.util.HexUtil;
import com.xiaoleilu.hutool.util.StrUtil;

/**
 * HMAC摘要算法
* HMAC,全称为“Hash Message Authentication Code”,中文名“散列消息鉴别码”
* 主要是利用哈希算法,以一个密钥和一个消息为输入,生成一个消息摘要作为输出。
* 一般的,消息鉴别码用于验证传输于两个共 同享有一个密钥的单位之间的消息。
* HMAC 可以与任何迭代散列函数捆绑使用。MD5 和 SHA-1 就是这种散列函数。HMAC 还可以使用一个用于计算和确认消息鉴别值的密钥。
* 注意:此对象实例化后为非线程安全! * @author Looly * */ public class HMac { private Mac mac; private SecretKey secretKey; // ------------------------------------------------------------------------------------------- Constructor start /** * 构造,自动生成密钥 * @param algorithm 算法 {@link HmacAlgorithm} */ public HMac(HmacAlgorithm algorithm) { this(algorithm, (SecretKey)null); } /** * 构造 * @param algorithm 算法 {@link HmacAlgorithm} * @param key 密钥 */ public HMac(HmacAlgorithm algorithm, byte[] key) { init(algorithm.getValue(), key); } /** * 构造 * @param algorithm 算法 {@link HmacAlgorithm} * @param key 密钥 */ public HMac(HmacAlgorithm algorithm, SecretKey key) { init(algorithm.getValue(), key); } // ------------------------------------------------------------------------------------------- Constructor end /** * 初始化 * @param algorithm 算法 * @param key 密钥 * @return {@link HMac} * @throws CryptoException Cause by IOException */ public HMac init(String algorithm, byte[] key){ return init(algorithm, (null == key) ? null : new SecretKeySpec(key, algorithm)); } /** * 初始化 * @param algorithm 算法 * @param key 密钥 {@link SecretKey} * @return {@link HMac} * @throws CryptoException Cause by IOException */ public HMac init(String algorithm, SecretKey key){ try { mac = Mac.getInstance(algorithm); if(null != key){ this.secretKey = key; }else{ this.secretKey = SecureUtil.generateKey(algorithm); } mac.init(this.secretKey); } catch (Exception e) { throw new CryptoException(e); } return this; } // ------------------------------------------------------------------------------------------- Digest /** * 生成文件摘要 * * @param data 被摘要数据 * @param charset 编码 * @return 摘要 */ public byte[] digest(String data, String charset) { return digest(StrUtil.bytes(data, charset)); } /** * 生成文件摘要 * * @param data 被摘要数据 * @return 摘要 */ public byte[] digest(String data) { return digest(data, CharsetUtil.UTF_8); } /** * 生成文件摘要,并转为16进制字符串 * * @param data 被摘要数据 * @param charset 编码 * @return 摘要 */ public String digestHex(String data, String charset) { return HexUtil.encodeHexStr(digest(data, charset)); } /** * 生成文件摘要 * * @param data 被摘要数据 * @return 摘要 */ public String digestHex(String data) { return digestHex(data, CharsetUtil.UTF_8); } /** * 生成文件摘要
* 使用默认缓存大小,见 {@link IoUtil#DEFAULT_BUFFER_SIZE} * * @param file 被摘要文件 * @return 摘要bytes * @throws CryptoException Cause by IOException */ public byte[] digest(File file) throws CryptoException{ InputStream in = null; try { in = FileUtil.getInputStream(file); return digest(in); } finally{ IoUtil.close(in); } } /** * 生成文件摘要,并转为16进制字符串
* 使用默认缓存大小,见 {@link IoUtil#DEFAULT_BUFFER_SIZE} * * @param file 被摘要文件 * @return 摘要 */ public String digestHex(File file) { return HexUtil.encodeHexStr(digest(file)); } /** * 生成摘要 * * @param data 数据bytes * @return 摘要bytes */ public byte[] digest(byte[] data) { byte[] result; try { result = mac.doFinal(data); } finally { mac.reset(); } return result; } /** * 生成摘要,并转为16进制字符串
* * @param data 被摘要数据 * @return 摘要 */ public String digestHex(byte[] data) { return HexUtil.encodeHexStr(digest(data)); } /** * 生成摘要,使用默认缓存大小,见 {@link IoUtil#DEFAULT_BUFFER_SIZE} * * @param data {@link InputStream} 数据流 * @return 摘要bytes */ public byte[] digest(InputStream data) { return digest(data, IoUtil.DEFAULT_BUFFER_SIZE); } /** * 生成摘要,并转为16进制字符串
* 使用默认缓存大小,见 {@link IoUtil#DEFAULT_BUFFER_SIZE} * * @param data 被摘要数据 * @return 摘要 */ public String digestHex(InputStream data) { return HexUtil.encodeHexStr(digest(data)); } /** * 生成摘要 * * @param data {@link InputStream} 数据流 * @param bufferLength 缓存长度,不足1使用 {@link IoUtil#DEFAULT_BUFFER_SIZE} 做为默认值 * @return 摘要bytes */ public byte[] digest(InputStream data, int bufferLength) { if (bufferLength < 1) { bufferLength = IoUtil.DEFAULT_BUFFER_SIZE; } byte[] buffer = new byte[bufferLength]; byte[] result = null; try { int read = data.read(buffer, 0, bufferLength); while (read > -1) { mac.update(buffer, 0, read); read = data.read(buffer, 0, bufferLength); } result = mac.doFinal(); } catch (IOException e) { throw new CryptoException(e); }finally{ mac.reset(); } return result; } /** * 生成摘要,并转为16进制字符串
* 使用默认缓存大小,见 {@link IoUtil#DEFAULT_BUFFER_SIZE} * * @param data 被摘要数据 * @param bufferLength 缓存长度,不足1使用 {@link IoUtil#DEFAULT_BUFFER_SIZE} 做为默认值 * @return 摘要 */ public String digestHex(InputStream data, int bufferLength) { return HexUtil.encodeHexStr(digest(data, bufferLength)); } /** * 获得 {@link Mac} * @return {@link Mac} */ public Mac getMac() { return mac; } /** * 获得密钥 * @return 密钥 * @since 3.0.3 */ public SecretKey getSecretKey() { return secretKey; } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy