java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.script.ScriptException
- All Implemented Interfaces:
Serializable
The generic
Exception
class for the Scripting APIs. Checked
exception types thrown by underlying scripting implementations must be wrapped in instances of
ScriptException
. The class has members to store line and column numbers and
filenames if this information is available.- Since:
- 1.6
- See Also:
-
Constructor Summary
ConstructorDescriptionCreates aScriptException
wrapping anException
thrown by an underlying interpreter.Creates aScriptException
with a String to be used in its message.ScriptException
(String message, String fileName, int lineNumber) Creates aScriptException
with message, filename and linenumber to be used in error messages.ScriptException
(String message, String fileName, int lineNumber, int columnNumber) ScriptException
constructor specifying message, filename, line number and column number. -
Method Summary
Modifier and TypeMethodDescriptionint
Get the column number on which an error occurred.Get the source of the script causing the error.int
Get the line number on which an error occurred.Returns a message containing the String passed to a constructor as well as line and column numbers and filename if any of these are known.Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Constructor Details
-
ScriptException
Creates aScriptException
with a String to be used in its message. Filename, and line and column numbers are unspecified.- Parameters:
s
- The String to use in the message.
-
ScriptException
Creates aScriptException
wrapping anException
thrown by an underlying interpreter. Line and column numbers and filename are unspecified.- Parameters:
e
- The wrappedException
.
-
ScriptException
Creates aScriptException
with message, filename and linenumber to be used in error messages.- Parameters:
message
- The string to use in the messagefileName
- The file or resource name describing the location of a script error causing theScriptException
to be thrown.lineNumber
- A line number describing the location of a script error causing theScriptException
to be thrown.
-
ScriptException
ScriptException
constructor specifying message, filename, line number and column number.- Parameters:
message
- The message.fileName
- The filenamelineNumber
- the line number.columnNumber
- the column number.
-
-
Method Details
-
getMessage
Returns a message containing the String passed to a constructor as well as line and column numbers and filename if any of these are known.- Overrides:
getMessage
in classThrowable
- Returns:
- The error message.
-
getLineNumber
public int getLineNumber()Get the line number on which an error occurred.- Returns:
- The line number. Returns -1 if a line number is unavailable.
-
getColumnNumber
public int getColumnNumber()Get the column number on which an error occurred.- Returns:
- The column number. Returns -1 if a column number is unavailable.
-
getFileName
Get the source of the script causing the error.- Returns:
- The file name of the script or some other string describing the script source. May return some implementation-defined string such as <unknown> if a description of the source is unavailable.
-