javax.net.ssl
类 TrustManagerFactory

java.lang.Object
  javax.net.ssl.TrustManagerFactory

public class TrustManagerFactory
extends Object

此类充当基于信任材料源的信任管理器的工厂。每个信任管理器管理特定类型的由安全套接字使用的信任材料。信任材料是基于 KeyStore 和/或提供程序特定的源。

从以下版本开始：

1.4

另请参见：

TrustManager

构造方法摘要

protected

TrustManagerFactory(TrustManagerFactorySpi factorySpi, Provider provider, String algorithm) 创建 TrustManagerFactory 对象。

方法摘要

String	getAlgorithm() 返回此 TrustManagerFactory 对象的算法名称。
static String	getDefaultAlgorithm() 获取默认的 TrustManagerFactory 算法名称。
static TrustManagerFactory	getInstance(String algorithm) 生成实现指定的信任管理算法的 TrustManagerFactory 对象。
static TrustManagerFactory	getInstance(String algorithm, Provider provider) 根据指定的提供程序为指定的信任管理算法生成 TrustManagerFactory 对象。
static TrustManagerFactory	getInstance(String algorithm, String provider) 根据指定的提供程序为指定的信任管理算法生成 TrustManagerFactory 对象。
Provider	getProvider() 返回此 TrustManagerFactory 对象的提供程序。
TrustManager[]	getTrustManagers() 为每种信任材料返回一个信任管理器。
void	init(KeyStore ks) 用证书授权源和相关的信任材料初始化此工厂。
void	init(ManagerFactoryParameters spec) 使用特定于提供程序的信任材料源初始化此工厂。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

TrustManagerFactory

protected TrustManagerFactory(TrustManagerFactorySpi factorySpi,
                              Provider provider,
                              String algorithm)

创建 TrustManagerFactory 对象。

参数：

factorySpi - 委托

provider - 提供程序

algorithm - 算法

方法详细信息

getDefaultAlgorithm

public static final String getDefaultAlgorithm()

获取默认的 TrustManagerFactory 算法名称。

默认的 TrustManager 可以在运行时改变，方法是通过把 "ssl.TrustManagerFactory.algorithm" 安全属性（在 Java 安全属性文件或 通过调用 Security.setProperty(String, String) 设置）的值设置为期望的名称。

返回：

在 Java 安全属性中指定的默认算法名称；如果没有这种属性存在，则返回一个特定于实现的默认值。

getAlgorithm

public final String getAlgorithm()

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

这与创建此 TrustManagerFactory 对象的 getInstance 调用之一指定的名称相同。

返回：

此 TrustManagerFactory 对象的算法名称。

getInstance

public static final TrustManagerFactory getInstance(String algorithm)
                                             throws NoSuchAlgorithmException

生成实现指定的信任管理算法的 TrustManagerFactory 对象。

如果默认的提供程序包提供了请求的信任管理算法的实现，则返回包含该实现的 TrustManagerFactory 实例。如果默认提供程序包中未提供算法，则搜索其他的包。

参数：

algorithm - 请求的信任管理算法的标准名称。

返回：

新 TrustManagerFactory 对象

抛出：

NoSuchAlgorithmException - 如果默认的提供程序包中指定的算法不可用，或者搜索到的其他提供程序包中的算法都不可用。

getInstance

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

根据指定的提供程序为指定的信任管理算法生成 TrustManagerFactory 对象。

参数：

algorithm - 请求的信任管理算法的标准名称。

provider - 提供程序的名称

返回：

新 TrustManagerFactory 对象

抛出：

NoSuchAlgorithmException - 如果指定提供程序中的算法不可用。

NoSuchProviderException - 如果指定的提供程序未配置。

IllegalArgumentException - 如果提供程序的名称为 null 或空。

getInstance

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

根据指定的提供程序为指定的信任管理算法生成 TrustManagerFactory 对象。

参数：

algorithm - 请求的信任管理算法的标准名称。

provider - 提供程序的实例

返回：

新 TrustManagerFactory 对象

抛出：

NoSuchAlgorithmException - 如果指定提供程序中的算法不可用。

IllegalArgumentException - 如果 provider 为 null。

getProvider

public final Provider getProvider()

返回此 TrustManagerFactory 对象的提供程序。

返回：

此 TrustManagerFactory 对象的提供程序。

init

public final void init(KeyStore ks)
                throws KeyStoreException

用证书授权源和相关的信任材料初始化此工厂。

提供程序通常使用 KeyStore 作为基础做出信任决定。

有关更多灵活初始化的信息，请参见 init(ManagerFactoryParameters)。

参数：

ks - 密钥仓库或 null

抛出：

KeyStoreException - 如果此操作失败

init

public final void init(ManagerFactoryParameters spec)
                throws InvalidAlgorithmParameterException

使用特定于提供程序的信任材料源初始化此工厂。

在某些情况下，提供程序可能需要初始化参数而不是密钥仓库。期望由该特定提供程序的用户传递由提供程序定义的适当 ManagerFactoryParameters 实现。然后提供程序可以调用 ManagerFactoryParameters 实现中指定的方法来获取所需的信息。

参数：

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

抛出：

InvalidAlgorithmParameterException - 如果遇到了错误

getTrustManagers

public final TrustManager[] getTrustManagers()

为每种信任材料返回一个信任管理器。

返回：

密钥管理器