Интерфейс Parser
@Deprecated(since="11",
forRemoval=true)
public interface Parser Представляет экземпляр парсера nashorn ECMAScript.
- С:
- 9
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
static Parser | create(String... options) | Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Метод фабрики для создания нового экземпляра Parser. |
CompilationUnitTree | parse(File file,
DiagnosticListener listener) | Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Парсит исходный файл и возвращает дерево единицы компиляции |
CompilationUnitTree | parse(String name,
Reader reader,
DiagnosticListener listener) | Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Парсит чтение и возвращает дерево единицы компиляции |
CompilationUnitTree | parse(String name,
String code,
DiagnosticListener listener) | Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Парсит строковый исходник и возвращает дерево единицы компиляции |
CompilationUnitTree | parse(URL url,
DiagnosticListener listener) | Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Парсит URL исходника и возвращает дерево единицы компиляции |
CompilationUnitTree | parse(Path path,
DiagnosticListener listener) | Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Парсит путь к исходнику и возвращает дерево единицы компиляции |
CompilationUnitTree | parse(ScriptObjectMirror scriptObj,
DiagnosticListener listener) | Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Парсит исходник из объекта скрипта и возвращает дерево единицы компиляции |
Методы
parse
CompilationUnitTree parse(File file,
DiagnosticListener listener)
throws IOException,
NashornException Парсит исходный файл и возвращает дерево единицы компиляции
- Параметры:
-
file- исходный файл для парсинга -
listener- для получения диагностических сообщений от парсера. Может быть null. Если null, при первой ошибке парсинга будет выброшено исключение NashornException. - Возвращает:
- дерево единицы компиляции
- Выбрасывает:
-
NullPointerException- если файл null -
IOException- если произошла ошибка чтения исходного файла для парсинга -
NashornException- выбрасывается, если не указан слушатель, и парсер обнаружил ошибку
parse
CompilationUnitTree parse(Path path,
DiagnosticListener listener)
throws IOException,
NashornException Парсит исходный путь и возвращает дерево единицы компиляции
- Параметры:
-
path- исходный путь для парсинга -
listener- для получения диагностических сообщений от парсера. Может быть null. Если null, при первой ошибке парсинга будет выброшено исключение NashornException. - Возвращает:
- дерево единицы компиляции
- Выбрасывает:
-
NullPointerException- если путь null -
IOException- если произошла ошибка чтения исходного файла для парсинга -
NashornException- выбрасывается, если не указан слушатель, и парсер обнаружил ошибку
parse
CompilationUnitTree parse(URL url,
DiagnosticListener listener)
throws IOException,
NashornException Парсит исходный URL и возвращает дерево единицы компиляции
- Параметры:
-
url- исходный файл для парсинга -
listener- для получения диагностических сообщений от парсера. Может быть null. Если null, при первой ошибке парсинга будет выброшено исключение NashornException. - Возвращает:
- дерево единицы компиляции
- Выбрасывает:
-
NullPointerException- если url null -
IOException- если произошла ошибка чтения исходного файла для парсинга -
NashornException- выбрасывается, если не указан слушатель, и парсер обнаружил ошибку
parse
CompilationUnitTree parse(String name,
Reader reader,
DiagnosticListener listener)
throws IOException,
NashornException Парсит reader и возвращает дерево единицы компиляции
- Параметры:
-
name- имя исходного файла для парсинга -
reader- из которого считывается исходный код -
listener- для получения диагностических сообщений от парсера. Может быть null. Если null, при первой ошибке парсинга будет выброшено исключение NashornException. - Возвращает:
- дерево единицы компиляции
- Выбрасывает:
-
NullPointerException- если имя или reader null -
IOException- если произошла ошибка чтения исходного файла для парсинга -
NashornException- выбрасывается, если не указан слушатель, и парсер обнаружил ошибку
parse
CompilationUnitTree parse(String name,
String code,
DiagnosticListener listener)
throws NashornException Парсит строковый исходный код и возвращает дерево единицы компиляции
- Параметры:
-
name- имя исходного кода -
code- строковый исходный код -
listener- для получения диагностических сообщений от парсера. Может быть null. Если null, при первой ошибке парсинга будет выброшено исключение NashornException. - Возвращает:
- дерево единицы компиляции
- Выбрасывает:
-
NullPointerException- если имя или код null -
NashornException- выбрасывается, если не указан слушатель, и парсер обнаружил ошибку
parse
CompilationUnitTree parse(ScriptObjectMirror scriptObj,
DiagnosticListener listener)
throws NashornException Парсит исходный код из объекта скрипта и возвращает дерево единицы компиляции
- Параметры:
-
scriptObj- объект скрипта, чьи свойства script и name используются для получения исходного кода скрипта -
listener- для получения диагностических сообщений от парсера. Может быть null. Если null, при первой ошибке парсинга будет выброшено исключение NashornException. - Возвращает:
- дерево единицы компиляции
- Выбрасывает:
-
NullPointerException- если scriptObj null -
NashornException- выбрасывается, если не указан слушатель, и парсер обнаружил ошибку
create
static Parser create(String... options)
throws IllegalArgumentException Метод фабрики для создания нового экземпляра Parser.
- Параметры:
-
options- параметры конфигурации для инициализации парсера. В настоящее время поддерживаются следующие параметры:- "--const-as-var"
- обрабатывать объявление "const" как "var"
- "-dump-on-error" или "-doe"
- выводить трассировку стека при ошибке
- "--empty-statements"
- включать узлы пустых операторов
- "--no-syntax-extensions" или "-nse"
- отключать расширения синтаксиса ECMAScript
- "-scripting"
- включать расширения режима скриптинга
- "-strict"
- включать режим строгости ECMAScript
- "--language=es6"
- включать режим парсинга ECMAScript 6
- "--es6-module"
- включать режим парсинга модулей ECMAScript 6. Этот параметр подразумевает --language=es6
- Возвращает:
- новый экземпляр Parser.
- Выбрасывает:
-
NullPointerException- если массив options или любой из его элементов равен null -
IllegalArgumentException- при недопустимом значении параметра.
© 1993, 2020, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/jdk.scripting.nashorn/jdk/nashorn/api/tree/Parser.html