Класс HKDFParameterSpec.Builder

java.lang.Object

javax.crypto.spec.HKDFParameterSpec.Builder

Включающий интерфейс:: HKDFParameterSpec

public static final class HKDFParameterSpec.Builder extends Object

Этот Builder создает объекты Extract и ExtractThenExpand.

Builder инициализируется с помощью метода ofExtract интерфейса HKDFParameterSpec. Как указано в описании класса, при необходимости можно вызвать addIKM и/или addSalt. Наконец, объект «создается» вызовом либо extractOnly, либо thenExpand для соответствующих вариантов использования Extract и ExtractThenExpand. Обратите внимание, что Builder не является потокобезопасным.

Начиная с:: 25

Краткое описание методов

Модификатор и тип	Метод	Описание
`HKDFParameterSpec.Builder`	`addIKM(byte[] ikm)`	Добавляет входной ключевой материал (IKM) в построитель.
`HKDFParameterSpec.Builder`	`addIKM(SecretKey ikm)`	Добавляет входной ключевой материал (IKM) в построитель.
`HKDFParameterSpec.Builder`	`addSalt(byte[] salt)`	Добавляет соль в построитель.
`HKDFParameterSpec.Builder`	`addSalt(SecretKey salt)`	Добавляет соль в построитель.
`HKDFParameterSpec.Extract`	`extractOnly()`	Создает объект `Extract` из текущего состояния `Builder`.
`HKDFParameterSpec.ExtractThenExpand`	`thenExpand(byte[] info, int length)`	Создает объект `ExtractThenExpand` из текущего состояния `Builder`.

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

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

Подробное описание методов

extractOnly

public HKDFParameterSpec.Extract extractOnly()

Создает объект Extract из текущего состояния Builder.

Возвращает:: неизменяемый объект Extract

thenExpand

public HKDFParameterSpec.ExtractThenExpand thenExpand(byte[] info, int length)

Создает объект ExtractThenExpand из текущего состояния Builder.

Примечание по реализации:: Реализации HKDF обеспечивают, чтобы длина не превышала 255 * длину HMAC. Реализации HKDF также обеспечивают, чтобы значение {code null} для info трактовалось как байтовый массив нулевой длины.
Параметры:: info — необязательная контекстная информация и информация, специфичная для приложения (может быть null); байтовый массив клонируется во избежание последующего изменения; length — длина выходного ключевого материала (должна быть больше 0)
Возвращает:: неизменяемый объект ExtractThenExpand
Выбрасывает:: IllegalArgumentException — если length не больше 0

addIKM

public HKDFParameterSpec.Builder addIKM(SecretKey ikm)

Добавляет входной ключевой материал (IKM) в построитель.

Пользователи могут вызывать addIKM несколько раз, если значение входного ключевого материала собирается по частям или если часть IKM предоставляется аппаратным криптографическим устройством. Метод ikms() объекта Extract или ExtractThenExpand, созданного впоследствии, возвращает собранный входной ключевой материал в виде списка объектов SecretKey.

Параметры:: ikm — значение входного ключевого материала (IKM)
Возвращает:: этот построитель
Выбрасывает:: NullPointerException — если аргумент ikm равен null

addIKM

public HKDFParameterSpec.Builder addIKM(byte[] ikm)

Добавляет входной ключевой материал (IKM) в построитель. Обратите внимание, что байтовый массив ikm нулевой длины будет отброшен.

Параметры:: ikm — значение входного ключевого материала (IKM); байтовый массив ikm будет преобразован в SecretKeySpec, то есть байтовый массив будет клонирован внутри конструктора SecretKeySpec
Возвращает:: этот построитель
Выбрасывает:: NullPointerException — если аргумент ikm равен null

addSalt

public HKDFParameterSpec.Builder addSalt(SecretKey salt)

Добавляет соль в построитель.

Пользователи могут вызывать addSalt несколько раз, если значение соли собирается по частям или если часть соли предоставляется аппаратным криптографическим устройством. Метод salts() объекта Extract или ExtractThenExpand, созданного впоследствии, возвращает собранную соль в виде списка объектов SecretKey.

Параметры:: salt — значение соли
Возвращает:: этот построитель
Выбрасывает:: NullPointerException — если salt равно null

addSalt

public HKDFParameterSpec.Builder addSalt(byte[] salt)

Добавляет соль в построитель. Обратите внимание, что байтовый массив salt нулевой длины будет отброшен.

Параметры:: salt — значение соли; байтовый массив salt будет преобразован в SecretKeySpec, то есть байтовый массив будет клонирован внутри конструктора SecretKeySpec
Возвращает:: этот построитель
Выбрасывает:: NullPointerException — если salt равно null

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/javax/crypto/spec/HKDFParameterSpec.Builder.html