Интерфейс RetrievalMethod

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

public interface RetrievalMethod
extends URIReference, XMLStructure

Представление XML-элемента, как определено в Рекомендации 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
См. также:: KeyInfoFactory.newRetrievalMethod(String), KeyInfoFactory.newRetrievalMethod(String, String, List)

Методы

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

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

getType

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

isFeatureSupported

Методы

getTransforms

List 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

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

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

© 1993, 2020, 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.