Интерфейс 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

Модификатор и тип	Метод	Описание
`String`	`getType()`	Возвращает тип данных, на которые ссылается этот URI.

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

isFeatureSupported

Модификатор и тип	Метод	Описание
`boolean`	`isFeatureSupported(String feature)`	Показывает, поддерживается ли указанная функция.

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

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.