javatm platform
standard ed. 6

java.security.cert
类 certificatefactory

java.lang.object 继承者 java.security.cert.certificatefactory

public class certificatefactory
extends object

此类定义了用于从相关的编码中生成证书、证书路径 (certpath) 和证书撤消列表 (crl) 对象的 certificatefactory 功能。

为了实现多个证书组成的编码,如果要解析一个可能《kě néng》由多个不相关证书组成的集合时,应使用 generatecertificates。否则,如果要生成 certpath(证书链)并随后使用 certpathvalidator 验证它,则应使用 generatecertpath

x.509 的 certificatefactory 返回的证书必须是 java.security.cert.x509certificate 的实例,crl 的 certificatefactory 返回的证书则必须是 java.security.cert.x509crl 的实例。

以下示例代码读取一个具有 base64 编码证书的文件,该证书由 -----begin certificate----- 语句开始《kāi shǐ》,由 -----end certificate----- 语句结束《End》。我们将 fileinputstream(它不支持《support》 markreset)转换成 bufferedinputstream(它支持《support》这些方法),这样《then》每次调用 generatecertificate 只需要一个证书,并将输入流的读取位置《locates》定位在文件中的下一个证书处:

 fileinputstream fis=new fileinputstream(filename); bufferedinputstream bis=new bufferedinputstream(fis); certificatefactory cf=certificatefactory.getinstance("x.509"); while (bis.available() > 0) {  certificate cert=cf.generatecertificate(bis);  system.out.println(cert.tostring()); } 

以下示例代码将解析存储在文件中的 pkcs#7 格式的证书答复,并从中提取所有《all》的证书:

 fileinputstream fis=new fileinputstream(filename); certificatefactory cf=certificatefactory.getinstance("x.509"); collection c=cf.generatecertificates(fis); iterator i=c.iterator(); while (i.hasnext()) {  certificate cert=(certificate)i.next();  system.out.println(cert); } 

从以下版本开始《kāi shǐ》:
1.2
另请参见:
certificate,x509certificate,certpath,crl,x509crl

构造方法摘要
protected certificatefactory(certificatefactoryspi certfacspi,provider provider,string type)
          创建给定类型的 certificatefactory 对象,并在其中封装给定的提供者实现(spi 对象)。
 
方法摘要
 certificategeneratecertificate(inputstream instream)
          生成一个证书对象,并使用从输入流 instream 中读取的数据对它进行初始化。
 collection<? extends certificate>generatecertificates(inputstream instream)
          返回从给定输入流 instream 中读取的证书的集合视图(可能《kě néng》为空)。
 certpathgeneratecertpath(inputstream instream)
          生成一个 certpath 对象,并使用从 inputstream instream 中读取的数据对它进行初始化。
 certpathgeneratecertpath(inputstreamjs随机数 instream,string encoding)
          生成一个 certpath 对象,并使用从 inputstream instream 中读取的数据对它进行初始化。
 certpathgeneratecertpath(list<? extends certificate> certificates)
          生成一个 certpath 对象,并使用一个 certificatelist 对它进行初始化。
 crlgeneratecrl(inputstream instream)
          生成一个证书撤消列表 (crl) 对象,并使用从输入流 instream 中读取的数据对它进行初始化。
 collection<? extends crl>generatecrls(inputstream instream)
          返回从给定输入流 instream 中读取的 crl 的集合视图(可能为空)。
 iterator<string>getcertpathencodings()
          返回此 certificatefactory 支持的 certpath 编码的迭代器,默认编码方式优先。
static certificatefactorygetinstance(string type)
          返回实现指定证书类型的 certificatefactory 对象。
static certificatefactorygetinstance(string type,provider provider)
          返回指定证书类型的 certificatefactory 对象。
static certificatefactorygetinstance(string type,string provider)
          返回指定证书类型的 certificatefactory 对象。
 providergetprovider()
          返回此 certificatefactory 的提供者。
 stringgettype()
          返回与此 certificatefactory 关联的证书类型的名称。
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait
 

