java/6 : com/sun/org/apache/xml/internal/security/transforms/Transforms.java

Transforms
https://openjdk.java.net/
GPLv2 + Classpath Exception
/*
 * reserved comment block
 * DO NOT REMOVE OR ALTER!
 */
/*
 * Copyright  1999-2008 The Apache Software Foundation.
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 */
package com.sun.org.apache.xml.internal.security.transforms;

import java.io.IOException;
import java.io.OutputStream;

import com.sun.org.apache.xml.internal.security.c14n.CanonicalizationException;
import com.sun.org.apache.xml.internal.security.c14n.Canonicalizer;
import com.sun.org.apache.xml.internal.security.c14n.InvalidCanonicalizerException;
import com.sun.org.apache.xml.internal.security.exceptions.XMLSecurityException;
import com.sun.org.apache.xml.internal.security.signature.XMLSignatureException;
import com.sun.org.apache.xml.internal.security.signature.XMLSignatureInput;
import com.sun.org.apache.xml.internal.security.utils.Constants;
import com.sun.org.apache.xml.internal.security.utils.SignatureElementProxy;
import com.sun.org.apache.xml.internal.security.utils.XMLUtils;
import org.w3c.dom.DOMException;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;

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/**
 * Holder of the {@link com.sun.org.apache.xml.internal.security.transforms.Transform} steps to
 * be performed on the data.
 * The input to the first Transform is the result of dereferencing the
 * <code>URI</code> attribute of the <code>Reference</code> element.
 * The output from the last Transform is the input for the
 * <code>DigestMethod algorithm</code>
 *
 * @author Christian Geuer-Pollmann
 * @see Transform
 * @see com.sun.org.apache.xml.internal.security.signature.Reference
 */
public class Transforms extends SignatureElementProxy {

    logging logging facility /** {@link java.util.logging} logging facility */
    static java.util.logging.Logger log =
        java.util.logging.Logger.getLogger(Transforms.class.getName());
    Canonicalization - Required Canonical XML (omits comments) /** Canonicalization - Required Canonical XML (omits comments) */
    public static final String TRANSFORM_C14N_OMIT_COMMENTS
        = Canonicalizer.ALGO_ID_C14N_OMIT_COMMENTS;
    Canonicalization - Recommended Canonical XML with Comments /** Canonicalization - Recommended Canonical XML with Comments */
    public static final String TRANSFORM_C14N_WITH_COMMENTS
        = Canonicalizer.ALGO_ID_C14N_WITH_COMMENTS;
    Canonicalization - Required Canonical XML 1.1 (omits comments) /** Canonicalization - Required Canonical XML 1.1 (omits comments) */
    public static final String TRANSFORM_C14N11_OMIT_COMMENTS
        = Canonicalizer.ALGO_ID_C14N11_OMIT_COMMENTS;
    Canonicalization - Recommended Canonical XML 1.1 with Comments /** Canonicalization - Recommended Canonical XML 1.1 with Comments */
    public static final String TRANSFORM_C14N11_WITH_COMMENTS
        = Canonicalizer.ALGO_ID_C14N11_WITH_COMMENTS;
    Canonicalization - Required Exclusive Canonicalization (omits comments) /** Canonicalization - Required Exclusive Canonicalization (omits comments) */
    public static final String TRANSFORM_C14N_EXCL_OMIT_COMMENTS
        = Canonicalizer.ALGO_ID_C14N_EXCL_OMIT_COMMENTS;
    Canonicalization - Recommended Exclusive Canonicalization with Comments /** Canonicalization - Recommended Exclusive Canonicalization with Comments */
    public static final String TRANSFORM_C14N_EXCL_WITH_COMMENTS
        = Canonicalizer.ALGO_ID_C14N_EXCL_WITH_COMMENTS;
    Transform - Optional XSLT /** Transform - Optional XSLT */
    public static final String TRANSFORM_XSLT
        = "http://www.w3.org/TR/1999/REC-xslt-19991116";
    Transform - Required base64 decoding /** Transform - Required base64 decoding */
    public static final String TRANSFORM_BASE64_DECODE
        = Constants.SignatureSpecNS + "base64";
    Transform - Recommended XPath /** Transform - Recommended XPath */
    public static final String TRANSFORM_XPATH
        = "http://www.w3.org/TR/1999/REC-xpath-19991116";
    Transform - Required Enveloped Signature /** Transform - Required Enveloped Signature */
    public static final String TRANSFORM_ENVELOPED_SIGNATURE
        = Constants.SignatureSpecNS + "enveloped-signature";
    Transform - XPointer /** Transform - XPointer */
    public static final String TRANSFORM_XPOINTER
        = "http://www.w3.org/TR/2001/WD-xptr-20010108";
    Transform - XPath Filter v2.0 /** Transform - XPath Filter v2.0 */
    public static final String TRANSFORM_XPATH2FILTER04
        = "http://www.w3.org/2002/04/xmldsig-filter2";
    Transform - XPath Filter /** Transform - XPath Filter */
    public static final String TRANSFORM_XPATH2FILTER
        = "http://www.w3.org/2002/06/xmldsig-filter2";
    Transform - XPath Filter  CHGP private /** Transform - XPath Filter  CHGP private */
    public static final String TRANSFORM_XPATHFILTERCHGP
        = "http://www.nue.et-inf.uni-siegen.de/~geuer-pollmann/#xpathFilter";

