AES (bropen-toolkit 4.8.1 API)

java.lang.Object
- bropen.toolkit.utils.security.AES

public class AES
extends java.lang.Object

AES 对称加解密工具

示例：
     // AES d = new AES("AES/CFB");
     AES d = new AES("12345678");
     System.out.println(d.encrypt("abc"));
     System.out.println(d.decrypt(d.encrypt("abc")));
     System.out.println(d.encryptToBase64("abc"));
     System.out.println(d.decryptString(d.encryptToBase64("abc")));

     d.encrypt(new FileInputStream("/dev/shm/ramdisk/plain.xls"), new FileOutputStream("/dev/shm/ramdisk/enc"))
     d.decrypt(new FileInputStream("/dev/shm/ramdisk/enc"), new FileOutputStream("/dev/shm/ramdisk/dec.xls"))

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`ALGORITHM`
`static java.lang.String`	`BASE64_TYPE_MINE`
`static java.lang.String`	`BASE64_TYPE_URLSAFE`
`static java.nio.charset.Charset`	`CHARSET`
`static java.lang.String`	`CIPHER_CBC_ISO10126PADDING`
`static java.lang.String`	`CIPHER_CBC_PKCS5PADDING`
`static java.lang.String`	`CIPHER_CBC_PKCS7PADDING`
`static java.lang.String`	`CIPHER_CFB_ISO10126PADDING`
`static java.lang.String`	`CIPHER_CFB_NOPADDING`
`static java.lang.String`	`CIPHER_CFB_PKCS5PADDING`
`static java.lang.String`	`CIPHER_CFB_PKCS7PADDING`
`static java.lang.String`	`CIPHER_ECB_ISO10126PADDING`
`static java.lang.String`	`CIPHER_ECB_PKCS5PADDING`
`static java.lang.String`	`CIPHER_ECB_PKCS7PADDING`
`static java.lang.String`	`CIPHER_OFB_ISO10126PADDING`
`static java.lang.String`	`CIPHER_OFB_NOPADDING`
`static java.lang.String`	`CIPHER_OFB_PKCS5PADDING`
`static java.lang.String`	`CIPHER_OFB_PKCS7PADDING`

Constructor Summary

Constructors
Constructor and Description

AES(java.lang.String key)
构造方法

AES(java.lang.String key, java.lang.String method)
构造方法

