javax.xml.crypto.dsig
인터페이스 Reference

모든 슈퍼 인터페이스:

URIReference , XMLStructure

public interface Reference
extends URIReference , XMLStructure 

「W3C Recommendation for XML-Signature Syntax and Processing 」로 정의되고 있는 XML Reference 요소의 표현. XML schema는, 다음과 같이 정의됩니다.

 <element name="Reference" type="ds:ReferenceType"/>
 <complexType name="ReferenceType">
   <sequence>
     <element ref="ds:Transforms" minOccurs="0"/>
     <element ref="ds:DigestMethod"/>
     <element ref="ds:DigestValue"/>
   </sequence>
   <attribute name="Id" type="ID" use="optional"/>
   <attribute name="URI" type="anyURI" use="optional"/>
   <attribute name="Type" type="anyURI" use="optional"/>
 </complexType>

 <element name="DigestValue" type="ds:DigestValueType"/>
 <simpleType name="DigestValueType">
   <restriction base="base64Binary"/>
 </simpleType>
 

　

Reference 인스턴스는,XMLSignatureFactory 클래스의 newReference 메소드의 1 개를 호출하는 것으로 작성됩니다. 다음에 예를 나타냅니다.

   XMLSignatureFactory factory = XMLSignatureFactory.getInstance("DOM");
   Reference ref = factory.newReference
     ("http://www.ietf.org/rfc/rfc3275.txt", 
        factory.newDigestMethod(DigestMethod.SHA1, null));
 

도입된 버젼:

1.6

관련 항목:

XMLSignatureFactory.newReference(String, DigestMethod) , XMLSignatureFactory.newReference(String, DigestMethod, List, String, String)

메소드의 개요

byte[]	getCalculatedDigestValue () 검증 조작의 나중에, 이 Reference 의 계산된 다이제스트치를 돌려줍니다.
Data	getDereferencedData () 참조 캐쉬가 유효한 경우, 간접 참조된 데이터를 돌려줍니다.
InputStream	getDigestInputStream () 참조 캐쉬가 유효한 경우, 사전 다이제스트 된 입력 스트림을 돌려줍니다.
DigestMethod	getDigestMethod () 이 Reference 의 다이제스트 메소드를 돌려줍니다.
byte[]	getDigestValue () 이 Reference 의 다이제스트치를 돌려줍니다.
String	getId () 이 Reference 의 생략 가능한 Id 속성을 돌려주어, 다른 장소로부터 이 참조가 참조되는 것을 허가합니다.
List	getTransforms () 이 Reference 에 포함되고 있는 Transform 의변경 불가능한 리스트 를 돌려줍니다.
boolean	validate (XMLValidateContext validateContext) 이 참조를 검증합니다.

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

getType , getURI

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

isFeatureSupported

메소드의 상세

getTransforms

List  getTransforms()

이 Reference 에 포함되고 있는 Transform 의변경 불가능한 리스트 를 돌려줍니다.

반환값:

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

getDigestMethod

DigestMethod  getDigestMethod()

이 Reference 의 다이제스트 메소드를 돌려줍니다.

반환값:

다이제스트 메소드

getId

String  getId()

이 Reference 의 생략 가능한 Id 속성을 돌려주어, 다른 장소로부터 이 참조가 참조되는 것을 허가합니다.

반환값:

Id 속성. 지정되지 않은 경우는 null 도 가능.

getDigestValue

byte[] getDigestValue()

이 Reference 의 다이제스트치를 돌려줍니다.

반환값:

raw 다이제스트치, 또는 이 참조가 다이제스트되어 있지 않은 경우는 null. 이 메소드의 각 호출은, 이후의 변경으로부터 보호하기 위해서, 새로운 클론을 돌려줍니다

getCalculatedDigestValue

byte[] getCalculatedDigestValue()

검증 조작의 나중에, 이 Reference 의 계산된 다이제스트치를 돌려줍니다. 이 메소드는, 참조가 검증에 실패했을 경우의 디버그에 편리합니다.

반환값:

계산된 다이제스트치, 또는 이 참조가 검증되어 있지 않은 경우는 null. 이 메소드의 각 호출은, 이후의 변경으로부터 보호하기 위해서, 새로운 클론을 돌려줍니다

validate

boolean validate(XMLValidateContext  validateContext)
                 throws XMLSignatureException 

이 참조를 검증합니다. 이 메소드는, 이 참조의 다이제스트를 검증합니다. 　

이 메소드는 참조가 최초로 불려 갔을 때 마셔 검증합니다. 다음번 이후의 호출에서는, 캐쉬된 결과를 돌려줍니다.

파라미터:

validateContext - 검증하는 문맥

반환값:

이 참조가 정상적으로 검증되었을 경우는 true. 그렇지 않은 경우는 false

예외:

NullPointerException - validateContext 가 null 의 경우

XMLSignatureException - 참조의 검증중에 예상외의 예외가 발생했을 경우

getDereferencedData

Data  getDereferencedData()

참조 캐쉬가 유효한 경우, 간접 참조된 데이터를 돌려줍니다. 이것은, 검증중 또는 생성 처리중에 이 참조의 URI 를 간접 참조한 결과입니다.

반환값:

간접 참조된 데이터, 또는 캐쉬가 유효하지 않은 경우 또는 이 참조가 생성 또는 검증되어 있지 않은 경우는 null

getDigestInputStream

InputStream  getDigestInputStream()

참조 캐쉬가 유효한 경우, 사전 다이제스트 된 입력 스트림을 돌려줍니다. 이것은, 검증중 또는 서명 처리중의 다이제스트 처리에 대한 입력입니다.

반환값:

사전 다이제스트 된 입력을 포함한 입력 스트림, 또는 또는 캐쉬가 유효하지 않은 경우 또는 이 참조가 생성 또는 검증되어 있지 않은 경우는 null