接口 java.security.Certificate
- public interface Certificate
这是一个管理身份验证的抽象方法接口。 一个身份验证是由一个主体作出的保证,该保证确认一个公共密钥是另一个主体的密钥。 (一个主体表示一个实体,例如个体用户或者一个组)。
具体说,该接口试图成为那些具有不同格式却具有重要共同应用的结构的公共抽象。例如,不同类型的验证字,如 X.509 验证字和 PGP 验证字,共享一般的验证字运算(编码和解码验证字的需要)和某些类型的信息,如公共密钥,密钥所属的主体,验证者和一个确认公共密钥是指定主体的密钥的验证。即使 X.509 验证字和 PGP 验证的格式、附加的类型和存储的信息量不同,它们的实现都可使用 Certificate 接口。
要点:
该接口在给共享某些公共应用程序的类进行编目和分组方面是极为有用的。它不具有任何属于它自己的语义。 具体地说,一个 Certificate 对象从不作象绑定
validity 这样的声明。实现该工具接口来验证验证字并使它满足自己的要求是应用程序自己的事。
方法索引
- decode(InputStream)
- 从输入流解码验证字。
- encode(OutputStream)
- 将验证字编码为可被方法
decode 解码的格式的输出流。 - getFormat()
- 返回编码格式的名称。
- getGuarantor()
-
返回验证字的验证者,也就是一个主体,它作出与验证字相关的公共密钥确实是与验证字相关的主体验证。
- getPrincipal()
- 返回由验证者验证的实体-密钥对中的主体。
- getPublicKey()
- 返回由验证者验证的实体-密钥对中的关键字。
- toString(boolean)
- 返回验证字内容的字符串表示。
方法
getGuarantor
public abstract Principal getGuarantor()
- 返回验证字的验证者,也即一个主体,它作出与验证字相关的公共密钥确实是与验证字相关的主体的验证。对于 X.509 验证字来说,验证者通常为一
Certificate Authority (比如 United States Postal Service 或
Verisign, Inc.)。
- 返回:
- 验证到绑定实体-密钥对的验证者。
getPrincipal
public abstract Principal getPrincipal()
- 返回由验证者验证的实体-密钥对中的主体。
- 返回:
- 绑定到该验证字的主体。
getPublicKey
public abstract PublicKey getPublicKey()
- 返回由验证者验证的实体-密钥对中的关键字。
- 返回:
- 由验证字验证的属于一个特定主体的公共密钥。
encode
public abstract void encode(OutputStream stream) throws KeyException, IOException
- 以可被方法
decode 解码的格式将验证字编码为输出流。
- 参数:
- stream - 输出流,包含验证字的编码。
- 抛出: KeyException
- 如果验证字没有正确地赋初值,或者没有数据,等等。
- 抛出:
IOException
- 如果试图将编码后的验证字输出到输出流时发生流异常。
- 参见:
- decode, getFormat
decode
public abstract void decode(InputStream stream) throws KeyException, IOException
- 从输入流解码验证字。 格式应该是
getFormat 返回的格式和 encode 产生的格式。
- 参数:
- stream - 从中获取解码数据的输入流。
- 抛出: KeyException
- 如果验证字没有正确地赋初值,或者没有数据,等等。
- 抛出:
IOException
- 如果试图从一输入流输入编码的验证字时发生一异常。
- 参见:
- encode, getFormat
getFormat
public abstract String getFormat()
- 返回编码格式的名称。 它作为查找适当语法分析程序的提示使用。它可能是 “X.509”, “PGP”等等。它是
encode
和 decode 方法产生并被理解的格式。
- 返回:
- 编码格式的名称。
toString
public abstract String toString(boolean detailed)
- 返回验证字内容的字符串表示。
- 参数:
- detailed - 是否给出有关验证字的详细信息。