- /*
- * The Apache Software License, Version 1.1
- *
- *
- * Copyright (c) 1999 The Apache Software Foundation. All rights
- * reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in
- * the documentation and/or other materials provided with the
- * distribution.
- *
- * 3. The end-user documentation included with the redistribution,
- * if any, must include the following acknowledgment:
- * "This product includes software developed by the
- * Apache Software Foundation (http://www.apache.org/)."
- * Alternately, this acknowledgment may appear in the software itself,
- * if and wherever such third-party acknowledgments normally appear.
- *
- * 4. The names "Xalan" and "Apache Software Foundation" must
- * not be used to endorse or promote products derived from this
- * software without prior written permission. For written
- * permission, please contact apache@apache.org.
- *
- * 5. Products derived from this software may not be called "Apache",
- * nor may "Apache" appear in their name, without prior written
- * permission of the Apache Software Foundation.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
- * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
- * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
- * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- * SUCH DAMAGE.
- * ====================================================================
- *
- * This software consists of voluntary contributions made by many
- * individuals on behalf of the Apache Software Foundation and was
- * originally based on software copyright (c) 1999, Lotus
- * Development Corporation., http://www.lotus.com. For more
- * information on the Apache Software Foundation, please see
- * <http://www.apache.org/>.
- */
- package org.apache.xalan.templates;
-
- //import org.w3c.dom.*;
- import org.apache.xml.dtm.DTM;
-
- import org.xml.sax.*;
-
- import org.apache.xpath.*;
- import org.apache.xml.utils.QName;
- import org.apache.xalan.res.XSLTErrorResources;
- import org.apache.xalan.transformer.TransformerImpl;
-
- import javax.xml.transform.TransformerException;
-
- /**
- * <meta name="usage" content="advanced"/>
- * Implement xsl:comment.
- * <pre>
- * <!ELEMENT xsl:comment %char-template;>
- * <!ATTLIST xsl:comment %space-att;>
- * </pre>
- * @see <a href="http://www.w3.org/TR/xslt#section-Creating-Comments">section-Creating-Comments in XSLT Specification</a>
- */
- public class ElemComment extends ElemTemplateElement
- {
-
- /**
- * Get an int constant identifying the type of element.
- * @see org.apache.xalan.templates.Constants
- *
- * @return The token ID for this element
- */
- public int getXSLToken()
- {
- return Constants.ELEMNAME_COMMENT;
- }
-
- /**
- * Return the node name.
- *
- * @return This element's name
- */
- public String getNodeName()
- {
- return Constants.ELEMNAME_COMMENT_STRING;
- }
-
- /**
- * Execute the xsl:comment transformation
- *
- *
- * @param transformer non-null reference to the the current transform-time state.
- * @param sourceNode non-null reference to the <a href="http://www.w3.org/TR/xslt#dt-current-node">current source node</a>.
- * @param mode reference, which may be null, to the <a href="http://www.w3.org/TR/xslt#modes">current mode</a>.
- *
- * @throws TransformerException
- */
- public void execute(
- TransformerImpl transformer)
- throws TransformerException
- {
- if (TransformerImpl.S_DEBUG)
- transformer.getTraceManager().fireTraceEvent(this);
- try
- {
- // Note the content model is:
- // <!ENTITY % instructions "
- // %char-instructions;
- // | xsl:processing-instruction
- // | xsl:comment
- // | xsl:element
- // | xsl:attribute
- // ">
- String data = transformer.transformToString(this);
-
- transformer.getResultTreeHandler().comment(data);
- }
- catch(org.xml.sax.SAXException se)
- {
- throw new TransformerException(se);
- }
- finally
- {
- if (TransformerImpl.S_DEBUG)
- transformer.getTraceManager().fireTraceEndEvent(this);
- }
- }
-
- /**
- * Add a child to the child list.
- *
- * @param newChild Child to add to this node's child list
- *
- * @return Child that was just added to child list
- *
- * @throws DOMException
- */
- public ElemTemplateElement appendChild(ElemTemplateElement newChild)
- {
-
- int type = ((ElemTemplateElement) newChild).getXSLToken();
-
- switch (type)
- {
-
- // char-instructions
- case Constants.ELEMNAME_TEXTLITERALRESULT :
- case Constants.ELEMNAME_APPLY_TEMPLATES :
- case Constants.ELEMNAME_APPLY_IMPORTS :
- case Constants.ELEMNAME_CALLTEMPLATE :
- case Constants.ELEMNAME_FOREACH :
- case Constants.ELEMNAME_VALUEOF :
- case Constants.ELEMNAME_COPY_OF :
- case Constants.ELEMNAME_NUMBER :
- case Constants.ELEMNAME_CHOOSE :
- case Constants.ELEMNAME_IF :
- case Constants.ELEMNAME_TEXT :
- case Constants.ELEMNAME_COPY :
- case Constants.ELEMNAME_VARIABLE :
- case Constants.ELEMNAME_MESSAGE :
-
- // instructions
- // case Constants.ELEMNAME_PI:
- // case Constants.ELEMNAME_COMMENT:
- // case Constants.ELEMNAME_ELEMENT:
- // case Constants.ELEMNAME_ATTRIBUTE:
- break;
- default :
- error(XSLTErrorResources.ER_CANNOT_ADD,
- new Object[]{ newChild.getNodeName(),
- this.getNodeName() }); //"Can not add " +((ElemTemplateElement)newChild).m_elemName +
-
- //" to " + this.m_elemName);
- }
-
- return super.appendChild(newChild);
- }
- }