当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

KeySelector (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。