Spec-Zone .ru
спецификации, руководства, описания, API
|
public class AlgorithmParameters extends Object
AlgorithmParameters
объект для того, чтобы управлять параметрами для определенного алгоритма может быть получен, вызывая один из getInstance
методы фабрики (статические методы, которые возвращают экземпляры данного class).
Однажды AlgorithmParameters
объект получается, он должен быть инициализирован через звонок init
, использование соответствующей спецификации параметра или кодирование параметра.
Прозрачная спецификация параметра получается из AlgorithmParameters
объект через звонок getParameterSpec
, и кодирование байта параметров получается через звонок getEncoded
.
Каждая реализация платформы Java обязана поддерживать следующий стандарт AlgorithmParameters
алгоритмы:
AlgorithmParameterSpec
, DSAParameterSpec
, KeyPairGenerator
Модификатор | Конструктор и Описание |
---|---|
protected |
AlgorithmParameters(AlgorithmParametersSpi paramSpi, Provider provider, String algorithm)
Создает объект AlgorithmParameters.
|
Модификатор и Тип | Метод и Описание |
---|---|
Строка |
getAlgorithm()
Возвращает имя алгоритма, связанного с этим объектом параметра.
|
byte[] |
getEncoded()
Возвращает параметры в их основном формате кодирования.
|
byte[] |
getEncoded(String format)
Возвращает параметры, закодированные в указанной схеме.
|
static AlgorithmParameters |
getInstance(String algorithm)
Возвращает объект параметра для указанного алгоритма.
|
static AlgorithmParameters |
getInstance(String algorithm, Provider provider)
Возвращает объект параметра для указанного алгоритма.
|
static AlgorithmParameters |
getInstance(String algorithm, String provider)
Возвращает объект параметра для указанного алгоритма.
|
<T extends AlgorithmParameterSpec> |
getParameterSpec(Class<T> paramSpec)
Возвращает (прозрачную) спецификацию этого объекта параметра.
|
Провайдер |
getProvider()
Возвращает провайдера этого объекта параметра.
|
void |
init(AlgorithmParameterSpec paramSpec)
Инициализирует этот объект параметра использование параметров, определенных в
paramSpec . |
void |
init(byte[] params)
Импортирует указанные параметры и декодирует их согласно основному формату декодирования для параметров.
|
void |
init(byte[] params, String format)
Импортирует параметры из
params и декодирует их согласно указанной схеме декодирования. |
Строка |
toString()
Возвращает отформатированную строку, описывающую параметры.
|
protected AlgorithmParameters(AlgorithmParametersSpi paramSpi, Provider provider, String algorithm)
paramSpi
- делегатprovider
- провайдерalgorithm
- алгоритмpublic final String getAlgorithm()
public static AlgorithmParameters getInstance(String algorithm) throws NoSuchAlgorithmException
Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект AlgorithmParameters инкапсуляция реализации AlgorithmParametersSpi от первого Провайдера, который поддерживает указанный алгоритм.
Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders()
метод.
Возвращенный объект параметра должен быть инициализирован через звонок init
, использование соответствующей спецификации параметра или кодирование параметра.
algorithm
- имя алгоритма требуют. См. раздел AlgorithmParameters в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.NoSuchAlgorithmException
- если никакой Провайдер не поддерживает реализацию AlgorithmParametersSpi для указанного алгоритма.Provider
public static AlgorithmParameters getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
Возвращается новый объект AlgorithmParameters инкапсуляция реализации AlgorithmParametersSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.
Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders()
метод.
Возвращенный объект параметра должен быть инициализирован через звонок init
, использование соответствующей спецификации параметра или кодирование параметра.
algorithm
- имя алгоритма требуют. См. раздел AlgorithmParameters в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.provider
- имя провайдера.NoSuchAlgorithmException
- если реализация AlgorithmParametersSpi для указанного алгоритма не доступна от указанного провайдера.NoSuchProviderException
- если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.IllegalArgumentException
- если имя провайдера является нулем или пустой.Provider
public static AlgorithmParameters getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
Возвращается новый объект AlgorithmParameters инкапсуляция реализации AlgorithmParametersSpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.
Возвращенный объект параметра должен быть инициализирован через звонок init
, использование соответствующей спецификации параметра или кодирование параметра.
algorithm
- имя алгоритма требуют. См. раздел AlgorithmParameters в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.provider
- имя провайдера.NoSuchAlgorithmException
- если реализация AlgorithmParameterGeneratorSpi для указанного алгоритма не доступна от указанного объекта Провайдера.IllegalArgumentException
- если провайдер является нулем.Provider
public final Provider getProvider()
public final void init(AlgorithmParameterSpec paramSpec) throws InvalidParameterSpecException
paramSpec
.paramSpec
- спецификация параметра.InvalidParameterSpecException
- если данная спецификация параметра является несоответствующей для инициализации этого объекта параметра, или если этот объект параметра был уже инициализирован.public final void init(byte[] params) throws IOException
params
- закодированные параметры.IOException
- при декодировании ошибок, или если этот объект параметра был уже инициализирован.public final void init(byte[] params, String format) throws IOException
params
и декодирует их согласно указанной схеме декодирования. Если format
нуль, основной формат декодирования для параметров используется. Основной формат декодирования является ASN.1, если спецификация ASN.1 для этих параметров существует.params
- закодированные параметры.format
- имя схемы декодирования.IOException
- при декодировании ошибок, или если этот объект параметра был уже инициализирован.public final <T extends AlgorithmParameterSpec> T getParameterSpec(Class<T> paramSpec) throws InvalidParameterSpecException
paramSpec
идентифицирует спецификацию class, в котором должны быть возвращены параметры. Это могло, например, быть DSAParameterSpec.class
, указать, что параметры должны быть возвращены в экземпляре DSAParameterSpec
class.paramSpec
- class спецификации, в котором должны быть возвращены параметры.InvalidParameterSpecException
- если требуемая спецификация параметра является несоответствующей для этого объекта параметра, или если этот объект параметра не был инициализирован.public final byte[] getEncoded() throws IOException
IOException
- при кодировании ошибок, или если этот объект параметра не был инициализирован.public final byte[] getEncoded(String format) throws IOException
format
нуль, основной формат кодирования для параметров используется. Основной формат кодирования является ASN.1, если спецификация ASN.1 для этих параметров существует.format
- имя формата кодирования.IOException
- при кодировании ошибок, или если этот объект параметра не был инициализирован.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92