Класс Provider.Service

public static class Provider.Service
extends Object

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

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

Этот класс определяет методы supportsParameter() и newInstance(), которые используются фреймворком безопасности Java при поиске подходящих служб и создании их экземпляров. Допустимые аргументы для этих методов зависят от типа службы. Для типов служб, определенных в Java SE, см. спецификацию и справочник по API архитектуры Java Cryptography для допустимых значений. Обратите внимание, что компоненты за пределами Java SE могут определять дополнительные типы служб и их поведение.

Экземпляры этого класса неизменяемы.

Подробное описание конструкторов

Service

public Service(Provider provider,
               String type,
               String algorithm,
               String className,
               List<String> aliases,
               Map<String,String> attributes)

Создать новую службу.

Параметры:

provider - поставщик, который предлагает эту службу

type - тип этой службы

algorithm - имя алгоритма

className - имя класса, реализующего эту службу

aliases - Список псевдонимов или null, если алгоритм не имеет псевдонимов

attributes - Карта атрибутов или null, если эта реализация не имеет атрибутов

Исключения:

NullPointerException - если provider, type, algorithm или className равны null

Подробное описание методов

getType

public final String getType()

Получить тип этой службы. Например, MessageDigest.

Возвращает:

тип этой службы

getAlgorithm

public final String getAlgorithm()

Возвращает имя алгоритма этой службы. Например, SHA-1.

Возвращает:

алгоритм этой службы

getProvider

public final Provider getProvider()

Возвращает Provider этой службы.

Возвращает:

Provider этой службы

getClassName

public final String getClassName()

Возвращает имя класса, реализующего эту службу.

Возвращает:

имя класса, реализующего эту службу

getAttribute

public final String getAttribute(String name)

Возвращает значение указанного атрибута или null, если этот атрибут не установлен для этой службы.

Параметры:

name - имя запрашиваемого атрибута

Возвращает:

значение указанного атрибута или null, если атрибут отсутствует

Исключения:

NullPointerException - если name равно null

newInstance

public Object newInstance(Object constructorParameter)
                   throws NoSuchAlgorithmException

Параметры:

constructorParameter - значение для передачи конструктору или null, если этот тип службы не использует constructorParameter.

Возвращает:

новая реализация этой службы

Исключения:

InvalidParameterException - если значение constructorParameter недействительно для этого типа службы.

NoSuchAlgorithmException - если создание экземпляра завершилось неудачей по любой другой причине.

supportsParameter

public boolean supportsParameter(Object parameter)

Параметры:

parameter - параметр для проверки

Возвращает:

false, если эта служба не может использовать указанный параметр; true, если она может потенциально использовать параметр

Исключения:

InvalidParameterException - если значение параметра недействительно для этого типа службы или если этот метод не может использоваться с этим типом службы

toString

public String toString()

Возвращает строковое представление этой службы.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этой службы.