Интерфейс KeyInfo

public interface KeyInfo
extends XMLStructure

Представление XML-элемента KeyInfo , определённого в рекомендации W3C по синтаксису и обработке XML-подписей. Объект KeyInfo содержит список XMLStructure, каждый из которых содержит информацию, позволяющую получателю(лям) получить ключ для проверки XML-подписи. Определение XML-схемы:

<element name="KeyInfo" type="ds:KeyInfoType"/>
 <complexType name="KeyInfoType" mixed="true">
   <choice maxOccurs="unbounded">
     <element ref="ds:KeyName"/>
     <element ref="ds:KeyValue"/>
     <element ref="ds:RetrievalMethod"/>
     <element ref="ds:X509Data"/>
     <element ref="ds:PGPData"/>
     <element ref="ds:SPKIData"/>
     <element ref="ds:MgmtData"/>
     <any processContents="lax" namespace="##other"/>
     <!-- (1,1) elements from (0,unbounded) namespaces -->
   </choice>
   <attribute name="Id" type="ID" use="optional"/>
 </complexType>

Экземпляр KeyInfo можно создать, вызвав один из методов newKeyInfo класса KeyInfoFactory, передав ему список одного или нескольких XMLStructure и необязательный параметр id; например:

KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
   KeyInfo keyInfo = factory.newKeyInfo
      (Collections.singletonList(factory.newKeyName("Alice"), "keyinfo-1"));

Объекты KeyInfo также можно сериализовать в XML, вызвав метод marshal.

Методы

getContent

List getContent()

Возвращает:

неизменяемый список одного или нескольких XMLStructure в этом KeyInfo. Никогда не возвращает null или пустой список.

getId

String getId()

Возвращает необязательный атрибут Id этого KeyInfo, который может быть полезен для ссылки на этот KeyInfo из других XML-структур.

Возвращает:

атрибут Id этого KeyInfo (может быть null если не указан)

marshal

void marshal(XMLStructure parent,
             XMLCryptoContext context)
      throws MarshalException

Сериализует информацию о ключе в XML.

Параметры:

parent - структура, специфичная для механизма, содержащая родительский узел, к которому будет добавлен сериализованный ключ

context - XMLCryptoContext, содержащий дополнительный контекст (может быть null, если не применимо)

Исключения:

ClassCastException - если тип parent или context несовместим с этим ключом

MarshalException - если ключ нельзя сериализовать

NullPointerException - если parent является null