public abstract class RhinoException
extends java.lang.RuntimeException
| Modifier and Type | Method and Description |
|---|---|
int |
columnNumber()
The column number of the location of the error, or zero if unknown.
|
java.lang.String |
details() |
java.lang.String |
getMessage() |
ScriptStackElement[] |
getScriptStack()
Get the script stack of this exception as an array of
ScriptStackElements. |
ScriptStackElement[] |
getScriptStack(int limit,
java.lang.String hideFunction)
Get the script stack of this exception as an array of
ScriptStackElements. |
java.lang.String |
getScriptStackTrace()
Get a string representing the script stack of this exception.
|
java.lang.String |
getScriptStackTrace(java.io.FilenameFilter filter)
Deprecated.
the filter argument is ignored as we are able to recognize script stack elements
by our own. Use #getScriptStackTrace() instead.
|
java.lang.String |
getScriptStackTrace(int limit,
java.lang.String functionName)
Get a string representing the script stack of this exception.
|
static StackStyle |
getStackStyle()
Return the current stack style in use.
|
void |
initColumnNumber(int columnNumber)
Initialize the column number of the script statement causing the error.
|
void |
initLineNumber(int lineNumber)
Initialize the line number of the script statement causing the error.
|
void |
initLineSource(java.lang.String lineSource)
Initialize the text of the source line containing the error.
|
void |
initSourceName(java.lang.String sourceName)
Initialize the uri of the script source containing the error.
|
int |
lineNumber()
Returns the line number of the statement causing the error, or zero if not available.
|
java.lang.String |
lineSource()
The source text of the line causing the error, or null if unknown.
|
void |
printStackTrace(java.io.PrintStream s) |
void |
printStackTrace(java.io.PrintWriter s) |
static void |
setStackStyle(StackStyle style)
Specify the stack style to use from between three different formats: "Rhino" (the default),
"Mozilla", and "V8." See StackStyle for information about each.
|
java.lang.String |
sourceName()
Get the uri of the script source containing the error, or null if that information is not
available.
|
static void |
useMozillaStackStyle(boolean flag)
Tell subclasses of
RhinoException whether to use the Mozilla/Firefox style of
rendering script stacks (functionName()@fileName:lineNumber) instead of Rhino's
own Java-inspired format ( at fileName:lineNumber (functionName)). |
static boolean |
usesMozillaStackStyle()
Returns true if subclasses of
RhinoException use the Mozilla/Firefox style of
rendering script stacks (functionName()@fileName:lineNumber) instead of Rhino's
own Java-inspired format ( at fileName:lineNumber (functionName)). |
public final java.lang.String getMessage()
getMessage in class java.lang.Throwablepublic java.lang.String details()
public final java.lang.String sourceName()
public final void initSourceName(java.lang.String sourceName)
sourceName - the uri of the script source responsible for the error. It should not be
null.java.lang.IllegalStateException - if the method is called more then once.public final int lineNumber()
public final void initLineNumber(int lineNumber)
lineNumber - the line number in the script source. It should be positive number.java.lang.IllegalStateException - if the method is called more then once.public final int columnNumber()
public final void initColumnNumber(int columnNumber)
columnNumber - the column number in the script source. It should be positive number.java.lang.IllegalStateException - if the method is called more then once.public final java.lang.String lineSource()
public final void initLineSource(java.lang.String lineSource)
lineSource - the text of the source line responsible for the error. It should not be
null.java.lang.IllegalStateException - if the method is called more then once.public java.lang.String getScriptStackTrace()
public java.lang.String getScriptStackTrace(int limit,
java.lang.String functionName)
limit - the number of stack frames returnedfunctionName - the name of a function on the stack -- frames below it will be ignored@Deprecated public java.lang.String getScriptStackTrace(java.io.FilenameFilter filter)
filter - ignoredpublic ScriptStackElement[] getScriptStack()
ScriptStackElements. If
optimization is enabled, this includes java stack elements whose source and method names
suggest they have been generated by the Rhino script compiler.public ScriptStackElement[] getScriptStack(int limit, java.lang.String hideFunction)
ScriptStackElements. If
optimization is enabled, this includes java stack elements whose source and method names
suggest they have been generated by the Rhino script compiler.limit - the number of stack frames returned, or -1 for unlimitedhideFunction - the name of a function on the stack -- frames below it will be ignored,
or nullpublic void printStackTrace(java.io.PrintWriter s)
printStackTrace in class java.lang.Throwablepublic void printStackTrace(java.io.PrintStream s)
printStackTrace in class java.lang.Throwablepublic static boolean usesMozillaStackStyle()
RhinoException use the Mozilla/Firefox style of
rendering script stacks (functionName()@fileName:lineNumber) instead of Rhino's
own Java-inspired format ( at fileName:lineNumber (functionName)).ScriptStackElementpublic static void useMozillaStackStyle(boolean flag)
RhinoException whether to use the Mozilla/Firefox style of
rendering script stacks (functionName()@fileName:lineNumber) instead of Rhino's
own Java-inspired format ( at fileName:lineNumber (functionName)). Use
"setStackStyle" to select between more than just the "Mozilla" and "Rhino" formats.flag - whether to render stacks in Mozilla/Firefox styleScriptStackElementpublic static void setStackStyle(StackStyle style)
style - the style to select -- an instance of the StackStyle classStackStylepublic static StackStyle getStackStyle()