模块 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

嵌套类汇总

嵌套类

变量和类型	类	描述
static class	KeySelector.Purpose	要选择的密钥的目的。

构造方法摘要

构造方法

变量	构造器	描述
protected	KeySelector()	默认的no-args构造函数; 仅供子类调用。

方法摘要

变量和类型	方法	描述
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()

默认的no-args构造函数; 仅供子类调用。

方法详细信息

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参数（如果指定）来解析和取消引用URI。

结果

键选择器的结果

异常

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

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

singletonKeySelector

public static KeySelector singletonKeySelector(Key key)

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

参数

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

结果

一个始终选择指定键的键选择器

异常

NullPointerException - if key is null