compact1, compact2, compact3

java.security

Класс AlgorithmParameterGenerator

java.lang. Объект

java.security.AlgorithmParameterGenerator

public class AlgorithmParameterGenerator
extends Object

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

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

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

• Другой подход инициализирует объект генератора параметра использование специфичной для алгоритма семантики, которые представляются рядом специфичных для алгоритма значений генерации параметра. Чтобы генерировать системные параметры Diffie-Hellman, например, значения генерации параметра обычно состоят из размера главного модуля и размера случайной экспоненты, оба определенные в числе битов.

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

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

• DiffieHellman (1024)
• DSA (1024)

Эти алгоритмы описываются в разделе AlgorithmParameterGenerator Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.

С тех пор:

1.2

См. Также:

AlgorithmParameters, AlgorithmParameterSpec

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	AlgorithmParameterGenerator(AlgorithmParameterGeneratorSpi paramGenSpi, Provider provider, String algorithm) Создает объект AlgorithmParameterGenerator.

Сводка метода

Модификатор и Тип	Метод и Описание
AlgorithmParameters	generateParameters() Генерирует параметры.
Строка	getAlgorithm() Возвращает стандартное имя алгоритма, с которым связывается этот генератор параметра.
static AlgorithmParameterGenerator	getInstance(String algorithm) Возвращает объект AlgorithmParameterGenerator для того, чтобы генерировать ряд параметров, которые будут использоваться с указанным алгоритмом.
static AlgorithmParameterGenerator	getInstance(String algorithm, Provider provider) Возвращает объект AlgorithmParameterGenerator для того, чтобы генерировать ряд параметров, которые будут использоваться с указанным алгоритмом.
static AlgorithmParameterGenerator	getInstance(String algorithm, String provider) Возвращает объект AlgorithmParameterGenerator для того, чтобы генерировать ряд параметров, которые будут использоваться с указанным алгоритмом.
Провайдер	getProvider() Возвращает провайдера этого объекта генератора параметра алгоритма.
void	init(AlgorithmParameterSpec genParamSpec) Инициализирует этот генератор параметра с рядом специфичных для алгоритма значений генерации параметра.
void	init(AlgorithmParameterSpec genParamSpec, SecureRandom random) Инициализирует этот генератор параметра с рядом специфичных для алгоритма значений генерации параметра.
void	init(int size) Инициализирует этот генератор параметра для определенного размера.
void	init(int size, SecureRandom random) Инициализирует этот генератор параметра для определенного размера и источника случайности.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

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

Возвращает объект AlgorithmParameterGenerator для того, чтобы генерировать ряд параметров, которые будут использоваться с указанным алгоритмом.

Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект AlgorithmParameterGenerator инкапсуляция реализации AlgorithmParameterGeneratorSpi от первого Провайдера, который поддерживает указанный алгоритм.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - имя алгоритма этот генератор параметра связывается с. См. раздел AlgorithmParameterGenerator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

Возвраты:

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

Броски:

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

См. Также:

Provider

getInstance

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

Возвращает объект AlgorithmParameterGenerator для того, чтобы генерировать ряд параметров, которые будут использоваться с указанным алгоритмом.

Возвращается новый объект AlgorithmParameterGenerator инкапсуляция реализации AlgorithmParameterGeneratorSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - имя алгоритма этот генератор параметра связывается с. См. раздел AlgorithmParameterGenerator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - имя строки Провайдера.

Возвраты:

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

Броски:

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

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

IllegalArgumentException - если имя провайдера является нулем или пустой.

См. Также:

Provider

getInstance

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

Возвращает объект AlgorithmParameterGenerator для того, чтобы генерировать ряд параметров, которые будут использоваться с указанным алгоритмом.

Возвращается новый объект AlgorithmParameterGenerator инкапсуляция реализации AlgorithmParameterGeneratorSpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.

Параметры:

algorithm - имя строки алгоритма этот генератор параметра связывается с. См. раздел AlgorithmParameterGenerator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - объект Провайдера.

Возвраты:

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

Броски:

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

IllegalArgumentException - если указанный провайдер является нулем.

С тех пор:

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.