compact1, compact2, compact3

java.security

Class KeyStoreSpi

java.lang.Object

java.security.KeyStoreSpi

public abstract class KeyStoreSpi
extends Object

这个类定义了服务提供者接口（ SPI）为 KeyStore类。这个类中的所有抽象方法必须由每个加密服务提供者谁愿意为一个特定的密钥类型提供密钥库的实施执行。

从以下版本开始：

一点二

另请参见：

KeyStore

构造方法摘要

构造方法

Constructor and Description
KeyStoreSpi()

方法摘要

Modifier and Type	Method and Description
abstract Enumeration<String>	engineAliases() 列出所有这个密钥库的别名。
abstract boolean	engineContainsAlias(String alias) 检查给出的别名存在这个密钥库。
abstract void	engineDeleteEntry(String alias) 删除条目由给定的别名从密钥库确定。
boolean	engineEntryInstanceOf(String alias, 类<? extends KeyStore.Entry> entryClass) 确定是否为指定的 alias keystore Entry是指定 entryClass实例或类。
abstract Certificate	engineGetCertificate(String alias) 返回与给定别名关联的证书。
abstract String	engineGetCertificateAlias(Certificate cert) 返回（化名）名称的第一个条目匹配给定的密钥证书证书。
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) 返回true如果条目被给定的别名是由一个叫 setCertificateEntry创建，或通过调用创建一个 TrustedCertificateEntry setEntry。
abstract boolean	engineIsKeyEntry(String alias) 返回true如果条目被给定的别名是由一个叫 setKeyEntry创建，或通过调用创建一 PrivateKeyEntry或 SecretKeyEntry setEntry。
abstract void	engineLoad(InputStream stream, char[] password) 载荷从给定的输入流密钥库。
void	engineLoad(KeyStore.LoadStoreParameter param) 负载使用给定的 KeyStore.LoadStoreParameter密钥库。
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() 这个密钥库检索条目数量。
void	engineStore(KeyStore.LoadStoreParameter param) 商店这个密钥使用给定的 KeyStore.LoadStoreParmeter。
abstract void	engineStore(OutputStream stream, char[] password) 商店这个密钥库到给定的输出流，其完整性与给定的密码保护。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

KeyStoreSpi

public KeyStoreSpi()

方法详细信息

engineGetKey

public abstract Key engineGetKey(String alias,
                                 char[] password)
                          throws NoSuchAlgorithmException,
                                 UnrecoverableKeyException

返回与给定别名关联的密钥，使用给定的密码来恢复它。关键要一直用电话 setKeyEntry别名关联，或通过调用一个 PrivateKeyEntry或 SecretKeyEntry setEntry。

参数

alias -别名

password -恢复密钥的密码

结果

所请求的键，或如果给定的别名不存在或不确定密钥相关的条目，或为空。

异常

NoSuchAlgorithmException如果恢复键不能发现算法

UnrecoverableKeyException -如果钥匙无法恢复（例如，给定的密码是错误的）。

engineGetCertificateChain

public abstract Certificate[] engineGetCertificateChain(String alias)

返回与给定别名关联的证书链。证书链必须已经通过调用 setKeyEntry别名关联，或通过调用一个 PrivateKeyEntry setEntry。

参数

alias -别名

结果

证书链（如果给定的别名不存在或不包含证书链，将使用用户的证书或根证书颁发机构）或“最后一次”命令

engineGetCertificate

public abstract Certificate engineGetCertificate(String alias)

返回与给定别名关联的证书。

如果给定的别名标识被调用的setCertificateEntry创建了一个条目，或通过调用创建setEntry与TrustedCertificateEntry，那么可信证书包含在输入返回。

如果给定的别名标识被调用的setKeyEntry创建了一个条目，或通过调用创建setEntry与PrivateKeyEntry，然后在输入证书链的第一个元素（如果存在返回链）。

参数

alias -别名

结果

