java.security.cert

接口
类
异常

java.security.cert
类 X509CRL

java.lang.Object
  继承者 java.security.cert.CRL
      继承者 java.security.cert.X509CRL
所有已实现的接口：
X509Extension 
public abstract class X509CRL
     

      extends 
      CRL
     

     

      implements 
      X509Extension

X.509 证书撤消列表 (CRL) 的抽象类。CRL 是标识已撤消证书的时间戳列表。它由证书颁发机构 (CA) 签署并且可在公共存储库中随意使用。

在 CRL 中，通过每个已撤消证书的证书序列号来标识该证书。当使用证书的系统使用某个证书（例如，用它验证远程用户的数字签名）时，该系统不仅要检查该证书的签名和有效性，而且还要获取一个最近合适的 CRL，并检查该证书序列号在不在该 CRL 中。“最近合适”的含义可能随本地策略的不同而有所不同，但是它通常指的是最近发布的 CRL。CA 定期发布新的 CRL（例如每小时、每日、每周）。当撤消发生时向 CRL 添加一个项，而到达证书的终止日期时，可能会移除一个项。

X.509 v2 CRL 格式的 ASN.1 描述如下： 

 CertificateList  ::=  SEQUENCE  {
     tbsCertList          TBSCertList,
     signatureAlgorithm   AlgorithmIdentifier,
     signature            BIT STRING  }

在 RFC 2459，即 "Internet X.509 Public Key Infrastructure Certificate and CRL Profile"（位于 http://www.ietf.org/rfc/rfc2459.txt ）中可找到更多信息。

tbsCertList 的 ASN.1 定义是： 

 TBSCertList  ::=  SEQUENCE  {
     version                 Version OPTIONAL,
                             -- if present, must be v2
     signature               AlgorithmIdentifier,
     issuer                  Name,
     thisUpdate              ChoiceOfTime,
     nextUpdate              ChoiceOfTime OPTIONAL,
     revokedCertificates     SEQUENCE OF SEQUENCE  {
         userCertificate         CertificateSerialNumber,
         revocationDate          ChoiceOfTime,
         crlEntryExtensions      Extensions OPTIONAL
                                 -- if present, must be v2
         }  OPTIONAL,
     crlExtensions           [0]  EXPLICIT Extensions OPTIONAL
                                  -- if present, must be v2
     }

CRL 是使用证书工厂进行实例化的。下面的示例演示了如何实例化一个 X.509 CRL： 

 
 InputStream inStream = new FileInputStream("fileName-of-crl");
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 X509CRL crl = (X509CRL)cf.generateCRL(inStream);
 inStream.close();

另请参见：
CRL, CertificateFactory, X509Extension

构造方法摘要
protected X509CRL()
          X.509 CRL 的构造方法。
 
方法摘要
 boolean equals(Object other)
          比较此 CRL 与给定对象的相等性。
abstract  byte[] getEncoded()
          返回此 CRL 的 ASN.1 DER 编码形式。
abstract  Principal getIssuerDN()
          已过时，由 getIssuerX500Principal() 替代。
 X500Principal getIssuerX500Principal()
          以 X500Principal 的形式返回 CRL 的发布方（发布方标识名）值。
abstract  Date getNextUpdate()
          获取 CRL 的 nextUpdate 日期。
abstract  X509CRLEntry getRevokedCertificate(BigInteger serialNumber)
          获取具有给定证书 serialNumber 的 CRL 项（如果有）。
 X509CRLEntry getRevokedCertificate(X509Certificate certificate)
          获取给定证书的 CRL 项（如果有）。
abstract  Set<? extends X509CRLEntry> getRevokedCertificates()
          获取此 CRL 中的所有项。
abstract  String getSigAlgName()
          获取 CRL 签名算法的签名算法名。
abstract  String getSigAlgOID()
          获取 CRL 的签名算法 OID 字符串。
abstract  byte[] getSigAlgParams()
          获取此 CRL 的签名算法中 DER 编码形式的签名算法参数。
abstract  byte[] getSignature()
          获取 CRL 的 signature 值（原始签名位）。
abstract  byte[] getTBSCertList()
          从此 CRL 中获取以 DER 编码的 CRL 信息，即 tbsCertList。
abstract  Date getThisUpdate()
          获取 CRL 的 thisUpdate 日期。
abstract  int getVersion()
          获取 CRL 的 version（版本号）值。
 int hashCode()
          根据此 CRL 的编码形式返回该 CRL 的哈希码值。
