Класс AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object

Класс AlgorithmParameterGenerator используется для генерации набора параметров, которые будут использованы с определённым алгоритмом. Генераторы параметров создаются с помощью методов-фабрик getInstance (статических методов, возвращающих экземпляры данного класса).

Объект, который будет генерировать параметры, может быть инициализирован двумя различными способами: независимо от алгоритма или с учётом конкретного алгоритма:

• Подход, независимый от алгоритма, использует тот факт, что все генераторы параметров разделяют понятие «размер» и источник случайности. Мера размера универсальна для всех параметров алгоритмов, хотя она интерпретируется по-разному для разных алгоритмов. Например, в случае параметров для алгоритма DSA «размер» соответствует размеру простого модуля (в битах). При использовании этого подхода значения параметров, специфичные для алгоритма (если таковые имеются), по умолчанию принимают некоторые стандартные значения, если они не могут быть получены из указанного размера.
• Другой подход инициализирует объект генератора параметров с использованием семантики, специфичной для алгоритма, которая представлена набором значений генерации параметров, специфичных для алгоритма. Например, для генерации параметров системы Диффи-Хеллмана значения генерации параметров обычно включают размер простого модуля и размер случайного показателя, оба указанных в количестве битов.

В случае, если клиент не инициализирует явно AlgorithmParameterGenerator (через вызов метода init), каждый поставщик должен предоставить (и документировать) значение по умолчанию. Например, поставщик Sun использует стандартный размер простого модуля 1024 бита для генерации параметров DSA.

Каждая реализация Java платформы обязана поддерживать следующие стандартные AlgorithmParameterGenerator алгоритмы и размеры ключей в скобках:

• DiffieHellman (1024)
• DSA (1024)

Эти алгоритмы описаны в разделе AlgorithmParameterGenerator документации Java Cryptography Architecture по стандартным именам алгоритмов. Обратитесь к документации выпуска вашей реализации, чтобы узнать, какие другие алгоритмы поддерживаются.

Конструкторы

AlgorithmParameterGenerator

protected AlgorithmParameterGenerator(AlgorithmParameterGeneratorSpi paramGenSpi,
                                      Provider provider,
                                      String algorithm)

Создаёт объект AlgorithmParameterGenerator.

Параметры:

paramGenSpi - делегат

provider - провайдер

algorithm - алгоритм

Методы

getAlgorithm

public final String getAlgorithm()

Возвращает стандартное имя алгоритма, с которым связан этот генератор параметров.

Возвращает:

строковое имя алгоритма.

getInstance

public static AlgorithmParameterGenerator getInstance(String algorithm)
                                               throws NoSuchAlgorithmException

Параметры:

algorithm - имя алгоритма, с которым связан этот генератор параметров. См. раздел AlgorithmParameterGenerator в документации Java Cryptography Architecture по стандартным именам алгоритмов для получения информации о стандартных именах алгоритмов.

Возвращает:

новый объект AlgorithmParameterGenerator.

Исключения:

NoSuchAlgorithmException - если ни один поставщик не поддерживает реализацию AlgorithmParameterGeneratorSpi для указанного алгоритма.

См. также:

Provider

getInstance

public static AlgorithmParameterGenerator getInstance(String algorithm,
                                                      String provider)
                                               throws NoSuchAlgorithmException,
                                                      NoSuchProviderException

Параметры:

algorithm - имя алгоритма, с которым связан этот генератор параметров. См. раздел AlgorithmParameterGenerator в документации Java Cryptography Architecture по стандартным именам алгоритмов для получения информации о стандартных именах алгоритмов.

provider - строковое имя поставщика.

Возвращает:

новый объект AlgorithmParameterGenerator.

Исключения:

NoSuchAlgorithmException - если реализация AlgorithmParameterGeneratorSpi для указанного алгоритма недоступна от указанного поставщика.

NoSuchProviderException - если указанный поставщик не зарегистрирован в списке поставщиков безопасности.

IllegalArgumentException - если имя поставщика null или пустое.

См. также:

Provider

getInstance

public static AlgorithmParameterGenerator getInstance(String algorithm,
                                                      Provider provider)
                                               throws NoSuchAlgorithmException

Параметры:

algorithm - строковое имя алгоритма, с которым связан этот генератор параметров. См. раздел AlgorithmParameterGenerator в документации Java Cryptography Architecture по стандартным именам алгоритмов для получения информации о стандартных именах алгоритмов.

provider - объект поставщика.

Возвращает:

новый объект AlgorithmParameterGenerator.

Исключения:

NoSuchAlgorithmException - если реализация AlgorithmParameterGeneratorSpi для указанного алгоритма недоступна от указанного объекта поставщика.

IllegalArgumentException - если указанный поставщик null.

С момента:

1.4

См. также:

Provider

getProvider

public final Provider getProvider()

Возвращает поставщика этого объекта генератора параметров алгоритма.

Возвращает:

поставщика этого объекта генератора параметров алгоритма

init

public final void init(int size)

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

Параметры:

size - размер (в битах).

init

public final void init(int size,
                       SecureRandom random)

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

Параметры:

size - размер (в битах).

random - источник случайности.

init

public final void init(AlgorithmParameterSpec genParamSpec)
                throws InvalidAlgorithmParameterException

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

Параметры:

genParamSpec - набор значений генерации параметров, специфичных для алгоритма.

Исключения:

InvalidAlgorithmParameterException - если заданные значения генерации параметров не подходят для этого генератора параметров.

init

public final void init(AlgorithmParameterSpec genParamSpec,
                       SecureRandom random)
                throws InvalidAlgorithmParameterException

Инициализирует этот генератор параметров набором значений генерации параметров, специфичных для алгоритма.

Параметры:

genParamSpec - набор значений генерации параметров, специфичных для алгоритма.

random - источник случайности.

Исключения:

InvalidAlgorithmParameterException - если заданные значения генерации параметров не подходят для этого генератора параметров.

generateParameters

public final AlgorithmParameters generateParameters()

Генерирует параметры.

Возвращает:

новый объект AlgorithmParameters.