javax.crypto

Класс SecretKeyFactory

java.lang. Объект

javax.crypto. SecretKeyFactory

public class SecretKeyFactory
extends Object

Этот class представляет фабрику для секретных ключей.

Ключевые фабрики используются, чтобы преобразовать ключи (непрозрачные криптографические ключи типа Key) в ключевые спецификации (прозрачные представления базового ключевого материала), и наоборот. Фабрики секретного ключа работают только на секретных (симметричных) ключах.

Ключевые фабрики двунаправлены, то есть, они позволяют создавать непрозрачный ключевой объект из данной ключевой спецификации (ключевой материал), или получать базовый ключевой материал ключевого объекта в подходящем формате.

Разработчики приложений должны сослаться на документацию их провайдера, чтобы узнать, какие ключевые спецификации поддерживаются generateSecret и getKeySpec методы. Например, фабрика секретного ключа DES, предоставленная провайдером "SunJCE", поддерживает DESKeySpec как прозрачное представление ключей DES, и что фабрика секретного ключа провайдера для Тройных ключей DES поддерживает DESedeKeySpec как прозрачное представление Тройных ключей DES.

Каждая реализация платформы Java обязана поддерживать следующий стандарт SecretKeyFactory алгоритмы:

• DES
• DESede

Эти алгоритмы описываются в разделе SecretKeyFactory Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.

С тех пор:

1.4

См. Также:

SecretKey, DESKeySpec, DESedeKeySpec, PBEKeySpec

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	SecretKeyFactory(SecretKeyFactorySpi keyFacSpi, Provider provider, String algorithm) Создает объект SecretKeyFactory.

Сводка метода

Модификатор и Тип	Метод и Описание
SecretKey	generateSecret(KeySpec keySpec) Генерирует a SecretKey объект от обеспеченной ключевой спецификации (ключевой материал).
Строка	getAlgorithm() Возвращает имя алгоритма этого SecretKeyFactory объект.
static SecretKeyFactory	getInstance(String algorithm) Возвраты a SecretKeyFactory объект, который преобразовывает секретные ключи указанного алгоритма.
static SecretKeyFactory	getInstance(String algorithm, Provider provider) Возвраты a SecretKeyFactory объект, который преобразовывает секретные ключи указанного алгоритма.
static SecretKeyFactory	getInstance(String algorithm, String provider) Возвраты a SecretKeyFactory объект, который преобразовывает секретные ключи указанного алгоритма.
KeySpec	getKeySpec(SecretKey key, Class<?> keySpec) Возвращает спецификацию (ключевой материал) данного ключевого объекта в требуемом формате.
Провайдер	getProvider() Возвращает провайдера этого SecretKeyFactory объект.
SecretKey	translateKey(SecretKey key) Преобразовывает ключевой объект, провайдер которого может быть неизвестным или потенциально недоверяемым в соответствующий ключевой объект этой фабрики секретного ключа.

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

SecretKeyFactory

protected SecretKeyFactory(SecretKeyFactorySpi keyFacSpi,
                           Provider provider,
                           String algorithm)

Создает объект SecretKeyFactory.

Параметры:

keyFacSpi - делегат

provider - провайдер

algorithm - алгоритм секретного ключа

Деталь метода

getInstance

public static final SecretKeyFactory getInstance(String algorithm)
                                          throws NoSuchAlgorithmException

Возвраты a SecretKeyFactory объект, который преобразовывает секретные ключи указанного алгоритма.

Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект SecretKeyFactory инкапсуляция реализации SecretKeyFactorySpi от первого Провайдера, который поддерживает указанный алгоритм.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - стандартное имя требуемого алгоритма секретного ключа. См. раздел SecretKeyFactory в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

Возвраты:

новое SecretKeyFactory объект.

Броски:

NullPointerException - если указанный алгоритм является нулем.

NoSuchAlgorithmException - если никакой Провайдер не поддерживает реализацию SecretKeyFactorySpi для указанного алгоритма.

См. Также:

Provider

