Module java.xml.crypto

软件包 javax.xml.crypto

Class KeySelector

java.lang.Object

javax.xml.crypto.KeySelector

public abstract class KeySelector
extends Object

使用KeyInfo对象中包含的数据查找并返回键的选择器。 这个类的实现的一个例子就是，搜索一个KeyStore相匹配包含的信息信任密钥KeyInfo 。

返回的密钥是否被信任，用于确定返回的密钥是实现特定的机制。

从以下版本开始：

1.6

Nested Class Summary

Nested Classes

Modifier and Type	Class	描述
static class	KeySelector.Purpose	要选择的键的目的。

构造方法摘要

构造方法

Modifier	Constructor	描述
protected	KeySelector()	默认的无参数构造函数; 仅供子类调用。

方法摘要

Modifier and Type	方法	描述
abstract KeySelectorResult	select(KeyInfo keyInfo, KeySelector.Purpose purpose, AlgorithmMethod method, XMLCryptoContext context)	尝试找到满足指定约束的键。
static KeySelector	singletonKeySelector(Key key)	返回一个 KeySelector ，总是选择指定的键，而不管传递给它的是什么 KeyInfo 。

Methods inherited from class 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 - 一个XMLCryptoContext ，其中可能包含用于查找适当键的有用信息。 如果此密钥选择器支持解析RetrievalMethod类型，则选择器应使用上下文的baseURI和dereferencer参数（如果指定）来解析dereferencer引用URI。

结果

键选择器的结果

异常

KeySelectorException - 如果尝试找到密钥时发生异常情况。 请注意，无法找到密钥不被视为异常（在这种情况下应返回null ）。 然而，阻止KeySelector找到潜在密钥的错误状况（例如：网络通信故障）应被视为异常。

ClassCastException - 如果此键选择器不支持 method的数据类型

singletonKeySelector

public static KeySelector singletonKeySelector(Key key)

返回 KeySelector总是选择指定密钥，不管的 KeyInfo传递给它。

参数

key - 要存储在钥匙选择器中的唯一钥匙

结果

一个总是选择指定键的键选择器

异常

NullPointerException - if key is null