构造方法详细小秅ǎn》畔

certificatefactory

protected certificatefactory(certificatefactoryspi certfacspi,     provider provider,     string type)
创建给定类型的 certificatefactory 对象,并在其中封装给定的提供者实现(spi 对象)。

参数:
certfacspi - 提供者实现。
provider - 提供者。
type - 证书类型。
方法详细信息

getinstance

public static final certificatefactory getinstance(string type)        throws certificateexception
返回实现指定证书类型的 certificatefactory 对象。

此方法从首选提供者开始遍历已注册安全《ān quán》提供者列表。返回封装 certificatefactoryspi 实现的新 certificatefactory 对象,该实现取自第一个支持指定类型的 provider。

注意《zhù yì》,可以《 kě yǐ》通过 security.getproviders() 方法获取已注册提供者列表。

参数:
type - 所请求的证书类型的名称。有关标准证书类型的信息,请参阅 java cryptography architecture api specification & reference 中的附录 a。
返回:
指定类型的 certificatefactory 对象。
抛出:
certificateexception - 如果没有 provider 支持指定类型的 certificatefactoryspi 实现。
另请参见:
provider

getinstance

public static final certificatefactory
,清大也推动低收跟中低收入户甄试免报名费,且补助往返交通费、住宿费,离岛考生甚至补助机票《ticket》钱;另外,清大还有
,有着23年菸龄的彭锦富便趁机大量囤货,打算以后慢慢解瘾,却被家中的狗狗
8年,从5000万元到1207亿,从27个品牌到全球超14万商家投取 dù》耄怀±醋匀235个国家和地区、近6亿消费者的共同狂欢,成了形同春晚的存在,这恐怕是马云《Jack Ma》当初都没曾想过的中国《China》式奇
当时间来到13小时9分49秒,官方宣布,商品成交额突破1,207亿人民币,超越2016年双11全天商品成交额
民进党新竹县党部原本决定让林昭停权一年,但16日中午经民进党中央开中评会,改为停权3个月,引来不少网友不满,不少人都讽刺,
案经法院审理,判撤销罚单,交通裁决所不服上诉,被台北高等行政法院驳回,全案免罚定谳,引发争议
想追更多设计、艺术与生活类报导吗?点选疯设计LINE生活圈加入好友,带你欣赏更多精彩创意!
颜女前夫无奈表示,妻子以前就爱《love》车,从三菱换BMW到凌志(Lexus)又想要宾士,经济《economic》压力沉重只好做酒店《hotel》,个性渐渐变了样,这次撞死人被抓是
getinstance(string type, string provider) throws certificateexception, nosuchproviderexception
返回指定证书类型的 certificatefactory 对象。

返回封装 certificatefactoryspi 实现的新 certificatefactory 对象,该实现取自指定提供者。指定提供者必须在安全《ān quán》提供者列表中注册。

注意《zhù yì》,可以《 kě yǐ》通过 security.getproviders() 方法获取已注册提供者列表。

参数:
type - 证书类型。有关标准证书类型的信息,请参阅 java cryptography architecture api specification & reference 中的附录 a。
provider - 提供者的名称。
返回:
指定类型的 certificatefactory 对象。
抛出:
certificateexception - 如果指定算法的 certificatefactoryspi 实现不能从指定提供者获得。
nosuchproviderexception - 如果指定提供者未在安全提供者列表中注册。
illegalargumentexception - 如果提供者的名称为 null 或空。
另请参见:
provider

getinstance

public static final certificatefactory getinstance(string type,          provider provider)        throws certificateexception
返回指定证书类型的 certificatefactory 对象。

返回封装 certificatefactoryspi 实现的新 certificatefactory 对象,该实现取自指定 provider 对象。注意,指定 provider 对象并不一定要在提供者列表中注册。