该证书，或无效，如果给定的别名不存在或不包含证书。

engineGetCreationDate

public abstract Date engineGetCreationDate(String alias)

返回给定别名标识的条目的创建日期。

参数

alias -别名

结果

此条目的创建日期，如果给定的别名不存在，或为空

engineSetKeyEntry

public abstract void engineSetKeyEntry(String alias,
                                       Key key,
                                       char[] password,
                                       Certificate[] chain)
                                throws KeyStoreException

将给定的密钥分配给给定的别名，用给定的密码保护它。

如果给定的键的类型是java.security.PrivateKey，它必须伴随着相应的公共密钥证书链认证。

如果给定的别名已经存在，与它相关的密钥信息是由给定的键重写（可能是证书链）。

参数

alias -别名

key -与别名关联的关键

password -保护密钥的密码

chain -相应的公钥证书链（如果给定的关键是型 java.security.PrivateKey只需要）。

异常

KeyStoreException -如果给定的键不能保护，或操作失败的其他原因

engineSetKeyEntry

public abstract void engineSetKeyEntry(String alias,
                                       byte[] key,
                                       Certificate[] chain)
                                throws KeyStoreException

指定给定的键（已被保护）给给定的别名。

如果受保护的关键是java.security.PrivateKey型，它必须伴随着相应的公共密钥证书链认证。

如果给定的别名已经存在，与它相关的密钥信息是由给定的键重写（可能是证书链）。

参数

alias -别名

key的关键（在保护格式）是与别名关联

chain -相应的公钥证书链（唯一有用的如果受保护的关键是型 java.security.PrivateKey）。

异常

KeyStoreException -如果操作失败。

engineSetCertificateEntry

public abstract void engineSetCertificateEntry(String alias,
                                               Certificate cert)
                                        throws KeyStoreException

将给定的证书分配给给定的别名。

如果给定的别名识别现有项目通过调用setCertificateEntry创建，或通过调用创建一TrustedCertificateEntry setEntry，可信证书在现有的条目是由给定的证书中重写。

参数

alias -别名

cert -证书

异常

KeyStoreException -如果给定的别名已经存在不确定项包含一个可信的证书，或操作失败的其他原因。

engineDeleteEntry

public abstract void engineDeleteEntry(String alias)
                                throws KeyStoreException

删除条目由给定的别名从密钥库确定。

参数

alias -别名

异常

KeyStoreException如果项目不能删除。

engineAliases

public abstract Enumeration<String> engineAliases()

列出所有这个密钥库的别名。

结果

别名的枚举

engineContainsAlias

public abstract boolean engineContainsAlias(String alias)

检查给出的别名存在这个密钥库。

参数

alias -别名

结果

如果别名存在，否则为假

engineSize

public abstract int engineSize()

这个密钥库检索条目数量。

结果

这个密钥库条目数量

engineIsKeyEntry

public abstract boolean engineIsKeyEntry(String alias)

返回true如果条目被给定的别名是由一个叫 setKeyEntry创建，或通过调用创建一 PrivateKeyEntry或 SecretKeyEntry setEntry。

参数

alias -密钥库进入被检查的别名

结果

如果给定的别名所标识的条目是一个关键相关的，则为。

engineIsCertificateEntry

public abstract boolean engineIsCertificateEntry(String alias)

返回true如果条目被给定的别名是由一个叫 setCertificateEntry创建，或通过调用创建一 TrustedCertificateEntry setEntry。

参数

alias -密钥库进入被检查的别名

结果

如果给定的别名所标识的条目包含一个可信证书，则为。

engineGetCertificateAlias

public abstract String engineGetCertificateAlias(Certificate cert)

返回（化名）名称的第一个条目匹配给定的密钥证书证书。

匹配给定的每个密钥入境证此方法的尝试。如果条目被认为是由一个叫setCertificateEntry创建，或通过调用创建一TrustedCertificateEntry setEntry，然后给定的证书相比，入门的证书。

