- java.lang.Object
-
- java.security.cert.CertificateFactorySpi
-
public abstract class CertificateFactorySpi extends Object
此类定义CertificateFactory
类的 ( SPI )。 此类中的所有抽象方法必须由希望为特定证书类型(例如,X.509)提供证书工厂实现的每个加密服务提供者实现。证书工厂用于从其编码生成证书,证书路径(
CertPath
)和证书撤销列表(CRL)对象。X.509的证书工厂必须返回
java.security.cert.X509Certificate
实例的java.security.cert.X509Certificate
,以及java.security.cert.X509CRL
实例的java.security.cert.X509CRL
。- 从以下版本开始:
- 1.2
- 另请参见:
-
CertificateFactory
,Certificate
,X509Certificate
,CertPath
,CRL
,X509CRL
-
-
构造方法摘要
构造方法 构造器 描述 CertificateFactorySpi()
-
方法摘要
所有方法 实例方法 抽象方法 具体的方法 变量和类型 方法 描述 abstract Certificate
engineGenerateCertificate(InputStream 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
初始化它。abstract CRL
engineGenerateCRL(InputStream inStream)
生成证书吊销列表(CRL)对象,并使用从输入流inStream
读取的数据对其进行初始化。abstract Collection<? extends CRL>
engineGenerateCRLs(InputStream inStream)
返回从给定输入流inStream
读取的CRL的(可能为空)集合视图。Iterator<String>
engineGetCertPathEncodings()
返回此证书工厂支持的CertPath
编码的迭代,首先使用默认编码。
-
-
-
方法详细信息
-
engineGenerateCertificate
public abstract Certificate engineGenerateCertificate(InputStream inStream) throws CertificateException
生成证书对象并使用从输入流inStream
读取的数据对其进行初始化。为了利用此证书工厂支持的专用证书格式,可以将返回的证书对象强制转换为相应的证书类。 例如,如果此证书工厂实现X.509证书,则返回的证书对象可以类型转换为
X509Certificate
类。对于X.509证书的证书工厂,
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 Platform Standard Edition的1.4版中。 为了保持与现有服务提供者的向后兼容性,此方法不能是
abstract
,默认情况下会抛出UnsupportedOperationException
。- 参数
-
inStream
- 包含数据的InputStream
- 结果
-
一个
CertPath
从与所述数据初始化InputStream
- 异常
-
CertificateException
- 如果解码时发生异常 -
UnsupportedOperationException
- 如果不支持该方法 - 从以下版本开始:
- 1.4
-
engineGenerateCertPath
public CertPath engineGenerateCertPath(InputStream inStream, String encoding) throws CertificateException
生成CertPath
对象,并使用从InputStream
inStream中读取的数据InputStream
进行初始化。 假设数据采用指定的编码。此方法已添加到Java 2 Platform Standard Edition的1.4版中。 为了保持与现有服务提供商的向后兼容性,此方法不能是
abstract
,默认情况下会抛出UnsupportedOperationException
。- 参数
-
inStream
- 包含数据的InputStream
-
encoding
- 用于数据的编码 - 结果
-
一个
CertPath
从与所述数据初始化InputStream
- 异常
-
CertificateException
- 如果在解码时发生异常或不支持所请求的编码 -
UnsupportedOperationException
- 如果不支持该方法 - 从以下版本开始:
- 1.4
-
engineGenerateCertPath
public CertPath engineGenerateCertPath(List<? extends Certificate> certificates) throws CertificateException
生成CertPath
对象并使用List
(Certificate
对其进行初始化。提供的证书必须是
CertificateFactory
支持的类型。 它们将从提供的List
对象中复制出来。此方法已添加到Java 2 Platform Standard Edition的1.4版中。 为了保持与现有服务提供者的向后兼容性,此方法不能是
abstract
,默认情况下会抛出UnsupportedOperationException
。- 参数
-
certificates
-List
ofCertificate
s - 结果
-
使用提供的证书列表初始化的
CertPath
- 异常
-
CertificateException
- 如果发生异常 -
UnsupportedOperationException
- 如果不支持该方法 - 从以下版本开始:
- 1.4
-
engineGetCertPathEncodings
public Iterator<String> engineGetCertPathEncodings()
返回此证书工厂支持的CertPath
编码的迭代,首先使用默认编码。 有关标准编码名称的信息,请参阅Java Security Standard Algorithm Names Specification中的CertPath编码部分。尝试通过
remove
方法修改返回的Iterator
,结果为UnsupportedOperationException
。此方法已添加到Java 2 Platform Standard Edition的1.4版中。 为了保持与现有服务提供者的向后兼容性,此方法不能是
abstract
,默认情况下会抛出UnsupportedOperationException
。- 结果
-
一个
Iterator
超过支持的CertPath
编码的名称(如String
s) - 异常
-
UnsupportedOperationException
- 如果不支持该方法 - 从以下版本开始:
- 1.4
-
engineGenerateCertificates
public abstract Collection<? extends Certificate> engineGenerateCertificates(InputStream inStream) throws CertificateException
返回从给定输入流inStream
读取的证书的(可能为空)集合视图。为了利用此证书工厂支持的专用证书格式,可以将返回的集合视图中的每个元素强制转换为相应的证书类。 例如,如果此证书工厂实现X.509证书,则返回集合中的元素可以类型转换为
X509Certificate
类。对于X.509证书的证书工厂,
inStream
可能包含一个DER编码的证书,其格式为generateCertificate
。 此外,inStream
可能包含PKCS#7证书链。 这是一个PKCS#7 SignedData对象,唯一重要的字段是证书 。 特别是,签名和内容被忽略。 此格式允许一次下载多个证书。 如果没有证书,则返回空集合。- 参数
-
inStream
- 带有证书的输入流。 - 结果
- 使用输入流中的数据初始化的java.security.cert.Certificate对象的(可能为空)集合视图。
- 异常
-
CertificateException
- 解析错误。
-
engineGenerateCRL
public abstract CRL engineGenerateCRL(InputStream inStream) throws CRLException
生成证书吊销列表(CRL)对象,并使用从输入流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,则返回空集合。- 参数
-
inStream
- 带有CRL的输入流。 - 结果
- 使用输入流中的数据初始化的java.security.cert.CRL对象的(可能为空)集合视图。
- 异常
-
CRLException
- 解析错误。
-
-