14c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson/* 24c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * Licensed to the Apache Software Foundation (ASF) under one 34c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * or more contributor license agreements. See the NOTICE file 44c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * distributed with this work for additional information 54c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * regarding copyright ownership. The ASF licenses this file 64c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * to you under the Apache License, Version 2.0 (the "License"); 74c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * you may not use this file except in compliance with the License. 84c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * You may obtain a copy of the License at 94c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 104c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * http://www.apache.org/licenses/LICENSE-2.0 114c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 124c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * Unless required by applicable law or agreed to in writing, software 134c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS, 144c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 154c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * See the License for the specific language governing permissions and 164c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * limitations under the License. 174c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson */ 184c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson/* 194c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * $Id: ElemFallback.java 468643 2006-10-28 06:56:03Z minchau $ 204c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson */ 214c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilsonpackage org.apache.xalan.templates; 224c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 234c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilsonimport javax.xml.transform.TransformerException; 244c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 254c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilsonimport org.apache.xalan.transformer.TransformerImpl; 264c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 274c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson/** 284c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * Implement xsl:fallback. 294c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * <pre> 304c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * <!ELEMENT xsl:fallback %template;> 314c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * <!ATTLIST xsl:fallback %space-att;> 324c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * </pre> 334c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @see <a href="http://www.w3.org/TR/xslt#fallback">fallback in XSLT Specification</a> 344c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @xsl.usage advanced 354c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson */ 364c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilsonpublic class ElemFallback extends ElemTemplateElement 374c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson{ 384c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson static final long serialVersionUID = 1782962139867340703L; 394c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 404c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson /** 414c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * Get an int constant identifying the type of element. 424c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @see org.apache.xalan.templates.Constants 434c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 444c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @return The token ID for this element 454c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson */ 464c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson public int getXSLToken() 474c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson { 484c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson return Constants.ELEMNAME_FALLBACK; 494c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson } 504c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 514c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson /** 524c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * Return the node name. 534c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 544c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @return The Element's name 554c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson */ 564c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson public String getNodeName() 574c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson { 584c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson return Constants.ELEMNAME_FALLBACK_STRING; 594c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson } 604c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 614c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson /** 624c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * This is the normal call when xsl:fallback is instantiated. 634c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * In accordance with the XSLT 1.0 Recommendation, chapter 15, 644c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * "Normally, instantiating an xsl:fallback element does nothing." 654c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 664c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @param transformer non-null reference to the the current transform-time state. 674c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 684c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @throws TransformerException 694c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson */ 704c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson public void execute( 714c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson TransformerImpl transformer) 724c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson throws TransformerException 734c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson { 744c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson } 754c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 764c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson /** 774c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * Execute the fallback elements. This must be explicitly called to 784c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * instantiate the content of an xsl:fallback element. 794c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * When an XSLT transformer performs fallback for an instruction 804c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * element, if the instruction element has one or more xsl:fallback 814c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * children, then the content of each of the xsl:fallback children 824c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * must be instantiated in sequence; otherwise, an error must 834c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * be signaled. The content of an xsl:fallback element is a template. 844c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 854c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @param transformer non-null reference to the the current transform-time state. 864c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * 874c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson * @throws TransformerException 884c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson */ 894c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson public void executeFallback( 904c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson TransformerImpl transformer) 914c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson throws TransformerException 924c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson { 934c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 944c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson int parentElemType = m_parentNode.getXSLToken(); 954c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson if (Constants.ELEMNAME_EXTENSIONCALL == parentElemType 964c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson || Constants.ELEMNAME_UNDEFINED == parentElemType) 974c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson { 984c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 994c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson transformer.executeChildTemplates(this, true); 1004c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 1014c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson } 1024c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson else 1034c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson { 1044c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson 1054c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson // Should never happen 1064c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson System.out.println( 1074c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson "Error! parent of xsl:fallback must be an extension or unknown element!"); 1084c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson } 1094c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson } 1104c7a0d97cf2b27790e6236965a1d798d710d7ec7Jesse Wilson} 111