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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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.