compact1, compact2, compact3

java.security.cert

Class CertificateFactorySpi

java.lang.Object

java.security.cert.CertificateFactorySpi

public abstract class CertificateFactorySpi
extends Object

这个类定义的 （SPI） CertificateFactory类。 该类中的所有抽象方法必须由希望为特定证书类型（例如X.509）提供证书工厂的实现的每个加密服务提供商实现。

证书工厂用于从其编码生成证书，认证路径（ CertPath ）和证书撤销列表（CRL）对象。

X.509的证书工厂必须返回一个实例为java.security.cert.X509Certificate ，而CRL为java.security.cert.X509CRL 。

从以下版本开始：

1.2

另请参见：

CertificateFactory ， Certificate ， X509Certificate ， CertPath ， CRL ， X509CRL

构造方法摘要

构造方法

Constructor and Description
CertificateFactorySpi()

方法摘要

Modifier and Type	Method and Description
abstract Certificate	engineGenerateCertificate(InputStream inStream) 生成证书对象，并使用从输入流 inStream读取的数据进行 inStream 。
abstract Collection<? extends Certificate>	engineGenerateCertificates(InputStream inStream) 返回从给定输入流 inStream读取的证书的（可能为空的）集合视图。
CertPath	engineGenerateCertPath(InputStream inStream) 生成一个 CertPath对象，并使用从 InputStream inStream读取的数据进行 InputStream 。
CertPath	engineGenerateCertPath(InputStream inStream, String encoding) 生成一个 CertPath对象，并使用从 InputStream inStream读取的数据进行 InputStream 。
CertPath	engineGenerateCertPath(List<? extends Certificate> certificates) 生成一个 CertPath对象，并使用 List的 Certificate s进行 Certificate 。
abstract CRL	engineGenerateCRL(InputStream inStream) 生成证书吊销列表（CRL）对象，并使用从输入流 inStream读取的数据进行 inStream 。
abstract Collection<? extends CRL>	engineGenerateCRLs(InputStream inStream) 返回从给定输入流 inStream读取的CRL的（可能为空的）集合视图。
Iterator<String>	engineGetCertPathEncodings() 返回此证书工厂 CertPath CertPath编码的迭代，首先使用默认编码。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

CertificateFactorySpi

public CertificateFactorySpi()

方法详细信息

engineGenerateCertificate

public abstract Certificate engineGenerateCertificate(InputStream inStream)
                                               throws CertificateException

生成证书对象，并使用从输入流inStream读取的数据进行inStream 。

为了利用此证书工厂支持的特殊证书格式，返回的证书对象可以类型转换为相应的证书类。 例如，如果此证书工厂实施X.509证书，则返回的证书对象可以类型转换为X509Certificate类。

在X.509证书的证书工厂的情况下，inStream中提供的inStream必须是DER编码的，并且可以以二进制或可打印（Base64）编码方式提供。 如果证书是以Base64编码方式提供的，则必须以----- BEGIN CERTIFICATE -----开头为边界，并且必须在----- END CERTIFICATE ----- 。

请注意，如果给定的输入流不支持mark和reset ，则此方法将消耗整个输入流。 否则，对该方法的每次调用都会消耗一个证书，并且输入流的读取位置位于固有的证书结束标记之后的下一个可用字节。 如果输入流中的数据不包含固有的证书结束标记（EOF除外），并且在证书被解析后存在尾随数据，则会抛出一个CertificateException 。

参数

inStream - 具有证书数据的输入流。

结果

用来自输入流的数据初始化的证书对象。

异常

CertificateException - 解析错误。

engineGenerateCertPath

public CertPath engineGenerateCertPath(InputStream inStream)
                                throws CertificateException

生成一个CertPath对象，并使用从InputStream inStream读取的数据进行InputStream 。 数据假定为默认编码。

该方法被添加到Java 2平台标准版的1.4版本。 为了保持与现有服务提供商的向后兼容性，此方法不能为abstract ，默认情况下会抛出UnsupportedOperationException 。

参数

inStream - 一个 InputStream数据的 InputStream

结果

一个 CertPath初始化的数据来自 InputStream

异常

CertificateException - 解码时是否发生异常

UnsupportedOperationException - 如果不支持该方法

从以下版本开始：

1.4

engineGenerateCertPath

public CertPath engineGenerateCertPath(InputStream inStream,
                                       String encoding)
                                throws CertificateException

生成一个CertPath对象，并使用从InputStream inStream读取的数据进行InputStream 。 数据假定为指定的编码。

该方法被添加到Java 2平台标准版的1.4版本。 为了保持与现有服务提供商的向后兼容性，此方法不能为abstract ，默认情况下会抛出UnsupportedOperationException 。

参数

inStream - 一个 InputStream数据的 InputStream

encoding - 用于数据的编码

结果

一个 CertPath初始化的数据来自 InputStream

