Класс KeySelector

java.lang.Object

javax.xml.crypto.KeySelector

public abstract class KeySelector extends Object

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

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

Начиная с:: 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`.

Методы, объявленные в классе 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

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

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

singletonKeySelector

public static KeySelector singletonKeySelector(Key key)

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

Параметры:: key — единственный ключ, который будет храниться в селекторе ключей
Возвращает:: селектор ключей, всегда выбирающий указанный ключ
Исключения:: NullPointerException — если key является null

© 1993, 2025, 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/25/docs/api/java.xml.crypto/javax/xml/crypto/KeySelector.html