org.aoju.bus.crypto.symmetric

Class Crypto

java.lang.Object

org.aoju.bus.crypto.symmetric.Crypto

All Implemented Interfaces:

Serializable, Decryptor, Encryptor

Direct Known Subclasses:

AES, ChaCha20, DES, DESede, SM4, ZUC

public class Crypto
extends Object
implements Encryptor, Decryptor, Serializable

对称加密算法 在对称加密算法中，数据发信方将明文（原始数据）和加密密钥一起经过特殊加密算法处理后，使其变成复杂的加密密文发送出去。 收信方收到密文后，若想解读原文，则需要使用加密用过的密钥及相同算法的逆算法对密文进行解密，才能使其恢复成可读明文。 在对称加密算法中，使用的密钥只有一个，发收信双方都使用这个密钥对数据进行加密和解密，这就要求解密方事先必须知道加密密钥。

Since:

JDK 1.8+

Version:

6.3.1

Author:

Kimi Liu

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Crypto(org.aoju.bus.core.lang.Algorithm algorithm) 构造，使用随机密钥
Crypto(org.aoju.bus.core.lang.Algorithm algorithm, byte[] key) 构造
Crypto(org.aoju.bus.core.lang.Algorithm algorithm, SecretKey key) 构造
Crypto(String algorithm) 构造，使用随机密钥
Crypto(String algorithm, byte[] key) 构造
Crypto(String algorithm, SecretKey key) 构造
Crypto(String algorithm, SecretKey key, AlgorithmParameterSpec paramsSpec) 构造

Method Summary

Modifier and Type	Method and Description
byte[]	decrypt(byte[] bytes) 解密
void	decrypt(InputStream data, OutputStream out, boolean isClose) 解密，针对大数据量，结束后不关闭流
byte[]	encrypt(byte[] data) 加密
void	encrypt(InputStream data, OutputStream out, boolean isClose) 加密，针对大数据量，可选结束后是否关闭流
Cipher	getCipher() 获得加密或解密器
SecretKey	getSecretKey() 获得对称密钥
Crypto	init(String algorithm, SecretKey key) 初始化
Crypto	setIv(byte[] iv) 设置偏移向量
Crypto	setIv(IvParameterSpec iv) 设置偏移向量
Crypto	setMode(Mode.Cipher mode) 初始化模式并清空数据
Crypto	setParams(AlgorithmParameterSpec params) 设置 AlgorithmParameterSpec，通常用于加盐或偏移向量
byte[]	update(byte[] data) 更新数据，分组加密中间结果可以当作随机数 第一次更新数据前需要调用setMode(Mode.Cipher)初始化加密或解密模式，然后每次更新数据都是累加模式
String	updateHex(byte[] data) 更新数据，分组加密中间结果可以当作随机数 第一次更新数据前需要调用setMode(Mode.Cipher)初始化加密或解密模式，然后每次更新数据都是累加模式

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.aoju.bus.crypto.symmetric.Encryptor

encrypt, encrypt, encrypt, encrypt, encryptBase64, encryptBase64, encryptBase64, encryptBase64, encryptBase64, encryptHex, encryptHex, encryptHex, encryptHex, encryptHex

Methods inherited from interface org.aoju.bus.crypto.symmetric.Decryptor

decrypt, decrypt, decryptStr, decryptStr, decryptStr, decryptStr, decryptStr, decryptStr

Constructor Detail

Crypto

public Crypto(org.aoju.bus.core.lang.Algorithm algorithm)

构造，使用随机密钥

Parameters:

algorithm - Algorithm

Crypto

public Crypto(String algorithm)

构造，使用随机密钥

Parameters:

algorithm - 算法，可以是"algorithm/mode/padding"或者"algorithm"

Crypto

public Crypto(org.aoju.bus.core.lang.Algorithm algorithm,
              byte[] key)

构造

Parameters:

algorithm - 算法 Algorithm

