X509CRLSelector (Java Platform SE 8 )

java.lang.Object
- java.security.cert.X509CRLSelector

All Implemented Interfaces:

Cloneable ， CRLSelector
```
public class X509CRLSelector
extends Object
implements CRLSelector
```
甲CRLSelector ，其选择X509CRLs匹配所有指定标准。当从CertStore中选择CRL以检查特定证书的撤销状态时，此类特别有用。
首次构建时， X509CRLSelector没有启用条件，并且get方法中的每一个返回默认值（ null ）。因此， match方法将返回true任何X509CRL 。通常，启用了几个条件（例如通过调用setIssuers或setDateAndTime ），然后将X509CRLSelector传递给CertStore.getCRLs或一些类似的方法。

请参考RFC 3280: Internet X.509 Public Key Infrastructure Certificate and CRL Profile为下面提到的X.509 CRL领域和扩展的定义。

并发访问

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

从以下版本开始：

1.4

另请参见：

CRLSelector ， X509CRL

构造方法摘要

构造方法
Constructor and Description
`X509CRLSelector()` 创建一个 `X509CRLSelector` 。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addIssuer(X500Principal issuer)` 向issuerNames条件添加一个名称。
`void`	`addIssuerName(byte[] name)` 向issuerNames条件添加一个名称。
`void`	`addIssuerName(String name)` 诋毁，使用 addIssuer(X500Principal)或 addIssuerName(byte[])代替。
`Object`	`clone()` 返回此对象的副本。
`X509Certificate`	`getCertificateChecking()` 返回正在检查的证书。
`Date`	`getDateAndTime()` 返回dateAndTime条件。
`Collection<Object>`	`getIssuerNames()` 返回issuerNames条件的副本。
`Collection<X500Principal>`	`getIssuers()` 返回issuerNames条件。
`BigInteger`	`getMaxCRL()` 返回maxCRLNumber标准。
`BigInteger`	`getMinCRL()` 返回minCRLNumber标准。
`boolean`	`match(CRL crl)` 决定是否选择 `CRL` 。
`void`	`setCertificateChecking(X509Certificate cert)` 设置正在检查的证书。
`void`	`setDateAndTime(Date dateAndTime)` 设置dateAndTime标准。
`void`	`setIssuerNames(Collection<?> names)` 注意：使用 setIssuers(Collection)或使用此方法时，仅指定可分辨名称的字节数组形式。
`void`	`setIssuers(Collection<X500Principal> issuers)` 设置issuerNames条件。
`void`	`setMaxCRLNumber(BigInteger maxCRL)` 设置maxCRLNumber标准。
`void`	`setMinCRLNumber(BigInteger minCRL)` 设置minCRLNumber标准。
`String`	`toString()` 返回X509CRLSelector的可 `X509CRLSelector` 。

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

- 构造方法详细信息
  - X509CRLSelector
```
public X509CRLSelector()
```
    创建一个X509CRLSelector 。最初没有设置任何条件，所以任何X509CRL将匹配。
- 方法详细信息
  - setIssuers
```
public void setIssuers(Collection<X500Principal> issuers)
```
    设置issuerNames条件。在发行人分辨名称X509CRL必须在指定的专有名称中的至少一个相匹配。如果null ，任何发行人的可分辨名称都可以。
    该方法允许调用者使用单个方法调用指定X509CRLs可能包含的完整的发行者名称X509CRLs 。指定的值替换issuerNames条件的上一个值。
    
    names参数（如果不是null ）是Collection的X500Principal s。
    
    需要注意的是names参数可以包含重复的专有名称，但他们可以从被删除Collection通过返回的名字getIssuers方法。
    
    请注意，在Collection上执行Collection以防止后续修改。
    
    参数
    
    issuers - 一个 Collection的X500Principals（或 null ）
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    getIssuers()
  - setIssuerNames
```
public void setIssuerNames(Collection<?> names)
                    throws IOException
