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：
```
证书：：=序列tbscertificate tbscertificate，algorithmidentifier签名算法，签名位字符串
```
这些证书被广泛用于支持在互联网安全系统中的身份验证和其他功能。常见的应用包括隐私增强邮件（PEM），传输层安全（SSL），代码为可信软件分发签名和安全电子交易（SET）。

这些证书的管理和保证的证书颁发机构（CA）。CAS是通过将数据创建证书的X.509标准的格式，然后进行数字签名，数据服务。中国科学院作为受信任的第三方，使彼此之间没有直接的知识的校长之间的介绍。钙证书是由自己签署的，或由一些其他的钙，如一个“根”约。

ASN的tbsCertificate 1定义：
```
tbscertificate：：=序列{版本[ 0 ]明确的版本默认V1，序列号certificateserialnumber，签名algorithmidentifier，发行人名称，效力，课题名称，subjectpublickeyinfo subjectpublickeyinfo，}
```
下面是示例代码实例化一个X.509证书：
```
InputStream流=新的输入（“filename证书”）；X509Certificate证书= X509Certificate getInstance（河道）；河道内。（）；
```
或
```
字节[] certdata = 
 
        
        
        
      
        
      <证书读取一个文件，说>
       
         
       
         
         
         
  X509Certificate证书= 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 SE证书班位于java.security.cert。
从以下版本开始：

一点四

另请参见：

Certificate， X509Extension， security properties

构造方法摘要

构造方法

Constructor and Description

X509Certificate()

构造方法
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`。
`abstract Principal`	`getIssuerDN()` 得到 `issuer`（发行人可分辨名称）从证书的价值。
`abstract Date`	`getNotAfter()` 从该证书的有效期有 `notAfter`日期。
`abstract Date`	`getNotBefore()` 从该证书的有效期有 `notBefore`日期。
`abstract BigInteger`	`getSerialNumber()` 从获取证书的 `serialNumber`价值。
`abstract String`	`getSigAlgName()` 获取证书签名算法的签名算法的名称。
`abstract String`	`getSigAlgOID()` 从获取证书的签名算法OID的字符串。
`abstract byte[]`	`getSigAlgParams()` 从该证书的签名算法得到的的的的的的的的的编码的签名算法参数。
`abstract Principal`	`getSubjectDN()` 得到 `subject`（主题可分辨名称）从证书的价值。
`abstract int`	`getVersion()` 得到 `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

- Constructor Detail
  - X509Certificate
```
public X509Certificate()
```
- 方法详细信息
  - getInstance
```
public static final X509Certificate getInstance(InputStream inStream)
                                         throws CertificateException
