javax.xml.crypto

Класс KeySelector

java.lang. Объект

javax.xml.crypto. KeySelector

public abstract class KeySelector
extends Object

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

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

С тех пор:

1.6

Вложенная Сводка Класса

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

Модификатор и Тип	Класс и Описание
static class	KeySelector. Цель Цель ключа, который должен быть выбран.

Сводка конструктора

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

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

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
abstract KeySelectorResult	select(KeyInfo keyInfo, KeySelector.Purpose purpose, AlgorithmMethod method, XMLCryptoContext context) Попытки найти ключ, который удовлетворяет указанные ограничения.
static KeySelector	singletonKeySelector(Key key) Возвраты a KeySelector это всегда выбирает указанный ключ, независимо от KeyInfo переданный к этому.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

KeySelector

protected KeySelector()

Значение по умолчанию никакой-args конструктор; предназначенный для вызова подклассами только.

Деталь метода

выбрать

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 - XMLCryptoContext это может содержать полезную информацию для того, чтобы найти соответствующий ключ. Если этот ключевой селектор поддерживает разрешение RetrievalMethod типы, контекст baseURI и dereferencer параметры (если определено) должны использоваться селектором, чтобы разрешить и разыменовать URI.

Возвраты:

результат ключевого селектора

Броски:

KeySelectorException - если исключительное условие происходит, пытаясь найти ключ. Отметьте, что неспособность найти ключ не считают исключением (null должен быть возвращен в этом случае). Однако, состояние ошибки (исключая: отказ сетевых коммуникаций), который предотвратил KeySelector от обнаружения потенциального ключа должен считаться исключением.

ClassCastException - если тип данных method не поддерживается этим ключевым селектором

singletonKeySelector

public static KeySelector singletonKeySelector(Key key)

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

Параметры:

key - единственный ключ, который будет сохранен в ключевом селекторе

Возвраты:

ключевой селектор, который всегда выбирает указанный ключ

Броски:

NullPointerException - если key null