compact1, compact2, compact3

javax.net.ssl

Class KeyManagerFactory

java.lang.Object

javax.net.ssl.KeyManagerFactory

public class KeyManagerFactory
extends Object

这个类作为一个工厂的关键管理人员的基础上的关键材料的来源。每个键管理器管理一个特定类型的安全套接字使用的关键材料。主要材料是基于密钥库和/或供应商特定的来源。

从以下版本开始：

一点四

另请参见：

KeyManager

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	KeyManagerFactory(KeyManagerFactorySpi factorySpi, Provider provider, String algorithm) 创建一个keymanagerfactory对象。

方法摘要

Modifier and Type	Method and Description
String	getAlgorithm() 返回该对象的算法名称 KeyManagerFactory。
static String	getDefaultAlgorithm() 得到默认keymanagerfactory算法名称。
static KeyManagerFactory	getInstance(String algorithm) 返回一个 KeyManagerFactory对象作为一个关键管理人员厂。
static KeyManagerFactory	getInstance(String algorithm, Provider provider) 返回一个 KeyManagerFactory对象作为一个关键管理人员厂。
static KeyManagerFactory	getInstance(String algorithm, String provider) 返回一个 KeyManagerFactory对象作为一个关键管理人员厂。
KeyManager[]	getKeyManagers() 返回每个类型关键材料的一个关键管理器。
Provider	getProvider() 返回该对象的 KeyManagerFactory提供者。
void	init(KeyStore ks, char[] password) 一个关键的材料源初始化这个厂。
void	init(ManagerFactoryParameters spec) 与供应商特定的关键材料源初始化这个厂。

Methods inherited from class java.lang.Object

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

Constructor Detail

KeyManagerFactory

protected KeyManagerFactory(KeyManagerFactorySpi factorySpi,
                            Provider provider,
                            String algorithm)

创建一个keymanagerfactory对象。

参数

factorySpi -代表

provider -供应商

algorithm -算法

方法详细信息

getDefaultAlgorithm

public static final String getDefaultAlgorithm()

得到默认keymanagerfactory算法名称。

默认算法可以通过设置的ssl.KeyManagerFactory.algorithm安全属性的值所需的算法名称在运行时改变。

结果

默认的算法名称的 ssl.KeyManagerFactory.algorithm安全属性中指定，或实现特定的默认如果没有这种属性的存在。

另请参见：

security properties

getAlgorithm

public final String getAlgorithm()

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

这是相同的名字，是在一个KeyManagerFactory创建这个对象调用指定getInstance。

结果

这 KeyManagerFactory对象的算法名称。

getInstance

public static final KeyManagerFactory getInstance(String algorithm)
                                           throws NoSuchAlgorithmException

返回一个 KeyManagerFactory对象作为一个关键管理人员厂。

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

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

参数

algorithm -请求算法的标准名称。看到有关标准算法名称信息 Java Secure Socket Extension Reference Guide 。

结果

新 KeyManagerFactory对象。

异常

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

NullPointerException -如果 algorithm是空的。

另请参见：

Provider

getInstance

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

返回一个 KeyManagerFactory对象作为一个关键管理人员厂。

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

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

参数

algorithm -请求算法的标准名称。看到有关标准算法名称信息 Java Secure Socket Extension Reference Guide 。

provider -提供者的名称。

结果

新 KeyManagerFactory对象。

异常

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

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

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

NullPointerException -如果 algorithm是空的。

另请参见：

Provider

getInstance

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

返回一个 KeyManagerFactory对象作为一个关键管理人员厂。

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

参数

algorithm -请求算法的标准名称。看到有关标准算法名称信息 Java Secure Socket Extension Reference Guide 。

provider -提供程序实例。

结果

新 KeyManagerFactory对象。

异常

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

IllegalArgumentException如果供应商是空的。

NullPointerException -如果 algorithm是空的。

另请参见：

Provider

getProvider

public final Provider getProvider()

返回该对象的 KeyManagerFactory提供者。

结果

这 KeyManagerFactory对象的提供者

init

public final void init(KeyStore ks,
                       char[] password)
                throws KeyStoreException,
                       NoSuchAlgorithmException,
                       UnrecoverableKeyException

一个关键的材料源初始化这个厂。

供应商通常使用一个密钥获取关键材料中使用安全套接字的谈判。密钥库一般是密码保护。

更为灵活的初始化，请看init(ManagerFactoryParameters)。

参数

ks -密钥存储或空

password为密钥恢复密钥的密码

异常

KeyStoreException -如果操作失败

NoSuchAlgorithmException -如果指定的算法是无法从指定的供应商。

UnrecoverableKeyException -如果钥匙无法恢复（例如密码是错误的）。

init

public final void init(ManagerFactoryParameters spec)
                throws InvalidAlgorithmParameterException

与供应商特定的关键材料源初始化这个厂。

在某些情况下，初始化参数比其他的私钥和密码可以由供应商需要。该供应商将通过适当的ManagerFactoryParameters实现提供者定义的用户。提供程序可以调用指定的方法在ManagerFactoryParameters实现获取所需的信息。

参数

spec -一个提供程序特定的参数规范的实现

异常

InvalidAlgorithmParameterException -如果遇到错误

getKeyManagers

public final KeyManager[] getKeyManagers()

返回每个类型关键材料的一个关键管理器。

结果

关键管理人员

异常

IllegalStateException -如果keymanagerfactory未初始化