Интерфейс 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
См. также:: KeyInfoFactory.newRetrievalMethod(String), KeyInfoFactory.newRetrievalMethod(String, String, List)

Методы

Модификатор и тип	Метод	Описание
`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 - если возникла ошибка при деферировании