Интерфейс 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`, на которую дана ссылка.

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

getType

Методы, объявленные в интерфейсе 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml.crypto/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.html