Класс KeySelector

public abstract class KeySelector
extends Object

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

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

Конструкторы

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