    Element []transforms;

    protected Transforms() { };

    Constructs Transforms. 
Params: doc – the Document in which XMLSignature will
be placed/**
     * Constructs {@link Transforms}.
     *
     * @param doc the {@link Document} in which <code>XMLSignature</code> will
     * be placed
     */
    public Transforms(Document doc) {
        super(doc);
        XMLUtils.addReturnToElement(this._constructionElement);
    }

    Constructs Transforms from Element which is Transforms Element
Params: element –  is Transforms element
BaseURI – the URI where the XML instance was stored
Throws: DOMException – 
InvalidTransformException – 
TransformationException – 
XMLSecurityException – 
XMLSignatureException – /**
     * Constructs {@link Transforms} from {@link Element} which is
     * <code>Transforms</code> Element
     *
     * @param element  is <code>Transforms</code> element
     * @param BaseURI the URI where the XML instance was stored
     * @throws DOMException
     * @throws InvalidTransformException
     * @throws TransformationException
     * @throws XMLSecurityException
     * @throws XMLSignatureException
     */
    public Transforms(Element element, String BaseURI)
           throws DOMException, XMLSignatureException,
                  InvalidTransformException, TransformationException,
                  XMLSecurityException {

        super(element, BaseURI);

        int numberOfTransformElems = this.getLength();

        if (numberOfTransformElems == 0) {

            // At least one Transform element must be present. Bad.
            Object exArgs[] = { Constants._TAG_TRANSFORM,
                                Constants._TAG_TRANSFORMS };

            throw new TransformationException("xml.WrongContent", exArgs);
        }
    }

    Adds the Transform with the specified Transform
algorithm URI
Params: transformURI – the URI form of transform that indicates which
transformation is applied to data
Throws: TransformationException – /**
     * Adds the <code>Transform</code> with the specified <code>Transform
     * algorithm URI</code>
     *
     * @param transformURI the URI form of transform that indicates which
     * transformation is applied to data
     * @throws TransformationException
     */
    public void addTransform(String transformURI)
           throws TransformationException {

        try {
            if (log.isLoggable(java.util.logging.Level.FINE))
                log.log(java.util.logging.Level.FINE, "Transforms.addTransform(" + transformURI + ")");

            Transform transform = new Transform(this._doc, transformURI);

            this.addTransform(transform);
        } catch (InvalidTransformException ex) {
            throw new TransformationException("empty", ex);
        }
    }

    Adds the Transform with the specified Transform
algorithm URI
Params: 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)/**
     * Adds the <code>Transform</code> with the specified <code>Transform
     * algorithm URI</code>
     *
     * @param transformURI the URI form of transform that indicates which
     * transformation is applied to data
     * @param contextElement
     * @throws TransformationException
     * @see Transform#getInstance(Document doc, String algorithmURI, Element childElement)
     */
    public void addTransform(String transformURI, Element contextElement)
           throws TransformationException {

        try {
            if (log.isLoggable(java.util.logging.Level.FINE))
                log.log(java.util.logging.Level.FINE, "Transforms.addTransform(" + transformURI + ")");

            Transform transform = new Transform(this._doc, transformURI, contextElement);

            this.addTransform(transform);
        } catch (InvalidTransformException ex) {
            throw new TransformationException("empty", ex);
        }
    }

    Adds the Transform with the specified Transform
algorithm URI.
Params: 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)/**
     * Adds the <code>Transform</code> with the specified <code>Transform
     * algorithm URI</code>.
     *
     * @param transformURI the URI form of transform that indicates which
     * transformation is applied to data
     * @param contextNodes
     * @throws TransformationException
     * @see Transform#getInstance(Document doc, String algorithmURI, NodeList contextNodes)
     */
    public void addTransform(String transformURI, NodeList contextNodes)
           throws TransformationException {

        try {
            Transform transform = new Transform(this._doc, transformURI, contextNodes);
            this.addTransform(transform);
        } catch (InvalidTransformException ex) {
            throw new TransformationException("empty", ex);
        }
    }

    Adds a user-provided Transform step.