```
    注意：使用setIssuers(Collection)或使用此方法时，仅指定可分辨名称的字节数组形式。见addIssuerName(String)以获取更多信息。
    设置issuerNames条件。在发行人分辨名称X509CRL必须在指定的专有名称中的至少一个相匹配。如果null ，任何发行人的可分辨名称都可以。
    
    该方法允许调用者使用单个方法调用指定X509CRLs可能包含的完整的发行者名称X509CRLs 。指定的值替换issuerNames条件的上一个值。
    
    names参数（如果不是null ）是一个Collection的名称。每个名称是一个String或一个表示可分辨名称的字节数组（分别为RFC 2253或ASN.1 DER编码形式）。如果提供null作为此参数的值，则不执行issuerNames检查。
    
    需要注意的是names参数可以包含重复的专有名称，但他们可以从被删除Collection通过返回的名字getIssuerNames方法。
    
    如果一个名称被指定为一个字节数组，它应包含一个DER编码的唯一名称，如X.501所定义。该结构的ASN.1符号如下。
```
   Name ::= CHOICE { RDNSequence } RDNSequence ::= SEQUENCE OF RelativeDistinguishedName RelativeDistinguishedName ::= SET SIZE (1 .. MAX) OF AttributeTypeAndValue AttributeTypeAndValue ::= SEQUENCE { type AttributeType, value AttributeValue } AttributeType ::= OBJECT IDENTIFIER AttributeValue ::= ANY DEFINED BY AttributeType .... DirectoryString ::= CHOICE { teletexString TeletexString (SIZE (1..MAX)), printableString PrintableString (SIZE (1..MAX)), universalString UniversalString (SIZE (1..MAX)), utf8String UTF8String (SIZE (1.. MAX)), bmpString BMPString (SIZE (1..MAX)) }  
```
    需要注意的是深拷贝上进行Collection ，以防止后续修改。
    参数
    
    names - a Collection的名称（或 null ）
    
    异常
    
    IOException - 如果发生解析错误
    
    另请参见：
    
    getIssuerNames()
  - addIssuer
```
public void addIssuer(X500Principal issuer)
```
    向issuerNames条件添加一个名称。在发行人分辨名称X509CRL必须在指定的专有名称中的至少一个相匹配。
    此方法允许调用者向X509CRLs可能包含的发行者名称集合添加一个名称。指定的名称将添加到issuerNames条件的任何先前值。如果指定的名称是重复的，则可能会被忽略。
    
    参数
    
    issuer - 发行人为X500Principal
    
    从以下版本开始：
    
    1.5
  - addIssuerName
```
public void addIssuerName(String name)
                   throws IOException
```
    诋毁，使用addIssuer(X500Principal)或addIssuerName(byte[])代替。不应该依赖此方法，因为由于某些专有名称的RFC 2253字符串形式的编码信息丢失，因此可能无法匹配某些CRL。
    向issuerNames条件添加一个名称。在发行人分辨名称X509CRL必须在指定的专有名称中的至少一个相匹配。
    
    该方法允许调用者向X509CRLs可能包含的发行者名称集合添加一个名称。指定的名称将添加到issuerNames条件的任何先前值。如果指定的名称是重复的，则可能会被忽略。
    
    参数
    
    name - RFC 2253表格中的名称
    
    异常
    
    IOException - 如果发生解析错误
  - addIssuerName
```
public void addIssuerName(byte[] name)
                   throws IOException