abstract  void verify(PublicKey key)
          验证是否已使用与给定公钥相应的私钥签署了此 CRL。
abstract  void verify(PublicKey key, String sigProvider)
          验证是否已使用与给定公钥相应的私钥签署了此 CRL。
 
从类 java.security.cert.CRL 继承的方法
getType, isRevoked, toString
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
从接口 java.security.cert.X509Extension 继承的方法
getCriticalExtensionOIDs, getExtensionValue, getNonCriticalExtensionOIDs, hasUnsupportedCriticalExtension
 

构造方法详细信息

X509CRL

protected X509CRL()
X.509 CRL 的构造方法。

方法详细信息

equals

public boolean equals(Object other)
比较此 CRL 与给定对象的相等性。如果 other 对象是一个 instanceof X509CRL，则获取其编码形式并且与此 CRL 的编码形式进行比较。

覆盖：
类 Object 中的 equals
参数：
other - 要与此 CRL 进行相等性测试的对象。
返回：
当且仅当两个 CRL 的编码形式匹配时才返回 true；否则返回 false。
另请参见：
Object.hashCode(), Hashtable

hashCode

public int hashCode()
根据此 CRL 的编码形式返回该 CRL 的哈希码值。

覆盖：
类 Object 中的 hashCode
返回：
哈希码值。
另请参见：
Object.equals(java.lang.Object), Hashtable

getEncoded

public abstract byte[] getEncoded()
                           throws CRLException
返回此 CRL 的 ASN.1 DER 编码形式。

返回：
此证书的编码形式
抛出：
CRLException - 如果发生编码错误。

verify

public abstract void verify(PublicKey key)
                     throws CRLException,
                            NoSuchAlgorithmException,
                            InvalidKeyException,
                            NoSuchProviderException,
                            SignatureException
验证是否已使用与给定公钥相应的私钥签署了此 CRL。

参数：
key - 用于进行验证的 PublicKey。
抛出：
NoSuchAlgorithmException - 如果签名算法不受支持。
InvalidKeyException - 如果密钥不正确。
NoSuchProviderException - 如果没有默认的提供者。
SignatureException - 如果发生签名错误。
CRLException - 如果发生编码错误。

verify

public abstract void verify(PublicKey key,
                            String sigProvider)
                     throws CRLException,
                            NoSuchAlgorithmException,
                            InvalidKeyException,
                            NoSuchProviderException,
                            SignatureException
验证是否已使用与给定公钥相应的私钥签署了此 CRL。此方法使用给定提供者所提供的签名验证引擎。

参数：
key - 用于进行验证的 PublicKey。
sigProvider - 签名提供者的名称。
抛出：
NoSuchAlgorithmException - 如果签名算法不受支持。
InvalidKeyException - 如果密钥不正确。
NoSuchProviderException - 如果提供者不正确。
SignatureException - 如果发生签名错误。
CRLException - 如果发生编码错误。

getVersion

public abstract int getVersion()
获取 CRL 的 version（版本号）值。此内容的 ASN.1 定义如下： 
 version    Version OPTIONAL,
             -- if present, must be v2

 Version  ::=  INTEGER  {  v1(0), v2(1), v3(2)  }
             -- v3 does not apply to CRLs but appears for consistency
             -- with definition of Version for certs

返回：
版本号，比如 1 或 2。

getIssuerDN

public abstract Principal getIssuerDN()
已过时，由 getIssuerX500Principal() 替代。此方法返回作为特定 Principal 对象实现的 issuer，可移植的代码不应依靠该对象。

获取 CRL 的 issuer（发布方的标识名）。发布方名称标识了签署（并发布）该 CRL 的实体。

发布方名称字段包含一个 X.500 标识名 (DN)。此内容的 ASN.1 定义如下： 

 issuer    Name

 Name ::= CHOICE { RDNSequence }
 RDNSequence ::= SEQUENCE OF RelativeDistinguishedName
 RelativeDistinguishedName ::=
     SET OF AttributeValueAssertion

 AttributeValueAssertion ::= SEQUENCE {
                               AttributeType,
                               AttributeValue }
 AttributeType ::= OBJECT IDENTIFIER
 AttributeValue ::= ANY
Name 描述了一个层次结构名，由属性（如国家/地区名）和相应值（如 US）组成。 AttributeValue 组件的类型由 AttributeType 来确定；一般是 directoryString。 directoryString 通常是 PrintableString、 TeletexString 或 UniversalString 之一。