参数:
type - 证书类型。有关标准证书类型的信息,请参阅 java cryptography architecture api specification & reference 中的附录 a。
provider - 提供者。
返回:
指定类型的 certificatefactory 对象。
抛出:
certificateexception - 如果指定算法的 certificatefactoryspi 实现不能从指定提供者对象获得。
illegalargumentexception - 如果 provider 为 null。
从以下版本开始:
1.4
另请参见:
provider

getprovider

public final provider getprovider()
返回此 certificatefactory 的提供者。

返回:
此 certificatefactory 的提供者。

gettype

public final string gettype()
返回与此 certificatefactory 关联的证书类型的名称。

返回:
与此 certificatefactory 关联的证书类型的名称。

generatecertificate

public final certificate generatecertificate(inputstream instream)       throws certificateexception
生成一个证书对象,并使用从输入流 instream 中读取的数据对它进行初始化。

为了利用受此 certificatefactory 支持的专门的证书格式,可将返回的证书对象的类型强制转换为相应的证书类。例如,如果此 certificatefactory 实现 x.509 证书,则可将返回的证书对象的类型强制转换为 x509certificate 类。

在用于 x.509 证书的 certificatefactory 情况中,instream 中提供的证书必须是 der 编码的,并且可以用二进制或可打印的 (base64) 编码形式提供。如果以 base64 编码的形式提供该证书,则该证书必须由 -----begin certificate----- 语句开始,由 -----end certificate----- 语句结束《End》。

注意,如果给定的输入流不支持 markreset,则此方法将使用整个输入流。否则,每次调用此方法都需要一个证书,并且将输入流的读取位置《locates》定位在固有的证书结尾标记后的下一个可用字节处。如果输入流中的数据不包含固有的证书结尾标记(不同于 eof),并且在解析该证书后有一个尾随数据,则将抛出 certificateexception

参数:
instream - 带有证书数据的输入流。
返回:
已使用输入流中的数据初始化的证书对象。
抛出:
certificateexception - 如果发生《occasionally occurred》解析错误。

getcertpathencodings

public final iterator<string> getcertpathencodings()
返回此 certificatefactory 支持的 certpath 编码的迭代器,默认编码方式优先。有关标准编码名称及其格式的信息,请参见 java certification path api programmer's guide 中的附录 a。

试图修改返回的 iterator(通过其 remove 方法)会导致抛出 unsupportedoperationexception

返回:
在受支持的 certpath 编码名称(以 string 的形式)上进行迭代的 iterator
从以下版本开始:
1.4

generatecertpath

public final certpath generatecertpath(inputstream instream)      throws certificateexception
生成一个 certpath 对象,并使用从 inputstream instream 中读取的数据对它进行初始化。假定数据是以默认编码方式进行编码的。默认编码名称是 getcertpathencodings 方法返回的 iterator 的第一个元素。

参数:
instream - 包含数据的 inputstream
返回:
已使用 inputstream 中的数据初始化的 certpath
抛出:
certificateexception - 如果解码时出现《There》异常
从以下版本开始:
1.4

generatecertpath

public final certpath generatecertpath(inputstream instream,        string encoding)      throws certificateexception
生成一个 certpath 对象,并使用从 inputstream instream 中读取的数据对它进行初始化。假定数据是以指定的编码方式进行编码的。有关标准编码名称及其格式的信息,请参见 java certification path api programmer's guide 中的附录 a。

参数:
instream - 包含数据的 inputstream
encoding - 数据使用的编码
返回:
已使用 inputstream 中的数据初始化的 certpath
抛出:
certificateexception - 如果解码时出现《There》异常或者不支持所请求的编码
从以下版本开始:
1.4

generatecertpath

public final certpath generatecertpath(list<? extends certificate> certificates)      throws certificateexceptionjs随机数
生成一个 certpath 对象,并使用一个 certificatelist 对它进行初始化。

