javax.crypto.spec

Класс SecretKeySpec

java.lang. Объект

javax.crypto.spec. SecretKeySpec

Все Реализованные Интерфейсы:

Сериализуемый, Ключевой, KeySpec, SecretKey

public class SecretKeySpec
extends Object
implements KeySpec, SecretKey

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

Это может использоваться, чтобы создать a SecretKey от байтового массива, не имея необходимость проходить через (основанный на провайдере) SecretKeyFactory.

Этот класс только полезен для необработанных секретных ключей, которые могут быть представлены как байтовый массив и не иметь никаких основных параметров, связанных с ними, например, DES или Утраивать ключи 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) Тесты для равенства между указанным объектом и этим объектом.
Строка	getAlgorithm() Возвращает имя алгоритма, связанного с этим секретным ключом.
byte[]	getEncoded() Возвращает ключевой материал этого секретного ключа.
Строка	getFormat() Возвращает имя формата кодирования для этого секретного ключа.
int	hashCode() Вычисляет значение хэш-кода для объекта.

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

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

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

SecretKeySpec

public SecretKeySpec(byte[] key,
             String algorithm)

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

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

Параметры:

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

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

Броски:

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

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 - имя алгоритма секретного ключа, который будет связан с данным ключевым материалом. См. Приложение A в Справочнике Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

Броски:

IllegalArgumentException - если algorithm нуль или key нуль, пустой, или слишком короткий, то есть. key.length-offset.

ArrayIndexOutOfBoundsException - is thrown if offset or len index bytes outside the key.

Method Detail

getAlgorithm

public String getAlgorithm()

Returns the name of the algorithm associated with this secret key.

Specified by:

getAlgorithm in interface Key

Returns:

the secret key algorithm.

getFormat

public String getFormat()

Returns the name of the encoding format for this secret key.

Specified by:

getFormat in interface Key

Returns:

the string "RAW".

getEncoded

public byte[] getEncoded()

Returns the key material of this secret key.

Specified by:

getEncoded in interface Key

Returns:

the key material. Returns a new array each time this method is called.

hashCode

public int hashCode()

Calculates a hash code value for the object. Objects that are equal will also have the same hashcode.

Overrides:

hashCode in class Object

Returns:

a hash code value for this object.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Tests for equality between the specified object and this object. Two SecretKeySpec objects are considered equal if they are both SecretKey instances which have the same case-insensitive algorithm name and key encoding.

Overrides:

equals in class Object

Parameters:

obj - the object to test for equality with this object.

Returns:

true if the objects are considered equal, false if obj is null or otherwise.

See Also:

Object.hashCode(), HashMap