Constructors
Constructor and Description
`AES(java.lang.String key)` 构造方法
`AES(java.lang.String key, java.lang.String method)` 构造方法

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`byte[]`	`decrypt(byte[] encryptedData)` 数据解密
`javax.crypto.CipherInputStream`	`decrypt(java.io.InputStream encryptedIs)` 数据解密
`void`	`decrypt(java.io.InputStream encryptedIs, java.io.OutputStream decryptedOs)` 数据解密
`javax.crypto.CipherOutputStream`	`decrypt(java.io.OutputStream decryptedOs)` 数据解密
`byte[]`	`decrypt(java.lang.String encryptedStr)` 对使用 Base64 编码过的数据解密
`java.lang.String`	`decryptString(byte[] encryptedData)` 数据解密，并返回解密后的字符串
`java.lang.String`	`decryptString(java.lang.String encryptedStr)` 对使用 Base64 编码过的数据解密，并返回解密后的字符串
`byte[]`	`encrypt(byte[] plainData)` 数据加密
`javax.crypto.CipherInputStream`	`encrypt(java.io.InputStream plainIs)` 数据加密
`void`	`encrypt(java.io.InputStream plainIs, java.io.OutputStream encryptedOs)` 数据加密
`javax.crypto.CipherOutputStream`	`encrypt(java.io.OutputStream encryptedOs)` 数据加密
`java.lang.String`	`encryptToBase64(byte[] plainData)` 数据加密并返回 Base64 编码后的字符串
`java.lang.String`	`encryptToBase64(java.lang.String plainStr)` 对字符串加密，并返回 Base64 编码后的字符串
`static void`	`main(java.lang.String[] args)`
`AES`	`setBase64Type(java.lang.String type)` 设置 Base64 的编解码器类型
`AES`	`setIv(byte[] iv)` 设置向量（某些算法必需）
`static boolean`	`validateKey(java.lang.String key)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CHARSET
```
public static final java.nio.charset.Charset CHARSET
```
  - ALGORITHM
```
public static final java.lang.String ALGORITHM
```
    See Also:
    
    Constant Field Values
  - CIPHER_CBC_PKCS5PADDING
```
public static final java.lang.String CIPHER_CBC_PKCS5PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_CBC_PKCS7PADDING
```
public static final java.lang.String CIPHER_CBC_PKCS7PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_CBC_ISO10126PADDING
```
public static final java.lang.String CIPHER_CBC_ISO10126PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_ECB_PKCS5PADDING
```
public static final java.lang.String CIPHER_ECB_PKCS5PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_ECB_PKCS7PADDING
```
public static final java.lang.String CIPHER_ECB_PKCS7PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_ECB_ISO10126PADDING
```
public static final java.lang.String CIPHER_ECB_ISO10126PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_OFB_NOPADDING
```
public static final java.lang.String CIPHER_OFB_NOPADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_OFB_PKCS5PADDING
```
public static final java.lang.String CIPHER_OFB_PKCS5PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_OFB_PKCS7PADDING
```
public static final java.lang.String CIPHER_OFB_PKCS7PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_OFB_ISO10126PADDING
```
public static final java.lang.String CIPHER_OFB_ISO10126PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_CFB_NOPADDING
```
public static final java.lang.String CIPHER_CFB_NOPADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_CFB_PKCS5PADDING
```
public static final java.lang.String CIPHER_CFB_PKCS5PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_CFB_PKCS7PADDING
```
public static final java.lang.String CIPHER_CFB_PKCS7PADDING
```
    See Also:
    
    Constant Field Values
  - CIPHER_CFB_ISO10126PADDING
```
public static final java.lang.String CIPHER_CFB_ISO10126PADDING
```
    See Also:
    
    Constant Field Values
  - BASE64_TYPE_URLSAFE
```
public static final java.lang.String BASE64_TYPE_URLSAFE
```
    See Also:
    
    Constant Field Values
  - BASE64_TYPE_MINE
```
public static final java.lang.String BASE64_TYPE_MINE
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - AES
```
public AES(java.lang.String key,
           java.lang.String method)
```
    构造方法
    
    Parameters:
    
    key - 加解密的密钥，长度为 16、24、32 的字符串；但由于 jvm 的限制，可能只支持长度 16 的秘钥。
    
    method - 算法/模式/填充，默认为 AES/ECB/PKCS5Padding
  - AES
```
public AES(java.lang.String key)
```
    构造方法
    
    Parameters:
    
    key - 加解密的密钥，长度为 16、24、32 的字符串；但由于 jvm 的限制，可能只支持长度 16 的秘钥。
- Method Detail
  - validateKey
```
public static boolean validateKey(java.lang.String key)
                           throws java.security.InvalidKeyException
```
    Throws:
    
    java.security.InvalidKeyException
  - setIv
```
public AES setIv(byte[] iv)
```
    设置向量（某些算法必需）
    
    Parameters:
    
    iv - 向量值，注意长度问题（通常 16 位），避免加解密时抛出 `Wrong IV length` 异常
    
    Returns:
    
    this
  - encrypt
```
public void encrypt(java.io.InputStream plainIs,
                    java.io.OutputStream encryptedOs)
             throws java.security.GeneralSecurityException,
                    java.io.IOException
```
    数据加密
    
    Parameters:
    
    plainIs - 需要加密的数据流，如 FileInputStream
    
    encryptedOs - 解密的输出流，如 FileOutputStream
    
    Throws:
    
    java.security.GeneralSecurityException - .
    
    java.io.IOException - .
  - encrypt
