Класс KeyPairGeneratorSpi

java.lang.Object

java.security.KeyPairGeneratorSpi

Прямые известные подклассы:: KeyPairGenerator

public abstract class KeyPairGeneratorSpi extends Object

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

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

Если клиент явно не инициализирует KeyPairGenerator (посредством вызова метода initialize), каждый поставщик должен предоставить (и задокументировать) инициализацию по умолчанию. Сведения о размерах ключей, используемых поставщиками JDK по умолчанию для KeyPairGenerator, см. в разделах об ограничениях на размер ключа документа Поставщики JDK. Однако обратите внимание, что значения по умолчанию могут различаться у разных поставщиков. Кроме того, значение по умолчанию для поставщика может измениться в будущей версии. Поэтому рекомендуется явно инициализировать KeyPairGenerator, а не полагаться на значения по умолчанию, зависящие от поставщика.

Начиная с:

1.2

См. также:

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

Конструктор	Описание
`KeyPairGeneratorSpi()`	Конструктор, вызываемый подклассами.

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

Модификатор и тип	Метод	Описание
`abstract KeyPair`	`generateKeyPair()`	Генерирует пару ключей.
`abstract void`	`initialize(int keysize, SecureRandom random)`	Инициализирует генератор пар ключей для заданного размера ключа с использованием набора параметров по умолчанию.
`void`	`initialize(AlgorithmParameterSpec params, SecureRandom random)`	Инициализирует генератор пар ключей с использованием указанного набора параметров и предоставленного пользователем источника случайности.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

KeyPairGeneratorSpi

public KeyPairGeneratorSpi()

Конструктор, вызываемый подклассами.

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

initialize

public abstract void initialize(int keysize, SecureRandom random)

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

Параметры:: keysize — размер ключа. Это метрика, зависящая от алгоритма, например длина модуля, выраженная в битах.; random — источник случайности для этого генератора.
Вызывает исключение:: InvalidParameterException — если keysize не поддерживается этим объектом KeyPairGeneratorSpi.

initialize

public void initialize(AlgorithmParameterSpec params, SecureRandom random) throws InvalidAlgorithmParameterException

Инициализирует генератор пар ключей с использованием указанного набора параметров и предоставленного пользователем источника случайности.

Этот конкретный метод добавлен в ранее определённый абстрактный класс. (Для обеспечения обратной совместимости он не может быть абстрактным.) Поставщик может переопределить его для инициализации генератора пар ключей. Ожидается, что такое переопределение вызовет InvalidAlgorithmParameterException, если параметр не подходит для этого генератора пар ключей. Если этот метод не переопределён, он всегда вызывает UnsupportedOperationException.

Параметры:: params — набор параметров, используемый для генерации ключей.; random — источник случайности для этого генератора.
Вызывает исключение:: InvalidAlgorithmParameterException — если заданные параметры не подходят для этого генератора пар ключей.
Начиная с:: 1.2

generateKeyPair

public abstract KeyPair generateKeyPair()

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

Возвращает:: вновь сгенерированную KeyPair

© 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.