PKIXParameters (Java Platform SE 8 )

java.lang.Object
- java.security.cert.PKIXParameters

All Implemented Interfaces:

Cloneable ， CertPathParameters

已知直接子类：

PKIXBuilderParameters
```
public class PKIXParameters
extends Object
implements CertPathParameters
```
参数用作PKIX CertPathValidator算法的输入。
甲PKIX CertPathValidator使用这些参数来验证CertPath根据PKIX证书路径验证算法。

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

一旦PKIXParameters对象已经创建，其他参数可以（通过调用来指定setInitialPolicies或setDate ，例如），然后将PKIXParameters与一起传递CertPath被验证到CertPathValidator.validate 。

任何未设置的参数（或设置为null ）将被设置为该参数的默认值。 date参数的默认值为null ，表示路径验证当前的时间。剩余参数的默认值最小限制。

并发访问

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

从以下版本开始：

1.4

另请参见：

CertPathValidator

构造方法摘要

构造方法
Constructor and Description
`PKIXParameters(KeyStore keystore)` 创建一个 `PKIXParameters`的实例，它从指定的 `PKIXParameters`中包含的受信任证书条目填充最受信任的CA `KeyStore` 。
`PKIXParameters(Set<TrustAnchor> trustAnchors)` 创建的实例 `PKIXParameters`与指定的 `Set`最受信任的CA的。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addCertPathChecker(PKIXCertPathChecker checker)` 将 `PKIXCertPathChecker`添加到认证路径检查器列表中。
`void`	`addCertStore(CertStore store)` 将 `CertStore`添加到用于查找证书和CRL的 `CertStore`列表的 `CertStore` 。
`Object`	`clone()` 制作这个 `PKIXParameters`对象的副本。
`List<PKIXCertPathChecker>`	`getCertPathCheckers()` 返回 `List`证书路径检查。
`List<CertStore>`	`getCertStores()` 返回用于查找证书和CRL的不可 `List`的 `CertStore` （CertStore）。
`Date`	`getDate()` 返回确定认证路径有效性的时间。
`Set<String>`	`getInitialPolicies()` 返回一个不可 `Set`的初始策略标识符（OID字符串）Set，表明这些策略中的任何一个对证书用户来说都是可接受的，用于认证路径处理。
`boolean`	`getPolicyQualifiersRejected()` 获取PolicyQualifiersRejected标志。
`String`	`getSigProvider()` 返回签名提供者的名称，或 `null`如果没有设置。
`CertSelector`	`getTargetCertConstraints()` 返回目标证书所需的约束。
`Set<TrustAnchor>`	`getTrustAnchors()` 返回不可替代的 `Set`最受信任的CA。
`boolean`	`isAnyPolicyInhibited()` 检查是否应将任何策略OID包含在证书中进行处理。
`boolean`	`isExplicitPolicyRequired()` 检查是否需要明确的策略。
`boolean`	`isPolicyMappingInhibited()` 检查策略映射是否被禁止。
`boolean`	`isRevocationEnabled()` 检查RevocationEnabled标志。
`void`	`setAnyPolicyInhibited(boolean val)` 设置状态以确定是否应将任何策略OID包含在证书中进行处理。
`void`	`setCertPathCheckers(List<PKIXCertPathChecker> checkers)` 设置一个 `List`的认证路径检查器List。
`void`	`setCertStores(List<CertStore> stores)` 设置列表 `CertStore`在查找证书和CRL时所使用秒。
`void`	`setDate(Date date)` 设置认证路径的有效性应该被确定的时间。
`void`	`setExplicitPolicyRequired(boolean val)` 设置ExplicitPolicyRequired标志。
`void`	`setInitialPolicies(Set<String> initialPolicies)` 设置 `Set`初始策略标识符（OID字符串），表明这些政策中的任何一个可以接受的认证路径处理的目的，证书用户。
`void`	`setPolicyMappingInhibited(boolean val)` 设置PolicyMappingInhibited标志。
`void`	`setPolicyQualifiersRejected(boolean qualifiersRejected)` 设置PolicyQualifiersRejected标志。
`void`	`setRevocationEnabled(boolean val)` 设置RevocationEnabled标志。
`void`	`setSigProvider(String sigProvider)` 设置签名提供者的名称。
`void`	`setTargetCertConstraints(CertSelector selector)` 设置目标证书所需的约束。
`void`	`setTrustAnchors(Set<TrustAnchor> trustAnchors)` 设置最受信任的CA的 `Set` 。
`String`	`toString()` 返回描述参数的格式化字符串。

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - PKIXParameters
```
public PKIXParameters(Set<TrustAnchor> trustAnchors)
               throws InvalidAlgorithmParameterException
