JavaTM 2 Platform
Standard Ed. 5.0

java.security
接口 Certificate


已过时。 在 Java 2 平台中创建了新的证书处理包。此 Certificate 接口已完全废弃,其仍存在是为了能平稳地过渡到新包。

@Deprecated
public interface Certificate

这是一个用于管理多种身份证书的抽象方法的接口。身份证书是某个主体的保证,保证某个公钥是另一个主体的公钥。(主体表示实体,如个别用户、团体或公司。)

需要特别指出的是,此接口应为具有不同格式但重要的公共用途的那些构造的公共抽象。例如,不同的证书类型(如 X.509 证书和 PGP 证书)共享通用的证书功能(编码和解码证书所需要的)和某些类型的信息,如公钥、将公钥作为密钥的主体和保证公钥是指定主体的密钥的 guarantor。因此,X.509 证书的实现和 PGP 证书的实现都可以利用 Certificate 接口,尽管它们的格式和附加类型以及存储的信息量各不相同。

重要主意事项:此接口对编目和分组共享某些公共用途的对象很有用。它本身没有任何语义。需要特别指出的是,Certificate 对象不作出任何关于绑定有效性 的声明。由实现此接口的应用程序来负责验证证书并赋予其本身有效性。

另请参见:
Certificate

方法摘要
 void decode(InputStream stream)
          已过时。 从输入流解码证书。
 void encode(OutputStream stream)
          已过时。 以 decode 方法可以解码的格式将证书编码到输出流。
 String getFormat()
          已过时。 返回编码格式的名称。
 Principal getGuarantor()
          已过时。 返回证书的保证人,即某个主体,其保证与此证书关联的公钥是与此证书关联的主体的公钥。
 Principal getPrincipal()
          已过时。 返回保证人所保证的主体密钥对的主体。
 PublicKey getPublicKey()
          已过时。 返回保证人所保证的主体密钥对的密钥。
 String toString(boolean detailed)
          已过时。 返回表示证书内容的字符串。
 

方法详细信息

getGuarantor

Principal getGuarantor()
已过时。 
返回证书的保证人,即某个主体,其保证与此证书关联的公钥是与此证书关联的主体的公钥。对于 X.509 证书,保证人通常为 Certificate Authority(如美国邮政管理局或 Verisign 等)。

返回:
保证主体密钥绑定的保证人。

getPrincipal

Principal getPrincipal()
已过时。 
返回保证人所保证的主体密钥对的主体。

返回:
此证书绑定的主体。

getPublicKey

PublicKey getPublicKey()
已过时。 
返回保证人所保证的主体密钥对的密钥。

返回:
此证书证明的属于特定主体的公钥。

encode

void encode(OutputStream stream)
            throws KeyException,
                   IOException
已过时。 
decode 方法可以解码的格式将证书编码到输出流。

参数:
stream - 要将证书编码到的输出流。
抛出:
KeyException - 如果没有正确初始化证书,或者丢失数据,等等。
IOException - 如果在试图将已编码的证书输出到输出流中时发生流异常。
另请参见:
decode(java.io.InputStream), getFormat()

decode

void decode(InputStream stream)
            throws KeyException,
                   IOException
已过时。 
从输入流解码证书。格式应为 getFormat 所返回的格式并且由 encode 产生。

参数:
stream - 从中获取要解码的数据的输入流。
抛出:
KeyException - 如果没有正确初始化证书,或者丢失数据,等等。
IOException - 如果在试图从输入流输入已编码的证书时发生异常。
另请参见:
encode(java.io.OutputStream), getFormat()

getFormat

String getFormat()
已过时。 
返回编码格式的名称。该名称用作查找适当解析器的提示。它可以为 "X.509"、"PGP" 等。这是由 encodedecode 方法产生被可以被它们理解的格式。

返回:
编码格式的名称。

toString

String toString(boolean detailed)
已过时。 
返回表示证书内容的字符串。

参数:
detailed - 是否给出关于证书的详细信息
返回:
表示证书内容的字符串

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策