Интерфейс DSAKeyPairGenerator

public interface DSAKeyPairGenerator

Интерфейс объекта, способного генерировать пары ключей DSA.

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

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

Получают генератор пар ключей для алгоритма DSA, вызвав метод KeyPairGenerator getInstance с аргументом "DSA".
Проверяют, является ли возвращенный генератор пар ключей экземпляром DSAKeyPairGenerator, прежде чем привести результат к DSAKeyPairGenerator и вызвать один из методов initialize из этого интерфейса DSAKeyPairGenerator.
Генерируют пару ключей, вызвав метод generateKeyPair класса KeyPairGenerator.

Примечание: не всегда необходимо выполнять инициализацию, специфичную для алгоритма, для генератора пар ключей DSA. То есть, не всегда необходимо вызывать метод initialize в этом интерфейсе. Достаточно выполнить инициализацию, независимую от алгоритма, используя метод initialize в интерфейсе KeyPairGenerator, если вы принимаете значения по умолчанию для параметров, специфичных для алгоритма.

Примечание: некоторые более ранние реализации этого интерфейса могут не поддерживать большие значения параметров DSA, такие как 3072-битные.

Since:

1.1

See Also:

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

Модификатор и тип	Метод	Описание
`void`	`initialize(int modlen, boolean genParams, SecureRandom random)`	Инициализирует генератор пар ключей для заданной длины модуля (вместо параметров) и необязательного источника случайных чисел SecureRandom.
`void`	`initialize(DSAParams params, SecureRandom random)`	Инициализирует генератор пар ключей с использованием параметров семейства DSA (p, q и g) и необязательного источника случайных чисел SecureRandom.

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

initialize

void initialize(DSAParams params, SecureRandom random)

Инициализирует генератор пар ключей с использованием параметров семейства DSA (p, q и g) и необязательного источника случайных чисел SecureRandom. Если источник случайных чисел SecureRandom необходим, но не предоставлен (т.е. null), будет использован по умолчанию SecureRandom.

Parameters:: params - параметры, используемые для генерации ключей.; random - источник случайных битов, используемый для генерации битов ключа; может быть null.
Throws:: InvalidParameterException - если значение params недействительно, null или не поддерживается.

initialize

void initialize(int modlen, boolean genParams, SecureRandom random)

Инициализирует генератор пар ключей для заданной длины модуля (вместо параметров) и необязательного источника случайных чисел SecureRandom. Если источник случайных чисел SecureRandom необходим, но не предоставлен (т.е. null), будет использован по умолчанию SecureRandom.

Если genParams равно true, этот метод генерирует новые параметры p, q и g. Если false, метод использует предварительно вычисленные параметры для запрошенной длины модуля. Если предварительно вычисленных параметров для этой длины модуля нет, будет выброшено исключение.

Parameters:: modlen - длина модуля в битах. Допустимые значения — любые кратные 64 от 512 до 1024 включительно, 2048 и 3072.; genParams - нужно ли генерировать новые параметры для запрошенной длины модуля.; random - источник случайных битов, используемый для генерации битов ключа; может быть null.
Throws:: InvalidParameterException - если modlen недействительно или не поддерживается, или если genParams равно false и предварительно вычисленных параметров для запрошенной длины модуля нет.

© 1993, 2023, 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/21/docs/api/java.base/java/security/interfaces/DSAKeyPairGenerator.html