Class Transforms

java.lang.Object

org.apache.xml.security.utils.ElementProxy

org.apache.xml.security.utils.SignatureElementProxy

org.apache.xml.security.transforms.Transforms

public class Transforms
extends SignatureElementProxy

Holder of the Transform steps to be performed on the data. The input to the first Transform is the result of dereferencing the URI attribute of the Reference element. The output from the last Transform is the input for the DigestMethod algorithm

Author:

Christian Geuer-Pollmann

See Also:

• Transform
• Reference

Field Summary

Fields

Modifier and Type	Field	Description
static final String	TRANSFORM_BASE64_DECODE	Transform - Required base64 decoding
static final String	TRANSFORM_C14N_EXCL_OMIT_COMMENTS	Canonicalization - Required Exclusive Canonicalization (omits comments)
static final String	TRANSFORM_C14N_EXCL_WITH_COMMENTS	Canonicalization - Recommended Exclusive Canonicalization with Comments
static final String	TRANSFORM_C14N_OMIT_COMMENTS	Canonicalization - Required Canonical XML (omits comments)
static final String	TRANSFORM_C14N_WITH_COMMENTS	Canonicalization - Recommended Canonical XML with Comments
static final String	TRANSFORM_ENVELOPED_SIGNATURE	Transform - Required Enveloped Signature
static final String	TRANSFORM_XPATH	Transform - Recommended XPath
static final String	TRANSFORM_XPATH2FILTER	Transform - XPath Filter
static final String	TRANSFORM_XPATH2FILTER04	Transform - XPath Filter v2.0
static final String	TRANSFORM_XPATHFILTERCHGP	Transform - XPath Filter CHGP private
static final String	TRANSFORM_XPOINTER	Transform - XPointer
static final String	TRANSFORM_XSLT	Transform - Optional XSLT

Fields inherited from class ElementProxy

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

Constructor Summary

Constructors

Constructor	Description
Transforms(Document doc)	Consturcts Transforms
Transforms(Element element, String BaseURI)	Consturcts Transforms from Element which is Transforms Element

Method Summary

Modifier and Type	Method	Description
void	addTransform(String transformURI)	Adds the Transform with the specified Transform algorithm URI
void	addTransform(String transformURI, Element contextElement)	Adds the Transform with the specified Transform algorithm URI
void	addTransform(String transformURI, NodeList contextNodes)	Adds the Transform with the specified Transform algorithm URI
String	getBaseLocalName()	Returns the localname of the Elements of the sub-class.
int	getLength()	Return the nonnegative number of transformations.
Transform	item(int i)	Return the ith Transform.
XMLSignatureInput	performTransforms(XMLSignatureInput xmlSignatureInput)	Applies all included Transforms to xmlSignatureInput and returns the result of these transformations.
XMLSignatureInput	performTransforms(XMLSignatureInput xmlSignatureInput, OutputStream os)	Applies all included Transforms to xmlSignatureInput and returns the result of these transformations.

Methods inherited from class SignatureElementProxy

getBaseNamespace

Methods inherited from class 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 Object

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

Field Details

TRANSFORM_C14N_OMIT_COMMENTS

public static final String TRANSFORM_C14N_OMIT_COMMENTS

Canonicalization - Required Canonical XML (omits comments)

See Also:

• Constant Field Values

TRANSFORM_C14N_WITH_COMMENTS

public static final String TRANSFORM_C14N_WITH_COMMENTS

Canonicalization - Recommended Canonical XML with Comments

See Also:

• Constant Field Values

TRANSFORM_C14N_EXCL_OMIT_COMMENTS

public static final String TRANSFORM_C14N_EXCL_OMIT_COMMENTS

Canonicalization - Required Exclusive Canonicalization (omits comments)

See Also:

• Constant Field Values

TRANSFORM_C14N_EXCL_WITH_COMMENTS

public static final String TRANSFORM_C14N_EXCL_WITH_COMMENTS

Canonicalization - Recommended Exclusive Canonicalization with Comments

See Also:

• Constant Field Values

TRANSFORM_XSLT

public static final String TRANSFORM_XSLT

