Класс ScriptException

javax.script.ScriptException

Все реализуемые интерфейсы:: Serializable

public class ScriptException extends Exception

Общий класс Exception для API сценариев. Проверяемые типы исключений, выбрасываемые нижележащими реализациями сценариев, должны быть обёрнуты в экземпляры ScriptException. Класс содержит поля для хранения номеров строк и столбцов, а также имён файлов, если эта информация доступна.

Начиная с версии:

1.6

См. также:

Краткое описание конструкторов

Конструктор	Описание
`ScriptException(Exception e)`	Создаёт `ScriptException`, оборачивающее `Exception`, выброшенное нижележащим интерпретатором.
`ScriptException(String s)`	Создаёт `ScriptException` со строкой, которая будет использована в сообщении.
`ScriptException(String message, String fileName, int lineNumber)`	Создаёт `ScriptException` с сообщением, именем файла и номером строки для использования в сообщениях об ошибках.
`ScriptException(String message, String fileName, int lineNumber, int columnNumber)`	Конструктор `ScriptException`, задающий сообщение, имя файла, номер строки и номер столбца.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getColumnNumber()`	Возвращает номер столбца, в котором произошла ошибка.
`String`	`getFileName()`	Возвращает источник сценария, вызвавшего ошибку.
`int`	`getLineNumber()`	Возвращает номер строки, в которой произошла ошибка.
`String`	`getMessage()`	Возвращает сообщение, содержащее строку, переданную конструктору, а также номера строки и столбца и имя файла, если какие-либо из этих данных известны.

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным для передачи этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`Throwable`	`getCause()`	Возвращает причину возникновения этого исключения или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создаёт локализованное описание этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, для передачи этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`printStackTrace()`	Выводит это исключение и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и его трассировку в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и его трассировку в указанный объект записи.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задаёт элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методом `Throwable.printStackTrace()` и связанными методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечёт заданный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечёт заданный промежуток реального времени.

Подробное описание конструкторов

ScriptException

public ScriptException(String s)

Создаёт ScriptException со строкой, которая будет использована в сообщении. Имя файла и номера строки и столбца не заданы.

Параметры:: s — строка для использования в сообщении.

ScriptException

public ScriptException(Exception e)

Создаёт ScriptException, оборачивающее Exception, выброшенное нижележащим интерпретатором. Номера строки и столбца, а также имя файла не заданы.

Параметры:: e — обёрнутое Exception.

ScriptException

public ScriptException(String message, String fileName, int lineNumber)

Создаёт ScriptException с сообщением, именем файла и номером строки для использования в сообщениях об ошибках.

Параметры:: message — строка для использования в сообщении; fileName — имя файла или ресурса, описывающее расположение ошибки сценария, вызвавшей выброс ScriptException.; lineNumber — номер строки, указывающий расположение ошибки сценария, вызвавшей выброс ScriptException.

ScriptException

public ScriptException(String message, String fileName, int lineNumber, int columnNumber)

Конструктор ScriptException, задающий сообщение, имя файла, номер строки и номер столбца.

Параметры:: message — сообщение.; fileName — имя файла; lineNumber — номер строки.; columnNumber — номер столбца.

Подробное описание методов

getMessage

public String getMessage()

Возвращает сообщение, содержащее строку, переданную конструктору, а также номера строки и столбца и имя файла, если какие-либо из этих данных известны.

Переопределяет:: getMessage в классе Throwable
Возвращает:: Сообщение об ошибке.

getLineNumber

public int getLineNumber()

Возвращает номер строки, в которой произошла ошибка.

Возвращает:: Номер строки. Возвращает -1, если номер строки недоступен.

getColumnNumber

public int getColumnNumber()

Возвращает номер столбца, в котором произошла ошибка.

Возвращает:: Номер столбца. Возвращает -1, если номер столбца недоступен.

getFileName

public String getFileName()

Возвращает источник сценария, вызвавшего ошибку.

Возвращает:: Имя файла сценария или другая строка, описывающая источник сценария. Если описание источника недоступно, может быть возвращена определяемая реализацией строка, например <unknown>.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.