```
public javax.crypto.CipherInputStream encrypt(java.io.InputStream plainIs)
                                       throws java.security.GeneralSecurityException
```
    数据加密
    
    Parameters:
    
    plainIs - 需要加密的数据流，如 FileInputStream
    
    Returns:
    
    已加密的数据输入流
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - encrypt
```
public javax.crypto.CipherOutputStream encrypt(java.io.OutputStream encryptedOs)
                                        throws java.security.GeneralSecurityException
```
    数据加密
    
    Parameters:
    
    encryptedOs - 需要加密输出流，如 FileOutputStream
    
    Returns:
    
    已加密的数据输出流
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - encrypt
```
public byte[] encrypt(byte[] plainData)
               throws java.security.GeneralSecurityException
```
    数据加密
    
    Parameters:
    
    plainData - 需要加密的数据
    
    Returns:
    
    加密的数据
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - encryptToBase64
```
public java.lang.String encryptToBase64(byte[] plainData)
                                 throws java.security.GeneralSecurityException
```
    数据加密并返回 Base64 编码后的字符串
    
    Parameters:
    
    plainData - 需要加密的数据
    
    Returns:
    
    加密并使用 Base64 编码的字符串
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - encryptToBase64
```
public java.lang.String encryptToBase64(java.lang.String plainStr)
                                 throws java.security.GeneralSecurityException
```
    对字符串加密，并返回 Base64 编码后的字符串
    
    Parameters:
    
    plainStr - 需要加密的字符串
    
    Returns:
    
    加密并使用 Base64 编码的字符串
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - decrypt
```
public void decrypt(java.io.InputStream encryptedIs,
                    java.io.OutputStream decryptedOs)
             throws java.security.GeneralSecurityException,
                    java.io.IOException
```
    数据解密
    
    Parameters:
    
    encryptedIs - 加密的数据输入流，如 FileInputStream
    
    decryptedOs - 解密的数据输出流，如 FileOutputStream
    
    Throws:
    
    java.security.GeneralSecurityException - .
    
    java.io.IOException - .
  - decrypt
```
public javax.crypto.CipherOutputStream decrypt(java.io.OutputStream decryptedOs)
                                        throws java.security.GeneralSecurityException
```
    数据解密
    
    Parameters:
    
    decryptedOs - 希望解密的数据输出流
    
    Returns:
    
    已解密的数据输出流
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - decrypt
```
public javax.crypto.CipherInputStream decrypt(java.io.InputStream encryptedIs)
                                       throws java.security.GeneralSecurityException
```
    数据解密
    
    Parameters:
    
    encryptedIs - 加密的数据输入流
    
    Returns:
    
    已解密的数据输入流
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - decrypt
```
public byte[] decrypt(byte[] encryptedData)
               throws java.security.GeneralSecurityException
```
    数据解密
    
    Parameters:
    
    encryptedData - 加密的数据
    
    Returns:
    
    解密后的数据
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - decrypt
```
public byte[] decrypt(java.lang.String encryptedStr)
               throws java.security.GeneralSecurityException
```
    对使用 Base64 编码过的数据解密
    
    Parameters:
    
    encryptedStr - 加密的数据
    
    Returns:
    
    解密后的数据
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - decryptString
```
public java.lang.String decryptString(byte[] encryptedData)
                               throws java.security.GeneralSecurityException
```
    数据解密，并返回解密后的字符串
    
    Parameters:
    
    encryptedData - 加密数据
    
    Returns:
    
    解密后的字符串
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - decryptString
```
public java.lang.String decryptString(java.lang.String encryptedStr)
                               throws java.security.GeneralSecurityException
```
    对使用 Base64 编码过的数据解密，并返回解密后的字符串
    
    Parameters:
    
    encryptedStr - 加密的字符串
    
    Returns:
    
    解密后的字符串
    
    Throws:
    
    java.security.GeneralSecurityException - .
  - setBase64Type
```
public AES setBase64Type(java.lang.String type)
```
    设置 Base64 的编解码器类型
    
    Parameters:
    
    type - 可选 BASE64_TYPE_URLSAFE、BASE64_TYPE_MINE、其他（默认）
    
    Returns:
    
    this
  - main
```
public static void main(java.lang.String[] args)
                 throws java.lang.Exception
```
    Throws:
    
    java.lang.Exception

Class AES

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CHARSET

ALGORITHM

CIPHER_CBC_PKCS5PADDING

CIPHER_CBC_PKCS7PADDING

CIPHER_CBC_ISO10126PADDING

CIPHER_ECB_PKCS5PADDING

CIPHER_ECB_PKCS7PADDING

CIPHER_ECB_ISO10126PADDING

CIPHER_OFB_NOPADDING

CIPHER_OFB_PKCS5PADDING

CIPHER_OFB_PKCS7PADDING

CIPHER_OFB_ISO10126PADDING

CIPHER_CFB_NOPADDING

CIPHER_CFB_PKCS5PADDING

CIPHER_CFB_PKCS7PADDING

CIPHER_CFB_ISO10126PADDING

BASE64_TYPE_URLSAFE

BASE64_TYPE_MINE

Constructor Detail

AES

AES

Method Detail

validateKey

setIv

encrypt

encrypt

encrypt

encrypt

encryptToBase64

encryptToBase64

decrypt

decrypt

decrypt

decrypt

decrypt

decryptString

decryptString

setBase64Type

main