异常

CertificateException - 如果在解码或请求的编码不支持时发生异常

UnsupportedOperationException - 如果不支持该方法

从以下版本开始：

1.4

engineGenerateCertPath

public CertPath engineGenerateCertPath(List<? extends Certificate> certificates)
                                throws CertificateException

生成一个CertPath对象，并使用Certificate s的List进行Certificate 。

提供的证书必须是CertificateFactory支持的CertificateFactory 。 它们将被拷贝出来，随附的List对象。

该方法被添加到Java 2平台标准版的1.4版本。 为了保持与现有服务提供商的向后兼容性，此方法不能为abstract ，默认情况下会抛出UnsupportedOperationException 。

参数

certificates - a List of Certificate s

结果

一个 CertPath用提供的证书列表初始化

异常

CertificateException - 如果发生异常

UnsupportedOperationException - 如果不支持该方法

从以下版本开始：

1.4

engineGetCertPathEncodings

public Iterator<String> engineGetCertPathEncodings()

返回此证书工厂CertPath CertPath编码的迭代，首先使用默认编码。 看到的CertPath编码部分Java Cryptography Architecture Standard Algorithm Name Documentation有关标准编码名称的信息。

尝试通过其remove方法修改返回的Iterator会导致UnsupportedOperationException 。

该方法被添加到Java 2平台标准版的1.4版本。 为了保持与现有服务提供商的向后兼容性，此方法不能为abstract ，默认情况下会抛出UnsupportedOperationException 。

结果

一个 Iterator的支持的CertPath CertPath名称（如 String ）

异常

UnsupportedOperationException - 如果不支持该方法

从以下版本开始：

1.4

engineGenerateCertificates

public abstract Collection<? extends Certificate> engineGenerateCertificates(InputStream inStream)
                                                                      throws CertificateException

返回从给定输入流inStream读取的证书的（可能为空的）集合视图。

为了利用此证书工厂支持的特殊证书格式，返回的集合视图中的每个元素都可以类型转换为相应的证书类。 例如，如果此证书工厂实施X.509证书，返回集合中的元素可以类型转换为X509Certificate类。

在X.509证书的证书工厂的情况下， inStream可能包含generateCertificate所述格式的单个DER编码证书 。 另外， inStream可能包含PKCS＃7证书链。 这是一个PKCS＃7 SignedData对象，唯一有效的字段是证书 。 特别地，签名和内容被忽略。 此格式允许一次下载多个证书。 如果没有证书，则返回空集合。

请注意，如果给定的输入流不支持mark和reset ，则此方法将消耗整个输入流。

参数

inStream - 具有 inStream的输入流。

结果

使用来自输入流的数据初始化的java.security.cert.Certificate对象的（可能为空的）集合视图。

异常

CertificateException - 解析错误。

engineGenerateCRL

public abstract CRL engineGenerateCRL(InputStream inStream)
                               throws CRLException

生成证书吊销列表（CRL）对象，并使用从输入流inStream读取的数据进行inStream 。

为了利用此证书工厂支持的专用CRL格式，返回的CRL对象可以对应于相应的CRL类型。 例如，如果此证书工厂实现X.509 CRL，则返回的CRL对象可以类型转换为X509CRL类。

请注意，如果给定的输入流不支持mark和reset ，则此方法将消耗整个输入流。 否则，对该方法的每次调用都会消耗一个CRL，并且输入流的读取位置位于固有的CRL结束标记之后的下一个可用字节。 如果输入流中的数据不包含固有的CRL结束标记（EOF除外），并且在解析CRL后存在尾随数据，则会抛出CRLException 。

参数

inStream - 具有CRL数据的输入流。

结果

用输入流中的数据初始化一个CRL对象。

异常

CRLException - 解析错误。

engineGenerateCRLs

public abstract Collection<? extends CRL> engineGenerateCRLs(InputStream inStream)
                                                      throws CRLException

返回从给定输入流inStream读取的CRL的（可能为空的）集合视图。

为了利用此证书工厂支持的专用CRL格式，返回的集合视图中的每个元素都可以类型转换为相应的CRL类。 例如，如果此证书工厂实现X.509 CRL，则返回的集合中的元素可以类型转换为X509CRL类。

在X.509 CRL的证书工厂的情况下， inStream可能包含单个DER编码的CRL。 另外， inStream可能包含PKCS＃7 CRL集。 这是一个PKCS＃7 SignedData对象，唯一有效的字段是crls 。 特别地，签名和内容被忽略。 此格式允许一次下载多个CRL。 如果没有CRL，则返回一个空的集合。

请注意，如果给定的输入流不支持mark和reset ，则此方法将消耗整个输入流。

参数

inStream - 具有CRL的输入流。

结果

使用来自输入流的数据初始化的java.security.cert.CRL对象的（可能为空的）集合视图。

异常

CRLException - 解析错误。