|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object net.sf.saxon.query.DynamicQueryContext
public class DynamicQueryContext
This object represents a dynamic context for query execution. This class is used by the application writer to set up aspects of the dynamic context; it is not used operationally (or modified) by the XQuery processor itself, which copies all required information into its own internal representation.
Constructor Summary | |
---|---|
DynamicQueryContext(Configuration config)
Create the dynamic context for a query |
Method Summary | |
---|---|
void |
clearParameters()
Reset the parameters to an empty list. |
Configuration |
getConfiguration()
Get the Configuration associated with this dynamic query context |
Item |
getContextItem()
Get the context item for the query, as set using setContextItem() or setContextNode(). |
DateTimeValue |
getCurrentDateTime()
Get the date and time set previously using setCurrentDateTime(net.sf.saxon.value.DateTimeValue)
or null if none has been set. |
ErrorListener |
getErrorListener()
Get the error listener. |
Object |
getParameter(String expandedName)
Get the actual value of a parameter to the query. |
HashMap<String,Object> |
getParameters()
Get all the supplied parameters as a HashMap. |
int |
getSchemaValidationMode()
Ask whether source documents loaded using the doc(), document(), and collection() functions, or supplied as a StreamSource or SAXSource to the transform() or addParameter() method should be subjected to schema validation |
PrintStream |
getTraceFunctionDestination()
Get the destination for output from the fn:trace() function. |
TraceListener |
getTraceListener()
Get the trace listener. |
URIResolver |
getURIResolver()
Get the URI resolver. |
void |
initializeController(Controller controller)
Apply the settings from this DynamicQueryContext to a Controller |
boolean |
isApplyFunctionConversionRulesToExternalVariables()
Ask whether the function conversion rules should be applied to supplied parameter values. |
void |
setApplyFunctionConversionRulesToExternalVariables(boolean convert)
Say whether the function conversion rules should be applied to supplied parameter values. |
void |
setContextItem(Item item)
Set the context item for evaluating the expression. |
void |
setContextNode(NodeInfo node)
Deprecated. From Saxon 8.7, the method setContextItem(Item) is preferred |
void |
setCurrentDateTime(DateTimeValue dateTime)
Set a value to be used as the current date and time for the query. |
void |
setErrorListener(ErrorListener listener)
Set the error listener. |
void |
setParameter(String expandedName,
Object value)
Set a parameter for the query. |
void |
setParameterValue(String expandedName,
ValueRepresentation value)
Set a parameter for the query. |
void |
setSchemaValidationMode(int validationMode)
Say whether source documents loaded using the doc(), document(), and collection() functions, or supplied as a StreamSource or SAXSource to the transform() or addParameter() method, should be subjected to schema validation. |
void |
setTraceFunctionDestination(PrintStream stream)
Set the destination for output from the fn:trace() function. |
void |
setTraceListener(TraceListener listener)
Set the trace listener. |
void |
setURIResolver(URIResolver resolver)
Set an object that will be used to resolve URIs used in fn:document() and related functions. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public DynamicQueryContext(Configuration config)
config
- the Saxon configurationMethod Detail |
---|
public int getSchemaValidationMode()
Validation.DEFAULT
otherwise.public void setSchemaValidationMode(int validationMode)
validationMode
- the validation (or construction) mode to be used for source documents.
One of Validation.STRIP
, Validation.PRESERVE
, Validation.STRICT
,
Validation.LAX
public void setApplyFunctionConversionRulesToExternalVariables(boolean convert)
convert
- true if function conversion rules are to be applied to supplied
values; if false, the supplied value must match the required type exactly.public boolean isApplyFunctionConversionRulesToExternalVariables()
public void setContextNode(NodeInfo node)
setContextItem(Item)
is preferred
buildDocument
in class QueryProcessor.
node
- The node that is to be the context node for the querypublic void setContextItem(Item item)
buildDocument
in class QueryProcessor.
item
- The item that is to be the context item for the query
IllegalArgumentException
- if the supplied item is a node that was built under the wrong
Saxon Configuration
NullPointerException
- if the supplied item is nullpublic Item getContextItem()
public void setParameter(String expandedName, Object value)
expandedName
- The name of the parameter in "{uri}local-name" format.
It is not an error to supply a value for a parameter that has not been
declared, the parameter will simply be ignored. If the parameter has
been declared in the query (as an external global variable) then it
will be initialized with the value supplied.value
- The value of the parameter. This can be any valid Java
object. It follows the same conversion rules as a value returned
from a Saxon extension function. An error will occur at query
execution time if the supplied value cannot be converted to the required
type as declared in the query. For precise control of the type of the
value, instantiate one of the classes in the net.sf.saxon.value package,
for example net.sf.saxon.value.DayTimeDuration.public void setParameterValue(String expandedName, ValueRepresentation value)
expandedName
- The name of the parameter in "{uri}local-name" format.
It is not an error to supply a value for a parameter that has not been
declared, the parameter will simply be ignored. If the parameter has
been declared in the query (as an external global variable) then it
will be initialized with the value supplied.value
- The value of the parameter. This must be an XPath value in its Saxon
representation: no conversion occurs. The value is not checked at this stage
against its required type; such checking will happen later, when the query
is executed.public void clearParameters()
public Object getParameter(String expandedName)
expandedName
- the name of the required parameter, in
"{uri}local-name" format
public HashMap<String,Object> getParameters()
public void setURIResolver(URIResolver resolver)
resolver
- An object that implements the URIResolver interface, or
null.public URIResolver getURIResolver()
public void setErrorListener(ErrorListener listener)
listener
- the ErrorListener to be usedpublic ErrorListener getErrorListener()
public void setTraceListener(TraceListener listener)
listener
- the TraceListener to be usedpublic TraceListener getTraceListener()
public void setTraceFunctionDestination(PrintStream stream)
stream
- the PrintStream to which trace output will be sent. If set to
null, trace output is suppressed entirely. It is the caller's responsibility
to close the stream after use.public PrintStream getTraceFunctionDestination()
public DateTimeValue getCurrentDateTime()
setCurrentDateTime(net.sf.saxon.value.DateTimeValue)
or null if none has been set.
public void setCurrentDateTime(DateTimeValue dateTime) throws XPathException
This method also has the effect of setting the implicit timezone.
dateTime
- The value to be used as the current date and time. This must include a timezone. The timezone
from this value will also be used as the implicit timezone
XPathException
- if the dateTime does not include a timezonepublic Configuration getConfiguration()
public void initializeController(Controller controller)
controller
- the Controller whose settings are to be initialized
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |