Spec-Zone.ru › OpenJDK 25

Класс SignatureSpi

java.lang.Object
java.security.SignatureSpi
Прямые известные подклассы:
Signature
public abstract class SignatureSpi extends Object
Этот класс определяет интерфейс поставщика службы (SPI) для класса Signature, который используется для предоставления функциональности алгоритма цифровой подписи. Цифровые подписи используются для аутентификации и обеспечения целостности цифровых данных.

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

Начиная с:
1.2
См. также:
  • Signature

Краткое описание полей

Модификатор и тип Поле Описание
protected SecureRandom appRandom
Указанный приложением источник случайности.

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

Конструктор Описание
SignatureSpi()
Конструктор для вызова подклассами.

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

Модификатор и тип Метод Описание
Object clone()
Возвращает клон, если реализация поддерживает клонирование.
protected abstract Object engineGetParameter(String param)
Устарело.
protected AlgorithmParameters engineGetParameters()
Возвращает параметры, используемые с этим объектом Signature.
protected abstract void engineInitSign(PrivateKey privateKey)
Инициализирует этот объект Signature указанным закрытым ключом для операций подписания.
protected void engineInitSign(PrivateKey privateKey, SecureRandom random)
Инициализирует этот объект Signature указанным закрытым ключом и источником случайности для операций подписания.
protected abstract void engineInitVerify(PublicKey publicKey)
Инициализирует этот объект Signature указанным открытым ключом для операций проверки.
protected abstract void engineSetParameter(String param, Object value)
Устарело.
Заменён методом engineSetParameter.
protected void engineSetParameter(AlgorithmParameterSpec params)
Инициализирует этот объект Signature указанными значениями параметров.
protected abstract byte[] engineSign()
Возвращает байты подписи для всех данных, обработанных на данный момент.
protected int engineSign(byte[] outbuf, int offset, int len)
Завершает эту операцию подписания и сохраняет полученные байты подписи в предоставленном буфере outbuf, начиная с позиции offset.
protected abstract void engineUpdate(byte b)
Обновляет данные для подписания или проверки, используя указанный байт.
protected abstract void engineUpdate(byte[] b, int off, int len)
Обновляет данные для подписания или проверки, используя указанный массив байтов, начиная с заданного смещения.
protected void engineUpdate(ByteBuffer input)
Обновляет данные для подписания или проверки, используя указанный ByteBuffer.
protected abstract boolean engineVerify(byte[] sigBytes)
Проверяет переданную подпись.
protected boolean engineVerify(byte[] sigBytes, int offset, int length)
Проверяет переданную подпись в указанном массиве байтов, начиная с заданного смещения.

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

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

Подробное описание полей

appRandom

protected SecureRandom appRandom
Указанный приложением источник случайности.

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

SignatureSpi

public SignatureSpi()
Конструктор для вызова подклассами.

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

engineInitVerify

protected abstract void engineInitVerify(PublicKey publicKey) throws InvalidKeyException
Инициализирует этот объект Signature указанным открытым ключом для операций проверки.
Параметры:
publicKey — открытый ключ субъекта, подпись которого будет проверяться.
Исключения:
InvalidKeyException — если ключ имеет неправильный формат, отсутствуют параметры и т. п.

engineInitSign

protected abstract void engineInitSign(PrivateKey privateKey) throws InvalidKeyException
Инициализирует этот объект Signature указанным закрытым ключом для операций подписания.
Параметры:
privateKey — закрытый ключ субъекта, подпись которого будет создана.
Исключения:
InvalidKeyException — если ключ имеет неправильный формат, отсутствуют параметры и т. п.

engineInitSign

protected void engineInitSign(PrivateKey privateKey, SecureRandom random) throws InvalidKeyException
Инициализирует этот объект Signature указанным закрытым ключом и источником случайности для операций подписания.

Этот конкретный метод добавлен в ранее определённый абстрактный класс. (Для обеспечения обратной совместимости он не может быть абстрактным.)

Параметры:
privateKey — закрытый ключ субъекта, подпись которого будет создана.
random — источник случайности
Исключения:
InvalidKeyException — если ключ имеет неправильный формат, отсутствуют параметры и т. п.

engineUpdate

protected abstract void engineUpdate(byte b) throws SignatureException
Обновляет данные для подписания или проверки, используя указанный байт.
Параметры:
b — байт, используемый для обновления.
Исключения:
SignatureException — если механизм не инициализирован должным образом.

engineUpdate

protected abstract void engineUpdate(byte[] b, int off, int len) throws SignatureException
Обновляет данные для подписания или проверки, используя указанный массив байтов, начиная с заданного смещения.
Параметры:
b — массив байтов
off — смещение в массиве байтов, с которого следует начать
len — количество используемых байтов, начиная со смещения
Исключения:
SignatureException — если механизм не инициализирован должным образом

engineUpdate

protected void engineUpdate(ByteBuffer input)
Обновляет данные для подписания или проверки, используя указанный ByteBuffer. Обрабатывает байты data.remaining(), начиная с позиции data.position(). По завершении позиция буфера будет равна его пределу; предел не изменится.
Параметры:
input — ByteBuffer
Начиная с:
1.5

engineSign

protected abstract byte[] engineSign() throws SignatureException
Возвращает байты подписи для всех данных, обработанных на данный момент. Формат подписи зависит от используемой схемы подписи.
Возвращает:
байты подписи, полученные в результате операции подписания.
Исключения:
SignatureException — если механизм не инициализирован должным образом или данный алгоритм подписи не может обработать предоставленные входные данные.

engineSign

