Пакет jdk.jshell

Предоставляет интерфейсы для создания инструментов, таких как цикл чтения-вычисления-вывода (REPL), который интерактивно выполняет «фрагменты» кода на языке программирования Java. «Фрагментом» считается отдельное выражение, оператор или объявление. Эту функциональность можно использовать для расширения таких инструментов, как IDE, или применять автономно.

JShell — центральный класс. Экземпляр JShell хранит состояние вычислений, включающее текущий набор исходных фрагментов и созданное ими состояние выполнения.

Каждый исходный фрагмент представлен экземпляром подкласса Snippet. Например, оператор представлен экземпляром StatementSnippet, а объявление метода — экземпляром MethodSnippet. Фрагменты создаются при вызове JShell.eval(String) с входными данными, содержащими один или несколько фрагментов кода.

О каждом изменении состояния компиляции фрагмента сообщается с помощью SnippetEvent. Существует три основных типа изменений состояния фрагмента: он может быть создан с помощью eval, удалён из активного состояния исходного кода с помощью JShell.drop(jdk.jshell.Snippet) или его состояние может обновиться вследствие изменения состояния другого фрагмента. Например, если заданы js, экземпляр JShell, выполнение js.eval("int x = 5;") добавит переменную x в состояние исходного кода и создаст событие, описывающее создание VarSnippet для x. Затем выполнение js.eval("int timesx(int val) { return val * x; }") добавит метод в состояние исходного кода и создаст событие, описывающее создание MethodSnippet для timesx. Предположим, что varx содержит фрагмент, созданный первым вызовом eval. Выполнение js.drop(varx) создаст два события: одно — об изменении состояния фрагмента переменной на DROPPED, другое — об обновлении фрагмента метода (который теперь содержит неразрешённую ссылку на 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; возвращаемые значения этих методов — списки событий, созданных соответствующим вызовом. Поэтому, как и в примере выше, события можно использовать и без подписки на их получение.

Если вы опробуете этот пример, то увидите, что оператор или объявление переменной без завершающей точки с запятой просто не будет выполнено. Незавершённая запись (например, предполагаемый многострочный метод) также не будет выполнена после ввода одной строки. Утилиты в SourceCodeAnalysis предоставляют средства анализа границ исходного кода и его полноты, позволяющие обрабатывать подобные случаи. SourceCodeAnalysis также предлагает варианты дополнения введённых данных, что можно использовать, например, для автодополнения по клавише Tab.