19f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/* 29f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Licensed to the Apache Software Foundation (ASF) under one 39f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * or more contributor license agreements. See the NOTICE file 49f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed with this work for additional information 59f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * regarding copyright ownership. The ASF licenses this file 69f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * to you under the Apache License, Version 2.0 (the "License"); 79f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * you may not use this file except in compliance with the License. 89f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * You may obtain a copy of the License at 99f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 109f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * http://www.apache.org/licenses/LICENSE-2.0 119f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 129f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Unless required by applicable law or agreed to in writing, software 139f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS, 149f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 159f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * See the License for the specific language governing permissions and 169f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * limitations under the License. 179f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 189f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/* 199f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * $Id: KeyDeclaration.java 468643 2006-10-28 06:56:03Z minchau $ 209f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 219f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpackage org.apache.xalan.templates; 229f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 239f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonimport org.apache.xml.utils.QName; 249f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonimport org.apache.xpath.XPath; 259f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 269f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/** 279f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Holds the attribute declarations for the xsl:keys element. 289f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * A stylesheet declares a set of keys for each document using 299f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * the xsl:key element. When this set of keys contains a member 309f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * with node x, name y and value z, we say that node x has a key 319f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * with name y and value z. 329f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @see <a href="http://www.w3.org/TR/xslt#key">key in XSLT Specification</a> 339f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @xsl.usage internal 349f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 359f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpublic class KeyDeclaration extends ElemTemplateElement 369f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson{ 379f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson static final long serialVersionUID = 7724030248631137918L; 389f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 399f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 409f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Constructs a new element representing the xsl:key. The parameters 419f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * are needed to prioritize this key element as part of the recomposing 429f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * process. For this element, they are not automatically created 439f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * because the element is never added on to the stylesheet parent. 449f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 459f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public KeyDeclaration(Stylesheet parentNode, int docOrderNumber) 469f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 479f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson m_parentNode = parentNode; 489f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson setUid(docOrderNumber); 499f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 509f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 519f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 529f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The "name" property. 539f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @serial 549f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 559f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson private QName m_name; 569f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 579f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 589f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Set the "name" attribute. 599f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The name attribute specifies the name of the key. The value 609f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * of the name attribute is a QName, which is expanded as 619f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * described in [2.4 Qualified Names]. 629f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 639f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param name Value to set for the "name" attribute. 649f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 659f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public void setName(QName name) 669f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 679f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson m_name = name; 689f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 699f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 709f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 719f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Get the "name" attribute. 729f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The name attribute specifies the name of the key. The value 739f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * of the name attribute is a QName, which is expanded as 749f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * described in [2.4 Qualified Names]. 759f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 769f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return Value of the "name" attribute. 779f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 789f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public QName getName() 799f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 809f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson return m_name; 819f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 829f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 839f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 849f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Return the node name. 859f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 869f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return the element's name 879f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 889f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public String getNodeName() 899f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 909f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson return Constants.ELEMNAME_KEY_STRING; 919f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 929f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 939f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 949f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 959f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The "match" attribute. 969f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @serial 979f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 989f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson private XPath m_matchPattern = null; 999f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1009f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1019f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Set the "match" attribute. 1029f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The match attribute is a Pattern; an xsl:key element gives 1039f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * information about the keys of any node that matches the 1049f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * pattern specified in the match attribute. 1059f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @see <a href="http://www.w3.org/TR/xslt#patterns">patterns in XSLT Specification</a> 1069f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 1079f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param v Value to set for the "match" attribute. 1089f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1099f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public void setMatch(XPath v) 1109f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 1119f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson m_matchPattern = v; 1129f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 1139f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1149f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1159f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Get the "match" attribute. 1169f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The match attribute is a Pattern; an xsl:key element gives 1179f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * information about the keys of any node that matches the 1189f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * pattern specified in the match attribute. 1199f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @see <a href="http://www.w3.org/TR/xslt#patterns">patterns in XSLT Specification</a> 1209f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 1219f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return Value of the "match" attribute. 1229f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1239f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public XPath getMatch() 1249f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 1259f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson return m_matchPattern; 1269f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 1279f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1289f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1299f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The "use" attribute. 1309f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @serial 1319f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1329f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson private XPath m_use; 1339f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1349f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1359f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Set the "use" attribute. 1369f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The use attribute is an expression specifying the values 1379f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * of the key; the expression is evaluated once for each node 1389f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * that matches the pattern. 1399f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 1409f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param v Value to set for the "use" attribute. 1419f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1429f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public void setUse(XPath v) 1439f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 1449f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson m_use = v; 1459f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 1469f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1479f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1489f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Get the "use" attribute. 1499f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The use attribute is an expression specifying the values 1509f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * of the key; the expression is evaluated once for each node 1519f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * that matches the pattern. 1529f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 1539f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return Value of the "use" attribute. 1549f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1559f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public XPath getUse() 1569f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 1579f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson return m_use; 1589f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 1599f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1609f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1619f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Get an int constant identifying the type of element. 1629f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @see org.apache.xalan.templates.Constants 1639f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 1649f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return The token ID for this element 1659f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1669f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public int getXSLToken() 1679f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 1689f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson return Constants.ELEMNAME_KEY; 1699f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 1709f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1719f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1729f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * This function is called after everything else has been 1739f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * recomposed, and allows the template to set remaining 1749f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * values that may be based on some other property that 1759f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * depends on recomposition. 1769f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1779f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public void compose(StylesheetRoot sroot) 1789f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson throws javax.xml.transform.TransformerException 1799f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 1809f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson super.compose(sroot); 1819f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson java.util.Vector vnames = sroot.getComposeState().getVariableNames(); 1829f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson if(null != m_matchPattern) 1839f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson m_matchPattern.fixupVariables(vnames, sroot.getComposeState().getGlobalsSize()); 1849f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson if(null != m_use) 1859f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson m_use.fixupVariables(vnames, sroot.getComposeState().getGlobalsSize()); 1869f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 1879f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1889f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 1899f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * This function is called during recomposition to 1909f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * control how this element is composed. 1919f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param root The root stylesheet for this transformation. 1929f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 1939f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public void recompose(StylesheetRoot root) 1949f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 1959f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson root.recomposeKeys(this); 1969f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 1979f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 1989f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson} 199