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

DSIGTransformXPath Class Reference
[Main Signature API]

Transform holder for XPath transforms. More...

#include <DSIGTransformXPath.hpp>

Inheritance diagram for DSIGTransformXPath:

Inheritance graph
[legend]
Collaboration diagram for DSIGTransformXPath:

Collaboration graph
[legend]
List of all members.

Public Methods

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

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

virtual ~DSIGTransformXPath ()
 Destructor. More...

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

virtual TXFMBase * createTransformer (TXFMBase *input)
 Create the XPath Transformer class. More...

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

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

XPath specific methods
void setExpression (const char *expr)
 Set the XPath expression. More...

const char * getExpression (void)
 Get the XPath expression. More...

void setNamespace (const char *prefix, const char *value)
 Add a new namespace to the list to be used. More...

void deleteNamespace (const char *prefix)
 Delete a namespace to the list to be used. More...


Detailed Description

Transform holder for XPath transforms.

The DSIGTransformXPath class is used to hold XPath <Transform> elements within a document.

See also:
TXFMXPath , DSIGTransform


Constructor & Destructor Documentation

DSIGTransformXPath::DSIGTransformXPath (  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

DSIGTransformXPath::DSIGTransformXPath (  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 DSIGTransformXPath::~DSIGTransformXPath (    )  [virtual]
 

Destructor.

Destroy the DSIGSignature elements.

Does not destroy any associated DOM Nodes


Member Function Documentation

virtual DOMElement* DSIGTransformXPath::createBlankTransform (  DOMDocument *    parentDoc )  [virtual]
 

Construct blank XPath Transform element.

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

Implements DSIGTransform.

virtual TXFMBase* DSIGTransformXPath::createTransformer (  TXFMBase *    input )  [virtual]
 

Create the XPath Transformer class.

Create the transformer associated with this XPath transform. Will set the expression and Namespaces as appropriate

Returns:
The TXFMXPath transformer associated with this Transform

Implements DSIGTransform.

void DSIGTransformXPath::deleteNamespace (  const char *    prefix ) 
 

Delete a namespace to the list to be used.

Delete a namespace from the XPath Element.

Parameters:
prefix  NCName of the Namespace to delete
Exceptions:
XSECException  if the NCName does not exist

const char* DSIGTransformXPath::getExpression (  void    ) 
 

Get the XPath expression.

Returns a character buffer with the expression inside it.

Note:
Do not delete the returned pointer - it is owned by the object.
Returns:
The expression

virtual transformType DSIGTransformXPath::getTransformType (    )  [virtual]
 

Determine the transform type.

Used to determine what the type of the transform is.

Implements DSIGTransform.

virtual void DSIGTransformXPath::load (  void    )  [virtual]
 

Load a DOM structure.

Load the expression and Namespaces.

Implements DSIGTransform.

void DSIGTransformXPath::setExpression (  const char *    expr ) 
 

Set the XPath expression.

Takes the provided string and uses it to set the expression in the Signature and DOM structures.

If an expression already exists, it is overwritten.

Parameters:
expr  The expression to set

void DSIGTransformXPath::setNamespace (  const char *    prefix,
const char *    value
) 
 

Add a new namespace to the list to be used.

Add a new namespace to the XPath Element.

Parameters:
prefix  NCName of the Namespace to set
value  The string with the URI to set


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