如果条目被认为是由一个叫setKeyEntry创建，或通过调用创建一个PrivateKeyEntry setEntry，然后给定的证书相比，入门的证书链的第一个元素。

参数

cert -证书匹配。

结果

与之匹配的证书的第一项的别名，或空如果没有这样的条目存在这个密钥库。

engineStore

public abstract void engineStore(OutputStream stream,
                                 char[] password)
                          throws IOException,
                                 NoSuchAlgorithmException,
                                 CertificateException

商店这个密钥库到给定的输出流，其完整性与给定的密码保护。

参数

stream -输出流，这个密钥写入。

password -生成密钥完整性检查密码

异常

IOException -如果有一个I/O问题的数据

NoSuchAlgorithmException如果适当的数据完整性算法无法发现

CertificateException -如果证书包含在密钥库的数据无法保存

engineStore

public void engineStore(KeyStore.LoadStoreParameter param)
                 throws IOException,
                        NoSuchAlgorithmException,
                        CertificateException

商店这个密钥使用给定的 KeyStore.LoadStoreParmeter。

参数

param - KeyStore.LoadStoreParmeter指定如何存储密钥库，这可能是 null

异常

IllegalArgumentException -如果给定的 KeyStore.LoadStoreParmeter输入不认可

IOException -如果有一个I/O问题的数据

NoSuchAlgorithmException如果适当的数据完整性算法无法发现

CertificateException -如果证书包含在密钥库的数据无法保存

从以下版本开始：

一点五

engineLoad

public abstract void engineLoad(InputStream stream,
                                char[] password)
                         throws IOException,
                                NoSuchAlgorithmException,
                                CertificateException

载荷从给定的输入流密钥库。

密码可以解锁密钥库（如密钥库驻留在硬件令牌设备），或检查密钥库数据的完整性。如果没有给出完整性检查的密码，则不执行完整性检查。

参数

stream -从密钥库中加载输入流，或 null

password用于检查密钥库完整的密码，该密码用于解锁密钥库，或 null

异常

IOException -如果有一个I / O或密钥库的数据格式的问题，如果需要密码但没有给出，如果给定的密码是不正确的。如果错误是由于一个错误的密码，该 IOException的 cause应该是一个 UnrecoverableKeyException

NoSuchAlgorithmException如果用来检查密钥不能完整的被发现的算法

CertificateException -如果在密钥的证书无法加载

engineLoad

public void engineLoad(KeyStore.LoadStoreParameter param)
                throws IOException,
                       NoSuchAlgorithmException,
                       CertificateException

负载使用给定的 KeyStore.LoadStoreParameter密钥库。

注意，如果KeyStore已经被加载，它是重新初始化并重新加载，从给定的参数。

参数

param - KeyStore.LoadStoreParameter指定如何加载密钥库，这可能是 null

异常

IllegalArgumentException -如果给定的 KeyStore.LoadStoreParameter输入不认可

IOException -如果有一个I / O或密钥库的数据格式问题。如果错误是由于不正确的 ProtectionParameter（如密码错误）的 IOException的 cause应该是一个 UnrecoverableKeyException

NoSuchAlgorithmException如果用来检查密钥不能完整的被发现的算法

CertificateException -如果在密钥的证书无法加载

从以下版本开始：

一点五

engineGetEntry

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不包含恢复所需的关键信息（如密码错误）

从以下版本开始：

一点五

engineSetEntry

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 -如果操作失败

从以下版本开始：

一点五

engineEntryInstanceOf

public boolean engineEntryInstanceOf(String alias,
                                     类<? extends KeyStore.Entry> entryClass)

确定是否为指定的 alias keystore Entry是指定 entryClass实例或类。

参数

alias -别名

entryClass -入门级

结果

如果指定的 alias keystore Entry是指定 entryClass实例或类真，否则为假

从以下版本开始：

一点五