javax.xml.crypto.dsig.keyinfo
인터페이스 RetrievalMethod

모든 슈퍼 인터페이스:

URIReference , XMLStructure

public interface RetrievalMethod
extends URIReference , XMLStructure 

「W3C Recommendation for XML-Signature Syntax and Processing 」으로 정의되고 있는 XML RetrievalMethod 요소의 표현. RetrievalMethod 객체는, 다른 장소에 포함되고 있는 KeyInfo 정보에의 참조를 송신하기 위해서 사용됩니다. XML schema 정의는, 다음과 같이 정의됩니다.

   <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 인스턴스는,KeyInfoFactory 클래스의 newRetrievalMethod 메소드의 1 개를 호출해, KeyInfo 의 위치를 식별하는 URI, KeyInfo 의 형태를 식별하는 생략 가능한 형태 URI, 및 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 에 의해 참조되는 KeyInfo 정보를 간접 참조해, 지정한 Transform 를 적용합니다.
List	getTransforms () 이 RetrievalMethod Transform 의변경 불가능한 리스트 를 돌려줍니다.
String	getURI () 참조된 KeyInfo 정보의 URI 를 돌려줍니다.

인터페이스 javax.xml.crypto. URIReference 로부터 상속된 메소드

getType

인터페이스 javax.xml.crypto. XMLStructure 로부터 상속된 메소드

isFeatureSupported

메소드의 상세

getTransforms

List  getTransforms()

이 RetrievalMethod Transform 의변경 불가능한 리스트 를 돌려줍니다.

반환값:

Transform 객체의 변경 불가능한 리스트. 빈 상태(empty)에서 만나도 괜찮지만,null 는 되지 않는다

getURI

String  getURI()

참조된 KeyInfo 정보의 URI 를 돌려줍니다.

정의:

인터페이스 URIReference 내의 getURI

반환값:

RFC 2396 형식의, 참조된 KeyInfo 정보의 URI . null 는 되지 않는다

dereference

Data  dereference(XMLCryptoContext  context)
                 throws URIReferenceException 

이 RetrievalMethod 에 의해 참조되는 KeyInfo 정보를 간접 참조해, 지정한 Transform 를 적용합니다.

파라미터:

context - XMLCryptoContext 에는, URI 를 간접 참조하는데 유익한 정보가 포함되어 있는 경우가 있습니다. 문맥의 baseURI 및 dereferencer 파라미터 (지정되었을 경우)가 사용되어, 이 RetrievalMethod 의 해결 및 간접 참조에 사용됩니다.

반환값:

이 RetrievalMethod 에 의해 참조된다 KeyInfo 정보의 raw 컨텐츠를 표현한다 Data 객체. 반환된 데이터를 적절한 KeyInfo 객체로 변환하는 것은 호출측의 책임입니다.

예외:

NullPointerException - context 가 null 의 경우

URIReferenceException - 간접 참조동안에 에러가 발생했을 경우