模块 jdk.scripting.nashorn

软件包 jdk.nashorn.api.tree

Interface Parser

@Deprecated(since="11",
            forRemoval=true)
public interface Parser

Deprecated, for removal: This API element is subject to removal in a future version.

Nashorn JavaScript script engine and APIs, and the jjs tool are deprecated with the intent to remove them in a future release.

表示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

Deprecated, for removal: This API element is subject to removal in a future version.

解析源文件并返回编译单元树

参数

file - 要解析的源文件

listener - 从解析器接收诊断消息。 这可以为null。 如果传递null，则在第一个解析错误时抛出NashornException。

结果

编译单元树

异常

NullPointerException - 如果file为null

IOException - 如果解析源读取失败

NashornException - 如果未提供侦听器且解析器遇到错误，则抛出此异常

parse

CompilationUnitTree parse(Path path,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

解析源路径并返回编译单元树

参数

path - 源解析路径

listener - 从解析器接收诊断消息。 这可以为null。 如果传递null，则在第一个解析错误时抛出NashornException。

结果

编译单元树

异常

NullPointerException - 如果path为null

IOException - 如果解析源读取失败

NashornException - 如果未提供侦听器且解析器遇到错误，则抛出此异常

parse

CompilationUnitTree parse(URL url,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

解析源URL并返回编译单元树

参数

url - 要解析的源文件

listener - 从解析器接收诊断消息。 这可以为null。 如果传递null，则在第一个解析错误时抛出NashornException。

结果

编译单元树

异常

NullPointerException - 如果url为null

IOException - 如果解析源读取失败

NashornException - 如果未提供侦听器且解析器遇到错误，则抛出此异常

parse

CompilationUnitTree parse(String name,
                          Reader reader,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

解析读者并返回编译单元树

参数

name - 要解析的源文件的名称

reader - 从中读取源

listener - 从解析器接收诊断消息。 这可以为null。 如果传递null，则在第一个解析错误时抛出NashornException。

结果

编译单元树

异常

NullPointerException - 如果名称或读者为空

IOException - 如果解析源读取失败

NashornException - 如果未提供侦听器且解析器遇到错误，则抛出此异常

parse

CompilationUnitTree parse(String name,
                          String code,
                          DiagnosticListener listener)
                   throws NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

解析字符串源并返回编译单元树

参数

name - 来源

code - 字符串源

listener - 从解析器接收诊断消息。 这可以为null。 如果传递null，则在第一个解析错误时抛出NashornException。

结果

编译单元树

异常

NullPointerException - 如果名称或代码为空

NashornException - 如果未提供侦听器且解析器遇到错误，则抛出此异常

parse

CompilationUnitTree parse(ScriptObjectMirror scriptObj,
                          DiagnosticListener listener)
                   throws NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

从脚本对象解析源并返回编译单元树

参数

scriptObj - 脚本和名称属性用于脚本源的脚本对象

listener - 从解析器接收诊断消息。 这可以为null。 如果传递null，则在第一个解析错误时抛出NashornException。

结果

编译单元树

异常

NullPointerException - 如果scriptObj为null

NashornException - 如果未提供侦听器且解析器遇到错误，则抛出此异常

create

static Parser create(String... options)
              throws IllegalArgumentException

Deprecated, for removal: This API element is subject to removal in a future version.

工厂方法创建Parser的新实例。

参数

options - 初始化Parser的配置选项。 目前支持以下选项：

“--const-AS-VAR”

将“const”声明视为“var”

“-dump-on-error”或“-doe”

转储堆栈跟踪错误

“--empty语句”

包括空语句节点

“--no-syntax-extensions”或“-nse”

禁用ECMAScript语法扩展

“-scripting”

启用脚本模式扩展

“-严格”

启用ECMAScript严格模式

“--language = ES6”

启用ECMAScript 6解析模式

“--es6模块”

启用ECMAScript 6模块解析模式。 此选项意味着--language = es6

结果

一个新的Parser实例。

异常

NullPointerException - 如果options数组或其任何元素为null

IllegalArgumentException - 关于不受支持的选项值。