net.sf.saxon.expr.flwor.LetClause Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of Saxon-HE Show documentation
Show all versions of Saxon-HE Show documentation
The XSLT and XQuery Processor
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
// Copyright (c) 2018-2022 Saxonica Limited
// This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
// If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
// This Source Code Form is "Incompatible With Secondary Licenses", as defined by the Mozilla Public License, v. 2.0.
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
package net.sf.saxon.expr.flwor;
import net.sf.saxon.event.Outputter;
import net.sf.saxon.expr.*;
import net.sf.saxon.expr.parser.*;
import net.sf.saxon.trace.ExpressionPresenter;
import net.sf.saxon.trans.XPathException;
import net.sf.saxon.type.ItemType;
import java.util.List;
import static net.sf.saxon.expr.flwor.Clause.ClauseName.LET;
/**
* A "let" clause in a FLWOR expression
*/
public class LetClause extends Clause {
private LocalVariableBinding rangeVariable;
private Operand sequenceOp;
private Evaluator evaluator;
@Override
public ClauseName getClauseKey() {
return LET;
}
public Evaluator getEvaluator() {
if (evaluator == null) {
evaluator = ExpressionTool.lazyEvaluator(getSequence(), true);
}
return evaluator;
}
@Override
public LetClause copy(FLWORExpression flwor, RebindingMap rebindings) {
LetClause let2 = new LetClause();
let2.setLocation(getLocation());
let2.setPackageData(getPackageData());
let2.rangeVariable = rangeVariable.copy();
let2.initSequence(flwor, getSequence().copy(rebindings));
return let2;
}
public void initSequence(FLWORExpression flwor, Expression sequence) {
sequenceOp = new Operand(flwor, sequence, isRepeated() ? OperandRole.REPEAT_NAVIGATE : OperandRole.NAVIGATE);
}
public void setSequence(Expression sequence) {
sequenceOp.setChildExpression(sequence);
}
public Expression getSequence() {
return sequenceOp.getChildExpression();
}
public void setRangeVariable(LocalVariableBinding binding) {
this.rangeVariable = binding;
}
public LocalVariableBinding getRangeVariable() {
return rangeVariable;
}
/**
* Get the number of variables bound by this clause
*
* @return the number of variable bindings
*/
@Override
public LocalVariableBinding[] getRangeVariables() {
return new LocalVariableBinding[]{rangeVariable};
}
/**
* Get a tuple stream that implements the functionality of this clause, taking its
* input from another tuple stream which this clause modifies
*
* @param base the input tuple stream
* @param context the XPath context
* @return the output tuple stream
*/
@Override
public TuplePull getPullStream(TuplePull base, XPathContext context) {
return new LetClausePull(base, this);
}
/**
* Get a push-mode tuple stream that implements the functionality of this clause, supplying its
* output to another tuple stream
*
* @param destination the output tuple stream
* @param output the destination for the result
* @param context the XPath context
* @return the push tuple stream that implements the functionality of this clause of the FLWOR
* expression
*/
@Override
public TuplePush getPushStream(TuplePush destination, Outputter output, XPathContext context) {
return new LetClausePush(output, destination, this);
}
/**
* Process the subexpressions of this clause
*
* @param processor the expression processor used to process the subexpressions
*/
@Override
public void processOperands(OperandProcessor processor) throws XPathException {
processor.processOperand(sequenceOp);
}
/**
* Type-check the expression
*/
@Override
public void typeCheck(ExpressionVisitor visitor, ContextItemStaticInfo contextInfo) throws XPathException {
RoleDiagnostic role = new RoleDiagnostic(RoleDiagnostic.VARIABLE, rangeVariable.getVariableQName().getDisplayName(), 0);
setSequence(TypeChecker.strictTypeCheck(
getSequence(), rangeVariable.getRequiredType(), role, visitor.getStaticContext()));
evaluator = ExpressionTool.lazyEvaluator(getSequence(), true);
}
@Override
public void gatherVariableReferences(final ExpressionVisitor visitor, Binding binding, List references) {
ExpressionTool.gatherVariableReferences(getSequence(), binding, references);
}
@Override
public void refineVariableType(ExpressionVisitor visitor, List references, Expression returnExpr) {
final Expression seq = getSequence();
final ItemType actualItemType = seq.getItemType();
for (VariableReference ref : references) {
ref.refineVariableType(actualItemType, getSequence().getCardinality(),
seq instanceof Literal ? ((Literal) seq).getGroundedValue() : null,
seq.getSpecialProperties());
ExpressionTool.resetStaticProperties(returnExpr);
}
}
// /**
// * Provide additional information about the type of the variable, typically derived by analyzing
// * the initializer of the variable binding
// * @param type the item type of the variable
// * @param cardinality the cardinality of the variable
// * @param constantValue the actual value of the variable, if this is known statically, otherwise null
// * @param properties additional static properties of the variable's initializer
// * @param visitor an ExpressionVisitor
// */
// public void refineVariableType(
// ItemType type, int cardinality, Value constantValue, int properties, ExpressionVisitor visitor) {
// Executable exec = visitor.getExecutable();
// if (exec == null) {
// // happens during use-when evaluation
// return;
// }
// TypeHierarchy th = exec.getConfiguration().getTypeHierarchy();
// ItemType oldItemType = rangeVariable.getRequiredType().getPrimaryType();
// ItemType newItemType = oldItemType;
// if (th.isSubType(type, oldItemType)) {
// newItemType = type;
// }
// if (oldItemType instanceof NodeTest && type instanceof AtomicType) {
// // happens when all references are flattened
// newItemType = type;
// }
// int newcard = cardinality & rangeVariable.getRequiredType().getCardinality();
// if (newcard==0) {
// // this will probably lead to a type error later
// newcard = rangeVariable.getRequiredType().getCardinality();
// }
// SequenceType seqType = SequenceType.makeSequenceType(newItemType, newcard);
// //setStaticType(seqType, constantValue, properties);
// }
@Override
public void addToPathMap(PathMap pathMap, PathMap.PathMapNodeSet pathMapNodeSet) {
PathMap.PathMapNodeSet varPath = getSequence().addToPathMap(pathMap, pathMapNodeSet);
pathMap.registerPathForVariable(rangeVariable, varPath);
}
/**
* Diagnostic print of expression structure. The abstract expression tree
* is written to the supplied output destination.
*
* @param out the expression presenter used to display the structure
*/
@Override
public void explain(ExpressionPresenter out) throws XPathException {
out.startElement("let");
out.emitAttribute("var", getRangeVariable().getVariableQName());
out.emitAttribute("slot", getRangeVariable().getLocalSlotNumber() + "");
getSequence().export(out);
out.endElement();
}
@Override
public String toShortString() {
StringBuilder fsb = new StringBuilder(64);
fsb.append("let $");
fsb.append(rangeVariable.getVariableQName().getDisplayName());
fsb.append(" := ");
fsb.append(getSequence().toShortString());
return fsb.toString();
}
public String toString() {
StringBuilder fsb = new StringBuilder(64);
fsb.append("let $");
fsb.append(rangeVariable.getVariableQName().getDisplayName());
fsb.append(" := ");
fsb.append(getSequence().toString());
return fsb.toString();
}
}