public static interface

XMLSignature.SignatureValue

implements XMLStructure
javax.xml.crypto.dsig.XMLSignature.SignatureValue

Class Overview

A representation of the XML SignatureValue element as defined in the W3C Recommendation for XML-Signature Syntax and Processing. The XML Schema Definition is defined as:

   <element name="SignatureValue" type="ds:SignatureValueType"/>
     <complexType name="SignatureValueType">
       <simpleContent>
         <extension base="base64Binary">
           <attribute name="Id" type="ID" use="optional"/>
         </extension>
       </simpleContent>
     </complexType>
 

Summary

Public Methods
abstract String getId()
Returns the optional Id attribute of this SignatureValue, which permits this element to be referenced from elsewhere.
abstract byte[] getValue()
Returns the signature value of this SignatureValue.
abstract boolean validate(XMLValidateContext validateContext)
Validates the signature value.
[Expand]
Inherited Methods
From interface javax.xml.crypto.XMLStructure

Public Methods

public abstract String getId ()

Returns the optional Id attribute of this SignatureValue, which permits this element to be referenced from elsewhere.

Returns
  • the Id attribute (may be null if not specified)

public abstract byte[] getValue ()

Returns the signature value of this SignatureValue.

Returns
  • the signature value (may be null if the XMLSignature has not been signed yet). Each invocation of this method returns a new clone of the array to prevent subsequent modification.

public abstract boolean validate (XMLValidateContext validateContext)

Validates the signature value. This method performs a cryptographic validation of the signature calculated over the SignedInfo of the XMLSignature.

This method only validates the signature the first time it is invoked. On subsequent invocations, it returns a cached result.

Parameters
validateContext the validating context
Returns
  • true if the signature was validated successfully; false otherwise
Throws
NullPointerException if validateContext is null
XMLSignatureException if an unexpected exception occurs while validating the signature