Params: transform – Transform object/**
     * Adds a user-provided Transform step.
     *
     * @param transform {@link Transform} object
     */
    private void addTransform(Transform transform) {
        if (log.isLoggable(java.util.logging.Level.FINE))
            log.log(java.util.logging.Level.FINE, "Transforms.addTransform(" + transform.getURI() + ")");

        Element transformElement = transform.getElement();

        this._constructionElement.appendChild(transformElement);
        XMLUtils.addReturnToElement(this._constructionElement);
    }

    Applies all included Transforms to xmlSignatureInput and
returns the result of these transformations.
Params: xmlSignatureInput – the input for the Transforms
Throws: TransformationException – 
Returns: the result of the Transforms/**
     * Applies all included <code>Transform</code>s to xmlSignatureInput and
     * returns the result of these transformations.
     *
     * @param xmlSignatureInput the input for the <code>Transform</code>s
     * @return the result of the <code>Transforms</code>
     * @throws TransformationException
     */
    public XMLSignatureInput performTransforms(
        XMLSignatureInput xmlSignatureInput) throws TransformationException {
        return performTransforms(xmlSignatureInput, null);
    }

    Applies all included Transforms to xmlSignatureInput and
returns the result of these transformations.
Params: xmlSignatureInput – the input for the Transforms
os – where to output the last transformation.
Throws: TransformationException – 
Returns: the result of the Transforms/**
     * Applies all included <code>Transform</code>s to xmlSignatureInput and
     * returns the result of these transformations.
     *
     * @param xmlSignatureInput the input for the <code>Transform</code>s
     * @param os where to output the last transformation.
     * @return the result of the <code>Transforms</code>
     * @throws TransformationException
     */
    public XMLSignatureInput performTransforms(
        XMLSignatureInput xmlSignatureInput, OutputStream os)
        throws TransformationException {

        try {
            int last=this.getLength()-1;
            for (int i = 0; i < last; i++) {
                Transform t = this.item(i);
                if (log.isLoggable(java.util.logging.Level.FINE)) {
                    log.log(java.util.logging.Level.FINE, "Perform the (" + i + ")th " + t.getURI()
                        + " transform");
                }
                xmlSignatureInput = t.performTransform(xmlSignatureInput);
            }
            if (last>=0) {
                Transform t = this.item(last);
                xmlSignatureInput = t.performTransform(xmlSignatureInput, os);
            }

            return xmlSignatureInput;
        } catch (IOException ex) {
            throw new TransformationException("empty", ex);
        } catch (CanonicalizationException ex) {
            throw new TransformationException("empty", ex);
        } catch (InvalidCanonicalizerException ex) {
            throw new TransformationException("empty", ex);
        }
    }

    Return the nonnegative number of transformations.
Returns: the number of transformations/**
     * Return the nonnegative number of transformations.
     *
     * @return the number of transformations
     */
    public int getLength()
    {
        if (transforms == null) {
            transforms = XMLUtils.selectDsNodes
                (this._constructionElement.getFirstChild(), "Transform");
        }
        return transforms.length;
    }

    Return the i^th Transform.
Valid i values are 0 to getLength-1.
Params: i – index of Transform to return
Throws: TransformationException – 
Returns: the i^th Transform/**
     * Return the <it>i</it><sup>th</sup> <code>{@link Transform}</code>.
     * Valid <code>i</code> values are 0 to <code>{@link #getLength}-1</code>.
     *
     * @param i index of {@link Transform} to return
     * @return the <it>i</it><sup>th</sup> Transform
     * @throws TransformationException
     */
    public Transform item(int i) throws TransformationException {

        try {
            if (transforms == null) {
                transforms = XMLUtils.selectDsNodes
                    (this._constructionElement.getFirstChild(), "Transform");
            }
            return new Transform(transforms[i], this._baseURI);
        } catch (XMLSecurityException ex) {
            throw new TransformationException("empty", ex);
        }
    }

    @inheritDoc /** @inheritDoc */
    public String getBaseLocalName() {
        return Constants._TAG_TRANSFORMS;
    }
}
Params:	element – is `Transforms` element BaseURI – the URI where the XML instance was stored
Throws:	DOMException – InvalidTransformException – TransformationException – XMLSecurityException – XMLSignatureException –
Params:	transformURI – the URI form of transform that indicates which transformation is applied to data
Throws:	TransformationException –
Params:	xmlSignatureInput – the input for the `Transform`s
Throws:	TransformationException –
Returns:	the result of the `Transforms`
Params:	i – index of `Transform` to return
Throws:	TransformationException –
Returns:	the i^th Transform
/

java/ 6/ com/sun/org/apache/xml/internal/security/transforms/Transforms.java