protected int engineSign(byte[] outbuf, int offset, int len) throws SignatureException
Завершает эту операцию подписания и сохраняет полученные байты подписи в предоставленном буфере outbuf, начиная с позиции offset. Формат подписи зависит от используемой схемы подписи.

Реализация подписи сбрасывается в исходное состояние (состояние после вызова одного из методов engineInitSign) и может быть повторно использована для создания других подписей с тем же закрытым ключом. Этот метод должен быть абстрактным, но для обеспечения бинарной совместимости он оставлен конкретным. Поставщикам, знакомым с особенностями реализации, следует переопределить этот метод.

Параметры:
outbuf — буфер для результата подписания.
offset — смещение в outbuf, куда сохраняется подпись.
len — количество байтов в outbuf, выделенных для подписи. Ни эта реализация по умолчанию, ни поставщик SUN не возвращают частичные дайджесты. Если значение этого параметра меньше фактической длины подписи, этот метод вызовет SignatureException. Этот параметр игнорируется, если его значение больше или равно фактической длине подписи.
Возвращает:
количество байтов, записанных в outbuf
Исключения:
SignatureException — если механизм не инициализирован должным образом, данный алгоритм подписи не может обработать предоставленные входные данные или len меньше фактической длины подписи.
Начиная с:
1.2

engineVerify

protected abstract boolean engineVerify(byte[] sigBytes) throws SignatureException
Проверяет переданную подпись.
Параметры:
sigBytes — байты подписи для проверки.
Возвращает:
true, если подпись проверена, false — если нет.
Исключения:
SignatureException — если механизм не инициализирован должным образом, переданная подпись имеет неправильный формат или тип, данный алгоритм подписи не может обработать предоставленные входные данные и т. п.

engineVerify

protected boolean engineVerify(byte[] sigBytes, int offset, int length) throws SignatureException
Проверяет переданную подпись в указанном массиве байтов, начиная с заданного смещения.

Примечание: подклассам следует переопределить реализацию по умолчанию.

Параметры:
sigBytes — байты подписи для проверки.
offset — смещение в массиве байтов, с которого следует начать.
length — количество используемых байтов, начиная со смещения.
Возвращает:
true, если подпись проверена, false — если нет.
Исключения:
SignatureException — если механизм не инициализирован должным образом, переданная подпись имеет неправильный формат или тип, данный алгоритм подписи не может обработать предоставленные входные данные и т. п.
Начиная с:
1.4

engineSetParameter

@Deprecated protected abstract void engineSetParameter(String param, Object value) throws InvalidParameterException
Устарело.
Заменён методом engineSetParameter.
Устанавливает указанное значение для заданного параметра алгоритма. Этот метод предоставляет универсальный механизм для установки различных параметров данного объекта. Параметром может быть любой параметр алгоритма, допускающий установку, например размер параметра, источник случайных битов для создания подписи (если применимо) или указание на необходимость выполнения определённого, но необязательного вычисления. Единая схема именования параметров для конкретного алгоритма желательна, но на данный момент не определена.
Параметры:
param — строковый идентификатор параметра.
value — значение параметра.
Исключения:
InvalidParameterException — если param является недопустимым параметром для этого объекта Signature, параметр уже задан и не может быть задан повторно, возникает исключение безопасности и т. п.

engineSetParameter

protected void engineSetParameter(AlgorithmParameterSpec params) throws InvalidAlgorithmParameterException
Инициализирует этот объект Signature указанными значениями параметров.
Параметры:
params — параметры
Исключения:
UnsupportedOperationException — если этот метод не переопределён поставщиком
InvalidAlgorithmParameterException — если этот метод переопределён поставщиком и указанные параметры не подходят для этого объекта Signature

engineGetParameters

protected AlgorithmParameters engineGetParameters()
Возвращает параметры, используемые с этим объектом Signature.

Возвращённые параметры могут совпадать с параметрами, использованными для инициализации этого объекта Signature, либо содержать дополнительные значения параметров по умолчанию или случайные значения, используемые базовой схемой подписи. Если необходимые параметры не были предоставлены и могут быть сгенерированы объектом Signature, возвращаются сгенерированные параметры; в противном случае возвращается null.

Однако, если схема подписи не поддерживает возврат параметров в виде AlgorithmParameters, всегда возвращается null.

Возвращает:
параметры, используемые с этим объектом Signature, или null
Исключения:
UnsupportedOperationException — если этот метод не переопределён поставщиком
Начиная с:
1.4

engineGetParameter

@Deprecated protected abstract Object engineGetParameter(String param) throws InvalidParameterException
Устарело.
Получает значение указанного параметра алгоритма. Этот метод предоставляет универсальный механизм для получения различных параметров данного объекта. Параметром может быть любой параметр алгоритма, допускающий установку, например размер параметра, источник случайных битов для создания подписи (если применимо) или указание на необходимость выполнения определённого, но необязательного вычисления. Единая схема именования параметров для конкретного алгоритма желательна, но на данный момент не определена.
Параметры:
param — строковое имя параметра.
Возвращает:
объект, представляющий значение параметра, или null, если такого значения нет.
Исключения:
InvalidParameterException — если param является недопустимым параметром для этого механизма или при попытке получить этот параметр возникает другое исключение.

clone

public Object clone() throws CloneNotSupportedException
Возвращает клон, если реализация поддерживает клонирование.
Переопределяет:
clone в классе Object
Возвращает:
клон, если реализация поддерживает клонирование.
Исключения:
CloneNotSupportedException — если этот метод вызван для реализации, не поддерживающей Cloneable.
См. также:
  • Cloneable

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/java/security/SignatureSpi.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API