Package net.sf.saxon.trans
Class IndependentContext
java.lang.Object
net.sf.saxon.trans.IndependentContext
- All Implemented Interfaces:
Serializable
,StaticContext
,NamespaceResolver
public class IndependentContext
extends Object
implements StaticContext, NamespaceResolver, Serializable
An IndependentContext provides a context for parsing an expression or pattern appearing
in a context other than a stylesheet.
This class was formerly named StandaloneContext. It has forked from that class, so that
StandaloneContext could be changed to meet the demands of the JAXP 1.3 XPath API.
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionIndependentContext
(Configuration config) Create an IndependentContext using a specific Configuration -
Method Summary
Modifier and TypeMethodDescriptionbindVariable
(int fingerprint) Bind a variable used in an XPath Expression to the XSLVariable element in which it is declared.void
Clear all the declared namespaces, including the standard ones (xml, xslt, saxon).void
Clear all the declared namespaces, except for the standard ones (xml, xslt, saxon, xdt).copy()
Create a copy of this IndependentContext.void
declareCollation
(String name, Comparator comparator, boolean isDefault) Declare a named collationvoid
declareNamespace
(String prefix, String uri) Declare a namespace whose prefix can be used in expressionsdeclareVariable
(String qname) Declare a variable.declareVariable
(QNameValue qname) Declare a variable.Get the Base URI of the stylesheet element, for resolving any relative URI's used in the expression.getCollation
(String name) Get a named collation.Get the system configurationGet the name of the default collation.short
Get the default XPath namespace, as a namespace code that can be looked up in the NamePoolGet the default function namespaceGet the function library containing all the in-scope functions available in this static contextGet the set of imported schemasint
Get the line number of the expression within that container.Get the location map.Get the NamePool used for compiling expressionsGet a namespace resolver to resolve the namespaces declared in this static context.int
getSlotNumber
(QNameValue qname) Get the slot number allocated to a particular variableGet the stack frame map containing the slot number allocations for the variables declared in this static contextGet the system ID of the container of the expression.getURIForPrefix
(String prefix) Get the URI for a prefix, using the declared namespaces as the context for namespace resolution.getURIForPrefix
(String prefix, boolean useDefault) Get the namespace URI corresponding to a given prefix.boolean
Determine whether a built-in type is available in this context.boolean
isImportedSchema
(String namespace) Determine whether a Schema for a given target namespace has been imported.boolean
Determine whether Backwards Compatible Mode is usedvoid
issueWarning
(String s, SourceLocator locator) Issue a compile-time warning.Get an iterator over all the prefixes declared in this namespace context.Construct a dynamic context for early evaluation of constant subexpressionsvoid
setBaseURI
(String baseURI) Set the base URI in the static contextvoid
Set the default namespace for elements and typesvoid
Set the default function namespacevoid
Set the function library to be usedvoid
setImportedSchemaNamespaces
(Set namespaces) void
setLocationMap
(LocationMap locationMap) void
setNamespaceResolver
(NamespaceResolver resolver) Set an external namespace resolver.void
setNamespaces
(NodeInfo node) Declares all the namespaces that are in-scope for a given node, removing all previous namespace declarations.
-
Constructor Details
-
IndependentContext
public IndependentContext() -
IndependentContext
Create an IndependentContext using a specific Configuration
-
-
Method Details
-
copy
Create a copy of this IndependentContext. All aspects of the context are copied except for declared variables. -
getConfiguration
Get the system configuration- Specified by:
getConfiguration
in interfaceStaticContext
-
makeEarlyEvaluationContext
Construct a dynamic context for early evaluation of constant subexpressions- Specified by:
makeEarlyEvaluationContext
in interfaceStaticContext
-
getLocationMap
Description copied from interface:StaticContext
Get the location map. This is a mapping from short location ids held with each expression or subexpression, to a fully-resolved location in a source stylesheet or query.- Specified by:
getLocationMap
in interfaceStaticContext
-
setLocationMap
-
declareNamespace
Declare a namespace whose prefix can be used in expressions- Parameters:
prefix
- The namespace prefix. Must not be null. Supplying "" sets the default element namespace.uri
- The namespace URI. Must not be null.
-
clearNamespaces
public void clearNamespaces()Clear all the declared namespaces, except for the standard ones (xml, xslt, saxon, xdt). This also resets the default element namespace to the "null" namespace -
clearAllNamespaces
public void clearAllNamespaces()Clear all the declared namespaces, including the standard ones (xml, xslt, saxon). Leave only the XML namespace and the default namespace (xmlns=""). This also resets the default element namespace to the "null" namespace. -
setNamespaces
Declares all the namespaces that are in-scope for a given node, removing all previous namespace declarations. In addition, the standard namespaces (xml, xslt, saxon) are declared. This method also sets the default element namespace to be the same as the default namespace for this node.- Parameters:
node
- The node whose in-scope namespaces are to be used as the context namespaces. If the node is an attribute, text node, etc, then the namespaces of its parent element are used.
-
setNamespaceResolver
Set an external namespace resolver. If this is set, then all resolution of namespace prefixes is delegated to the external namespace resolver, and namespaces declared individually on this IndependentContext object are ignored. -
setBaseURI
Set the base URI in the static context -
declareCollation
Declare a named collation- Parameters:
name
- The name of the collation (technically, a URI)comparator
- The Java Comparator used to implement the collating sequenceisDefault
- True if this is to be used as the default collation
-
getStackFrameMap
Get the stack frame map containing the slot number allocations for the variables declared in this static context -
declareVariable
Declare a variable. A variable must be declared before an expression referring to it is compiled. The initial value of the variable will be the empty sequence- Parameters:
qname
- The name of the variable- Returns:
- a Variable object representing information about the variable that has been declared.
-
declareVariable
Declare a variable. A variable may be declared before an expression referring to it is compiled. Alternatively, a JAXP XPathVariableResolver may be supplied to perform the resolution. A variable that has been explicitly declared is used in preference.- Parameters:
qname
- Lexical QName identifying the variable. The namespace prefix, if any, must have been declared before this method is called, or must be resolvable using the namespace context.- Throws:
XPathException
-
getSlotNumber
Get the slot number allocated to a particular variable- Returns:
- the slot number, or -1 if the variable has not been declared
-
getNamePool
Get the NamePool used for compiling expressions- Specified by:
getNamePool
in interfaceStaticContext
-
issueWarning
Issue a compile-time warning. This method is used during XPath expression compilation to output warning conditions. The default implementation writes the message to System.err. To change the destination of messages, create a subclass of StandaloneContext that overrides this method.- Specified by:
issueWarning
in interfaceStaticContext
-
getSystemId
Get the system ID of the container of the expression. Used to construct error messages.- Specified by:
getSystemId
in interfaceStaticContext
- Returns:
- "" always
-
getBaseURI
Get the Base URI of the stylesheet element, for resolving any relative URI's used in the expression. Used by the document() function, resolve-uri(), etc.- Specified by:
getBaseURI
in interfaceStaticContext
- Returns:
- "" if no base URI has been set
-
getLineNumber
public int getLineNumber()Get the line number of the expression within that container. Used to construct error messages.- Specified by:
getLineNumber
in interfaceStaticContext
- Returns:
- -1 always
-
getURIForPrefix
Get the URI for a prefix, using the declared namespaces as the context for namespace resolution. The default namespace is NOT used when the prefix is empty. This method is provided for use by the XPath parser.- Specified by:
getURIForPrefix
in interfaceStaticContext
- Parameters:
prefix
- The prefix- Throws:
XPathException
- if the prefix is not declared
-
getNamespaceResolver
Description copied from interface:StaticContext
Get a namespace resolver to resolve the namespaces declared in this static context.- Specified by:
getNamespaceResolver
in interfaceStaticContext
- Returns:
- a namespace resolver.
-
getURIForPrefix
Get the namespace URI corresponding to a given prefix. Return null if the prefix is not in scope.- Specified by:
getURIForPrefix
in interfaceNamespaceResolver
- Parameters:
prefix
- the namespace prefixuseDefault
- true if the default namespace is to be used when the prefix is ""- Returns:
- the uri for the namespace, or null if the prefix is not in scope. Return "" if the prefix maps to the null namespace.
-
iteratePrefixes
Get an iterator over all the prefixes declared in this namespace context. This will include the default namespace (prefix="") and the XML namespace where appropriate- Specified by:
iteratePrefixes
in interfaceNamespaceResolver
-
bindVariable
Bind a variable used in an XPath Expression to the XSLVariable element in which it is declared. This method is provided for use by the XPath parser, and it should not be called by the user of the API, or overridden, unless variables are to be declared using a mechanism other than the declareVariable method of this class.- Specified by:
bindVariable
in interfaceStaticContext
- Parameters:
fingerprint
- the name of the variable- Returns:
- a VariableReference representing the variable reference, suitably initialized to refer to the corresponding variable declaration
- Throws:
StaticError
-
getFunctionLibrary
Get the function library containing all the in-scope functions available in this static context- Specified by:
getFunctionLibrary
in interfaceStaticContext
-
setFunctionLibrary
Set the function library to be used -
getCollation
Get a named collation.- Specified by:
getCollation
in interfaceStaticContext
- Parameters:
name
- The name of the required collation. Supply null to get the default collation.- Returns:
- the collation identified by the given name, as set previously using declareCollation. Return null if no collation with this name is found.
-
getDefaultCollationName
Get the name of the default collation.- Specified by:
getDefaultCollationName
in interfaceStaticContext
- Returns:
- the name of the default collation; or the name of the codepoint collation if no default collation has been defined
-
getDefaultElementNamespace
public short getDefaultElementNamespace()Get the default XPath namespace, as a namespace code that can be looked up in the NamePool- Specified by:
getDefaultElementNamespace
in interfaceStaticContext
-
setDefaultElementNamespace
Set the default namespace for elements and types -
setDefaultFunctionNamespace
Set the default function namespace -
getDefaultFunctionNamespace
Get the default function namespace- Specified by:
getDefaultFunctionNamespace
in interfaceStaticContext
-
isInBackwardsCompatibleMode
public boolean isInBackwardsCompatibleMode()Determine whether Backwards Compatible Mode is used- Specified by:
isInBackwardsCompatibleMode
in interfaceStaticContext
- Returns:
- false; XPath 1.0 compatibility mode is not supported in the standalone XPath API
-
isImportedSchema
Description copied from interface:StaticContext
Determine whether a Schema for a given target namespace has been imported. Note that the in-scope element declarations, attribute declarations and schema types are the types registered with the (schema-aware) configuration, provided that their namespace URI is registered in the static context as being an imported schema namespace. (A consequence of this is that within a Configuration, there can only be one schema for any given namespace, including the null namespace).- Specified by:
isImportedSchema
in interfaceStaticContext
-
isAllowedBuiltInType
Determine whether a built-in type is available in this context. This method caters for differences between host languages as to which set of types are built in.- Specified by:
isAllowedBuiltInType
in interfaceStaticContext
- Parameters:
type
- the supposedly built-in type. This will always be a type in the XS or XDT namespace.- Returns:
- true if this type can be used in this static context
-
getImportedSchemaNamespaces
Get the set of imported schemas- Specified by:
getImportedSchemaNamespaces
in interfaceStaticContext
- Returns:
- a Set, the set of URIs representing the names of imported schemas
-
setImportedSchemaNamespaces
-