模块 java.xml.crypto
包 javax.xml.crypto.dsig.keyinfo

接口 KeyInfo

所有父级接口：
XMLStructure
public interface KeyInfo extends XMLStructure
W3C 对 XML 签名语法和处理的推荐 中定义的 XML KeyInfo 元素的表示。 KeyInfo 包含一个 XMLStructure 列表，每个列表都包含使接收者能够获得验证 XML 签名所需的密钥的信息。 XML Schema Definition 被定义为：例如： 
  KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
  KeyInfo keyInfo = factory.newKeyInfo
   (Collections.singletonList(factory.newKeyName("Alice"), "keyinfo-1"));

KeyInfo 对象也可以通过调用 marshal 方法编组为 XML。

自从：
1.6
参见：

  • 方法详情

    • getContent

      List <XMLStructure > getContent()
      返回包含密钥信息的unmodifiable list 。列表的每个条目都是一个 XMLStructure 。

      如果有表示 XMLStructure 类型的公共子类，则它作为该类的实例返回（例如：X509Data 元素将作为 X509Data 的实例返回）。

      返回：
      此 KeyInfo 中一个或多个 XMLStructure 的不可修改列表。从不返回 null 或空列表。

    • getId

      String  getId()
      返回此 KeyInfo 的可选 Id 属性，这对于从其他 XML 结构中引用此 KeyInfo 可能很有用。
      返回：
      此 KeyInfo 的 Id 属性（如果未指定，则可能是 null）

    • marshal

      void marshal(XMLStructure  parent, XMLCryptoContext  context) throws MarshalException
      将关键信息编组为 XML。
      参数：
      parent - 特定于机制的结构，包含编组密钥信息将附加到的父节点
      context - 包含附加上下文的 XMLCryptoContext（如果不适用则可能为 null）
      抛出：
      ClassCastException - 如果 parent 或 context 的类型与此密钥信息不兼容
      MarshalException - 如果无法编组关键信息
      NullPointerException - 如果 parent 是 null