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

KeyPairGenerator

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

Модификатор и тип	Метод	Описание
`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) throws InvalidParameterException

Инициализирует генератор пар ключей с использованием параметров семейства 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) throws InvalidParameterException

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

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

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

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