javax.xml.crypto

接口
类
异常

javax.xml.crypto
类 KeySelector

java.lang.Object
  继承者 javax.xml.crypto.KeySelector

public abstract class KeySelector
     

      extends 
      Object

一个选择器，可使用 KeyInfo 对象中包含的数据查找并返回某个密钥。此类实现的一个示例是：搜索与 KeyInfo 中所含信息相匹配的受信任密钥的 KeyStore。

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

从以下版本开始：
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
尝试查找满足指定约束的密钥。

参数：
keyInfo - 一个 KeyInfo（可以为 null）
purpose - 密钥的用途（ KeySelector.Purpose.SIGN、 KeySelector.Purpose.VERIFY、 KeySelector.Purpose.ENCRYPT 或 KeySelector.Purpose.DECRYPT）
method - 使用此密钥的算法方法。应该只返回与算法兼容且满足指定算法的约束条件的密钥。
context - 可能包含对查找某一适当密钥有用的信息的 XMLCryptoContext。如果此密钥选择器支持解析 RetrievalMethod 类型，则选择器应该使用上下文的 baseURI 和 dereferencer 参数（如果指定）来解析 URI，并取消对 URI 的引用。
返回：
密钥选择器的结果
抛出：
KeySelectorException - 如果试图查找某个密钥时发生异常条件。注意，无法查找密钥不被视为异常（在这种情况下，应该返回 null）。但是，阻止 KeySelector 查找某个可能密钥的错误条件（例如：网络通讯失败）应被视为异常。
ClassCastException - 如果 method 的数据类型不受此密钥选择器支持。

singletonKeySelector

public static KeySelector singletonKeySelector(Key key)
返回一个总是选择指定密钥的 KeySelector，不管传递给它的 KeyInfo 是什么。

参数：
key - 将存储到密钥选择器中的单独密钥
返回：
总是选择指定密钥的密钥选择器
抛出：
NullPointerException - 如果 key 为 null