javax.xml.crypto.dsig.keyinfo

Интерфейсный KeyInfo

Все Суперинтерфейсы:

XMLStructure

public interface KeyInfo
extends XMLStructure

Представление XML KeyInfo элемент как определено в Рекомендации W3C для Синтаксиса XML-подписи и Обработки. A KeyInfo содержит список XMLStructures, каждый из которых содержат информацию, которая позволяет получателю (ям) получить ключ, должен был проверить 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>
 

A KeyInfo экземпляр может быть создан, вызывая один из newKeyInfo методы KeyInfoFactory класс, и передача этого список один или больше XMLStructures и дополнительный параметр идентификатора; например:

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

KeyInfo объекты могут также быть упорядочены к XML, вызывая marshal метод.

С тех пор:

1.6

См. Также:

KeyInfoFactory.newKeyInfo(List), KeyInfoFactory.newKeyInfo(List, String)

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Список	getContent() Возвраты unmodifiable list содержа ключевую информацию.
Строка	getId() Возвратите дополнительный атрибут Идентификатора этого KeyInfo, который может быть полезным для ссылки на это KeyInfo от других структур XML.
void	marshal(XMLStructure parent, XMLCryptoContext context) Упорядочивает ключевую информацию к XML.

Методы, наследованные от интерфейса javax.xml.crypto. XMLStructure

isFeatureSupported

Деталь метода

getContent

List getContent()

Возвраты unmodifiable list содержа ключевую информацию. Каждая запись списка XMLStructure.

Если есть общедоступный подкласс, представляющий тип XMLStructure, это возвращается как экземпляр того класса (исключая: X509Data элемент был бы возвращен как экземпляр X509Data).

Возвраты:

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

getId

String getId()

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

Возвраты:

атрибут Идентификатора этого KeyInfo (может быть null если не определенный)

упорядочить

void marshal(XMLStructure parent,
           XMLCryptoContext context)
             throws MarshalException

Упорядочивает ключевую информацию к XML.

Параметры:

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

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

Броски:

ClassCastException - если тип parent или context не является совместимым с этой ключевой информацией

MarshalException - если ключевая информация не может быть упорядочена

NullPointerException - если parent null