SecretKeyFactory (Платформа Java SE 7)

java.lang. Объект
- javax.crypto. SecretKeyFactory

```
public class SecretKeyFactory
extends Object
```
Этот класс представляет фабрику для секретных ключей.
Ключевые фабрики используются, чтобы преобразовать ключи (непрозрачные криптографические ключи типа 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)` Преобразовывает ключевой объект, провайдер которого может быть неизвестным или потенциально недоверяемым в соответствующий ключевой объект этой фабрики секретного ключа.

Методы 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 - если данный ключ не может быть обработан этой фабрикой секретного ключа.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс SecretKeyFactory

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

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

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

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

SecretKeyFactory

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

getInstance

getInstance

getInstance

getProvider

getAlgorithm

generateSecret

getKeySpec

translateKey