X509Certificate (Java Platform SE 8 )

java.lang.Object
- javax.security.cert.Certificate
- - javax.security.cert.X509Certificate

```
public abstract class X509Certificate
extends Certificate
```
X.509 v1证书的抽象类。这提供了访问X.509证书的所有版本1属性的标准方法。通过此界面无法使用特定于X.509 v2或v3的属性。未来的API演进将提供对完整的X.509 v3属性的完全访问。
基本的X.509格式由ISO / IEC和ANSI X9定义，并在ASN.1中进行了描述：
```
  Certificate  ::=  SEQUENCE  {
     tbsCertificate       TBSCertificate,
     signatureAlgorithm   AlgorithmIdentifier,
     signature            BIT STRING  } 
```
这些证书被广泛用于支持Internet安全系统中的身份验证和其他功能。通用应用包括隐私增强邮件（PEM），传输层安全性（SSL），可靠软件分发的代码签名和安全电子交易（SET）。

这些证书由证书颁发机构 （CA）进行管理和验证。 CA是通过以X.509标准格式放置数据然后对数据进行数字签名来创建证书的服务。 CA作为可信赖的第三方，引导彼此之间没有直接了解的校长之间。 CA证书是由他们自己签名的，或由其他CA（如“root”）CA签名的。

tbsCertificate的ASN.1 tbsCertificate是：
```
  TBSCertificate  ::=  SEQUENCE  {
     version         [0]  EXPLICIT Version DEFAULT v1,
     serialNumber         CertificateSerialNumber,
     signature            AlgorithmIdentifier,
     issuer               Name,
     validity             Validity,
     subject              Name,
     subjectPublicKeyInfo SubjectPublicKeyInfo,
     } 
```
以下是实例化X.509证书的示例代码：
```
  InputStream inStream = new FileInputStream("fileName-of-cert");
 X509Certificate cert = X509Certificate.getInstance(inStream);
 inStream.close(); 
```
要么
```
  byte[] certData = <certificate read from a file, say>
 X509Certificate cert = X509Certificate.getInstance(certData); 
```
在这两种情况下，实例化X.509证书的代码都会参考cert.provider.x509v1安全性属性的值来定位实际实现或实例化默认实现。

cert.provider.x509v1属性设置为X.509的默认实现，如：
```
  cert.provider.x509v1=com.sun.security.cert.internal.x509.X509V1CertImpl 
```
此cert.provider.x509v1属性的值必须更改为实例化另一个实现。如果未设置此安全属性，将使用默认实现。目前，由于对安全属性访问的可能的安全限制，此值将在类初始化时被查找并缓存，如果安全属性不可访问，则将返回到默认实现。

注意：包装javax.security.cert的类存在与早期版本的Java安全套接字扩展（JSSE）的兼容性。 应该使用新应用程序使用位于java.security.cert的标准Java SE证书类。
从以下版本开始：

1.4

另请参见：

Certificate ， X509Extension ， security properties

构造方法摘要

构造方法
Constructor and Description
`X509Certificate()`

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract void`	`checkValidity()` 检查证书当前是否有效。
`abstract void`	`checkValidity(Date date)` 检查指定的日期是否在证书的有效期内。
`static X509Certificate`	`getInstance(byte[] certData)` 实例化一个X509Certificate对象，并用指定的字节数组初始化它。
`static X509Certificate`	`getInstance(InputStream inStream)` 实例化一个X509Certificate对象，并使用从输入流 `inStream`读取的数据进行 `inStream` 。
`abstract Principal`	`getIssuerDN()` 从 `issuer`获取 `issuer` （发行人可分辨名称）值。
`abstract Date`	`getNotAfter()` 从 `notAfter`的有效期获取 `notAfter`日期。
`abstract Date`	`getNotBefore()` 从 `notBefore`的有效期获取 `notBefore`日期。
`abstract BigInteger`	`getSerialNumber()` 从证书获取 `serialNumber`值。
`abstract String`	`getSigAlgName()` 获取证书签名算法的签名算法名称。
`abstract String`	`getSigAlgOID()` 从证书获取签名算法OID字符串。
`abstract byte[]`	`getSigAlgParams()` 从该证书的签名算法获取DER编码的签名算法参数。
`abstract Principal`	`getSubjectDN()` 从 `subject`获取 `subject` （主题可分辨名称）值。
`abstract int`	`getVersion()` 从 `version`获取 `version` （版本号）值。

Methods inherited from class javax.security.cert.Certificate
equals, getEncoded, getPublicKey, hashCode, toString, verify, verify

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

- 构造方法详细信息
  - X509Certificate
```
public X509Certificate()
```
- 方法详细信息
  - getInstance
```
public static final X509Certificate getInstance(InputStream inStream)
                                         throws CertificateException
```
    实例化一个X509Certificate对象，并使用从输入流inStream读取的数据进行inStream 。实现（X509Certificate是抽象类）由指定为cert.provider.x509v1 security属性值的类提供。
    注意：预计只有一个DER编码证书在输入流中。此外，所有X509Certificate子类都必须提供以下形式的构造函数：
```
   public <subClass>(InputStream inStream) ...  
```
    参数
    
    inStream - 要读取的数据的 inStream的输入流。
    
    结果
    
    用输入流中的数据初始化一个X509Certificate对象。
    
    异常
    
    CertificateException - 如果发生类初始化或证书解析错误。
  - getInstance
```
public static final X509Certificate getInstance(byte[] certData)
                                         throws CertificateException