返回：
一个 Principal，其名称是发布方的标识名。

getIssuerX500Principal

public X500Principal getIssuerX500Principal()
以 X500Principal 的形式返回 CRL 的发布方（发布方标识名）值。

建议子类重写此方法。

返回：
一个表示发布方标识名的 X500Principal
从以下版本开始：
1.4

getThisUpdate

public abstract Date getThisUpdate()
获取 CRL 的 thisUpdate 日期。此内容的 ASN.1 定义如下： 
 thisUpdate   ChoiceOfTime
 ChoiceOfTime ::= CHOICE {
     utcTime        UTCTime,
     generalTime    GeneralizedTime }

返回：
获取 CRL 的 thisUpdate 日期。

getNextUpdate

public abstract Date getNextUpdate()
获取 CRL 的 nextUpdate 日期。

返回：
获取 CRL 的 nextUpdate 日期，如果不存在，则返回 null。

getRevokedCertificate

public abstract X509CRLEntry getRevokedCertificate(BigInteger serialNumber)
获取具有给定证书 serialNumber 的 CRL 项（如果有）。

参数：
serialNumber - 要查找其 CRL 项的证书的序列号
返回：
具有给定序列号的项，如果此 CRL 中没有该项，则返回 null。
另请参见：
X509CRLEntry

getRevokedCertificate

public X509CRLEntry getRevokedCertificate(X509Certificate certificate)
获取给定证书的 CRL 项（如果有）。

此方法可用于在间接 CRL 中查找 CRL 项，间接 CRL 意味着其中包含来自不同于 CRL 发布方的发布方的项。默认的实现只返回由 CRL 发布方所发布的证书项。希望支持间接 CRL 的子类应该重写此方法。

参数：
certificate - 证书，在 CRL 中查找此证书的 CRL 项
返回：
给定证书的项，如果此 CRL 中没有该项，则返回 null。
抛出：
NullPointerException - 如果 certificate 为 null
从以下版本开始：
1.5

getRevokedCertificates

public abstract Set<? extends X509CRLEntry> getRevokedCertificates()
获取此 CRL 中的所有项。这会返回一个 X509CRLEntry 对象 Set。

返回：
所有项，如果没有项，则返回 null。
另请参见：
X509CRLEntry

getTBSCertList

public abstract byte[] getTBSCertList()
                               throws CRLException
从此 CRL 中获取以 DER 编码的 CRL 信息，即 tbsCertList。这可用于独立验证签名。

返回：
以 DER 编码的 CRL 信息。
抛出：
CRLException - 如果发生编码错误。

getSignature

public abstract byte[] getSignature()
获取 CRL 的 signature 值（原始签名位）。此内容的 ASN.1 定义如下： 
 signature     BIT STRING

返回：
签名。

getSigAlgName

public abstract String getSigAlgName()
获取 CRL 签名算法的签名算法名。例如字符串 "SHA-1/DSA"。此内容的 ASN.1 定义如下： 
 signatureAlgorithm   AlgorithmIdentifier

 AlgorithmIdentifier  ::=  SEQUENCE  {
     algorithm               OBJECT IDENTIFIER,
     parameters              ANY DEFINED BY algorithm OPTIONAL  }
                             -- contains a value of the type
                             -- registered for use with the
                             -- algorithm object identifier value

根据 algorithm OID 字符串确定该算法名。

返回：
签名算法名。

getSigAlgOID

public abstract String getSigAlgOID()
获取 CRL 的签名算法 OID 字符串。OID 由一组句点分隔的非负整数集来表示。例如，按照 RFC 2459 中的规定，字符串 "1.2.840.10040.4.3" 标识使用 DSA 签名算法的 SHA-1。

有关相关的 ASN.1 定义，请参见 getSigAlgName。

返回：
签名算法 OID 字符串。

getSigAlgParams

public abstract byte[] getSigAlgParams()
获取此 CRL 的签名算法中 DER 编码形式的签名算法参数。在大多数情况下，该签名算法参数为 null；该参数通常提供公钥。如果需要访问个别参数值，则使用 AlgorithmParameters 并使用 getSigAlgName 所返回的名称进行实例化。

有关相关的 ASN.1 定义，请参见 getSigAlgName。

返回：
DER 编码形式的签名算法参数，如果没有该参数，则返回 null。