```
    创建的实例PKIXParameters与指定的Set最受信任的CA的。该组的每个元素都是TrustAnchor 。
    请注意， Set被复制以防止后续修改。
    
    参数
    
    trustAnchors - a Set （ TrustAnchor ）
    
    异常
    
    InvalidAlgorithmParameterException - 如果指定的 Set为空 (trustAnchors.isEmpty() == true)
    
    NullPointerException - 如果指定的 Set是 null
    
    ClassCastException -如果任何在元素 Set类型不是 java.security.cert.TrustAnchor
  - PKIXParameters
```
public PKIXParameters(KeyStore keystore)
               throws KeyStoreException,
                      InvalidAlgorithmParameterException
```
    创建一个PKIXParameters的实例，它从指定的PKIXParameters中包含的受信任证书条目填充最受信任的CA KeyStore 。仅考虑包含受信任的X509Certificates密钥存储条目; 所有其他证书类型将被忽略。
    
    参数
    
    keystore - 一个 KeyStore ，一组最受信任的CA将被填充
    
    异常
    
    KeyStoreException - 如果密钥库尚未初始化
    
    InvalidAlgorithmParameterException - 如果密钥库不包含至少一个可信证书条目
    
    NullPointerException - 如果密钥库是 null
- 方法详细信息
  - getTrustAnchors
```
public Set<TrustAnchor> getTrustAnchors()
```
    返回不可替代的 Set最受信任的CA。
    
    结果
    
    一个不变的 Set的 TrustAnchor s（从不 null ）
    
    另请参见：
    
    setTrustAnchors(java.util.Set<java.security.cert.TrustAnchor>)
  - setTrustAnchors
```
public void setTrustAnchors(Set<TrustAnchor> trustAnchors)
                     throws InvalidAlgorithmParameterException
