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

모든 슈퍼 인터페이스:

XMLStructure

public interface XMLSignature
extends XMLStructure 

「W3C Recommendation for XML-Signature Syntax and Processing 」로 정의되고 있는 XML Signature 요소의 표현. 이 클래스에는, W3C 스펙으로 정의되고 있는, 동작을 포함한 XML 서명의 서명 및 검증용의 메소드를 포함합니다. XML schema 정의는, 다음과 같이 정의됩니다.

 <element name="Signature" type="ds:SignatureType"/>
 <complexType name="SignatureType">
    <sequence> 
      <element ref="ds:SignedInfo"/> 
      <element ref="ds:SignatureValue"/> 
      <element ref="ds:KeyInfo" minOccurs="0"/> 
      <element ref="ds:Object" minOccurs="0" maxOccurs="unbounded"/> 
    </sequence>  
    <attribute name="Id" type="ID" use="optional"/>
 </complexType>
 

XMLSignature 인스턴스는,XMLSignatureFactory 클래스의 newXMLSignature 메소드의 1 개를 호출하는 것으로 작성됩니다. 　

XMLSignature 를 포함하는 기본이 되는 문서의 컨텐츠가, 그 후 변경되었을 경우, 동작은 정의되고 있지 않습니다. 　

이 클래스는, 기존 java.security.Signature 클래스라는 명명에서의 크래쉬를 피하기 (위해)때문에,Signature 는 아니고 XMLSignature 로 이름을 붙일 수 있습니다.

도입된 버젼:

1.6

관련 항목:

XMLSignatureFactory.newXMLSignature(SignedInfo, KeyInfo) , XMLSignatureFactory.newXMLSignature(SignedInfo, KeyInfo, List, String, String)

상자의 클래스의 개요

static interface

XMLSignature.SignatureValue 「W3C Recommendation for XML-Signature Syntax and Processing 」로 정의되고 있는 XML SignatureValue 요소의 표현.

필드의 개요

static String

XMLNS XML 서명 구문 및 처리를 위한 W3C 권고의, XML 이름 공간 URI.

메소드의 개요

String	getId () 이 XMLSignature 의 식별자를 돌려줍니다.
KeyInfo	getKeyInfo () 이 XMLSignature 의 열쇠 정보를 돌려줍니다.
KeySelectorResult	getKeySelectorResult () 지정되었을 경우에는,XMLSignature 가 서명 또는 검증된 후에 KeySelector 의 결과를 돌려줍니다.
List	getObjects () 이 XMLSignature 에 포함되는 XMLObject 의변경 불가능한 리스트 를 돌려줍니다.
XMLSignature.SignatureValue	getSignatureValue () 이 XMLSignature 의 서명치를 돌려줍니다.
SignedInfo	getSignedInfo () 이 XMLSignature 의 서명 정보를 돌려줍니다.
void	sign (XMLSignContext signContext) 이 XMLSignature 에 서명합니다.
boolean	validate (XMLValidateContext validateContext) 코어 검증의 처리 규칙에 따라, 서명을 검증합니다.

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

isFeatureSupported

필드의 상세

XMLNS

static final String  XMLNS

XML 서명 구문 및 처리를 위한 W3C 권고의, XML 이름 공간 URI.

관련 항목:

정수 필드치

메소드의 상세

validate

boolean validate(XMLValidateContext  validateContext)
                 throws XMLSignatureException 

코어 검증의 처리 규칙에 따라, 서명을 검증합니다. 이 메소드는 기존 상태를 사용해 서명을 검증합니다만, 문맥으로 지정된 위치 정보를 사용해 XMLSignature 의 내용을 정렬화하거나 재초기화할 것은 없습니다. 　

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

파라미터:

validateContext - 검증하는 문맥

반환값:

서명이 코어 검증을 패스했을 경우는 true, 그렇지 않은 경우는 false

예외:

ClassCastException - validateContext 의 형태가 이 XMLSignature 와 호환성이 없는 경우

NullPointerException - validateContext 가 null 의 경우

XMLSignatureException - 검증중에 검증 처리를 완료할 수 없게 된다 예상외의 에러가 발생했을 경우

getKeyInfo

KeyInfo  getKeyInfo()

이 XMLSignature 의 열쇠 정보를 돌려줍니다.

반환값:

열쇠 정보. 지정되지 않는 경우는 null 도 가능

getSignedInfo

SignedInfo  getSignedInfo()

이 XMLSignature 의 서명 정보를 돌려줍니다.

반환값:

서명 정보. null 는 되지 않는다

getObjects

List  getObjects()

이 XMLSignature 에 포함되는 XMLObject 의변경 불가능한 리스트 를 돌려줍니다.

반환값:

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

getId

String  getId()

이 XMLSignature 의 식별자를 돌려줍니다.

반환값:

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

getSignatureValue

XMLSignature.SignatureValue  getSignatureValue()

이 XMLSignature 의 서명치를 돌려줍니다.

반환값:

서명치

sign

void sign(XMLSignContext  signContext)
          throws MarshalException ,
                 XMLSignatureException 

이 XMLSignature 에 서명합니다. 　

이 메소드가 예외를 throw 했을 경우, 이 XMLSignature 파라미터 및 signContext 파라미터는 호출해 전 상태와 같은 상태가 됩니다.

파라미터:

signContext - 서명 문맥

예외:

ClassCastException - signContext 의 형태가 이 XMLSignature 와 호환성이 없는 경우

NullPointerException - signContext 가 null 의 경우

MarshalException - 정렬화중에 예외가 발생했을 경우

XMLSignatureException - 서명의 생성중에 예상외의 예외가 발생했을 경우

getKeySelectorResult

KeySelectorResult  getKeySelectorResult()

지정되었을 경우에는,XMLSignature 가 서명 또는 검증된 후에 KeySelector 의 결과를 돌려줍니다.

반환값:

열쇠 셀렉터의 결과. 또는 열쇠 셀렉터가 지정되지 않았던 경우, 또는 이 XMLSignature 가 서명 또는 검증이되어 있지 않은 경우는 null