Класс SecretKeySpec

java.lang.Object
- javax.crypto.spec.SecretKeySpec

Все реализованные интерфейсы:: Serializable, Key, KeySpec, SecretKey, Destroyable

public class SecretKeySpec
extends Object
implements KeySpec, SecretKey

Этот класс определяет секретный ключ независимо от поставщика.

Он может быть использован для создания SecretKey из массива байтов без необходимости прохождения через (зависимый от поставщика) SecretKeyFactory.

Этот класс полезен только для сырых секретных ключей, которые могут быть представлены в виде массива байтов и не имеют связанных с ними параметров ключа, например, ключи DES или Triple DES.

С момента:: 1.4
См. также:: SecretKey, SecretKeyFactory, Сериализованная форма

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

Конструктор	Описание
`SecretKeySpec(byte[] key, int offset, int len, String algorithm)`	Создаёт секретный ключ из заданного массива байтов, используя первые `len` байты из `key`, начиная с `offset` включительно.
`SecretKeySpec(byte[] key, String algorithm)`	Создаёт секретный ключ из заданного массива байтов.

Методы

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Проверяет равенство указанного объекта и текущего объекта.
`String`	`getAlgorithm()`	Возвращает имя алгоритма, связанного с этим секретным ключом.
`byte[]`	`getEncoded()`	Возвращает ключевой материал этого секретного ключа.
`String`	`getFormat()`	Возвращает имя формата кодирования для этого секретного ключа.
`int`	`hashCode()`	Вычисляет значение хэш-кода для объекта.

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

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

Методы, объявленные в интерфейсе javax.security.auth.Destroyable

destroy, isDestroyed

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

SecretKeySpec

public SecretKeySpec(byte[] key,
                     String algorithm)

Создаёт секретный ключ из заданного массива байтов.

Этот конструктор не проверяет, действительно ли заданные байты определяют секретный ключ указанного алгоритма. Например, если алгоритм DES, этот конструктор не проверяет, что key имеет длину 8 байт, а также не проверяет слабые или полуслабые ключи. Для выполнения этих проверок должен использоваться класс спецификации ключа, специфичный для алгоритма (в данном случае: DESKeySpec).

Параметры:: key - ключевой материал секретного ключа. Содержимое массива копируется для защиты от последующих изменений.; algorithm - имя алгоритма секретного ключа, который должен быть связан с заданным ключевым материалом. См. документ Стандартные имена алгоритмов Java Security для получения информации о стандартных именах алгоритмов.
Исключения:: IllegalArgumentException - если algorithm равен null или key равен null или пустой.

SecretKeySpec

public SecretKeySpec(byte[] key,
                     int offset,
                     int len,
                     String algorithm)

Создаёт секретный ключ из заданного массива байтов, используя первые len байты из key, начиная с offset включительно.

Байты, составляющие секретный ключ, находятся между key[offset] и key[offset+len-1] включительно.

Этот конструктор не проверяет, действительно ли заданные байты определяют секретный ключ указанного алгоритма. Например, если алгоритм DES, этот конструктор не проверяет, что key имеет длину 8 байт, а также не проверяет слабые или полуслабые ключи. Для выполнения этих проверок необходимо использовать класс спецификации ключа, специфичный для алгоритма (в данном случае: DESKeySpec).

Параметры:: key - ключевой материал секретного ключа. Первые len байтов массива, начиная с offset включительно, копируются для защиты от последующих изменений.; offset - смещение в key, где начинается ключевой материал.; len - длина ключевого материала.; algorithm - имя алгоритма секретного ключа, который должен быть связан с заданным ключевым материалом. См. документ Стандартные имена алгоритмов Java Security для получения информации о стандартных именах алгоритмов.
Исключения:: IllegalArgumentException - если algorithm равен null или key равен null, пустой или слишком короткий, т.е. key.length-offset<len.; ArrayIndexOutOfBoundsException - выбрасывается, если индекс offset или len выходит за пределы key.

Методы

getAlgorithm

public String getAlgorithm()

Возвращает имя алгоритма, связанного с этим секретным ключом.

Определено в:: getAlgorithm в интерфейсе Key
Возвращает:: алгоритм секретного ключа.

getFormat

public String getFormat()

Возвращает имя формата кодирования для этого секретного ключа.

Определено в:: getFormat в интерфейсе Key
Возвращает:: строку "RAW".

getEncoded

public byte[] getEncoded()

Возвращает ключевой материал этого секретного ключа.

Определено в:: getEncoded в интерфейсе Key
Возвращает:: ключевой материал. Возвращает новый массив каждый раз, когда этот метод вызывается.

hashCode

public int hashCode()

Вычисляет значение хэш-кода для объекта. Объекты, которые равны, также будут иметь одинаковый хэш-код.

Переопределяет:: hashCode в классе Object
Возвращает:: значение хэш-кода для этого объекта.
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Проверяет равенство указанного объекта и текущего объекта. Два объекта SecretKeySpec считаются равными, если они оба являются SecretKey и имеют одинаковое имя алгоритма (регистронезависимое) и кодирование ключа.

Переопределяет:: equals в классе Object
Параметры:: obj - объект для проверки равенства с этим объектом.
Возвращает:: true, если объекты считаются равными, false, если obj равен null или по другим причинам.
См. также:: Object.hashCode(), HashMap