com.rsa.certj.xml.dsig

Class Manifest

java.lang.Object
  |
  +--com.rsa.certj.xml.dsig.Manifest

public class Manifest

extends Object

This class creates and stores the manifest element in an XML signature. It includes a list of Reference objects that each reference validation uses separately. The reference validation of the manifest is under application control.

Copyright © RSA Security Inc., 2001-2002. All rights reserved.

Constructor Summary

Manifest()

Generates an empty Manifest instance.

Manifest(Reference[] references)

Generates a Manifest instance by initializing the Reference list with references.

Manifest(Reference[] references, String id)

Generates a Manifest instance by initializing the Reference list with references and assigning the ID of this Manifest to id.

Method Summary

String	getId() Returns the ID of this Manifest instance.
Reference[]	getManifestContent() Returns the Reference object array stored in this Manifest instance.
void	setId(String id) Sets the ID of this Manifest instance.
void	setManifestContent(Reference[] references) Sets the list of Reference objects belonging to this Manifest instance to references.
boolean	verify(XMLSignature xmlSignature, StringBuffer[] descriptions) Validates each reference element in this Manifest instance and stores the validation result in descriptions.

Methods inherited from class java.lang.Object

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

Constructor Detail

Manifest

public Manifest()

Generates an empty Manifest instance.

Manifest

public Manifest(Reference[] references)

Generates a Manifest instance by initializing the Reference list with references.

Parameters

references

A list of Reference objects belonging to this Manifest instance.

Manifest

public Manifest(Reference[] references,
                String id)

Generates a Manifest instance by initializing the Reference list with references and assigning the ID of this Manifest to id.

Parameters

	references		A list of Reference objects belonging to this Manifest instance.
	id		A String object uniquely identifying this Manifest instance.

Method Detail

setId

public void setId(String id)

Sets the ID of this Manifest instance.

Parameters

id

A String object uniquely identifying this Manifest instance.

getId

public String getId()

Returns the ID of this Manifest instance.

Returns

A String object uniquely identifying this Manifest instance.

setManifestContent

public void setManifestContent(Reference[] references)

Sets the list of Reference objects belonging to this Manifest instance to references.

Parameters

references

A Reference array to assign to the manifest of this Reference object.

getManifestContent

public Reference[] getManifestContent()

Returns the Reference object array stored in this Manifest instance.

Returns

The manifest as a Reference array.

verify

public boolean verify(XMLSignature xmlSignature,
                      StringBuffer[] descriptions)
               throws XMLException

Validates each reference element in this Manifest instance and stores the validation result in descriptions. This method returns true only when all parts of the reference validation succeed.

Parameters

	xmlSignature		An XMLSignature object containing the current Reference instance.
	descriptions		A StringBuffer array containing the descriptions of each reference validation result. If any StringBuffer object in it is null, then no description for reference at that position is provided.

Returns

true if each reference validation succeeds; false, otherwise

Throws

XMLException - If an error occurs while verifying the manifest.