Класс Provider.Service

java.lang.Object

java.security.Provider.Service

Вложенный класс:: Provider

public static class Provider.Service extends Object

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

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

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

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

С:: 1.5

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

Конструктор	Описание
`Service(Provider provider, String type, String algorithm, String className, List<String> aliases, Map<String,String> attributes)`	Создаёт новую службу.

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

Модификатор и тип	Метод	Описание
`final String`	`getAlgorithm()`	Возвращает имя алгоритма этой службы.
`final String`	`getAttribute(String name)`	Возвращает значение указанного атрибута или `null` если этот атрибут не задан для этой службы.
`final String`	`getClassName()`	Возвращает имя класса, реализующего эту службу.
`final Provider`	`getProvider()`	Возвращает поставщика этой службы.
`final String`	`getType()`	Получить тип этой службы.
`Object`	`newInstance(Object constructorParameter)`	Возвращает новый экземпляр реализации, описанной этой службой.
`boolean`	`supportsParameter(Object parameter)`	Проверка, может ли эта служба использовать указанный параметр.
`String`	`toString()`	Возвращает `String` представление этой службы.

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

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

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

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 - если поставщик, тип, алгоритм или имя класса являются null

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

getType

public final String getType()

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

Возвращает:: тип этой службы

getAlgorithm

public final String getAlgorithm()

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

Возвращает:: алгоритм этой службы

getProvider

public final Provider getProvider()

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

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

getClassName

public final String getClassName()

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

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

getAttribute

public final String getAttribute(String name)

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

Параметры:: name - имя запрашиваемого атрибута
Возвращает:: значение указанного атрибута или null если атрибут отсутствует
Исключения:: NullPointerException - если имя является null

newInstance

public Object newInstance(Object constructorParameter) throws NoSuchAlgorithmException

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

По умолчанию используется рефлексия для вызова стандартного конструктора для этого типа службы. Поставщики безопасности могут переопределить этот метод, чтобы реализовать инициализацию другим способом. Для получения подробностей и значений constructorParameter, которые являются допустимыми для различных типов служб, см. Руководство по архитектуре Java Cryptography (JCA).

Параметры:: constructorParameter - значение, которое нужно передать в конструктор, или null если этот тип службы не использует constructorParameter.
Возвращает:: новая реализация этой службы
Исключения:: InvalidParameterException - если значение constructorParameter неверно для этого типа службы.; NoSuchAlgorithmException - если инициализация не удалась по любой другой причине.

supportsParameter

public boolean supportsParameter(Object parameter)

Проверка, может ли эта служба использовать указанный параметр. Возвращает false если эта служба не может использовать параметр. Возвращает true если эта служба может использовать параметр, если быстрая проверка невозможна, или если статус неизвестен.

Фреймворк поставщика безопасности использует этот метод с некоторыми типами служб для быстрого исключения несоответствующих реализаций из рассмотрения. Приложениям обычно не нужно его вызывать.

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

Параметры:: parameter - параметр для проверки
Возвращает:: false если эта служба не может использовать указанный параметр; true если она может, возможно, использовать параметр
Исключения:: InvalidParameterException - если значение параметра недопустимо для этого типа службы или если этот метод не может быть использован с этим типом службы

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: a String представление этой службы.

© 1993, 2023, 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/21/docs/api/java.base/java/security/Provider.Service.html