net.sf.saxon.sxpath.XPathEvaluator 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-2023 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.sxpath;
import net.sf.saxon.Configuration;
import net.sf.saxon.expr.Expression;
import net.sf.saxon.expr.PackageData;
import net.sf.saxon.expr.instruct.Executable;
import net.sf.saxon.expr.instruct.SlotManager;
import net.sf.saxon.expr.parser.*;
import net.sf.saxon.functions.FunctionLibrary;
import net.sf.saxon.functions.FunctionLibraryList;
import net.sf.saxon.functions.registry.ConstructorFunctionLibrary;
import net.sf.saxon.functions.registry.XPath31FunctionSet;
import net.sf.saxon.pattern.Pattern;
import net.sf.saxon.s9api.HostLanguage;
import net.sf.saxon.trans.XPathException;
import net.sf.saxon.type.ItemType;
import net.sf.saxon.type.Type;
/**
* This class provides a native Saxon API for free-standing evaluation of XPath expressions. This is the
* primitive XPath interface used internally within Saxon.
* The preferred API for user applications calling XPath is the s9api {@link net.sf.saxon.s9api.XPathCompiler}
* interface.
* @since 8.4
*/
public class XPathEvaluator {
private XPathStaticContext staticContext;
/**
* Construct an XPathEvaluator with a specified configuration.
*
* @param config the configuration to be used. If the XPathEvaluator is
* to be used to run schema-aware XPath expressions this must be an instance
* of {@code EnterpriseConfiguration}
*/
public XPathEvaluator(Configuration config) {
staticContext = new IndependentContext(config);
}
/**
* Get the Configuration in use.
*
* @return the Saxon configuration
*/
public Configuration getConfiguration() {
return staticContext.getConfiguration();
}
/**
* Set the static context for compiling XPath expressions. This provides more detailed control over the
* environment in which the expression is compiled, for example it allows namespace prefixes to
* be declared, variables to be bound and functions to be defined. For most purposes, the static
* context can be defined by providing and tailoring an instance of the {@link IndependentContext} class.
* Until this method is called, a default static context is used, in which no namespaces are defined
* other than the standard ones (xml, xslt, and saxon), and no variables or functions (other than the
* core XPath functions) are available.
*
* @param context the XPath static context
* Setting a new static context clears any variables and namespaces that have previously been declared.
*/
public void setStaticContext(XPathStaticContext context) {
staticContext = context;
}
/**
* Get the current static context. This will always return a value; if no static context has been
* supplied by the user, the system will have created its own. A system-created static context
* will always be an instance of {@link IndependentContext}
*
* @return the static context object
*/
public XPathStaticContext getStaticContext() {
return staticContext;
}
/**
* Prepare (compile) an XPath expression for subsequent evaluation.
*
* @param expression The XPath expression to be compiled, supplied as a string.
* @return an XPathExpression object representing the prepared expression
* @throws XPathException if the syntax of the expression is wrong, or if it references namespaces,
* variables, or functions that have not been declared.
*/
public XPathExpression createExpression(String expression) throws XPathException {
Configuration config = getConfiguration();
Executable exec = new Executable(config);
exec.setTopLevelPackage(staticContext.getPackageData());
exec.setSchemaAware(staticContext.getPackageData().isSchemaAware());
exec.setHostLanguage(HostLanguage.XPATH);
// Make the function library that's available at run-time (e.g. for saxon:evaluate() and function-lookup()).
// This includes all user-defined functions regardless of which module they are in
FunctionLibrary userlib = exec.getFunctionLibrary();
FunctionLibraryList lib = new FunctionLibraryList();
lib.addFunctionLibrary(XPath31FunctionSet.getInstance());
lib.addFunctionLibrary(config.getBuiltInExtensionLibraryList(31));
lib.addFunctionLibrary(new ConstructorFunctionLibrary(config));
lib.addFunctionLibrary(config.getIntegratedFunctionLibrary());
config.addExtensionBinders(lib);
if (userlib != null) {
lib.addFunctionLibrary(userlib);
}
exec.setFunctionLibrary(lib);
Optimizer opt = config.obtainOptimizer();
Expression exp = ExpressionTool.make(expression, staticContext, 0, -1, null);
RetainedStaticContext rsc = staticContext.makeRetainedStaticContext();
exp.setRetainedStaticContext(rsc);
ExpressionVisitor visitor = ExpressionVisitor.make(staticContext);
ItemType contextItemType = staticContext.getRequiredContextItemType();
ContextItemStaticInfo cit = config.makeContextItemStaticInfo(contextItemType, true);
cit.setParentless(staticContext.isContextItemParentless());
exp = exp.typeCheck(visitor, cit);
if (opt.isOptionSet(OptimizerOptions.MISCELLANEOUS)) {
exp = exp.optimize(visitor, cit);
}
if (opt.isOptionSet(OptimizerOptions.LOOP_LIFTING)) {
exp.setParentExpression(null);
exp = LoopLifter.process(exp, visitor, cit);
}
exp = postProcess(exp, visitor, cit);
exp.setRetainedStaticContext(rsc);
SlotManager map = staticContext.getStackFrameMap();
int numberOfExternalVariables = map.getNumberOfVariables();
ExpressionTool.allocateSlots(exp, numberOfExternalVariables, map);
XPathExpression xpe = new XPathExpression(staticContext, exp, exec);
xpe.setStackFrameMap(map, numberOfExternalVariables);
return xpe;
}
/**
* Customize the expression post-optimization. This method does nothing,
* but can be overridden in a subclass
* @param exp the expression after optimization
* @param visitor an expression visitor that includes static context information
* @param cit information about the context item type
*/
protected Expression postProcess(Expression exp, ExpressionVisitor visitor, ContextItemStaticInfo cit) throws XPathException {
return exp;
}
/**
* Prepare (compile) an XSLT pattern for subsequent evaluation. The result is an XPathExpression
* object representing a (pseudo-) expression that when evaluated returns a boolean result: true
* if the context node matches the pattern, false if it does not.
*
* @param pattern the XSLT pattern to be compiled, supplied as a string
* @return an XPathExpression object representing the pattern, wrapped as an expression
* @throws XPathException if the syntax of the expression is wrong, or if it references namespaces,
* variables, or functions that have not been declared.
* @since 9.1
*/
/*@NotNull*/
public XPathExpression createPattern(String pattern) throws XPathException {
Configuration config = getConfiguration();
Executable exec = new Executable(config);
Pattern pat = Pattern.make(pattern, staticContext, new PackageData(config));
ExpressionVisitor visitor = ExpressionVisitor.make(staticContext);
pat.typeCheck(visitor, config.makeContextItemStaticInfo(Type.NODE_TYPE, true));
SlotManager map = staticContext.getStackFrameMap();
int slots = map.getNumberOfVariables();
slots = pat.allocateSlots(map, slots);
//PatternSponsor sponsor = new PatternSponsor(pat);
XPathExpression xpe = new XPathExpression(staticContext, pat, exec);
xpe.setStackFrameMap(map, slots);
return xpe;
}
}