javax.crypto

Class SecretKeyFactory

java.lang.Object

javax.crypto.SecretKeyFactory

public class SecretKeyFactory
extends Object

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

关键的工厂是用来将钥匙（不透明的密钥类型Key）为主要规格（基础关键材料的透明表示），反之亦然。秘密密钥工厂只操作秘密（对称）密钥。

关键工厂是双向的，也就是说，他们允许建立一个不透明的关键对象从一个给定的关键规范（关键材料），或检索的基本关键材料的一个合适的格式的一个关键对象。

应用程序开发者应该参考他们的供应商的文档，找出其中的关键指标是由generateSecret和getKeySpec方法支持。例如，DES密钥厂以“sunjce提供者”支持DESKeySpec作为一个透明的DES密钥表示，供应商提供的密钥对DES密钥支持DESedeKeySpec工厂作为一个透明的DES密钥表示。

java平台的每种实现都要求支持以下标准SecretKeyFactory算法：

• DES
• DESede

这些算法的java加密体系标准算法的名字 SecretKeyFactory section描述文件。请咨询您的实现的发布文档，以查看是否支持任何其他算法。

从以下版本开始：

一点四

另请参见：

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

Constructor Detail

SecretKeyFactory

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

创建一个secretkeyfactory对象。

参数

keyFacSpi -代表

provider -供应商

algorithm -秘密密钥算法

方法详细信息

getInstance

public static final SecretKeyFactory getInstance(String algorithm)
                                          throws NoSuchAlgorithmException

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

该方法通过注册安全提供商列表，从最开始的首选供应商。一个新的secretkeyfactory对象封装secretkeyfactoryspi实施支持指定算法的第一供应商返回。

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

参数

algorithm -请求的密钥算法的标准名称。看到有关标准算法名称信息在 Java Cryptography Architecture Standard Algorithm Name Documentation的secretkeyfactory节。

结果

新 SecretKeyFactory对象。

异常

NullPointerException -如果指定的算法是无效的。

NoSuchAlgorithmException -如果没有提供程序支持一个指定的算法secretkeyfactoryspi实施。

另请参见：

Provider

getInstance

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

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

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

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

参数

algorithm -请求的密钥算法的标准名称。看到有关标准算法名称信息在 Java Cryptography Architecture Standard Algorithm Name Documentation的secretkeyfactory节。

provider -提供者的名称。

结果

新 SecretKeyFactory对象。

异常

NoSuchAlgorithmException -如果一个指定的算法secretkeyfactoryspi执行不可从指定的供应商。

NullPointerException -如果指定的算法是无效的。

NoSuchProviderException -如果指定的供应商不在安全提供商注册名单。

IllegalArgumentException -如果 provider是null或空。

另请参见：

Provider

getInstance

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

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

一个新的secretkeyfactory对象封装secretkeyfactoryspi实现从指定的提供程序对象返回。请注意，指定的提供程序对象不必在提供者列表中注册。

参数

algorithm -请求的密钥算法的标准名称。看到有关标准算法名称信息在 Java Cryptography Architecture Standard Algorithm Name Documentation的secretkeyfactory节。

provider -供应商。

结果

新 SecretKeyFactory对象。

异常

NullPointerException -如果指定的算法是无效的。

NoSuchAlgorithmException -如果一个指定的算法secretkeyfactoryspi执行不可从指定的提供程序对象。

IllegalArgumentException -如果 provider是空的。

另请参见：

Provider

getProvider

public final Provider getProvider()

返回该对象的 SecretKeyFactory提供者。

结果

这 SecretKeyFactory对象的提供者

getAlgorithm

public final String getAlgorithm()

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

这是相同的名字，是在一个SecretKeyFactory创建这个对象调用指定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如果给定键不能用这个密钥的工厂加工。