Интерфейс 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));
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Data |
dereference |
Дескрипция KeyInfo информации, на которую ссылается этот RetrievalMethod и применяет указанные Transform. |
List<Transform> |
getTransforms() |
|
String |
getURI() |
Возвращает URI ссылаемой KeyInfo информации. |
Методы, объявленные в интерфейсе javax.xml.crypto.URIReference
getType
Методы, объявленные в интерфейсе javax.xml.crypto.XMLStructure
isFeatureSupported
Подробное описание методов
getTransforms
List<Transform> getTransforms()
- Возвращает:
- неизменяемый список объектов
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- еслиcontextnull -
URIReferenceException- если произошла ошибка при дескрипции
© 1993, 2021, 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/17/docs/api/java.xml.crypto/javax/xml/crypto/dsig/keyinfo/RetrievalMethod.html