Package org.apache.xml.security.signature

Class Manifest

java.lang.Object

org.apache.xml.security.utils.ElementProxy

org.apache.xml.security.utils.SignatureElementProxy

org.apache.xml.security.signature.Manifest

Direct Known Subclasses:

SignedInfo

public class Manifest
extends SignatureElementProxy

Handles <ds:Manifest> elements.

This element holds the Reference elements

Author:

$author: $

Field Summary

Fields inherited from class org.apache.xml.security.utils.ElementProxy

_baseURI, _constructionElement, _doc, _state, MODE_CREATE, MODE_DECRYPT, MODE_ENCRYPT, MODE_PROCESS, MODE_SIGN, MODE_UNKNOWN, MODE_VERIFY

Constructor Summary

Constructors

Constructor	Description
Manifest(Document doc)	Consturts Manifest
Manifest(Element element, String BaseURI)	Constructor Manifest

Method Summary

Modifier and Type	Method	Description
void	addDocument(String BaseURI, String referenceURI, Transforms transforms, String digestURI, String ReferenceId, String ReferenceType)	This addDocument method is used to add a new resource to the signed info.
void	addResourceResolver(ResourceResolver resolver)	Adds Resource Resolver for retrieving resources at specified URI attribute in reference element
void	addResourceResolver(ResourceResolverSpi resolverSpi)	Adds Resource Resolver for retrieving resources at specified URI attribute in reference element
void	generateDigestValues()	The calculation of the DigestValues in the References must be after the References are already added to the document and during the signing process.
String	getBaseLocalName()	Method getBaseLocalName
String	getId()	Returns the Id attribute
int	getLength()	Return the nonnegative number of added references.
XMLSignatureInput	getReferencedContentAfterTransformsItem(int i)	Method getReferencedContentAfterTransformsItem
XMLSignatureInput	getReferencedContentBeforeTransformsItem(int i)	Method getReferencedContentPriorTransformsItem
String	getResolverProperty(String key)	Returns the value at specified key
byte[]	getSignedContentItem(int i)	Method getSignedContentItem
int	getSignedContentLength()	Method getSignedContentLength
boolean	getVerificationResult(int index)	After verifying a Manifest or a SignedInfo using the verifyReferences() or SignedInfo.verify() methods, the individual results can be retrieved with this method.
Reference	item(int i)	Return the ith reference.
void	setId(String Id)	Sets the Id attribute
void	setResolverProperty(String key, String value)	Used to pass parameters like proxy servers etc to the ResourceResolver implementation.
boolean	verifyReferences()	Used to do a reference validation of all enclosed references using the Reference.verify() method.
boolean	verifyReferences(boolean followManifests)	Used to do a reference validation of all enclosed references using the Reference.verify() method.

Methods inherited from class org.apache.xml.security.utils.SignatureElementProxy

getBaseNamespace

Methods inherited from class org.apache.xml.security.utils.ElementProxy

addBase64Element, addBase64Text, addBigIntegerElement, addText, addTextElement, createElementForFamily, getBaseURI, getBigIntegerFromChildElement, getBytesFromChildElement, getBytesFromTextChild, getDefaultPrefix, getDocument, getElement, getElementPlusReturns, getTextFromChildElement, getTextFromTextChild, guaranteeThatElementInCorrectSpace, length, setDefaultPrefix, setElement, setXPathNamespaceContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Manifest

public Manifest(Document doc)

Consturts Manifest

Parameters:

doc - the Document in which XMLsignature is placed

Manifest

public Manifest(Element element,
 String BaseURI)
         throws XMLSecurityException

Constructor Manifest

Parameters:

element -

BaseURI -

Throws:

XMLSecurityException

Method Details

addDocument

public void addDocument(String BaseURI,
 String referenceURI,
 Transforms transforms,
 String digestURI,
 String ReferenceId,
 String ReferenceType)
                 throws XMLSignatureException

This addDocument method is used to add a new resource to the signed info. A Reference is built from the supplied values.

Parameters:

BaseURI - the URI of the resource where the XML instance was stored

referenceURI - URI attribute in Reference for specifing where data is

transforms - org.apache.xml.security.signature.Transforms object with an ordered list of transformations to be performed.

digestURI - The digest algorthim URI to be used.

ReferenceId -

ReferenceType -

Throws:

XMLSignatureException

generateDigestValues

public void generateDigestValues()
                          throws XMLSignatureException,
ReferenceNotInitializedException

The calculation of the DigestValues in the References must be after the References are already added to the document and during the signing process. This ensures that all neccesary data is in place.

