モジュール jdk.scripting.nashorn

パッケージ jdk.nashorn.api.tree

インタフェースParser

public interface Parser

nashorn ECMAScriptパーサー・インスタンスを表します。

導入されたバージョン:

9

メソッドのサマリー

修飾子と型	メソッド	説明
static Parser	create(String... options)	Parserの新しいインスタンスを作成するためのファクトリ・メソッド。
CompilationUnitTree	parse(File file, DiagnosticListener listener)	ソース・ファイルを解析し、コンパイル単位ツリーを返します。
CompilationUnitTree	parse(String name, Reader reader, DiagnosticListener listener)	リーダーを解析し、コンパイル単位ツリーを返します。
CompilationUnitTree	parse(String name, String code, DiagnosticListener listener)	文字列ソースを解析し、コンパイル単位ツリーを返します。
CompilationUnitTree	parse(URL url, DiagnosticListener listener)	ソースURLを解析し、コンパイル単位ツリーを返します。
CompilationUnitTree	parse(Path path, DiagnosticListener listener)	ソース・パスを解析し、コンパイル単位ツリーを返します。
CompilationUnitTree	parse(ScriptObjectMirror scriptObj, DiagnosticListener listener)	スクリプト・オブジェクトからソースを解析し、コンパイル単位ツリーを返します。

メソッドの詳細

parse

CompilationUnitTree parse(File file,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

ソース・ファイルを解析し、コンパイル単位ツリーを返します。

パラメータ:

file - 解析するソース・ファイル

listener - パーサーから診断メッセージを受け取る。 これはnullでもかまいません。nullが渡された場合、最初の解析エラー時にNashornExceptionがスローされます。

戻り値:

コンパイル単位ツリー

例外:

NullPointerException - fileが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

リーダーを解析し、コンパイル単位ツリーを返します。

パラメータ:

name - 解析するソース・ファイルの名前

reader - ソースが読み取られる

listener - パーサーから診断メッセージを受け取る。 これはnullでもかまいません。nullが渡された場合、最初の解析エラー時にNashornExceptionがスローされます。

戻り値:

コンパイル単位ツリー

例外:

NullPointerException - 名前またはリーダーが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 - スクリプト・ソースにスクリプト・プロパティと名前プロパティが使用されるスクリプト・オブジェクト

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 strictモードを有効にします

"--language=es6"

ECMAScript 6解析モードを有効にします

"--es6-module"

ECMAScript 6モジュールの解析モードを有効にします。 このオプションは--language=es6を意味

戻り値:

新しいParserインスタンス。

例外:

NullPointerException - options配列またはその要素のいずれかがnullの場合

IllegalArgumentException - サポートされていないオプション値。