```
    向issuerNames条件添加一个名称。在发行人分辨名称X509CRL必须在指定的专有名称中的至少一个相匹配。
    此方法允许调用者向X509CRLs可能包含的发行者名称集合添加一个名称。指定的名称将添加到issuerNames条件的任何先前值。如果指定的名称是重复的，则可能会被忽略。如果一个名称被指定为一个字节数组，它应包含一个DER编码的唯一名称，如X.501所定义。该结构的ASN.1符号如下。
    
    该名称作为字节数组提供。该字节数组应包含单个DER编码的可分辨名称，如X.501中所定义。该结构的ASN.1符号出现在setIssuerNames(Collection names)的文档中。
    
    请注意，此处提供的字节数组被克隆以防止后续修改。
    
    参数
    
    name - 包含ASN.1 DER编码形式的名称的字节数组
    
    异常
    
    IOException - 如果发生解析错误
  - setMinCRLNumber
```
public void setMinCRLNumber(BigInteger minCRL)
```
    设置minCRLNumber标准。 X509CRL必须具有值大于或等于指定值的CRL号码扩展名。如果null ，则不会进行minCRLNumber检查。
    
    参数
    
    minCRL - 接受的最低CRL号码（或 null ）
  - setMaxCRLNumber
```
public void setMaxCRLNumber(BigInteger maxCRL)
```
    设置maxCRLNumber标准。 X509CRL必须具有值小于或等于指定值的CRL号码扩展名。如果null ，则不会执行maxCRLNumber检查。
    
    参数
    
    maxCRL - 接受的最大CRL号码（或 null ）
  - setDateAndTime
```
public void setDateAndTime(Date dateAndTime)
```
    设置dateAndTime标准。指定的日期必须等于或晚于X509CRL的X509CRL的值，并且早于nextUpdate组件的值。如果X509CRL不包含nextUpdate组件，则不匹配。如果null ，没有dateAndTime检查将完成。
    请注意， Date提供的Date被克隆以防止后续修改。
    
    参数
    
    dateAndTime - 与 Date （或 null ）
    
    另请参见：
    
    getDateAndTime()
  - setCertificateChecking
```
public void setCertificateChecking(X509Certificate cert)
```
    设置正在检查的证书。这不是一个标准。相反，它是可选的信息，可以帮助CertStore查找与检查指定证书的撤销相关的CRL。如果null null，则不提供这样的可选信息。
    
    参数
    
    cert - 被检查的 X509Certificate （或 null ）
    
    另请参见：
    
    getCertificateChecking()
  - getIssuers
```
public Collection<X500Principal> getIssuers()
```
    返回issuerNames条件。在发行人分辨名称X509CRL必须在指定的专有名称中的至少一个相匹配。如果返回的值为null ，任何发行人的可分辨名称都可以。
    如果返回的值不是null ，那么它是Collection的一个不可Collection的X500Principal 。
    
    结果
    
    一个不可修改的 Collection的名称（或 null ）
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    setIssuers(java.util.Collection<javax.security.auth.x500.X500Principal>)
  - getIssuerNames
```
public Collection<Object> getIssuerNames()
```
    返回issuerNames条件的副本。在发行人分辨名称X509CRL必须在指定的专有名称中的至少一个相匹配。如果返回的值为null ，则任何发行人的可分辨名称都可以。
    如果返回的值不是null ，那么它是一个Collection的名称。每个名称是一个String或一个表示可分辨名称的字节数组（分别为RFC 2253或ASN.1 DER编码形式）。请注意，返回的Collection可能包含重复的名称。
    
    如果一个名称被指定为一个字节数组，它应包含一个DER编码的唯一名称，如X.501所定义。此结构的ASN.1表示文档中给出了setIssuerNames(Collection names) 。
    
    需要注意的是深拷贝上进行Collection ，以防止后续修改。
    
    结果
    
    一个 Collection的名字（或 null ）
    
    另请参见：
    
    setIssuerNames(java.util.Collection<?>)
  - getMinCRL
```
public BigInteger getMinCRL()
```
    返回minCRLNumber标准。 X509CRL必须具有值大于或等于指定值的CRL号码扩展名。如果null ，则不会进行minCRLNumber检查。
    
    结果
    
    接受的最低CRL号码（或 null ）
  - getMaxCRL
```
public BigInteger getMaxCRL()
```
    返回maxCRLNumber标准。 X509CRL必须具有值小于或等于指定值的CRL号码扩展名。如果null ，则不会执行maxCRLNumber检查。
    
    结果
    
    接受的最大CRL号码（或 null ）
  - getDateAndTime
```
public Date getDateAndTime()
```
    返回dateAndTime条件。指定的日期必须等于或晚于X509CRL的X509CRL的值，并且早于nextUpdate组件的值。如果X509CRL不包含nextUpdate组件，则不匹配。如果null ，没有dateAndTime检查将完成。
    请注意，返回的Date被克隆以防止后续修改。
    
    结果
    
    Date来对抗（或 null ）
    
    另请参见：
    
    setDateAndTime(java.util.Date)
  - getCertificateChecking
```
public X509Certificate getCertificateChecking()
```
    返回正在检查的证书。这不是一个标准。相反，它是可选的信息，可以帮助CertStore查找与检查指定证书的撤销相关的CRL。如果返回值为null ，则不提供此类可选信息。
    
    结果
    
    正在检查的证书（或 null ）
    
    另请参见：
    
    setCertificateChecking(java.security.cert.X509Certificate)
  - toString
```
public String toString()
```
    返回X509CRLSelector的可 X509CRLSelector 。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    一个 String X509CRLSelector内容的 X509CRLSelector 。
  - match
```
public boolean match(CRL crl)
```
    决定是否选择 CRL 。
    
    Specified by:
    
    match在界面 CRLSelector
    
    参数
    
    crl - 要检查的 CRL
    
    结果
    
    true如果 CRL应该被选择， false false
  - clone
```
public Object clone()
```
    返回此对象的副本。
    
    Specified by:
    
    clone在界面 CRLSelector
    
    重写：
    
    clone在类别 Object
    
    结果
    
    副本
    
    另请参见：
    
    Cloneable

Class X509CRLSelector

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

X509CRLSelector

方法详细信息

setIssuers

setIssuerNames

addIssuer

addIssuerName

addIssuerName

setMinCRLNumber

setMaxCRLNumber

setDateAndTime

setCertificateChecking

getIssuers

getIssuerNames

getMinCRL

getMaxCRL

getDateAndTime

getCertificateChecking

toString

match

clone