|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.security.KeyStoreSpi
public abstract class KeyStoreSpi
此类为 KeyStore
类定义服务提供者接口 (SPI)。希望提供特定 keystore 类型的 keystore 实现的每个加密服务提供者必须实现此类中所有的抽象方法。
KeyStore
构造方法摘要 | |
---|---|
KeyStoreSpi()
|
方法摘要 | |
---|---|
abstract Enumeration<String> |
engineAliases()
列出此 keystore 的所有别名。 |
abstract boolean |
engineContainsAlias(String alias)
检查给定别名是否存在于此 keystore 中。 |
abstract void |
engineDeleteEntry(String alias)
删除由此 keystore 中给定的别名标识的项。 |
boolean |
engineEntryInstanceOf(String alias,
Class<? extends KeyStore.Entry> entryClass)
确定指定 alias 的 keystore Entry 是否是指定 entryClass 的实例或子类。 |
abstract Certificate |
engineGetCertificate(String alias)
返回与给定别名关联的证书。 |
abstract String |
engineGetCertificateAlias(Certificate cert)
返回其证书和给定证书匹配的第一个 keystore 项的名称(别名)。 |
abstract Certificate[] |
engineGetCertificateChain(String alias)
返回与给定别名关联的证书链。 |
abstract Date |
engineGetCreationDate(String alias)
返回该别名标识的项的创建日期。 |
KeyStore.Entry |
engineGetEntry(String alias,
KeyStore.ProtectionParameter protParam)
使用指定保护参数获取指定别名的 KeyStore.Entry 。 |
abstract Key |
engineGetKey(String alias,
char[] password)
返回与给定别名关联的密钥,使用给定密码恢复它。 |
abstract boolean |
engineIsCertificateEntry(String alias)
如果给定别名标识的项是通过调用 setCertificateEntry 或者调用使用 TrustedCertificateEntry 作为参数的 setEntry 来创建的,则返回 true。 |
abstract boolean |
engineIsKeyEntry(String alias)
如果给定别名标识的项是通过调用 setKeyEntry 或者调用使用 PrivateKeyEntry 或 SecretKeyEntry 作为参数的 setEntry 创建的,则返回 true。 |
abstract void |
engineLoad(InputStream stream,
char[] password)
从给定的输入流中加载此 KeyStore。 |
void |
engineLoad(KeyStore.LoadStoreParameter param)
使用给定的 KeyStore.LoadStoreParameter 加载该 keystore。 |
abstract void |
engineSetCertificateEntry(String alias,
Certificate cert)
将给定证书分配给给定别名。 |
void |
engineSetEntry(String alias,
KeyStore.Entry entry,
KeyStore.ProtectionParameter protParam)
用指定别名保存 KeyStore.Entry 。 |
abstract void |
engineSetKeyEntry(String alias,
byte[] key,
Certificate[] chain)
将给定密钥(已经被保护)分配给给定别名。 |
abstract void |
engineSetKeyEntry(String alias,
Key key,
char[] password,
Certificate[] chain)
将给定的密钥分配给给定的别名,用给定的密码保护它。 |
abstract int |
engineSize()
获取此 keystore 中项的数目。 |
void |
engineStore(KeyStore.LoadStoreParameter param)
使用给定的 KeyStore.LoadStoreParmeter 存储此 keystore。 |
abstract void |
engineStore(OutputStream stream,
char[] password)
将此 keystore 存储到给定输出流中,并用给定的密码保护其完整性。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public KeyStoreSpi()
方法详细信息 |
---|
public abstract Key engineGetKey(String alias, char[] password) throws NoSuchAlgorithmException, UnrecoverableKeyException
setKeyEntry
或者调用使用 PrivateKeyEntry
或 SecretKeyEntry
作为参数的 setEntry
将密钥与别名关联。
alias
- 别名password
- 恢复密钥所用的密码
NoSuchAlgorithmException
- 如果不能找到恢复密钥的算法
UnrecoverableKeyException
- 如果不能恢复密钥(例如,给定的密码错误)。public abstract Certificate[] engineGetCertificateChain(String alias)
setKeyEntry
,或者调用使用 PrivateKeyEntry
做参数的 setEntry
将密钥与别名关联。
alias
- 别名
public abstract Certificate engineGetCertificate(String alias)
如果给定的别名标识通过调用 setCertificateEntry
创建的项,或标识通过调用使用 TrustedCertificateEntry
参数的 setEntry
创建的项,那么返回包含在该项中的可信证书。
如果给定的别名标识通过调用 setKeyEntry
创建的项,或标识通过调用使用 PrivateKeyEntry
作为参数的 setEntry
创建的项,那么返回该项中证书链(如果存在证书链)的第一个元素。
alias
- 别名
public abstract Date engineGetCreationDate(String alias)
alias
- 别名
public abstract void engineSetKeyEntry(String alias, Key key, char[] password, Certificate[] chain) throws KeyStoreException
如果给定密钥的类型为 java.security.PrivateKey
类型,则它必须附带证明相应公钥的证书链。
如果给定的别名已经存在,则与别名关联的 keystore 信息被给定的密钥(可能和证书链)重写。
alias
- 别名key
- 要与别名关联的密钥password
- 保护密钥的密码chain
- 相应公钥的证书链(只在给定密钥的类型为 java.security.PrivateKey
时需要)。
KeyStoreException
- 如果不能保护给定密钥,或此操作由于某些其他原因而失败public abstract void engineSetKeyEntry(String alias, byte[] key, Certificate[] chain) throws KeyStoreException
如果被保护密钥的类型为 java.security.PrivateKey
,则它必须附带证明相应公钥的证书链。
如果给定的别名已经存在,则与别名关联的 keystore 信息被给定的密钥(可能和证书链)重写。
alias
- 别名key
- 要与别名关联的密钥(以受保护格式)chain
- 相应公钥的证书链(只在受保护密钥的类型为 java.security.PrivateKey
时有用)。
KeyStoreException
- 如果此操作失败。public abstract void engineSetCertificateEntry(String alias, Certificate cert) throws KeyStoreException
如果给定的别名标识通过调用 setCertificateEntry
创建的现有项,或者标识通过调用使用 TrustedCertificateEntry
作为参数的 setEntry
创建的现有项,那么现有项中的可信证书被给定证书重写。
alias
- 别名cert
- 证书
KeyStoreException
- 如果给定别名已存在且不标识一个包含可信任证书的项,或此操作由于其他某些原因而失败。public abstract void engineDeleteEntry(String alias) throws KeyStoreException
alias
- 别名
KeyStoreException
- 如果该项不能被移除public abstract Enumeration<String> engineAliases()
public abstract boolean engineContainsAlias(String alias)
alias
- 别名
public abstract int engineSize()
public abstract boolean engineIsKeyEntry(String alias)
setKeyEntry
或者调用使用 PrivateKeyEntry
或 SecretKeyEntry
作为参数的 setEntry
创建的,则返回 true。
alias
- 要检查的 keystore 项的别名
public abstract boolean engineIsCertificateEntry(String alias)
setCertificateEntry
或者调用使用 TrustedCertificateEntry
作为参数的 setEntry
来创建的,则返回 true。
alias
- 要检查的 keystore 项的别名
public abstract String engineGetCertificateAlias(Certificate cert)
此方法试图将给定证书与每一个 keystore 项相匹配。如果将被考虑的项是通过调用 setCertificateEntry
或者调用使用 TrustedCertificateEntry
作为参数的 setEntry
创建的,则将给定证书与该项的证书进行比较。
如果将被考虑的项是通过调用 setKeyEntry
或者调用使用 PrivateKeyEntry
作为参数的 setEntry
创建的,则将给定证书与该项证书链的第一个元素进行比较。
cert
- 要匹配的证书
public abstract void engineStore(OutputStream stream, char[] password) throws IOException, NoSuchAlgorithmException, CertificateException
stream
- 要写入此 keystore 的输出流。password
- 生成 keystore 完整性检验的密码
IOException
- 如果存在数据的 I/O 问题
NoSuchAlgorithmException
- 如果不能找到恰当的数据完整性算法
CertificateException
- 如果包含在 keystore 数据中的任何证书不能被存储public void engineStore(KeyStore.LoadStoreParameter param) throws IOException, NoSuchAlgorithmException, CertificateException
KeyStore.LoadStoreParmeter
存储此 keystore。
param
- 指出存储 keystore 的方式的 KeyStore.LoadStoreParmeter
,可以为 null
IllegalArgumentException
- 如果给定的 KeyStore.LoadStoreParmeter
输入无法识别
IOException
- 如果存在数据 I/O 问题
NoSuchAlgorithmException
- 如果不能找到恰当的数据完整性算法
CertificateException
- 如果 keystore 数据中的任何证书不能被存储public abstract void engineLoad(InputStream stream, char[] password) throws IOException, NoSuchAlgorithmException, CertificateException
可能给出密码来解锁 keystore(例如驻留在硬件标记设备上的 keystore)或检验 keystore 数据的完整性。如果没有给出用于完整性检验的密码,那么就不会执行完整性检验。
stream
- 从其加载 keystore 的输入流,或 null
password
- 用来检验 keystore 完整性的密码,用来解锁 keystore 的密码,或 null
IOException
- 如果存在 keystore 数据的 I/O 或格式问题,如果需要密码却没有给出,或者给出的密码错误。如果错误是由于密码错误,则 IOException
的 cause
应该是一个 UnrecoverableKeyException
NoSuchAlgorithmException
- 如果不能找到用来检验 keystore 完整性的算法
CertificateException
- 如果不能加载 keystore 中的任何证书public void engineLoad(KeyStore.LoadStoreParameter param) throws IOException, NoSuchAlgorithmException, CertificateException
KeyStore.LoadStoreParameter
加载该 keystore。
注意,如果此 KeyStore 已经被加载,则它将再次从给定参数中被初始化和加载。
param
- 指出加载 keystore 的方式的 KeyStore.LoadStoreParameter
,可以为 null
IllegalArgumentException
- 如果给定的 KeyStore.LoadStoreParameter
输入无法识别
IOException
- 如果存在 keystore 数据的 I/O 或格式问题。如果错误是由于 ProtectionParameter
不正确(如密码错误),则 IOException
的 cause
应该是一个 UnrecoverableKeyException
NoSuchAlgorithmException
- 如果不能找到用来检验 keystore 完整性的算法
CertificateException
- 如果不能加载 keystore 中的任何证书public KeyStore.Entry engineGetEntry(String alias, KeyStore.ProtectionParameter protParam) throws KeyStoreException, NoSuchAlgorithmException, UnrecoverableEntryException
KeyStore.Entry
。
alias
- 获取此别名的 KeyStore.Entry
protParam
- 用来保护 Entry
的 ProtectionParameter
,可以为 null
KeyStore.Entry
;如果不存在这样的项,则返回 null
KeyStoreException
- 如果操作失败
NoSuchAlgorithmException
- 如果不能找到恢复项的算法
UnrecoverableEntryException
- 如果指定的 protParam
不足或无效
UnrecoverableKeyException
- 如果该项是 PrivateKeyEntry
或 SecretKeyEntry
并且指定的 protParam
不包含恢复密钥所需的信息(如密码错误)public void engineSetEntry(String alias, KeyStore.Entry entry, KeyStore.ProtectionParameter protParam) throws KeyStoreException
KeyStore.Entry
。指定的保护参数用来保护 Entry
。
如果指定别名的项已经存在,它将被重写。
alias
- 以此别名保存 KeyStore.Entry
entry
- 要保存的 Entry
protParam
- 用来保护 Entry
的 ProtectionParameter
,可以为 null
KeyStoreException
- 如果此操作失败public boolean engineEntryInstanceOf(String alias, Class<? extends KeyStore.Entry> entryClass)
alias
的 keystore Entry
是否是指定 entryClass
的实例或子类。
alias
- 别名entryClass
- 项的类
alias
的 keystore Entry
是指定 entryClass
的实例或子类,则返回 true;否则返回 false。
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。