```
    实例化和初始化它的X509Certificate对象与数据从输入流中读取 inStream。实施（X509Certificate是一个抽象类）是由类指定的 cert.provider.x509v1安全属性提供的值。
    注：只有一个的德编码证书预计将在输入流。同时，所有的子类必须提供一个构造函数X509Certificate的形式：
```
 public <subClass>(InputStream 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字节数组编码的证书。
    
    结果
    
    从 certData X509Certificate对象初始化的数据。
    
    异常
    
    CertificateException -如果一个类初始化或证书解析错误发生。
  - checkValidity
```
public abstract void checkValidity()
                            throws CertificateExpiredException,
                                   CertificateNotYetValidException
```
    检查证书是否有效。如果当前日期和时间都在证书中的有效期内。
    有效期由两个日期/时间值组成：证书有效期的第一个和最后一个日期（和时间）。它是定义在ASN。1：
```
效力有效性：：=序列先certificatevaliditydate，之后，certificatevaliditydate }certificatevaliditydate：：=选择{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（版本号）从证书的价值。ASN。这1的定义是：
```
版本[ 0 ]明确的版本默认V1版本：：=整数{ V1，V2（0）（1），V3（2）}
```
    结果
    
    从系统的版本号。1编码，即0、1或2。
  - getSerialNumber
```
public abstract BigInteger getSerialNumber()
```
    从获取证书的 serialNumber价值。序列号是由证书颁发机构分配给每个证书的整数。它必须是唯一的每一个由一个给定的证书颁发的证书（即，发行人的名称和序列号确定一个唯一的证书）。ASN。这1的定义是：
```
序列号certificateserialnumberCertificateSerialNumber：：=整数
```
    结果
    
    序列号。
  - getIssuerDN
```
public abstract Principal getIssuerDN()
```
    得到 issuer（发行人可分辨名称）从证书的价值。发行人名称标识签名（并颁发）证书的实体。
    发行人名称字段包含一个X.500可分辨名称（DN）。ASN。此1定义：
```
发行人名称名称：：=选择rdnsequence } {rdnsequence：：=序列relativedistinguishednamerelativedistinguishedname：：=套attributevalueassertionattributevalueassertion：：=序列{AttributeType，属性值}AttributeType：：=对象标识符属性值：：=任何
```
    的 Name描述了一个由属性层次的名称，如国家的名字，和对应的值，如美国。 AttributeValue组件的类型是由 AttributeType确定；一般来说这将是一个 directoryString。一个 directoryString通常是一个 PrintableString， TeletexString或 UniversalString。
    结果
    
    名称为发行人姓名的委托人。
  - getSubjectDN
```
public abstract Principal getSubjectDN()
```
    得到 subject（主题可分辨名称）从证书的价值。ASN。这1的定义是：
```
课题名称
```
    看到Name和其他相关的定义getIssuerDN。
    结果
    
    名称为主题名称的主体。
    
    另请参见：
    
    getIssuerDN()
  - getNotBefore
```
public abstract Date getNotBefore()
```
    从该证书的有效期有 notBefore日期。有关ASN. 1定义：
```
效力有效性：：=序列先certificatevaliditydate，之后，certificatevaliditydate }certificatevaliditydate：：=选择{UTCTime UTCTime，generaltime generalizedtime }
```
    结果
    
    有效期的开始日期。
    
    另请参见：
    
    checkValidity()
  - getNotAfter
```
public abstract Date getNotAfter()
```
    从该证书的有效期有 notAfter日期。看到有关ASN getNotBefore 1定义。
    
    结果
    
    有效期的结束日期。
    
    另请参见：
    
    checkValidity()
  - getSigAlgName
```
public abstract String getSigAlgName()
```
    获取证书签名算法的签名算法的名称。一个例子是字符串“SHA-1或DSA”。ASN。这1的定义是：
```
algorithmidentifier签名算法algorithmidentifier：：=序列{算法对象标识符，参数定义的算法可选}-包含类型的值——注册用的——算法对象标识符值
```
    该算法的名字是从algorithm OID字符串确定。
    结果
    
    签名算法名称。
  - getSigAlgOID
```
public abstract String getSigAlgOID()
```
    从获取证书的签名算法OID的字符串。一个OID是由一组正整数用句点分隔的代表。例如，字符串“1.2.840.10040.4.3”标识的SHA-1与DSA签名算法，根据PKIX第一部分
    看到有关ASN getSigAlgName 1定义。
    
    结果
    
    签名算法OID的字符串。
  - getSigAlgParams
```
public abstract byte[] getSigAlgParams()
```
    从该证书的签名算法得到的的的的的的的的的编码的签名算法参数。在大多数情况下，签名算法参数是无效的，参数通常是提供证书的公钥。
    看到有关ASN getSigAlgName 1定义。
    
    结果
    
    的的的的的的的的编码的签名算法参数，或空，如果没有参数。

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

Constructor Detail

X509Certificate

方法详细信息

getInstance

getInstance

checkValidity

checkValidity

getVersion

getSerialNumber

getIssuerDN

getSubjectDN

getNotBefore

getNotAfter

getSigAlgName

getSigAlgOID

getSigAlgParams