Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class KeyStoreSpi extends Object
KeyStore
class. Все абстрактные методы в этом class должны быть реализованы каждым провайдером криптографических служб, который хочет предоставить реализацию 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)
Определяет если keystore
Entry для указанного alias экземпляр или подкласс указанного entryClass . |
abstract Certificate |
engineGetCertificate(String alias)
Возвращает сертификат, связанный с данным псевдонимом.
|
abstract String |
engineGetCertificateAlias(Certificate cert)
Возвращает (псевдоним) имя первой keystore записи, сертификат которой соответствует данный сертификат.
|
abstract Certificate[] |
engineGetCertificateChain(String alias)
Возвращает цепочку сертификата, связанную с данным псевдонимом.
|
abstract Date |
engineGetCreationDate(String alias)
Возвращает дату создания записи, идентифицированной данным псевдонимом.
|
KeyStore. Запись |
engineGetEntry(String alias, KeyStore.ProtectionParameter protParam)
Получает a
KeyStore.Entry для указанного псевдонима с указанным параметром защиты. |
abstract Key |
engineGetKey(String alias, char[] password)
Возвращает ключ, связанный с данным псевдонимом, используя данный пароль, чтобы восстановить это.
|
abstract boolean |
engineIsCertificateEntry(String alias)
Возвращает true, если запись, идентифицированная данным псевдонимом, создавалась звонком
setCertificateEntry , или создаваемый звонком setEntry с a TrustedCertificateEntry . |
abstract boolean |
engineIsKeyEntry(String alias)
Возвращает true, если запись, идентифицированная данным псевдонимом, создавалась звонком
setKeyEntry , или создаваемый звонком setEntry с a PrivateKeyEntry или a SecretKeyEntry . |
abstract void |
engineLoad(InputStream stream, char[] password)
Загружает keystore из данного входного потока.
|
void |
engineLoad(KeyStore.LoadStoreParameter param)
Загружает keystore использование данного
KeyStore.LoadStoreParameter . |
abstract void |
engineSetCertificateEntry(String alias, Certificate cert)
Присваивает данный сертификат данному псевдониму.
|
void |
engineSetEntry(String alias, KeyStore.Entry entry, KeyStore.ProtectionParameter protParam)
Сохраняет a
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 использование данного
KeyStore.LoadStoreParmeter . |
abstract void |
engineStore(OutputStream stream, char[] password)
Хранилища этот keystore к данному потоку вывода, и защищают его целостность с данным паролем.
|
public abstract Key engineGetKey(String alias, char[] password) throws NoSuchAlgorithmException, UnrecoverableKeyException
setKeyEntry
, или звонком setEntry
с a PrivateKeyEntry
или SecretKeyEntry
.alias
- имя псевдонимаpassword
- пароль для того, чтобы восстановить ключNoSuchAlgorithmException
- если алгоритм для того, чтобы восстановить ключ не может быть найденUnrecoverableKeyException
- если ключ не может быть восстановлен (например, данный пароль является неправильным).public abstract Certificate[] engineGetCertificateChain(String alias)
setKeyEntry
, или звонком setEntry
с a PrivateKeyEntry
.alias
- имя псевдонимаpublic abstract Certificate engineGetCertificate(String alias)
Если данное имя псевдонима идентифицирует запись, создаваемую звонком setCertificateEntry
, или создаваемый звонком setEntry
с a TrustedCertificateEntry
, тогда доверяемый сертификат, содержавшийся в той записи, возвращается.
Если данное имя псевдонима идентифицирует запись, создаваемую звонком setKeyEntry
, или создаваемый звонком setEntry
с a PrivateKeyEntry
, тогда первый элемент цепочки сертификата в той записи (если цепочка существует) возвращается.
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
, или создаваемый звонком setEntry
с a TrustedCertificateEntry
, доверяемый сертификат в существующей записи переопределяется данным сертификатом.
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
, или создаваемый звонком setEntry
с a PrivateKeyEntry
или a SecretKeyEntry
.alias
- псевдоним для keystore записи, которая будет проверенаpublic abstract boolean engineIsCertificateEntry(String alias)
setCertificateEntry
, или создаваемый звонком setEntry
с a TrustedCertificateEntry
.alias
- псевдоним для keystore записи, которая будет проверенаpublic abstract String engineGetCertificateAlias(Certificate cert)
Этот метод пытается соответствовать данный сертификат с каждой keystore записью. Если запись, которую рассматривают, создавалась звонком setCertificateEntry
, или создаваемый звонком setEntry
с a TrustedCertificateEntry
, тогда данный сертификат по сравнению с сертификатом той записи.
Если запись, которую рассматривают, создавалась звонком setKeyEntry
, или создаваемый звонком setEntry
с a PrivateKeyEntry
, тогда данный сертификат по сравнению с первым элементом цепочки сертификата той записи.
cert
- сертификат, чтобы соответствовать с.public abstract void engineStore(OutputStream stream, char[] password) throws IOException, NoSuchAlgorithmException, CertificateException
stream
- поток вывода, которому пишется этот keystore.password
- пароль, чтобы генерировать keystore проверку целостностиIOException
- если была проблема ввода-вывода с даннымиNoSuchAlgorithmException
- если соответствующий алгоритм целостности данных не мог бы быть найденCertificateException
- если какой-либо из сертификатов, включенных в keystore данные, не мог бы быть сохраненpublic void engineStore(KeyStore.LoadStoreParameter param) throws IOException, NoSuchAlgorithmException, CertificateException
KeyStore.LoadStoreParmeter
.param
- KeyStore.LoadStoreParmeter
это определяет, как сохранить keystore, который может быть null
IllegalArgumentException
- если данный KeyStore.LoadStoreParmeter
ввод не распознаетсяIOException
- если была проблема ввода-вывода с данными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 данными, если пароль требуется, но не дается, или если данный пароль был неправильным. Если ошибка происходит из-за неправильного пароля, cause
из IOException
должен быть UnrecoverableKeyException
NoSuchAlgorithmException
- если алгоритм, используемый, чтобы проверить целостность keystore, не может быть найденCertificateException
- если какой-либо из сертификатов в keystore не мог бы быть загруженpublic void engineLoad(KeyStore.LoadStoreParameter param) throws IOException, NoSuchAlgorithmException, CertificateException
KeyStore.LoadStoreParameter
. Отметьте, что, если этот KeyStore был уже загружен, он повторно инициализируется и загружается снова из данного параметра.
param
- KeyStore.LoadStoreParameter
это определяет, как загрузить keystore, который может быть null
IllegalArgumentException
- если данный KeyStore.LoadStoreParameter
ввод не распознаетсяIOException
- если есть проблема ввода-вывода или формата с keystore данными. Если ошибка происходит из-за неправильного ProtectionParameter
(например, неправильный пароль) cause
из IOException
должен быть UnrecoverableKeyException
NoSuchAlgorithmException
- если алгоритм, используемый, чтобы проверить целостность keystore, не может быть найденCertificateException
- если какой-либо из сертификатов в keystore не мог бы быть загруженpublic KeyStore.Entry engineGetEntry(String alias, KeyStore.ProtectionParameter protParam) throws KeyStoreException, NoSuchAlgorithmException, UnrecoverableEntryException
KeyStore.Entry
для указанного псевдонима с указанным параметром защиты.alias
- доберитесь KeyStore.Entry
для этого псевдонимаprotParam
- ProtectionParameter
используемый, чтобы защитить Entry
, который может быть null
KeyStore.Entry
для указанного псевдонима, или null
если нет такой записиKeyStoreException
- если работа перестала работатьNoSuchAlgorithmException
- если алгоритм для того, чтобы восстановить запись не может быть найденUnrecoverableEntryException
- если указанное protParam
были недостаточны или недопустимыUnrecoverableKeyException
- если запись является a 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
- ProtectionParameter
используемый, чтобы защитить Entry
, который может быть null
KeyStoreException
- если эта работа перестала работатьpublic boolean engineEntryInstanceOf(String alias, Class<? extends KeyStore.Entry> entryClass)
Entry
для указанного alias
экземпляр или подкласс указанного entryClass
.alias
- имя псевдонимаentryClass
- запись classEntry
для указанного alias
экземпляр или подкласс указанного entryClass
, ложь иначе
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92