javax.crypto.spec

Class PBEKeySpec

java.lang.Object

javax.crypto.spec.PBEKeySpec

All Implemented Interfaces:

KeySpec

public class PBEKeySpec
extends Object
implements KeySpec

用户选择的密码，可以用密码加密（PBE）。

密码可以被看作是某种原始的密钥材料，从它使用它的加密机制派生出一个密钥。

不同的PBE机制可能消耗不同的位的每一个密码字符。例如，PBE机制定义 PKCS #5看着只有低8位的每一个字符，而# PKCS 12看16位的每一个字符。

你把密码字符PBE关键创造合适的密钥厂实例。例如，一个# PKCS 5密钥工厂将只从低阶的8位密码字符构建PBE密钥，而密钥# PKCS 12厂将全部16位的每一个字符。

还注意到，这类存储密码代替String对象字符数组（这似乎更合乎逻辑），因为String类是不可变的，无法覆盖其内在价值时使用的密码存储在它不再需要。因此，这类请求的密码作为一个char数组，所以它可以被覆盖的时候做的。

从以下版本开始：

一点四

另请参见：

SecretKeyFactory， PBEParameterSpec

构造方法摘要

构造方法

Constructor and Description
PBEKeySpec(char[] password) 需要密码的构造函数。
PBEKeySpec(char[] password, byte[] salt, int iterationCount) 构造函数需要一个密码，盐，用于产生固定的密钥大小PBE密码pbekey迭代次数。
PBEKeySpec(char[] password, byte[] salt, int iterationCount, int keyLength) 构造函数需要一个密码，盐，迭代次数，并导出生成可变密钥大小pbekey PBE密码密钥长度。

方法摘要

Modifier and Type	Method and Description
void	clearPassword() 清除密码的内部副本。
int	getIterationCount() 返回迭代计数或0，如果没有指定。
int	getKeyLength() 返回要导出的密钥长度或0，如果没有指定。
char[]	getPassword() 返回密码的副本。
byte[]	getSalt() 如果没有指定的话，返回一个盐或空的副本。

Methods inherited from class java.lang.Object

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

Constructor Detail

PBEKeySpec

public PBEKeySpec(char[] password)

需要密码的构造函数。如果指定了空值，则使用一个空字符。

注：password克隆之前，它是存储在新的PBEKeySpec对象。

参数

password -密码。

PBEKeySpec

public PBEKeySpec(char[] password,
                  byte[] salt,
                  int iterationCount,
                  int keyLength)

构造函数需要一个密码，盐，迭代次数，并导出生成可变密钥大小pbekey PBE密码密钥长度。一个空字符[ ]如果空 password

注：本password和salt克隆之前，它们被存储在新的PBEKeySpec对象。

指定使用。

参数

password -密码。

salt -盐。

iterationCount -迭代计数。

keyLength -要导出密钥长度。

异常

NullPointerException -如果 salt是空的。

IllegalArgumentException -如果 salt是空的，即长度为0， iterationCount或 keyLength不积极。

PBEKeySpec

public PBEKeySpec(char[] password,
                  byte[] salt,
                  int iterationCount)

构造函数需要一个密码，盐，用于产生固定的密钥大小PBE密码pbekey迭代次数。一个空字符null [ ]如果指定使用 password。

注：本password和salt克隆之前，它们被存储在新的PBEKeySpec对象。

参数

password -密码。

salt -盐。

iterationCount -迭代计数。

异常

NullPointerException -如果 salt是空的。

IllegalArgumentException -如果 salt是空的，即长度为0，或 iterationCount不积极。

方法详细信息

clearPassword

public final void clearPassword()

清除密码的内部副本。

getPassword

public final char[] getPassword()

返回密码的副本。

注：此方法返回密码的副本。它是调用方的责任，以零出密码信息后，它不再需要。

结果

密码。

异常

IllegalStateException如果密码已经通过电话 clearPassword方法清除。

getSalt

public final byte[] getSalt()

如果没有指定的话，返回一个盐或空的副本。

注：此方法应返回一份盐。这是来电者的责任，以零掉盐信息后，不再需要。

结果

盐。

getIterationCount

public final int getIterationCount()

返回迭代计数或0，如果没有指定。

结果

迭代计数。

getKeyLength

public final int getKeyLength()

返回要导出的密钥长度或0，如果没有指定。

注：这是用来表示可变密钥大小密码对密钥长度的偏好。实际的密钥大小取决于每个供应商的实现。

结果

导出密钥长度。