Интерфейс RetrievalMethod

Все суперинтерфейсы:: URIReference, XMLStructure

public interface RetrievalMethod extends URIReference, XMLStructure

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

   <element name="RetrievalMethod" type="ds:RetrievalMethodType"/>
   <complexType name="RetrievalMethodType">
     <sequence>
       <element name="Transforms" type="ds:TransformsType" minOccurs="0"/>
     </sequence>
     <attribute name="URI" type="anyURI"/>
     <attribute name="Type" type="anyURI" use="optional"/>
   </complexType>

Экземпляр RetrievalMethod может быть создан путём вызова одного из методов newRetrievalMethod класса KeyInfoFactory и передачи ему URI, идентифицирующего расположение KeyInfo, необязательного URI типа KeyInfo и необязательного списка Transform; например:

   KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
   RetrievalMethod rm = factory.newRetrievalMethod
      ("#KeyValue-1", KeyValue.DSA_TYPE, Collections.singletonList(Transform.BASE64));

С тех пор:

1.6

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`Data`	`dereference(XMLCryptoContext context)`	Делегирует `KeyInfo` информацию, на которую ссылается данный `RetrievalMethod` и применяет указанные `Transform`.
`List<Transform>`	`getTransforms()`	Возвращает `unmodifiable list` объектов `Transform` данного `RetrievalMethod`.
`String`	`getURI()`	Возвращает URI ссылаемой `KeyInfo` информации.

Методы, объявленные в интерфейсе javax.xml.crypto.URIReference

getType

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

isFeatureSupported

Подробное описание методов

getTransforms

List<Transform> getTransforms()

Возвращает

unmodifiable
 list

объектов Transform данного RetrievalMethod.

Возвращает:: неизменяемый список объектов Transform (может быть пустым, но никогда null).

getURI

String getURI()

Возвращает URI ссылаемой KeyInfo информации.

Определено в:: getURI в интерфейсе URIReference
Возвращает:: URI ссылаемой KeyInfo информации в формате RFC 2396 (никогда null)

dereference

Data dereference(XMLCryptoContext context) throws URIReferenceException

Делегирует KeyInfo информацию, на которую ссылается данный RetrievalMethod и применяет указанные Transform.

Параметры:: context - контекст XMLCryptoContext, который может содержать дополнительную полезную информацию для делегирования URI. Параметры контекста baseURI и dereferencer (если указаны) используются для разрешения и делегирования этого RetrievalMethod
Возвращает:: объект Data, представляющий сырые данные KeyInfo информации, на которую ссылается данный RetrievalMethod. Ответственность за преобразование возвращенных данных в соответствующий объект KeyInfo лежит на вызывающем коде.
Исключения:: NullPointerException - если context является null; URIReferenceException - если произошла ошибка при делегировании

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.xml.crypto/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.html