compact1, compact2, compact3

java.security

Class KeyFactory

java.lang.Object

java.security.KeyFactory

public class KeyFactory
extends Object

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

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

多个兼容的密钥规范可能存在于同一个密钥中。例如，一个用公开密钥可以使用DSAPublicKeySpec或X509EncodedKeySpec指定。关键的工厂可以把关键指标之间的兼容。

下面是一个例子，如何使用为关键工厂实例化一个DSA公钥编码。假设爱丽丝已经收到了鲍伯的签名。鲍伯还把她自己的公共密钥（编码格式）来验证自己的签名。爱丽丝然后执行以下动作：

x509encodedkeyspec bobpubkeyspec =新x509encodedkeyspec（bobencodedpubkey）；keyfactory keyfactory = keyfactory getInstance（“DSA”）；公钥bobpubkey = keyfactory generatepublic（bobpubkeyspec）；签名Sig为签名。getInstance（“DSA”）；SIG initverify（bobpubkey）；SIG的更新（数据）；签名验证（签名）；

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

• DiffieHellman
• DSA
• RSA

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

从以下版本开始：

一点二

另请参见：

Key， PublicKey， PrivateKey， KeySpec， DSAPublicKeySpec， X509EncodedKeySpec

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	Method and Description
PrivateKey	generatePrivate(KeySpec keySpec) 从所提供的关键规范（关键材料）生成一个私有密钥对象。
PublicKey	generatePublic(KeySpec keySpec) 从所提供的关键规范（关键材料）生成公共密钥对象。
String	getAlgorithm() 得到这个 KeyFactory相关算法的名字。
static KeyFactory	getInstance(String algorithm) 返回一个对象，keyfactory转换指定算法的公共/私人密钥。
static KeyFactory	getInstance(String algorithm, Provider provider) 返回一个对象，keyfactory转换指定算法的公共/私人密钥。
static KeyFactory	getInstance(String algorithm, String provider) 返回一个对象，keyfactory转换指定算法的公共/私人密钥。
<T extends KeySpec> T	getKeySpec(Key key, 类<T> keySpec) 返回给定键对象的规范（关键材料）。
Provider	getProvider() 返回此键工厂对象的提供程序。
Key	translateKey(Key key) 翻译的重点对象，其供应商可能是未知的或潜在的不受信任的，在相应的关键对象这一关键厂。

Methods inherited from class java.lang.Object

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

Constructor Detail

KeyFactory

protected KeyFactory(KeyFactorySpi keyFacSpi,
                     Provider provider,
                     String algorithm)

创建一个keyfactory对象。

参数

keyFacSpi -代表

provider -供应商

algorithm -算法的名字与这个 KeyFactory副

方法详细信息

getInstance

public static KeyFactory getInstance(String algorithm)
                              throws NoSuchAlgorithmException

返回一个对象，keyfactory转换指定算法的公共/私人密钥。

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

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

参数

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

结果

新keyfactory对象。

异常

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

另请参见：

Provider

getInstance

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

返回一个对象，keyfactory转换指定算法的公共/私人密钥。

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

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

参数

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

provider -提供者的名称。

结果

新keyfactory对象。

异常

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

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

IllegalArgumentException如果提供者名称为空或空。

另请参见：

Provider

getInstance

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

返回一个对象，keyfactory转换指定算法的公共/私人密钥。

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

参数

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

provider -供应商。

结果

新keyfactory对象。

异常

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

IllegalArgumentException -如果指定的提供程序是无效的。

从以下版本开始：

一点四

另请参见：

Provider

getProvider

public final Provider getProvider()

返回此键工厂对象的提供程序。

结果

这个关键工厂对象的提供者

getAlgorithm

public final String getAlgorithm()

得到这个 KeyFactory相关算法的名字。

结果

与此 KeyFactory相关算法的名字

generatePublic

public final PublicKey generatePublic(KeySpec keySpec)
                               throws InvalidKeySpecException

从所提供的关键规范（关键材料）生成公共密钥对象。

参数

keySpec -规范（主要材料）的公钥。

结果

公共密钥。

异常

InvalidKeySpecException -如果给定的主要指标是不适合这个关键的工厂生产一个公钥。

generatePrivate

public final PrivateKey generatePrivate(KeySpec keySpec)
                                 throws InvalidKeySpecException

从所提供的关键规范（关键材料）生成一个私有密钥对象。

参数

keySpec -规范（主要材料）的私钥。

结果

私钥密钥。

异常

InvalidKeySpecException -如果给定的主要指标是不适合这个工厂产生的私钥。

getKeySpec

public final <T extends KeySpec> T getKeySpec(Key key,
                                              类<T> keySpec)
                                       throws InvalidKeySpecException

返回给定键对象的规范（关键材料）。 keySpec识别其关键材料应返回的规范类。它可以，例如，被 DSAPublicKeySpec.class，表明主要材料应在 DSAPublicKeySpec类的实例返回。

参数类型

T -要返回的关键规范的类型

参数

key的关键。

keySpec -其中主要材料应返回的规范类。

结果

在所请求的规范类的实例中的基本密钥规范（关键材料）。

异常

InvalidKeySpecException如果请求的主要指标是不适合给定的键，或给定的键不能被处理（例如，给定的键具有无法识别的算法或格式）。

translateKey

public final Key translateKey(Key key)
                       throws InvalidKeyException

翻译的重点对象，其供应商可能是未知的或潜在的不受信任的，在相应的关键对象这一关键厂。

参数

key -关键的供应商是未知或不可信。

结果

翻译的钥匙。

异常

InvalidKeyException如果给定键不能用这个关键的工厂加工。