パッケージ jdk.jshell
JShell
は中央クラスです。 JShell
のインスタンスは評価ステートを保持します。評価ステートは、ソース・スニペットの現在のセットと、生成された実行ステートの両方です。
各ソース・スニペットは、Snippet
のサブクラスのインスタンスで表されます。 たとえば、文はStatementSnippet
のインスタンスで表され、メソッド宣言はMethodSnippet
のインスタンスで表されます。 スニペットは、JShell.eval(String)
が1つ以上のコード・スニペットを含む入力で呼び出されたときに作成されます。
スニペットのコンパイル・ステータスの変更は、SnippetEvent
で報告されます。 スニペットのステータスには3つの主要な変更があります: eval
で作成することができます。JShell.drop(jdk.jshell.Snippet)
を使用してアクティブなソース状態から削除することができます。また、別のスニペットの状態変更の結果としてステータスを更新することもできます。 例えば: 与えられたjs
、JShell
のインスタンス、js.eval("int x = 5;")
を実行すると、変数x
がソース状態に追加され、x
のVarSnippet
の作成を記述するイベントが生成されます。 その後、js.eval("int timesx(int val) { return val * x; }")
を実行すると、ソース状態にメソッドが追加され、timesx
のMethodSnippet
の作成を記述するイベントが生成されます。 varx
がeval
への最初の呼び出しによって作成されたスニペットを保持し、js.drop(varx)
を実行すると2つのイベントが生成されるものとします: 1つは変数スニペットのステータスをDROPPED
に変更するメソッド、もう1つはメソッド・スニペット(これで、x
への未解決の参照があります)を更新するメソッドです。
もちろん、APIの一般的なアプリケーションでは、入力は固定ストリングではなく、ユーザーからの入力となります。 以下は、APIを使ってREPLを実装する方法の非常に簡単な例です。
import java.io.ByteArrayInputStream;
import java.io.Console;
import java.util.List;
import jdk.jshell.*;
import jdk.jshell.Snippet.Status;
class ExampleJShell {
public static void main(String[] args) {
Console console = System.console();
try (JShell js = JShell.create()) {
do {
System.out.print("Enter some Java code: ");
String input = console.readLine();
if (input == null) {
break;
}
List<SnippetEvent> events = js.eval(input);
for (SnippetEvent e : events) {
StringBuilder sb = new StringBuilder();
if (e.causeSnippet == null) {
// We have a snippet creation event
switch (e.status) {
case VALID:
sb.append("Successful ");
break;
case RECOVERABLE_DEFINED:
sb.append("With unresolved references ");
break;
case RECOVERABLE_NOT_DEFINED:
sb.append("Possibly reparable, failed ");
break;
case REJECTED:
sb.append("Failed ");
break;
}
if (e.previousStatus == Status.NONEXISTENT) {
sb.append("addition");
} else {
sb.append("modification");
}
sb.append(" of ");
sb.append(e.snippet.source());
System.out.println(sb);
if (e.value != null) {
System.out.printf("Value is: %s\n", e.value);
}
System.out.flush();
}
}
} while (true);
}
System.out.println("\nGoodbye");
}
}
ステータス変更イベントに登録するには、JShell.onSnippetEvent(java.util.function.Consumer)
を使用します。 これらのイベントはeval
とdrop
によってのみ生成され、これらのメソッドの戻り値はその呼び出しによって生成されたイベントのリストです。 したがって、上記の例のように、イベントを登録することなくイベントを使用することができます。
この例を試してみると、セミコロンで文または変数宣言を終了できないことが単に失敗することがわかります。 未終了のエントリ(例えば、所望のマルチ・ライン法)も1行後に失敗します。 SourceCodeAnalysis
のユーティリティは、それらのようなケースに対処するために、ソース境界と完全性分析を提供します。 SourceCodeAnalysis
は、タブ補完で使用される可能性のある、入力の推奨補完も提供します。
- 導入されたバージョン:
- 9
-
インタフェースのサマリーインタフェース説明
analyzeCompletion(String input)
の結果。与えられたユーザー入力の継続候補者のための文書。Javaソースのスニペットを有効なトップレベルJavaソースにラップします。与えられたユーザー入力の継続候補。 -
クラスのサマリークラス説明すべての宣言スニペットのグループ化: 変数宣言(
VarSnippet
)、メソッド宣言(MethodSnippet
)、および型宣言(TypeDeclSnippet
)。スニペットの診断情報。有効なJavaプログラミング言語コードではないコードのスニペット。代入式または可変値式のスニペット。インポート宣言のスニペット。JShell評価状態エンジン。JShell
インスタンスのビルダー。メソッド定義用のスニペット。将来のコードに影響を与え続けるスニペットのグループ化。スニペットは、JShell.eval(java.lang.String)
に渡されるJavaソース・コードのスニペットを表します。スニペットへの変更の説明。ソース・コード入力用の解析ユーティリティを提供します。可能な修飾名のリスト。文のスニペット。型定義のスニペット(クラス、インタフェース、enum、または注釈インタフェースの定義)。変数定義のスニペット。 -
列挙クラスの概要列挙クラス説明スニペットの一般的な種類について説明します。スニペットの現在の状態を示します。スニペットの詳細な種類。与えられた入力の完全性を記述します。
-
例外のサマリーException説明実行中のクライアント内でスローされるスロー可能オブジェクトをラップします。JShellのスーパークラスは例外を生成しました
RECOVERABLE_DEFINED
スニペットを実行しようとした際に例外が報告されました。