javax.crypto

Class SecretKeyFactory

java.lang.Object

javax.crypto.SecretKeyFactory

public class SecretKeyFactory
extends Object

这个类代表一个秘密密钥的工厂。

主要工厂用于将密钥 （类型为Key不透明加密密钥）转换为密钥规范 （基础密钥材料的透明表示），反之亦然。 秘密密钥工厂仅在秘密（对称）密钥上运行。

关键工厂是双向的，即它们允许从给定的密钥规范（密钥材料）构建一个不透明的密钥对象，或以适当的格式检索密钥对象的基础密钥材料。

应用程序开发人员应参考其提供商的文档，以了解generateSecret和getKeySpec方法支持哪些关键规范。 例如，“SunJCE”提供商提供的DES秘密密钥工厂支持DESKeySpec作为DES密钥的透明表示，该提供商的三重DES密钥密钥工厂支持DESedeKeySpec作为三重DES密钥的透明表示。

Java平台的每个实现都需要支持以下标准的SecretKeyFactory算法：

• DES
• DESede

这些算法的描述SecretKeyFactory section Java加密体系结构标准算法名称的文档。 请参阅发行说明文件以了解是否支持其他算法。

从以下版本开始：

1.4

另请参见：

SecretKey ， DESKeySpec ， DESedeKeySpec ， PBEKeySpec

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	SecretKeyFactory(SecretKeyFactorySpi keyFacSpi, Provider provider, String algorithm) 创建一个SecretKeyFactory对象。

方法摘要

Modifier and Type	Method and Description
SecretKey	generateSecret(KeySpec keySpec) 根据提供的密钥规范（密钥材料）生成一个 SecretKey对象。
String	getAlgorithm() 返回此 SecretKeyFactory对象的算法名称。
static SecretKeyFactory	getInstance(String algorithm) 返回 SecretKeyFactory对象转换指定算法的密钥。
static SecretKeyFactory	getInstance(String algorithm, Provider provider) 返回 SecretKeyFactory对象转换指定算法的密钥。
static SecretKeyFactory	getInstance(String algorithm, String provider) 返回 SecretKeyFactory对象转换指定算法的密钥。
KeySpec	getKeySpec(SecretKey key, 类<?> keySpec) 以请求的格式返回给定键对象的规范（关键材料）。
Provider	getProvider() 返回此 SecretKeyFactory对象的提供者。
SecretKey	translateKey(SecretKey key) 将其提供者可能未知或可能不受信任的关键对象转换为该秘密密钥工厂的相应密钥对象。

Methods inherited from class java.lang.Object

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

构造方法详细信息

SecretKeyFactory

protected SecretKeyFactory(SecretKeyFactorySpi keyFacSpi,
                           Provider provider,
                           String algorithm)

创建一个SecretKeyFactory对象。

参数

keyFacSpi - 代表

provider - 提供商

algorithm - 秘密密钥算法

方法详细信息

getInstance

public static final SecretKeyFactory getInstance(String algorithm)
                                          throws NoSuchAlgorithmException

返回SecretKeyFactory对象转换指定算法的密钥。

此方法遍历已注册的安全提供程序列表，从最优选的提供程序开始。 返回从支持指定算法的第一个Provider中封装SecretKeyFactorySpi实现的新SecretKeyFactory对象。

请注意，注册提供商的列表可以通过Security.getProviders()方法检索 。

参数

algorithm - 所请求密钥算法的标准名称。 看到的SecretKeyFactory部分Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称的信息。

结果

新的 SecretKeyFactory对象。

异常

NullPointerException - 如果指定的算法为空。

NoSuchAlgorithmException - 如果没有提供者支持指定算法的SecretKeyFactorySpi实现。

另请参见：

Provider

getInstance

public static final SecretKeyFactory getInstance(String algorithm,
                                                 String provider)
                                          throws NoSuchAlgorithmException,
                                                 NoSuchProviderException

返回SecretKeyFactory对象转换指定算法的密钥。

返回从指定提供程序封装SecretKeyFactorySpi实现的新SecretKeyFactory对象。 指定的提供者必须在安全提供程序列表中注册。

注意，可以通过Security.getProviders()方法检索已注册提供商的列表。

参数

algorithm - 所请求密钥算法的标准名称。 看到的SecretKeyFactory部分Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称的信息。

provider - 提供者的名称。

结果

新的 SecretKeyFactory对象。

异常

NoSuchAlgorithmException - 如果指定算法的SecretKeyFactorySpi实现不能从指定的提供者获得。

NullPointerException - 如果指定的算法为空。

NoSuchProviderException - 如果指定的提供程序未在安全提供程序列表中注册。

IllegalArgumentException - 如果 provider为空或为空。

另请参见：

Provider

getInstance

public static final SecretKeyFactory getInstance(String algorithm,
                                                 Provider provider)
                                          throws NoSuchAlgorithmException

返回SecretKeyFactory对象转换指定算法的密钥。

返回从指定的Provider对象封装SecretKeyFactorySpi实现的新SecretKeyFactory对象。 请注意，指定的Provider对象不必在提供者列表中注册。

参数

algorithm - 所请求密钥算法的标准名称。 看到的SecretKeyFactory部分Java Cryptography Architecture Standard Algorithm Name Documentation有关标准算法名称的信息。

provider - 提供商。

结果

新的 SecretKeyFactory对象。

异常

NullPointerException - 如果指定的算法为空。

NoSuchAlgorithmException - 如果指定的算法的SecretKeyFactorySpi实现从指定的Provider对象不可用。

IllegalArgumentException - 如果 provider为空。

另请参见：

Provider

getProvider

public final Provider getProvider()

返回此 SecretKeyFactory对象的提供者。

结果

这个 SecretKeyFactory对象的提供者

getAlgorithm

public final String getAlgorithm()

返回此SecretKeyFactory对象的算法名称。

这是在创建此SecretKeyFactory对象的getInstance调用之一中指定的getInstance 。

结果

这个 SecretKeyFactory对象的算法名称。

generateSecret

public final SecretKey generateSecret(KeySpec keySpec)
                               throws InvalidKeySpecException

从提供的密钥规范（密钥材料）生成一个 SecretKey对象。

参数

keySpec - 秘密密钥的规范（密钥材料）

结果

密钥

异常

InvalidKeySpecException - 如果给定的密钥规范不适合该秘密密钥工厂生成密钥。

getKeySpec

public final KeySpec getKeySpec(SecretKey key,
                                类<?> keySpec)
                         throws InvalidKeySpecException

以请求的格式返回给定键对象的规范（关键材料）。

参数

key - 关键

keySpec - 要求退还关键材料的要求格式

结果

请求格式的基础密钥规范（密钥材料）

异常

InvalidKeySpecException - 如果所请求的密钥规范对于给定的密钥是不合适的（例如，与 key和 keySpec不匹配，或 key引用加密硬件设备上的密钥，而 keySpec是基于软件的密钥的规范）或者给定的密钥不能被处理（例如，给定的密钥具有该秘密密钥工厂不支持的算法或格式）。

translateKey

public final SecretKey translateKey(SecretKey key)
                             throws InvalidKeyException

将其提供者可能未知或可能不受信任的关键对象转换为该秘密密钥工厂的相应密钥对象。

参数

key - 提供者未知或不信任的关键

结果

翻译密钥

异常

InvalidKeyException - 如果该密钥工厂无法处理给定的密钥。