Throws:

ReferenceNotInitializedException

XMLSignatureException

getLength

public int getLength()

Return the nonnegative number of added references.

Returns:

the number of references

item

public Reference item(int i)
               throws XMLSecurityException

Return the i^th reference. Valid i values are 0 to {link@ getSize}-1.

Parameters:

i - Index of the requested Reference

Returns:

the i^th reference

Throws:

XMLSecurityException

setId

public void setId(String Id)

Sets the Id attribute

Parameters:

Id - the Id attribute in ds:Manifest

getId

public String getId()

Returns the Id attribute

Returns:

the Id attribute in ds:Manifest

verifyReferences

public boolean verifyReferences()
                         throws MissingResourceFailureException,
XMLSecurityException

Used to do a reference validation of all enclosed references using the Reference.verify() method.

This step loops through all References and does verify the hash values. If one or more verifications fail, the method returns false. If all verifications are successful, it returns true. The results of the individual reference validations are available by using the getVerificationResult(int) method

Returns:

true if all References verify, false if one or more do not verify.

Throws:

MissingResourceFailureException - if a Reference does not verify (throws a ReferenceNotInitializedException because of an uninitialized XMLSignatureInput

XMLSecurityException

See Also:

• Reference.verify()
• SignedInfo.verify()
• MissingResourceFailureException

verifyReferences

public boolean verifyReferences(boolean followManifests)
                         throws MissingResourceFailureException,
XMLSecurityException

Used to do a reference validation of all enclosed references using the Reference.verify() method.

This step loops through all References and does verify the hash values. If one or more verifications fail, the method returns false. If all verifications are successful, it returns true. The results of the individual reference validations are available by using the getVerificationResult(int) method

Parameters:

followManifests -

Returns:

true if all References verify, false if one or more do not verify.

Throws:

MissingResourceFailureException - if a Reference does not verify (throws a ReferenceNotInitializedException because of an uninitialized XMLSignatureInput

XMLSecurityException

See Also:

• Reference.verify()
• SignedInfo.verify(boolean)
• MissingResourceFailureException

getVerificationResult

public boolean getVerificationResult(int index)
                              throws XMLSecurityException

After verifying a Manifest or a SignedInfo using the verifyReferences() or SignedInfo.verify() methods, the individual results can be retrieved with this method.

Parameters:

index - an index of into a Manifest or a SignedInfo

Returns:

the results of reference validation at the specified index

Throws:

XMLSecurityException

addResourceResolver

public void addResourceResolver(ResourceResolver resolver)

Adds Resource Resolver for retrieving resources at specified URI attribute in reference element

Parameters:

resolver - ResourceResolver can provide the implemenatin subclass of ResourceResolverSpi for retrieving resource.

addResourceResolver

public void addResourceResolver(ResourceResolverSpi resolverSpi)

Adds Resource Resolver for retrieving resources at specified URI attribute in reference element

Parameters:

resolverSpi - the implemenatin subclass of ResourceResolverSpi for retrieving resource.

setResolverProperty

public void setResolverProperty(String key,
 String value)

Used to pass parameters like proxy servers etc to the ResourceResolver implementation.

Parameters:

key - the key

value - the value

getResolverProperty

public String getResolverProperty(String key)

Returns the value at specified key

Parameters:

key - the key

Returns:

the value

getSignedContentItem

public byte[] getSignedContentItem(int i)
                            throws XMLSignatureException

Method getSignedContentItem

Parameters:

i -

Returns:

The signed content of the i reference.

Throws:

XMLSignatureException

getReferencedContentBeforeTransformsItem

public XMLSignatureInput getReferencedContentBeforeTransformsItem(int i)
                                                           throws XMLSecurityException

Method getReferencedContentPriorTransformsItem

Parameters:

i -

Returns:

The contents before transformation of the reference i.

Throws:

XMLSecurityException

getReferencedContentAfterTransformsItem

public XMLSignatureInput getReferencedContentAfterTransformsItem(int i)
                                                          throws XMLSecurityException

Method getReferencedContentAfterTransformsItem

Parameters:

i -

Returns:

The contents after transformation of the reference i.

Throws:

XMLSecurityException

getSignedContentLength

public int getSignedContentLength()

Method getSignedContentLength

Returns:

The nu,ber of references contained in this reference.

getBaseLocalName

public String getBaseLocalName()

Method getBaseLocalName

Specified by:

getBaseLocalName in class ElementProxy

Returns:

the localname of the Elements of the sub-class.