所提供的证书必须是该 certificatefactory 支持的类型。将从提供的 list 对象中复制出这些证书。

参数:
certificates - certificatelist
返回:
已使用所提供的证书列表初始化的 certpath
抛出:
certificateexception - 如果出现异常
从以下版本开始:
1.4

generatecertificates

public final collection<? extends certificate> generatecertificates(inputstream instream)           throws certificateexception
返回从给定输入流 instream 中读取的证书的集合视图(可能为空)。

为了利用此 certificatefactory 所支持的特殊证书格式,可将返回的集合视图中的每个元素的类型强制转换为相应的证书类。例如,如果此 certificatefactory 实现 x.509 证书,则可将返回集合中的元素的类型强制转换为 x509certificate 类。

在用于 x.509 证书的 certificatefactory 的情况中,instream 可能包含一个 der 编码的证书序列,这些证书使用 generatecertificate 所描述的格式。另外,instream网站地图 手机端 可能包含一个 pkcs#7 证书链。这是一个 pkcs#7 signeddata 对象,具有唯一《sole》认可 的有效字段。需要特别指出的是,签名和内容会被忽略。此格式允许《allow》同时下载多个证书。如果没有证书,则返回一个空集合。

注意,如果给定的输入流不支持 markreset,则此方法将使用整个输入流。

参数:
instream - 带有证书的输入流。
返回:
java.security.cert.certificate 对象的集合视图(可能为空),用输入流中的数据对该对象进行初始化。
抛出:
certificateexception - 如果发生《occasionally occurred》解析错误。

generatecrl

public final crl generatecrl(inputstream instream)     throws crlexception
生成一个证书撤消列表 (crl) 对象,并使用从输入流 instream 中读取的数据对它进行初始化。

为了利用此受 certificatefactory 支持的专门的 crl 格式,可将返回的 crl 对象的类型强制转换为相应的 crl 类。例如,如果此 certificatefactory 实现 x.509 crl,则可将返回的 crl 对象的类型强制转换为 x509crl 类。

注意,如果给定的输入流不支持 markreset,则此方法将使用整个输入流。否则,每次调用此方法都需要一个 crl,并且将输入流的读取位置定位在固有 crl 结尾标记后的下一个可用字节处。如果输入流中的数据不包含固有的 crl 结尾标记(不同于 eof),并且在解析该 crl 后有一个尾随数据,则将抛出 crlexception

参数:
instream - 带有 crl 数据的输入流。
返回:
已使用输入流中的数据初始化的 crl 对象。
抛出:
crlexception - 如果发生解析错误。

generatecrls

public final collection<? extends crl> generatecrls(inputstream instream)         throws crlexception
返回从给定输入流 instream 中读取的 crl 的集合视图(可能为空)。

为了利用受此 certificatefactory 支持的专门的 crl 格式,可将返回的集合视图中的每个元素的类型强制转换为相应的 crl 类。例如,如果此 certificatefactory 实现 x.509 crl,则可将返回集合中的元素类型强制转换为 x509crl 类。

在用于 x.509 crl 的 certificatefactory 情况中,instream 可能包含一个 der 编码的 crl 序列。另外,instream 可能包含一个 pkcs#7 crl 集合。这是一个 pkcs#7 signeddata 对象,具有唯一《sole》被 crl 的有效字段。需要特别指出的是,签名和内容会被忽略。此格式允许《allow》同时下载多个 crl。如果没有 crl,则返回一个空集合。

注意,如果给定的输入流不支持 markreset,则此方法将使用整个输入流。

参数:
instream - 带有 crl 的输入流。
返回:
java.security.cert.crl 对象的集合视图(可能为空),用输入流中的数据对该对象进行初始化。
抛出:
crlexception - 如果发生解析错误。

javatm platform
standard ed. 6

提交错误或意见《remark》
有关更多的 api 参考资料和开发《kāi fā》人员文档,请参阅 java se 开发《kāi fā》人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作《gōng zuò》代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策