```
    设置最受信任的CA的Set 。
    请注意， Set被复制以防止后续修改。
    
    参数
    
    trustAnchors - a Set （ TrustAnchor ）
    
    异常
    
    InvalidAlgorithmParameterException - 如果指定的 Set为空 (trustAnchors.isEmpty() == true)
    
    NullPointerException - 如果指定的 Set是 null
    
    ClassCastException - 如果集合中的任何元素不是类型 java.security.cert.TrustAnchor
    
    另请参见：
    
    getTrustAnchors()
  - getInitialPolicies
```
public Set<String> getInitialPolicies()
```
    返回一个不可Set的初始策略标识符（OID字符串）Set，这表明这些策略中的任何一个对证书用户来说都是可接受的，用于认证路径处理。默认返回值为空Set ，这被解释为意味着任何策略都是可接受的。
    
    结果
    
    String Set的初始策略OID String ，或空的Set （意味着任何策略都可以接受）。从不返回null 。
    
    另请参见：
    
    setInitialPolicies(java.util.Set<java.lang.String>)
  - setInitialPolicies
```
public void setInitialPolicies(Set<String> initialPolicies)
```
    设置Set初始策略标识符（OID字符串），表明这些政策中的任何一个可以接受的认证路径处理的目的，证书用户。默认情况下，任何策略都可以接受（即所有策略），因此希望允许任何策略可接受的用户不需要调用此方法，也可以使用空的Set （或null ）调用。
    请注意， Set被复制以防止后续修改。
    
    参数
    
    initialPolicies - String格式的 Set初始策略OID（或 null ）
    
    异常
    
    ClassCastException - 如果集合中的任何元素不是类型 String
    
    另请参见：
    
    getInitialPolicies()
  - setCertStores
```
public void setCertStores(List<CertStore> stores)
```
    设置列表CertStore在查找证书和CRL时所使用秒。可能是null ，在这种情况下不会使用CertStore 。列表中的第一个CertStore可能优于稍后出现的那些。
    请注意， List被复制以防止后续修改。
    
    参数
    
    stores - a List of CertStore s（或 null ）
    
    异常
    
    ClassCastException - 如果列表中的任何元素不是类型 java.security.cert.CertStore
    
    另请参见：
    
    getCertStores()
  - addCertStore
```
public void addCertStore(CertStore store)
```
    将 CertStore添加到用于查找证书和CRL的 CertStore列表的 CertStore 。
    
    参数
    
    store - 加CertStore 。如果null ，该商店被忽略（未添加到列表中）。
  - getCertStores
```
public List<CertStore> getCertStores()
```
    返回用于查找证书和CRL的不可 List的 CertStore的CertStore。
    
    结果
    
    一个不变的 List的 CertStore s（可能是空的，但从不 null ）
    
    另请参见：
    
    setCertStores(java.util.List<java.security.cert.CertStore>)
  - setRevocationEnabled
```
public void setRevocationEnabled(boolean val)
```
    设置RevocationEnabled标志。如果此标志为真，将使用基础PKIX服务提供程序的默认撤销检查机制。如果该标志为false，则默认的撤销检查机制将被禁用（未使用）。
    当创建一个PKIXParameters对象时，该标志设置为true。此设置反映了检查撤销的最常见策略，因为每个服务提供商必须支持撤销检查以符合PKIX。如果使用PKIX服务提供商的默认撤销检查机制或替代撤销检查机制（通过调用addCertPathChecker或setCertPathCheckers方法），复杂的应用程序应将此标志设置为false。
    
    参数
    
    val - RevocationEnabled标志的新值
  - isRevocationEnabled
```
public boolean isRevocationEnabled()
```
    检查RevocationEnabled标志。如果此标志为真，将使用基础PKIX服务提供程序的默认撤销检查机制。如果该标志为false，则默认的撤销检查机制将被禁用（未使用）。有关设置此标志值的更多详细信息，请参阅setRevocationEnabled方法。
    
    结果
    
    RevocationEnabled标志的当前值
  - setExplicitPolicyRequired
```
public void setExplicitPolicyRequired(boolean val)
```
    设置ExplicitPolicyRequired标志。如果此标志为真，则每个证书中都需要明确标识可接受的策略。默认情况下，ExplicitPolicyRequired标志为false。
    
    参数
    
    val - true如果需要明确的政策， false否则
  - isExplicitPolicyRequired
```
public boolean isExplicitPolicyRequired()
```
    检查是否需要明确的策略。如果此标志为真，则每个证书中都需要明确标识可接受的策略。默认情况下，ExplicitPolicyRequired标志为false。
    
    结果
    
    true如果需要明确的政策， false否则
  - setPolicyMappingInhibited
```
public void setPolicyMappingInhibited(boolean val)
```
    设置PolicyMappingInhibited标志。如果该标志为真，则禁止策略映射。缺省情况下，策略映射不被禁止（标志为false）。
    
    参数
    
    val - true如果 true策略映射， false否则
  - isPolicyMappingInhibited
```
public boolean isPolicyMappingInhibited()
```
    检查策略映射是否被禁止。如果该标志为真，则禁止策略映射。缺省情况下，策略映射不被禁止（标志为false）。
    
    结果
    
    如果禁止策略映射，则为true，否则为false
  - setAnyPolicyInhibited
```
public void setAnyPolicyInhibited(boolean val)
```
    设置状态以确定是否应将任何策略OID包含在证书中进行处理。默认情况下，任何策略OID不被禁止（ isAnyPolicyInhibited()返回false ）。
    
    参数
    
    val - true如果任何政策OID被禁止， false否则
  - isAnyPolicyInhibited
```
public boolean isAnyPolicyInhibited()
```
    检查是否应将任何策略OID包含在证书中进行处理。
    
    结果
    
    true如果任何策略OID被禁止， false false
  - setPolicyQualifiersRejected
```
public void setPolicyQualifiersRejected(boolean qualifiersRejected)
```
    设置PolicyQualifiersRejected标志。如果此标志为真，那么在证书策略扩展中包含策略限定符的证书将被拒绝。如果该标志为假，则证书不会在此基础上被拒绝。
    当创建一个PKIXParameters对象时，该标志设置为true。此设置反映了处理策略限定词的最常用（最简单）策略。希望使用更复杂的策略的应用程序必须将此标志设置为false。
    
    请注意，PKIX认证路径验证算法指定必须处理和验证证书策略扩展中标记为关键的任何策略限定符。否则认证路径必须被拒绝。如果policyQualifiersRejected标志设置为false，则应用程序以此方式验证所有策略限定符，以便符合PKIX标准。
    
    参数
    
    qualifiersRejected - PolicyQualifiersRejected标志的新值
    
    另请参见：
    
    getPolicyQualifiersRejected() ， PolicyQualifierInfo
  - getPolicyQualifiersRejected
```
public boolean getPolicyQualifiersRejected()
```
    获取PolicyQualifiersRejected标志。如果此标志为真，那么在证书策略扩展中包含策略限定符的证书将被拒绝。如果该标志为假，则证书不会在此基础上被拒绝。
    创建PKIXParameters对象时，此标志设置为true。此设置反映了处理策略限定词的最常用（最简单）策略。希望使用更复杂的策略的应用程序必须将此标志设置为false。
    
    结果
    
    PolicyQualifiersRejected标志的当前值
    
    另请参见：
    
    setPolicyQualifiersRejected(boolean)
  - getDate
```
public Date getDate()
```
    返回确定认证路径有效性的时间。如果是null ，则使用当前时间。
    请注意，返回的Date被复制以防止后续修改。
    
    结果
    
    Date或 null如果没有设置
    
    另请参见：
    
    setDate(java.util.Date)
  - setDate
```
public void setDate(Date date)
```
    设置认证路径的有效性应该被确定的时间。如果null ，则使用当前时间。
    请注意， Date提供的Date将被复制以防止后续修改。
    
    参数
    
    date - 当前时间为 Date或 null
    
    另请参见：
    
    getDate()
  - setCertPathCheckers
```
public void setCertPathCheckers(List<PKIXCertPathChecker> checkers)
```
    设置一个List的认证路径检查器的List。如果指定的List包含一个对象，它是不是一个PKIXCertPathChecker ，它将被忽略。
    每个PKIXCertPathChecker指定的实现对证书的附加检查。通常，这些是处理和验证证书中包含的私有扩展的检查。每个PKIXCertPathChecker应该用执行检查所需的任何初始化参数进行实例化。
    
    该方法允许复杂的应用程序扩展PKIX CertPathValidator或CertPathBuilder 。指定的PKIXCertPathChecker的每一个将被CertPathValidator或CertPathBuilder的每个证书的PKIX CertPathValidator或CertPathBuilder调用。
    
    无论这些额外的PKIXCertPathChecker是否设置，PKIX CertPathValidator或CertPathBuilder必须对每个证书执行所有必需的PKIX检查。此规则的一个例外是如果RevocationEnabled标志设置为false（请参阅setRevocationEnabled方法）。
    
    请注意， List提供的List被复制，并且克隆了列表中的每个PKIXCertPathChecker以防止后续修改。
    
    参数
    
    checkers - a List的PKIXCertPathChecker s。可能是null ，在这种情况下不会使用额外的检查。
    
    异常
    
    ClassCastException - 如果列表中的任何元素不是类型 java.security.cert.PKIXCertPathChecker
    
    另请参见：
    
    getCertPathCheckers()
  - getCertPathCheckers
```
public List<PKIXCertPathChecker> getCertPathCheckers()
```
    返回List证书路径检查。返回的List是不可变的，并且PKIXCertPathChecker中的每个List被克隆以防止随后的修改。
    
    结果
    
    一个不变的 List的 PKIXCertPathChecker s（可能是空的，但不是 null ）
    
    另请参见：
    
    setCertPathCheckers(java.util.List<java.security.cert.PKIXCertPathChecker>)
  - addCertPathChecker
```
public void addCertPathChecker(PKIXCertPathChecker checker)
```
    将PKIXCertPathChecker添加到认证路径检查器列表中。有关详细信息，请参阅setCertPathCheckers方法。
    请注意， PKIXCertPathChecker被克隆以防止后续修改。
    
    参数
    
    checker - 一个PKIXCertPathChecker添加到检查列表。如果null ，检查器被忽略（未添加到列表中）。
  - getSigProvider
```
public String getSigProvider()
```
    返回签名提供者的名称，或 null如果没有设置。
    
    结果
    
    签名提供者的名称（或 null ）
    
    另请参见：
    
    setSigProvider(java.lang.String)
  - setSigProvider
```
public void setSigProvider(String sigProvider)
```
    设置签名提供者的名称。创建Signature对象时，指定的提供程序将是首选。如果null或未设置，则将使用支持该算法的第一个提供者。
    
    参数
    
    sigProvider - 签名提供者的姓名（或 null ）
    
    另请参见：
    
    getSigProvider()
  - getTargetCertConstraints
```
public CertSelector getTargetCertConstraints()
```
    返回目标证书所需的约束。该约束返回的实例CertSelector 。如果null ，没有约束被定义。
    请注意，返回的CertSelector被克隆以防止后续修改。
    
    结果
    
    a CertSelector指定目标证书的约束（或 null ）
    
    另请参见：
    
    setTargetCertConstraints(java.security.cert.CertSelector)
  - setTargetCertConstraints
```
public void setTargetCertConstraints(CertSelector selector)
```
    设置目标证书所需的约束。约束被指定为的一个实例CertSelector 。如果null没有定义约束。
    请注意， CertSelector CertSelector被克隆以防止后续修改。
    
    参数
    
    selector - a CertSelector指定目标证书（或 null ）的 null
    
    另请参见：
    
    getTargetCertConstraints()
  - clone
```
public Object clone()
```
    制作这个PKIXParameters对象的副本。副本的更改不会影响原始文件，反之亦然。
    
    Specified by:
    
    clone在接口 CertPathParameters
    
    重写：
    
    clone在 Object
    
    结果
    
    这个 PKIXParameters对象的副本
    
    另请参见：
    
    Cloneable
  - toString
```
public String toString()
```
    返回描述参数的格式化字符串。
    
    重写：
    
    toString在 Object
    
    结果
    
    a formatted string describing the parameters.

Class PKIXParameters

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

PKIXParameters

PKIXParameters

方法详细信息

getTrustAnchors

setTrustAnchors

getInitialPolicies

setInitialPolicies

setCertStores

addCertStore

getCertStores

setRevocationEnabled

isRevocationEnabled

setExplicitPolicyRequired

isExplicitPolicyRequired

setPolicyMappingInhibited

isPolicyMappingInhibited

setAnyPolicyInhibited

isAnyPolicyInhibited

setPolicyQualifiersRejected

getPolicyQualifiersRejected

getDate

setDate

setCertPathCheckers

getCertPathCheckers

addCertPathChecker

getSigProvider

setSigProvider

getTargetCertConstraints

setTargetCertConstraints

clone

toString