- All Superinterfaces:
XMLStructure
- Enclosing interface:
- XMLSignature
public static interface XMLSignature.SignatureValue extends XMLStructure
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>
-
Method Summary
Modifier and Type Method Description String
getId()
Returns the optionalId
attribute of thisSignatureValue
, which permits this element to be referenced from elsewhere.byte[]
getValue()
Returns the signature value of thisSignatureValue
.boolean
validate(XMLValidateContext validateContext)
Validates the signature value.Methods declared in interface javax.xml.crypto.XMLStructure
isFeatureSupported
-
Method Details
-
getId
String getId()Returns the optionalId
attribute of thisSignatureValue
, which permits this element to be referenced from elsewhere.- Returns:
- the
Id
attribute (may benull
if not specified)
-
getValue
byte[] getValue()Returns the signature value of thisSignatureValue
.- Returns:
- the signature value (may be
null
if theXMLSignature
has not been signed yet). Each invocation of this method returns a new clone of the array to prevent subsequent modification.
-
validate
Validates the signature value. This method performs a cryptographic validation of the signature calculated over theSignedInfo
of theXMLSignature
.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
- ifvalidateContext
isnull
XMLSignatureException
- if an unexpected exception occurs while validating the signature
-