Класс KeySelector

java.lang.Object
- javax.xml.crypto.KeySelector

public abstract class KeySelector
extends Object

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

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

Since:: 1.6

Вложенные классы

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

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

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

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

Модификатор и тип	Метод	Описание
`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 - KeyInfo (может быть 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