key - 自定义KEY

Crypto

public Crypto(org.aoju.bus.core.lang.Algorithm algorithm,
              SecretKey key)

构造

Parameters:

algorithm - 算法 Algorithm

key - 自定义KEY

Crypto

public Crypto(String algorithm,
              byte[] key)

构造

Parameters:

algorithm - 算法

key - 密钥

Crypto

public Crypto(String algorithm,
              SecretKey key)

构造

Parameters:

algorithm - 算法

key - 密钥

Crypto

public Crypto(String algorithm,
              SecretKey key,
              AlgorithmParameterSpec paramsSpec)

构造

Parameters:

algorithm - 算法

key - 密钥

paramsSpec - 算法参数，例如加盐等

Method Detail

init

public Crypto init(String algorithm,
                   SecretKey key)

初始化

Parameters:

algorithm - 算法

key - 密钥，如果为null自动生成一个key

Returns:

Crypto的子对象，即子对象自身

getSecretKey

public SecretKey getSecretKey()

获得对称密钥

Returns:

获得对称密钥

getCipher

public Cipher getCipher()

获得加密或解密器

Returns:

加密或解密

setParams

public Crypto setParams(AlgorithmParameterSpec params)

设置 AlgorithmParameterSpec，通常用于加盐或偏移向量

Parameters:

params - AlgorithmParameterSpec

Returns:

自身

setIv

public Crypto setIv(IvParameterSpec iv)

设置偏移向量

Parameters:

iv - IvParameterSpec偏移向量

Returns:

自身

setIv

public Crypto setIv(byte[] iv)

设置偏移向量

Parameters:

iv - 偏移向量，加盐

Returns:

自身

setMode

public Crypto setMode(Mode.Cipher mode)

初始化模式并清空数据

Parameters:

mode - 模式枚举

Returns:

this

update

public byte[] update(byte[] data)

更新数据，分组加密中间结果可以当作随机数 第一次更新数据前需要调用setMode(Mode.Cipher)初始化加密或解密模式，然后每次更新数据都是累加模式

Parameters:

data - 被加密的bytes

Returns:

update之后的bytes

updateHex

public String updateHex(byte[] data)

更新数据，分组加密中间结果可以当作随机数 第一次更新数据前需要调用setMode(Mode.Cipher)初始化加密或解密模式，然后每次更新数据都是累加模式

Parameters:

data - 被加密的bytes

Returns:

update之后的hex数据

encrypt

public byte[] encrypt(byte[] data)

Description copied from interface: Encryptor

加密

Specified by:

encrypt in interface Encryptor

Parameters:

data - 被加密的bytes

Returns:

加密后的bytes

encrypt

public void encrypt(InputStream data,
                    OutputStream out,
                    boolean isClose)
             throws org.aoju.bus.core.lang.exception.CryptoException

Description copied from interface: Encryptor

加密，针对大数据量，可选结束后是否关闭流

Specified by:

encrypt in interface Encryptor

Parameters:

data - 被加密的字符串

out - 输出流，可以是文件或网络位置

isClose - 是否关闭流

Throws:

org.aoju.bus.core.lang.exception.CryptoException

decrypt

public byte[] decrypt(byte[] bytes)

Description copied from interface: Decryptor

解密

Specified by:

decrypt in interface Decryptor

Parameters:

bytes - 被解密的bytes

Returns:

解密后的bytes

decrypt

public void decrypt(InputStream data,
                    OutputStream out,
                    boolean isClose)
             throws org.aoju.bus.core.lang.exception.CryptoException

Description copied from interface: Decryptor

解密，针对大数据量，结束后不关闭流

Specified by:

decrypt in interface Decryptor

Parameters:

data - 加密的字符串

out - 输出流，可以是文件或网络位置

isClose - 是否关闭流，包括输入和输出流

Throws:

org.aoju.bus.core.lang.exception.CryptoException