Интерфейс DSAKeyPairGenerator

public interface DSAKeyPairGenerator

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

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

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

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

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

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

Начиная с:

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 — источник случайных битов для генерации битов ключа; может быть равен 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 — источник случайных битов для генерации битов ключа; может быть равен 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/security/interfaces/DSAKeyPairGenerator.html