Класс 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

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

Параметры:: keyInfo - a KeyInfo (может быть null); purpose - цель ключа (KeySelector.Purpose.SIGN, KeySelector.Purpose.VERIFY, KeySelector.Purpose.ENCRYPT или KeySelector.Purpose.DECRYPT); method - метод алгоритма, для которого будет использоваться этот ключ. Должны возвращаться только ключи, совместимые с алгоритмом и соответствующие ограничениям указанного алгоритма.; context - контекст, который может содержать полезную информацию для поиска подходящего ключа. Если этот селектор поддерживает разрешение типов 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://download.java.net/java/early_access/jdk24/docs/api/java.xml.crypto/javax/xml/crypto/KeySelector.html