Main Page   Modules   Class Hierarchy   Compound List   File List   Compound Members   File Members   Related Pages  

DSIGTransformC14n Class Reference
[Main Signature API]

Transform holder for C14n based transforms. More...

#include <DSIGTransformC14n.hpp>

Inheritance diagram for DSIGTransformC14n:

Inheritance graph
[legend]
Collaboration diagram for DSIGTransformC14n:

Collaboration graph
[legend]
List of all members.

Public Methods

Constructors and Destructors
 DSIGTransformC14n (DSIGSignature *sig, DOMNode *node)
 Contructor used for existing XML signatures. More...

 DSIGTransformC14n (DSIGSignature *sig)
 Contructor used for new signatures. More...

virtual ~DSIGTransformC14n ()
 Destructor. More...

Interface Methods
virtual transformType getTransformType ()
 Determine the transform type. More...

virtual TXFMBasecreateTransformer (TXFMBase *input)
 Create the Canonicalising transformer element. More...

virtual DOMElement * createBlankTransform (DOMDocument *parentDoc)
 Construct blank Canonicalisation Transform element. More...

virtual void load (void)
 Load a DOM structure. More...

C14n Specific Methods
void setCanonicalizationMethod (canonicalizationMethod method)
 Change canonicalisation method. More...

canonicalizationMethod getCanonicalizationMethod (void)
 Get canonicalisation type. More...

void addInclusiveNamespace (const char *ns)
 Add a namespace prefix to the InclusiveNamespaces list. More...

const XMLCh * getPrefixList (void)
 Get the string containing the inclusive namespaces. More...

void clearInclusiveNamespaces (void)
 Delete all inclusive namespaces. More...


Detailed Description

Transform holder for C14n based transforms.

The DSIGTransformC14n class is used to hold C14n <Transform> elements within a document. This includes Exclusive and Comment options

See also:
TXFMC14n , DSIGTransform


Constructor & Destructor Documentation

DSIGTransformC14n::DSIGTransformC14n DSIGSignature   sig,
DOMNode *    node
 

Contructor used for existing XML signatures.

The Node structure already exists, so read the nodes in.

Parameters:
sig  The Signature structure in which this transform exists.
node  The DOM node (within doc) that is to be used as the base of the Transform.
See also:
load

DSIGTransformC14n::DSIGTransformC14n DSIGSignature   sig
 

Contructor used for new signatures.

The Node structure will have to be created.

Note:
DSIGTransform structures should only ever be created via calls to a DSIGTransformList object.
Parameters:
sig  The Signature structure in which this transform exists.
See also:
createBlankTransform

virtual DSIGTransformC14n::~DSIGTransformC14n   [virtual]
 

Destructor.

Destroy the DSIGSignature elements.

Does not destroy any associated DOM Nodes


Member Function Documentation

void DSIGTransformC14n::addInclusiveNamespace const char *    ns
 

Add a namespace prefix to the InclusiveNamespaces list.

Exclusive canonicalisation includes the ability to define a PrefixList of namespace prefixes that will not be treated exclusively, rather they will be handled as per normal C14n.

This function allows a caller to add a prefix to this list

Parameters:
ns  The prefix to add.

void DSIGTransformC14n::clearInclusiveNamespaces void   
 

Delete all inclusive namespaces.

Deletes the structures (including the DOM nodes) that hold the inclusive namespaces list.

virtual DOMElement* DSIGTransformC14n::createBlankTransform DOMDocument *    parentDoc [virtual]
 

Construct blank Canonicalisation Transform element.

Instruct the implementation to create the required transform and return the newly constructed DOMNode structure

Note:
By default creates a non-comment non-exclusive C14n transform.

Implements DSIGTransform.

virtual TXFMBase* DSIGTransformC14n::createTransformer TXFMBase   input [virtual]
 

Create the Canonicalising transformer element.

Implemented by each Transform class and used by the DSIGSignature when consructing a TXFM List that includes canonicalisation (nearly always)

Implements DSIGTransform.

canonicalizationMethod DSIGTransformC14n::getCanonicalizationMethod void   
 

Get canonicalisation type.

Return the type of canonicalisation to the caller.

Returns:
Canonicalisation type.
See also:
canonicalizationMethod

const XMLCh* DSIGTransformC14n::getPrefixList void   
 

Get the string containing the inclusive namespaces.

Get the string containing a list of (space separated) prefixes that will be handled non-exclusively in an exclusive C14n transform.

Returns:
A pointer to the string held in the node (NULL if no namespaces defined).
Note:
The pointer returned is owned by the Transform structure - do not delete.

virtual transformType DSIGTransformC14n::getTransformType   [virtual]
 

Determine the transform type.

Used to determine what the type of the transform is.

Implements DSIGTransform.

virtual void DSIGTransformC14n::load void    [virtual]
 

Load a DOM structure.

(Re)read the DOM structure into the Signature structures

Implements DSIGTransform.

void DSIGTransformC14n::setCanonicalizationMethod canonicalizationMethod    method
 

Change canonicalisation method.

Set the canonicalisation method to the type indicated. If this changes the transform from Exclusive to Standard C14n, any associated InclusiveNamespaces children will be removed.

If this is moving from one form of Exclusive to another, any InclusiveNamespace children will remain.

Parameters:
method  Type of canicaliser required.
See also:
canonicalizationMethod


The documentation for this class was generated from the following file:
Generated on Sat Jan 11 20:35:13 2003 for XML-Security-C by doxygen1.2.15