Интерфейс 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

См. также:

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

Модификатор и тип	Метод	Описание
`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 по умолчанию.

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

initialize

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

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

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

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

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