/*
* reserved comment block
* DO NOT REMOVE OR ALTER!
*/
/*
* Copyright 1999-2004 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
*
*
* 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.
*/
/*
* $Id: Variable.java,v 1.2.4.1 2005/09/14 21:24:33 jeffsuttor Exp $
*/
/**
* The variable reference expression executer.
*/
{
/** Tell if fixupVariables was called.
* @serial */
private boolean m_fixUpWasCalled = false;
/** The qualified name of the variable.
* @serial */
/**
* The index of the variable, which is either an absolute index to a
* global, or, if higher than the globals area, must be adjusted by adding
* the offset to the current stack frame.
*/
protected int m_index;
/**
* Set the index for the variable into the stack. For advanced use only. You
* must know what you are doing to use this.
*
* @param index a global or local index.
*/
{
}
/**
* Set the index for the variable into the stack. For advanced use only.
*
* @return index a global or local index.
*/
public int getIndex()
{
return m_index;
}
/**
* Set whether or not this is a global reference. For advanced use only.
*
* @param isGlobal true if this should be a global variable reference.
*/
{
}
/**
* Set the index for the variable into the stack. For advanced use only.
*
* @return true if this should be a global variable reference.
*/
public boolean getGlobal()
{
return m_isGlobal;
}
protected boolean m_isGlobal = false;
/**
* This function is used to fixup variables from QNames to stack frame
* indexes at stylesheet build time.
* @param vars List of QNames that correspond to variables. This list
* should be searched backwards for the first qualified name that
* corresponds to the variable reference qname. The position of the
* QName in the vector from the start of the vector will be its position
* in the stack frame (but variables above the globalsTop value will need
* to be offset to the current stack frame).
*/
{
m_fixUpWasCalled = true;
{
// System.out.println("qn: "+qn);
{
if(i < globalsSize)
{
m_isGlobal = true;
m_index = i;
}
else
{
m_index = i-globalsSize;
}
return;
}
}
}
/**
* Set the qualified name of the variable.
*
* @param qname Must be a non-null reference to a qualified name.
*/
{
}
/**
* Get the qualified name of the variable.
*
* @return A non-null reference to a qualified name.
*/
{
return m_qname;
}
/**
* Execute an expression in the XPath runtime context, and return the
* result of the expression.
*
*
* @param xctxt The XPath runtime context.
*
* @return The result of the expression in the form of a <code>XObject</code>.
*
* @throws javax.xml.transform.TransformerException if a runtime exception
* occurs.
*/
{
}
/**
* Dereference the variable, and return the reference value. Note that lazy
* evaluation will occur. If a variable within scope is not found, a warning
* will be sent to the error listener, and an empty nodeset will be returned.
*
*
* @param xctxt The runtime execution context.
*
* @return The evaluated variable, or an empty nodeset if not found.
*
* @throws javax.xml.transform.TransformerException
*/
public XObject execute(XPathContext xctxt, boolean destructiveOK) throws javax.xml.transform.TransformerException
{
// Is the variable fetched always the same?
// XObject result = xctxt.getVariable(m_qname);
if(m_fixUpWasCalled)
{
if(m_isGlobal)
else
}
else {
}
{
// This should now never happen...
// (new RuntimeException()).printStackTrace();
// error(xctxt, XPATHErrorResources.ER_COULDNOT_GET_VAR_NAMED,
// new Object[]{ m_qname.getLocalPart() }); //"Could not get variable named "+varName);
}
return result;
// }
// else
// {
// // Hack city... big time. This is needed to evaluate xpaths from extensions,
// // pending some bright light going off in my head. Some sort of callback?
// synchronized(this)
// {
// com.sun.org.apache.xalan.internal.templates.ElemVariable vvar= getElemVariable();
// if(null != vvar)
// {
// m_index = vvar.getIndex();
// m_isGlobal = vvar.getIsTopLevel();
// m_fixUpWasCalled = true;
// return execute(xctxt);
// }
// }
// throw new javax.xml.transform.TransformerException(XSLMessages.createXPATHMessage(XPATHErrorResources.ER_VAR_NOT_RESOLVABLE, new Object[]{m_qname.toString()})); //"Variable not resolvable: "+m_qname);
// }
}
/**
* Get the XSLT ElemVariable that this sub-expression references. In order for
* this to work, the SourceLocator must be the owning ElemTemplateElement.
* @return The dereference to the ElemVariable, or null if not found.
*/
// J2SE does not support Xalan interpretive
/*
public com.sun.org.apache.xalan.internal.templates.ElemVariable getElemVariable()
{
// Get the current ElemTemplateElement, and then walk backwards in
// document order, searching
// for an xsl:param element or xsl:variable element that matches our
// qname. If we reach the top level, use the StylesheetRoot's composed
// list of top level variables and parameters.
com.sun.org.apache.xalan.internal.templates.ElemVariable vvar = null;
com.sun.org.apache.xpath.internal.ExpressionNode owner = getExpressionOwner();
if (null != owner && owner instanceof com.sun.org.apache.xalan.internal.templates.ElemTemplateElement)
{
com.sun.org.apache.xalan.internal.templates.ElemTemplateElement prev =
(com.sun.org.apache.xalan.internal.templates.ElemTemplateElement) owner;
if (!(prev instanceof com.sun.org.apache.xalan.internal.templates.Stylesheet))
{
while ( prev != null && !(prev.getParentNode() instanceof com.sun.org.apache.xalan.internal.templates.Stylesheet) )
{
com.sun.org.apache.xalan.internal.templates.ElemTemplateElement savedprev = prev;
while (null != (prev = prev.getPreviousSiblingElem()))
{
if(prev instanceof com.sun.org.apache.xalan.internal.templates.ElemVariable)
{
vvar = (com.sun.org.apache.xalan.internal.templates.ElemVariable) prev;
if (vvar.getName().equals(m_qname))
{
return vvar;
}
vvar = null;
}
}
prev = savedprev.getParentElem();
}
}
if (prev != null)
vvar = prev.getStylesheetRoot().getVariableOrParamComposed(m_qname);
}
return vvar;
}
*/
/**
* Tell if this expression returns a stable number that will not change during
* iterations within the expression. This is used to determine if a proximity
* position predicate can indicate that no more searching has to occur.
*
*
* @return true if the expression represents a stable number.
*/
public boolean isStableNumber()
{
return true;
}
/**
* Get the analysis bits for this walker, as defined in the WalkerFactory.
* @return One of WalkerFactory#BIT_DESCENDANT, etc.
*/
public int getAnalysisBits()
{
// J2SE does not support Xalan interpretive
/*
com.sun.org.apache.xalan.internal.templates.ElemVariable vvar = getElemVariable();
if(null != vvar)
{
XPath xpath = vvar.getSelect();
if(null != xpath)
{
Expression expr = xpath.getExpression();
if(null != expr && expr instanceof PathComponent)
{
return ((PathComponent)expr).getAnalysisBits();
}
}
}
*/
return WalkerFactory.BIT_FILTER;
}
/**
* @see com.sun.org.apache.xpath.internal.XPathVisitable#callVisitors(ExpressionOwner, XPathVisitor)
*/
{
}
/**
* @see Expression#deepEquals(Expression)
*/
{
if(!isSameClass(expr))
return false;
return false;
// J2SE does not support Xalan interpretive
/*
// We have to make sure that the qname really references
// the same variable element.
if(getElemVariable() != ((Variable)expr).getElemVariable())
return false;
*/
return true;
}
/**
* Tell if this is a psuedo variable reference, declared by Xalan instead
* of by the user.
*/
public boolean isPsuedoVarRef()
{
{
return true;
}
return false;
}
}