Интерфейс 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, и необязательный список Transforms; например:

   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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml.crypto/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.html