Класс HKDFParameterSpec.Builder

java.lang.Object

javax.crypto.spec.HKDFParameterSpec.Builder

Вложенный интерфейс:: HKDFParameterSpec^PREVIEW

public static final class HKDFParameterSpec.Builder extends Object

Builder это предварительная версия API платформы Java.

Программы могут использовать Builder только при включённых предварительных функциях.

Функции предварительной версии могут быть удалены в будущей версии или обновлены до постоянных функций платформы Java.

Данный Builder создаёт объекты Extract и ExtractThenExpand.

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

С:: 24

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

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

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

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

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

extractOnly

public HKDFParameterSpec.ExtractPREVIEW extractOnly()

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

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

thenExpand

public HKDFParameterSpec.ExtractThenExpandPREVIEW 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.BuilderPREVIEW addIKM(SecretKey ikm)

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

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

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

addIKM

public HKDFParameterSpec.BuilderPREVIEW addIKM(byte[] ikm)

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

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

addSalt

public HKDFParameterSpec.BuilderPREVIEW addSalt(SecretKey salt)

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

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

Параметры:: salt - значение соли
Возвращает:: этот билдер
Исключения:: NullPointerException - если salt равен null

addSalt

public HKDFParameterSpec.BuilderPREVIEW 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://download.java.net/java/early_access/jdk24/docs/api/java.base/javax/crypto/spec/HKDFParameterSpec.Builder.html