```
    实例化一个X509Certificate对象，并用指定的字节数组初始化它。实现（X509Certificate是一个抽象类）由指定为cert.provider.x509v1安全属性值的类提供。
    注意：所有X509Certificate子类必须提供以下形式的构造函数：
```
   public <subClass>(InputStream inStream) ...  
```
    参数
    
    certData - 包含DER编码证书的字节数组。
    
    结果
    
    一个X509Certificate对象用certData的数据 certData 。
    
    异常
    
    CertificateException - 如果发生类初始化或证书解析错误。
  - checkValidity
```
public abstract void checkValidity()
                            throws CertificateExpiredException,
                                   CertificateNotYetValidException
```
    检查证书当前是否有效。如果当前日期和时间在证书中给出的有效期内。
    有效期由两个日期/时间值组成：证书有效的第一个和最后一个日期（和时间）。它在ASN.1中定义为：
```
  validity             Validity

 Validity ::= SEQUENCE {
     notBefore      CertificateValidityDate,
     notAfter       CertificateValidityDate }

 CertificateValidityDate ::= CHOICE {
     utcTime        UTCTime,
     generalTime    GeneralizedTime } 
```
    异常
    
    CertificateExpiredException - 如果证书已过期。
    
    CertificateNotYetValidException - 如果证书尚未生效。
  - checkValidity
```
public abstract void checkValidity(Date date)
                            throws CertificateExpiredException,
                                   CertificateNotYetValidException
```
    检查指定的日期是否在证书的有效期内。换句话说，这将决定证书是否在指定的日期/时间有效。
    
    参数
    
    date - 在该日期/时间检查此证书是否有效的日期。
    
    异常
    
    CertificateExpiredException - 如果证书已经到期提供的 date 。
    
    CertificateNotYetValidException - 如果证书不符合提供的 date有效。
    
    另请参见：
    
    checkValidity()
  - getVersion
```
public abstract int getVersion()
```
    从version获取version （版本号）值。 ASN.1的定义是：
```
  version         [0]  EXPLICIT Version DEFAULT v1

 Version  ::=  INTEGER  {  v1(0), v2(1), v3(2)  } 
```
    结果
    
    来自ASN.1编码的版本号，即0，1或2。
  - getSerialNumber
```
public abstract BigInteger getSerialNumber()
```
    从证书中获取serialNumber值。序列号是由证书颁发机构分配给每个证书的整数。对于由给定CA颁发的每个证书（即，发行者名称和序列号标识唯一证书），它必须是唯一的。 ASN.1的定义是：
```
  serialNumber     CertificateSerialNumber

 CertificateSerialNumber  ::=  INTEGER 
```
    结果
    
    序列号。
  - getIssuerDN
```
public abstract Principal getIssuerDN()
```
    从issuer获取issuer （发行人可分辨名称）值。发行人名称标识签发（并签发）证书的实体。
    发行人名称字段包含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 。
    结果
    
    一位姓名为发行人名称的校长。
  - getSubjectDN
```
public abstract Principal getSubjectDN()
```
    从subject获取subject （主题可分辨名称）值。 ASN.1的定义是：
```
  subject    Name 
```
    关于Name的Name和其他相关定义。
    结果
    
    名称为主题名称的校长。
    
    另请参见：
    
    getIssuerDN()
  - getNotBefore
```
public abstract Date getNotBefore()
```
    从notBefore的有效期获取notBefore日期。相关的ASN.1定义是：
```
  validity             Validity

 Validity ::= SEQUENCE {
     notBefore      CertificateValidityDate,
     notAfter       CertificateValidityDate }

 CertificateValidityDate ::= CHOICE {
     utcTime        UTCTime,
     generalTime    GeneralizedTime } 
```
    结果
    
    有效期的开始日期。
    
    另请参见：
    
    checkValidity()
  - getNotAfter
```
public abstract Date getNotAfter()
```
    从notAfter的有效期获取notAfter日期。见getNotBefore对相关的ASN.1定义。
    
    结果
    
    有效期结束日期。
    
    另请参见：
    
    checkValidity()
  - getSigAlgName
```
public abstract String getSigAlgName()
```
    获取证书签名算法的签名算法名称。一个例子是字符串“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()
```
    从证书获取签名算法OID字符串。 OID由一组由周期分隔的正整数表示。例如，根据PKIX第一部分，字符串“1.2.840.10040.4.3”标识具有DSA签名算法的SHA-1。
    见getSigAlgName对相关的ASN.1定义。
    
    结果
    
    签名算法OID字符串。
  - getSigAlgParams
```
public abstract byte[] getSigAlgParams()
```
    从该证书的签名算法获取DER编码的签名算法参数。在大多数情况下，签名算法参数为null; 参数通常随附证书的公钥一起提供。
    见getSigAlgName对相关的ASN.1定义。
    
    结果
    
    DER编码的签名算法参数，如果没有参数，则为null。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class X509Certificate

构造方法摘要

方法摘要

Methods inherited from class javax.security.cert.Certificate

Methods inherited from class java.lang.Object

构造方法详细信息

X509Certificate

方法详细信息

getInstance

getInstance

checkValidity

checkValidity

getVersion

getSerialNumber

getIssuerDN

getSubjectDN

getNotBefore

getNotAfter

getSigAlgName

getSigAlgOID

getSigAlgParams