Class XQStackTraceElement

  • All Implemented Interfaces:
    java.io.Serializable

    public class XQStackTraceElement
    extends java.lang.Object
    implements java.io.Serializable
    This class represents a frame in a stack trace, akin to the java.lang.StackTraceElement but for XQuery callstacks instead of Java.
    See Also:
    XQQueryException.getQueryStackTrace, Serialized Form
    • Constructor Summary

      Constructors 
      Constructor Description
      XQStackTraceElement​(java.lang.String moduleURI, int line, int column, int position, javax.xml.namespace.QName function, XQStackTraceVariable[] variables)
      Construct an XQStackTraceElement object representing a frame in a stack trace.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int getColumnNumber()
      Gets the column number in the query string containing the execution point represented by this stack trace element.
      javax.xml.namespace.QName getFunctionQName()
      Gets the QName of the function in which the error occurred, or null if it occurred outside an enclosing function (in a main module).
      int getLineNumber()
      Gets the line number in the query string containing the execution point represented by this stack trace element.
      java.lang.String getModuleURI()
      Gets the module URI containing the execution point represented by this stack trace element.
      int getPosition()
      Gets the character position in the query string containing the execution point represented by this stack trace element.
      XQStackTraceVariable[] getVariables()
      Gets the variables in scope at this execution point, or null if no variable value retrieval is possible.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • XQStackTraceElement

        public XQStackTraceElement​(java.lang.String moduleURI,
                                   int line,
                                   int column,
                                   int position,
                                   javax.xml.namespace.QName function,
                                   XQStackTraceVariable[] variables)
        Construct an XQStackTraceElement object representing a frame in a stack trace.
        Parameters:
        moduleURI - the module URI containing the execution point representing the stack trace element. null when it is the main module or when the module is unknown
        line - the line number in the query string where the error occured. Line numbering starts at 1. -1 if unknown
        column - the column number in the query string where the error occured. Column numbering starts at 1. -1 if unknown
        position - the position in the query string where the error occured. This is a 0 based position. -1 if unknown
        function - the QName of the function in which the exception occurred, or null if it occurred outside an enclosing function
        variables - the variables in scope at this execution point, or null if no variable value retrieval is possible
    • Method Detail

      • getModuleURI

        public java.lang.String getModuleURI()
        Gets the module URI containing the execution point represented by this stack trace element. null when it is the main module or when the module is unknown.
        Returns:
        the module URI containing the excution point represented by the stack trace element or null
      • getPosition

        public int getPosition()
        Gets the character position in the query string containing the execution point represented by this stack trace element.

        This is a 0 based position. -1 if unknown.

Returns:
the character position in the query string containing the execution point represented by the stack trace element
  • getLineNumber

    public int getLineNumber()
    Gets the line number in the query string containing the execution point represented by this stack trace element.

    Line numbering starts at 1. -1 is returned if the line number is unknown. If the implementation does not support this method, it must return -1

    Returns:
    the line number in the query string containing the execution point represented by the stack trace element
  • getColumnNumber

    public int getColumnNumber()
    Gets the column number in the query string containing the execution point represented by this stack trace element.

    Column numbering starts at 1. -1 is returned if the column number is unknown. If the implementation does not support this method, it must return -1

    Returns:
    the column number in the query string containing the execution point represented by the stack trace element
  • getFunctionQName

    public javax.xml.namespace.QName getFunctionQName()
    Gets the QName of the function in which the error occurred, or null if it occurred outside an enclosing function (in a main module).
    Returns:
    the QName of the function in which the error occurred for this stack element or null if it occurred outside an enclosing function
  • getVariables

    public XQStackTraceVariable[] getVariables()
    Gets the variables in scope at this execution point, or null if no variable value retrieval is possible.
    Returns:
    the variables in scope at this execution point, or null if no variable value retrieval is possible.