Transform - Optional XSLT

See Also:

• Constant Field Values

TRANSFORM_BASE64_DECODE

public static final String TRANSFORM_BASE64_DECODE

Transform - Required base64 decoding

See Also:

• Constant Field Values

TRANSFORM_XPATH

public static final String TRANSFORM_XPATH

Transform - Recommended XPath

See Also:

• Constant Field Values

TRANSFORM_ENVELOPED_SIGNATURE

public static final String TRANSFORM_ENVELOPED_SIGNATURE

Transform - Required Enveloped Signature

See Also:

• Constant Field Values

TRANSFORM_XPOINTER

public static final String TRANSFORM_XPOINTER

Transform - XPointer

See Also:

• Constant Field Values

TRANSFORM_XPATH2FILTER04

public static final String TRANSFORM_XPATH2FILTER04

Transform - XPath Filter v2.0

See Also:

• Constant Field Values

TRANSFORM_XPATH2FILTER

public static final String TRANSFORM_XPATH2FILTER

Transform - XPath Filter

See Also:

• Constant Field Values

TRANSFORM_XPATHFILTERCHGP

public static final String TRANSFORM_XPATHFILTERCHGP

Transform - XPath Filter CHGP private

See Also:

• Constant Field Values

Constructor Details

Transforms

public Transforms(Document doc)

Consturcts Transforms

Parameters:

doc - the Document in which XMLsignature will be placed

Transforms

public Transforms(Element element,
 String BaseURI)
           throws DOMException,
XMLSignatureException,
InvalidTransformException,
TransformationException,
XMLSecurityException

Consturcts Transforms from Element which is Transforms Element

Parameters:

element - is Transforms element

BaseURI - the URI where the XML instance was stored

Throws:

DOMException

InvalidTransformException

TransformationException

XMLSecurityException

XMLSignatureException

Method Details

addTransform

public void addTransform(String transformURI)
                  throws TransformationException

Adds the Transform with the specified Transform algorithm URI

Parameters:

transformURI - the URI form of transform that indicates which transformation is applied to data

Throws:

TransformationException

addTransform

public void addTransform(String transformURI,
 Element contextElement)
                  throws TransformationException

Adds the Transform with the specified Transform algorithm URI

Parameters:

transformURI - the URI form of transform that indicates which transformation is applied to data

contextElement -

Throws:

TransformationException

See Also:

• Transform.getInstance(Document doc, String algorithmURI, Element childElement)

addTransform

public void addTransform(String transformURI,
 NodeList contextNodes)
                  throws TransformationException

Adds the Transform with the specified Transform algorithm URI

Parameters:

transformURI - the URI form of transform that indicates which transformation is applied to data

contextNodes -

Throws:

TransformationException

See Also:

• Transform.getInstance(Document doc, String algorithmURI, NodeList contextNodes)

performTransforms

public XMLSignatureInput performTransforms(XMLSignatureInput xmlSignatureInput)
                                    throws TransformationException

Applies all included Transforms to xmlSignatureInput and returns the result of these transformations.

Parameters:

xmlSignatureInput - the input for the Transforms

Returns:

the result of the Transforms

Throws:

TransformationException

performTransforms

public XMLSignatureInput performTransforms(XMLSignatureInput xmlSignatureInput,
 OutputStream os)
                                    throws TransformationException

Applies all included Transforms to xmlSignatureInput and returns the result of these transformations.

Parameters:

xmlSignatureInput - the input for the Transforms

os - where to output the last transformation.

Returns:

the result of the Transforms

Throws:

TransformationException

getLength

public int getLength()

Return the nonnegative number of transformations.

Returns:

the number of transformations

item

public Transform item(int i)
               throws TransformationException

Return the i^th Transform. Valid i values are 0 to getLength()-1.

Parameters:

i - index of Transform to return

Returns:

the i^th transforms

Throws:

TransformationException

getBaseLocalName

public String getBaseLocalName()

Description copied from class: ElementProxy

Returns the localname of the Elements of the sub-class.

Specified by:

getBaseLocalName in class ElementProxy

Returns:

the localname of the Elements of the sub-class.