Класс KEM.Decapsulator

java.lang.Object

javax.crypto.KEM.Decapsulator

Внешний класс:: KEM

public static final class KEM.Decapsulator extends Object

Декапсулятор, созданный с помощью KEM.newDecapsulator(PrivateKey) на стороне получателя KEM.

Этот класс представляет функцию декапсуляции ключа KEM. Вызов метода decapsulate восстанавливает секретный ключ из сообщения инкапсуляции ключа.

Начиная с:: 21

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

Модификатор и тип	Метод	Описание
`SecretKey`	`decapsulate(byte[] encapsulation)`	Функция декапсуляции ключа.
`SecretKey`	`decapsulate(byte[] encapsulation, int from, int to, String algorithm)`	Функция декапсуляции ключа.
`int`	`encapsulationSize()`	Возвращает размер сообщения инкапсуляции ключа.
`String`	`providerName()`	Возвращает имя поставщика.
`int`	`secretSize()`	Возвращает размер общего секрета.

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

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

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

providerName

public String providerName()

Возвращает имя поставщика.

Возвращает:: имя поставщика

decapsulate

public SecretKey decapsulate(byte[] encapsulation) throws DecapsulateException

Функция декапсуляции ключа.

Этот метод эквивалентен decapsulate(encapsulation, 0, secretSize(), "Generic"). Эта комбинация аргументов должна поддерживаться каждой реализацией.

Сгенерированный секретный ключ обычно передается функции выработки ключа (KDF) в качестве исходного ключевого материала.

Параметры:: encapsulation — сообщение инкапсуляции ключа от отправителя. Его размер должен быть равен значению, возвращаемому encapsulationSize(), иначе будет выброшено исключение DecapsulateException.
Возвращает:: общий секрет в виде SecretKey с именем алгоритма "Generic"
Выбрасывает:: DecapsulateException — если во время процесса декапсуляции произошла ошибка; NullPointerException — если encapsulation имеет значение null

decapsulate

public SecretKey decapsulate(byte[] encapsulation, int from, int to, String algorithm) throws DecapsulateException

Функция декапсуляции ключа.

Вызов этого метода восстанавливает секретный ключ из сообщения инкапсуляции ключа.

Реализация может не поддерживать произвольные комбинации from, to и algorithm.

Параметры:

encapsulation — сообщение инкапсуляции ключа от отправителя. Его размер должен быть равен значению, возвращаемому encapsulationSize(), иначе будет выброшено исключение DecapsulateException.

from — начальный индекс возвращаемого массива байтов общего секрета включительно

to — конечный индекс возвращаемого массива байтов общего секрета исключительно

algorithm — имя алгоритма возвращаемого секретного ключа. Сведения о стандартных именах алгоритмов секретных ключей см. в разделе SecretKey Algorithms спецификации Java Security Standard Algorithm Names. Укажите "Generic", если результат будет использоваться в качестве исходного ключевого материала функции выработки ключа (KDF).

Возвращает:

часть общего секрета в виде SecretKey, содержащую байты секрета в диапазоне от from до to исключительно, и имя алгоритма, указанное в параметрах. Например,

decapsulate(encapsulation, secretSize()
         - 16, secretSize(), "AES")

использует последние 16 байт общего секрета в качестве 128-битного ключа AES.

Выбрасывает:

DecapsulateException — если во время процесса декапсуляции произошла ошибка

IndexOutOfBoundsException — если from < 0, from > to или to > secretSize()

NullPointerException — если encapsulation или algorithm имеет значение null

UnsupportedOperationException — если декапсулятор не поддерживает комбинацию from, to и algorithm

Внешние спецификации

secretSize

public int secretSize()

Возвращает размер общего секрета.

Этот метод можно вызвать, чтобы узнать длину общего секрета до вызова decapsulate или если полученный SecretKey нельзя извлечь.

Возвращает:: размер общего секрета

encapsulationSize

public int encapsulationSize()

Возвращает размер сообщения инкапсуляции ключа.

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

Возвращает:: размер сообщения инкапсуляции ключа

© 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/KEM.Decapsulator.html