Класс KeySelector

java.lang.Object

javax.xml.crypto.KeySelector

public abstract class KeySelector extends Object

Селектор, который находит и возвращает ключ, используя данные, содержащиеся в объекте KeyInfo. Примером реализации этого класса может служить поиск в KeyStore надёжных ключей, которые соответствуют информации, содержащейся в KeyInfo.

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

Since:: 1.6

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`KeySelector.Purpose`	Назначение ключа, который должен быть выбран.

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

KeySelector()

Модификатор	Конструктор	Описание
`protected`	Конструктор по умолчанию без аргументов; предназначен только для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`abstract KeySelectorResult`	`select(KeyInfo keyInfo, KeySelector.Purpose purpose, AlgorithmMethod method, XMLCryptoContext context)`	Попытка найти ключ, удовлетворяющий указанным ограничениям.
`static KeySelector`	`singletonKeySelector(Key key)`	Возвращает `KeySelector`, который всегда выбирает указанный ключ, независимо от `KeyInfo`.

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

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

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

KeySelector

protected KeySelector()

Конструктор по умолчанию без аргументов; предназначен только для вызова подклассами.

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

select

public abstract KeySelectorResult select(KeyInfo keyInfo, KeySelector.Purpose purpose, AlgorithmMethod method, XMLCryptoContext context) throws KeySelectorException

Попытка найти ключ, удовлетворяющий указанным ограничениям.

Parameters:: keyInfo - a KeyInfo (may be null); purpose - назначение ключа (KeySelector.Purpose.SIGN, KeySelector.Purpose.VERIFY, KeySelector.Purpose.ENCRYPT или KeySelector.Purpose.DECRYPT); method - метод алгоритма, для которого будет использоваться этот ключ. Должны возвращаться только ключи, совместимые с алгоритмом и соответствующие ограничениям указанного алгоритма.; context - контекст, который может содержать полезную информацию для поиска подходящего ключа. Если этот селектор поддерживает разрешение типов RetrievalMethod, параметры baseURI и dereferencer контекста (если указаны) должны использоваться селектором для разрешения и дериференции URI.
Returns:: результат работы селектора ключей
Throws:: KeySelectorException - если при попытке найти ключ возникает исключительная ситуация. Отсутствие ключа не считается исключением (должен быть возвращен null). Однако, ошибка (например, ошибка сетевого соединения), которая помешала KeySelector найти потенциальный ключ, должна рассматриваться как исключение.; ClassCastException - если тип данных method не поддерживается этим селектором ключей

singletonKeySelector

public static KeySelector singletonKeySelector(Key key)

Возвращает KeySelector, который всегда выбирает указанный ключ, независимо от KeyInfo.

Parameters:: key - единственный ключ, который должен быть сохранён в селекторе ключей
Returns:: селектор ключей, который всегда выбирает указанный ключ
Throws:: NullPointerException - если key является null

© 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.xml.crypto/javax/xml/crypto/KeySelector.html