模块 java.base

软件包 java.security.cert

Class PKIXBuilderParameters

java.lang.Object

java.security.cert.PKIXParameters

java.security.cert.PKIXBuilderParameters

实现的所有接口

Cloneable ， CertPathParameters

public class PKIXBuilderParameters
extends PKIXParameters

用作PKIX CertPathBuilder算法输入的参数。

PKIX CertPathBuilder将这些参数用于build和CertPath ，该参数已根据PKIX认证路径验证算法进行了验证。

要实例化PKIXBuilderParameters对象，应用程序必须指定PKIX证书路径验证算法定义的一个或多个最受信任的CA. 可以使用两个构造函数之一指定最受信任的CA. 应用程序可以调用PKIXBuilderParameters(Set, CertSelector) ，指定Set个TrustAnchor对象，每个对象标识最受信任的CA. 或者，应用程序可以调用PKIXBuilderParameters(KeyStore, CertSelector) ，指定包含受信任证书条目的KeyStore实例，每个实例都将被视为最受信任的CA.

此外，应用程序必须在CertPathBuilder将尝试构建路径的目标证书上指定约束。 约束被指定为CertSelector对象。 这些约束应该为CertPathBuilder提供足够的搜索条件来查找目标证书。 X509Certificate最低标准通常包括主题名称和/或一个或多个主题替代名称。 如果未指定足够的标准，则CertPathBuilder可能会抛出CertPathBuilderException 。

并发访问

除非另有说明，否则此类中定义的方法不是线程安全的。 需要同时访问单个对象的多个线程应在它们之间进行同步并提供必要的锁定。 每个操作单独对象的多个线程不需要同步。

从以下版本开始：

1.4

另请参见：

CertPathBuilder

构造方法摘要

构造方法

构造器	描述
PKIXBuilderParameters(KeyStore keystore, CertSelector targetConstraints)	创建 PKIXBuilderParameters的实例，该实例从指定的 KeyStore包含的受信任证书条目填充最受信任的CA KeyStore 。
PKIXBuilderParameters(Set<TrustAnchor> trustAnchors, CertSelector targetConstraints)	使用指定的 Set最受信任的CA创建 PKIXBuilderParameters的实例。

方法摘要

变量和类型	方法	描述
int	getMaxPathLength()	返回证书路径中可能存在的最大中间非自发证书数的值。
void	setMaxPathLength(int maxPathLength)	设置证书路径中可能存在的最大非自发行中间证书数的值。
String	toString()	返回描述参数的格式化字符串。

声明方法的类 java.security.cert.PKIXParameters

addCertPathChecker, addCertStore, clone, getCertPathCheckers, getCertStores, getDate, getInitialPolicies, getPolicyQualifiersRejected, getSigProvider, getTargetCertConstraints, getTrustAnchors, isAnyPolicyInhibited, isExplicitPolicyRequired, isPolicyMappingInhibited, isRevocationEnabled, setAnyPolicyInhibited, setCertPathCheckers, setCertStores, setDate, setExplicitPolicyRequired, setInitialPolicies, setPolicyMappingInhibited, setPolicyQualifiersRejected, setRevocationEnabled, setSigProvider, setTargetCertConstraints, setTrustAnchors

声明方法的类 java.lang.Object

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

构造方法详细信息

PKIXBuilderParameters

public PKIXBuilderParameters(Set<TrustAnchor> trustAnchors,
                             CertSelector targetConstraints)
                      throws InvalidAlgorithmParameterException

使用指定的Set最受信任的CA创建PKIXBuilderParameters的实例。 该组的每个元素是TrustAnchor 。

请注意，复制了Set以防止后续修改。

参数

trustAnchors - Set of TrustAnchor s

targetConstraints - 指定对目标证书的约束的 CertSelector

异常

InvalidAlgorithmParameterException - 如果 trustAnchors是空的 (trustAnchors.isEmpty() == true)

NullPointerException - 如果 trustAnchors是 null

ClassCastException -如果任何的元件的 trustAnchors类型不是 java.security.cert.TrustAnchor

PKIXBuilderParameters

public PKIXBuilderParameters(KeyStore keystore,
                             CertSelector targetConstraints)
                      throws KeyStoreException,
                             InvalidAlgorithmParameterException

创建PKIXBuilderParameters的实例，该实例从指定的KeyStore包含的受信任证书条目填充最受信任的CA KeyStore 。 仅考虑包含受信任的X509Certificate的密钥库条目; 忽略所有其他证书类型。

参数

keystore - KeyStore ，将从中填充最受信任的CA集

targetConstraints - 指定对目标证书的约束的 CertSelector

异常

KeyStoreException - 如果 keystore尚未初始化

InvalidAlgorithmParameterException - 如果 keystore不包含至少一个受信任的证书条目

NullPointerException - 如果 keystore是 null

方法详细信息

setMaxPathLength

public void setMaxPathLength(int maxPathLength)

设置证书路径中可能存在的最大非自发行中间证书数的值。 如果主题和颁发者字段中出现的DN相同且不为空，则自行颁发证书。 请注意，证书路径中的最后一个证书不是中间证书，并且不包含在此限制中。 通常，最后一个证书是最终实体证书，但它可以是CA证书。 PKIX CertPathBuilder实例不能构建长于指定长度的路径。

值为0表示路径只能包含单个证书。 值-1表示路径长度不受约束（即没有最大值）。 默认的最大路径长度（如果未指定）为5.设置小于-1的值将导致抛出异常。

如果任何CA证书包含BasicConstraintsExtension ，则只要结果是较小长度的证书路径，扩展的pathLenConstraint字段的值pathLenConstraint覆盖最大路径长度参数。

参数

maxPathLength - 证书路径中可能存在的最大非自行颁发的中间证书数

异常

InvalidParameterException - 如果 maxPathLength设置为小于-1的值

另请参见：

getMaxPathLength()

getMaxPathLength

public int getMaxPathLength()

返回证书路径中可能存在的最大中间非自发证书数的值。 有关更多详细信息，请参见setMaxPathLength(int)方法。

结果

证书路径中可能存在的非自发中间证书的最大数量，如果没有限制，则为-1

另请参见：

setMaxPathLength(int)

toString

public String toString()

返回描述参数的格式化字符串。

重写：

toString在课程 PKIXParameters

结果

a formatted string describing the parameters