getInstance

public static final SecretKeyFactory getInstance(String algorithm,
                                                 String provider)
                                          throws NoSuchAlgorithmException,
                                                 NoSuchProviderException

Возвраты a SecretKeyFactory объект, который преобразовывает секретные ключи указанного алгоритма.

Возвращается новый объект SecretKeyFactory инкапсуляция реализации SecretKeyFactorySpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - стандартное имя требуемого алгоритма секретного ключа. См. раздел SecretKeyFactory в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - имя провайдера.

Возвраты:

новое SecretKeyFactory объект.

Броски:

NoSuchAlgorithmException - если реализация SecretKeyFactorySpi для указанного алгоритма не доступна от указанного провайдера.

NullPointerException - если указанный алгоритм является нулем.

NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.

IllegalArgumentException - если provider нуль или пустой.

См. Также:

Provider

getInstance

public static final SecretKeyFactory getInstance(String algorithm,
                                                 Provider provider)
                                          throws NoSuchAlgorithmException

Возвраты a SecretKeyFactory объект, который преобразовывает секретные ключи указанного алгоритма.

Возвращается новый объект SecretKeyFactory инкапсуляция реализации SecretKeyFactorySpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.

Параметры:

algorithm - стандартное имя требуемого алгоритма секретного ключа. См. раздел SecretKeyFactory в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - провайдер.

Возвраты:

новое SecretKeyFactory объект.

Броски:

NullPointerException - если указанный алгоритм является нулем.

NoSuchAlgorithmException - если реализация SecretKeyFactorySpi для указанного алгоритма не доступна от указанного объекта Провайдера.

IllegalArgumentException - если provider нуль.

См. Также:

Provider

getProvider

public final Provider getProvider()

Возвращает провайдера этого SecretKeyFactory объект.

Возвраты:

провайдер этого SecretKeyFactory объект

getAlgorithm

public final String getAlgorithm()

Возвращает имя алгоритма этого SecretKeyFactory объект.

Это - то же самое имя, которое было определено в одном из getInstance вызовы, которые создали это SecretKeyFactory объект.

Возвраты:

имя алгоритма этого SecretKeyFactory объект.

generateSecret

public final SecretKey generateSecret(KeySpec keySpec)
                               throws InvalidKeySpecException

Генерирует a SecretKey объект от обеспеченной ключевой спецификации (ключевой материал).

Параметры:

keySpec - спецификация (ключевой материал) секретного ключа

Возвраты:

секретный ключ

Броски:

InvalidKeySpecException - если данная ключевая спецификация является несоответствующей для этой фабрики секретного ключа, чтобы произвести секретный ключ.

getKeySpec

public final KeySpec getKeySpec(SecretKey key,
                                Class<?> keySpec)
                         throws InvalidKeySpecException

Возвращает спецификацию (ключевой материал) данного ключевого объекта в требуемом формате.

Параметры:

key - ключ

keySpec - требуемый формат, в котором должен быть возвращен ключевой материал

Возвраты:

базовая ключевая спецификация (ключевой материал) в требуемом формате

Броски:

InvalidKeySpecException - если требуемая ключевая спецификация является несоответствующей для данного ключа (например, алгоритмы, связанные с key и keySpec не соответствуйте, или key ссылается на ключ на криптографическом устройстве тогда как keySpec спецификация основанного на программном обеспечении ключа), или с данным ключом нельзя иметь дело с (например, у данного ключа есть алгоритм или формат, не поддерживаемый этой фабрикой секретного ключа).

translateKey

public final SecretKey translateKey(SecretKey key)
                             throws InvalidKeyException

Преобразовывает ключевой объект, провайдер которого может быть неизвестным или потенциально недоверяемым в соответствующий ключевой объект этой фабрики секретного ключа.

Параметры:

key - ключ, провайдер которого неизвестен или недоверяем

Возвраты:

преобразованный ключ

Броски:

InvalidKeyException - если данный ключ не может быть обработан этой фабрикой секретного ключа.