@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.
Represents nashorn ECMAScript parser instance.
- Since:
- 9
-
Method Summary
Modifier and Type Method Description static Parser
create(String... options)
Deprecated, for removal: This API element is subject to removal in a future version.Factory method to create a new instance of Parser.CompilationUnitTree
parse(File file, DiagnosticListener listener)
Deprecated, for removal: This API element is subject to removal in a future version.Parses the source file and returns compilation unit treeCompilationUnitTree
parse(String name, Reader reader, DiagnosticListener listener)
Deprecated, for removal: This API element is subject to removal in a future version.Parses the reader and returns compilation unit treeCompilationUnitTree
parse(String name, String code, DiagnosticListener listener)
Deprecated, for removal: This API element is subject to removal in a future version.Parses the string source and returns compilation unit treeCompilationUnitTree
parse(URL url, DiagnosticListener listener)
Deprecated, for removal: This API element is subject to removal in a future version.Parses the source url and returns compilation unit treeCompilationUnitTree
parse(Path path, DiagnosticListener listener)
Deprecated, for removal: This API element is subject to removal in a future version.Parses the source Path and returns compilation unit treeCompilationUnitTree
parse(ScriptObjectMirror scriptObj, DiagnosticListener listener)
Deprecated, for removal: This API element is subject to removal in a future version.Parses the source from script object and returns compilation unit tree
-
Method Details
-
parse
CompilationUnitTree parse(File file, DiagnosticListener listener) throws IOException, NashornExceptionDeprecated, for removal: This API element is subject to removal in a future version.Parses the source file and returns compilation unit tree- Parameters:
file
- source file to parselistener
- to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.- Returns:
- compilation unit tree
- Throws:
NullPointerException
- if file is nullIOException
- if parse source read failsNashornException
- is thrown if no listener is supplied and parser encounters error
-
parse
CompilationUnitTree parse(Path path, DiagnosticListener listener) throws IOException, NashornExceptionDeprecated, for removal: This API element is subject to removal in a future version.Parses the source Path and returns compilation unit tree- Parameters:
path
- source Path to parselistener
- to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.- Returns:
- compilation unit tree
- Throws:
NullPointerException
- if path is nullIOException
- if parse source read failsNashornException
- is thrown if no listener is supplied and parser encounters error
-
parse
CompilationUnitTree parse(URL url, DiagnosticListener listener) throws IOException, NashornExceptionDeprecated, for removal: This API element is subject to removal in a future version.Parses the source url and returns compilation unit tree- Parameters:
url
- source file to parselistener
- to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.- Returns:
- compilation unit tree
- Throws:
NullPointerException
- if url is nullIOException
- if parse source read failsNashornException
- is thrown if no listener is supplied and parser encounters error
-
parse
CompilationUnitTree parse(String name, Reader reader, DiagnosticListener listener) throws IOException, NashornExceptionDeprecated, for removal: This API element is subject to removal in a future version.Parses the reader and returns compilation unit tree- Parameters:
name
- name of the source file to parsereader
- from which source is readlistener
- to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.- Returns:
- compilation unit tree
- Throws:
NullPointerException
- if name or reader is nullIOException
- if parse source read failsNashornException
- is thrown if no listener is supplied and parser encounters error
-
parse
CompilationUnitTree parse(String name, String code, DiagnosticListener listener) throws NashornExceptionDeprecated, for removal: This API element is subject to removal in a future version.Parses the string source and returns compilation unit tree- Parameters:
name
- of the sourcecode
- string sourcelistener
- to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.- Returns:
- compilation unit tree
- Throws:
NullPointerException
- if name or code is nullNashornException
- is thrown if no listener is supplied and parser encounters error
-
parse
CompilationUnitTree parse(ScriptObjectMirror scriptObj, DiagnosticListener listener) throws NashornExceptionDeprecated, for removal: This API element is subject to removal in a future version.Parses the source from script object and returns compilation unit tree- Parameters:
scriptObj
- script object whose script and name properties are used for script sourcelistener
- to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.- Returns:
- compilation unit tree
- Throws:
NullPointerException
- if scriptObj is nullNashornException
- is thrown if no listener is supplied and parser encounters error
-
create
Deprecated, for removal: This API element is subject to removal in a future version.Factory method to create a new instance of Parser.- Parameters:
options
- configuration options to initialize the Parser. Currently the following options are supported:- "--const-as-var"
- treat "const" declaration as "var"
- "-dump-on-error" or "-doe"
- dump stack trace on error
- "--empty-statements"
- include empty statement nodes
- "--no-syntax-extensions" or "-nse"
- disable ECMAScript syntax extensions
- "-scripting"
- enable scripting mode extensions
- "-strict"
- enable ECMAScript strict mode
- "--language=es6"
- enable ECMAScript 6 parsing mode
- "--es6-module"
- enable ECMAScript 6 module parsing mode. This option implies --language=es6
- Returns:
- a new Parser instance.
- Throws:
NullPointerException
- if options array or any of its element is nullIllegalArgumentException
- on unsupported option value.
-