Перечисление класса Snippet.Status

public static final Snippet.Status VALID

Фрагмент кода является корректным (в контексте текущего состояния JShell). Выполнять можно только фрагменты с VALID Status (хотя не все фрагменты VALID содержат исполняемый код).

Фрагмент кода определён (isDefined() == true). Если фрагмент является объявлением или импортом (Snippet.Kind.isPersistent()), он виден другим фрагментам кода.

Фрагмент кода будет обновляться при изменении зависимых от него фрагментов (isActive() == true); его состояние может стать RECOVERABLE_DEFINED, RECOVERABLE_NOT_DEFINED, DROPPED или OVERWRITTEN.

public static final Snippet.Status RECOVERABLE_DEFINED

Фрагмент кода является фрагментом-объявлением с потенциально устранимыми неразрешёнными ссылками или другими проблемами в его теле (в контексте текущего состояния JShell). Такое Status может иметь только DeclarationSnippet.

Фрагмент кода имеет корректную сигнатуру и виден другим фрагментам (isDefined() == true), поэтому на него можно ссылаться в существующих или новых фрагментах, но его нельзя выполнить. При попытке выполнить его будет выброшено исключение UnresolvedReferenceException.

Фрагмент кода будет обновляться при изменении зависимых от него фрагментов (isActive() == true); его состояние может стать VALID, RECOVERABLE_NOT_DEFINED, DROPPED или OVERWRITTEN.

Примечание: и RECOVERABLE_DEFINED, и RECOVERABLE_NOT_DEFINED указывают на потенциально устранимые ошибки; они различаются тем, что в случае RECOVERABLE_DEFINED фрагмент кода определён.

public static final Snippet.Status RECOVERABLE_NOT_DEFINED

Фрагмент кода является фрагментом-объявлением с потенциально устранимыми неразрешёнными ссылками или другими проблемами (в контексте текущего состояния JShell). Такое Status может иметь только DeclarationSnippet.

Фрагмент кода имеет некорректную сигнатуру или реализация по иной причине не может определить его. Фрагмент кода не виден другим фрагментам (isDefined() == false), поэтому на него нельзя ссылаться и его нельзя выполнить.

Фрагмент кода будет обновляться при изменении зависимых от него фрагментов (isActive() == true); его состояние может стать VALID, RECOVERABLE_DEFINED, DROPPED или OVERWRITTEN.

Примечание: и RECOVERABLE_DEFINED, и RECOVERABLE_NOT_DEFINED указывают на потенциально устранимые ошибки; они различаются тем, что в случае RECOVERABLE_DEFINED фрагмент кода определён.

public static final Snippet.Status DROPPED

Фрагмент кода неактивен из-за явного вызова JShell.drop(Snippet).

Фрагмент кода не виден другим фрагментам (isDefined() == false), поэтому на него нельзя ссылаться и его нельзя выполнить.

Фрагмент кода не будет обновляться при изменении зависимых от него фрагментов (isActive() == false); его Status больше никогда не изменится.

public static final Snippet.Status OVERWRITTEN

Фрагмент кода неактивен, поскольку он был заменён новым фрагментом. Это происходит, когда новый фрагмент, добавленный с помощью eval, совпадает с предыдущим фрагментом. TypeDeclSnippet совпадает с другим TypeDeclSnippet, если их имена совпадают. Например, class X { } заменит class X { int ii; } или interface X { }. MethodSnippet совпадает с другим MethodSnippet, если совпадают имена и типы параметров. Например, void m(int a) { } заменит int m(int a) { return a+a; }. VarSnippet совпадает с другим VarSnippet, если их имена совпадают. Например, double z; заменит long z = 2L;. Такое Status может иметь только PersistentSnippet.

Фрагмент кода не виден другим фрагментам (isDefined() == false), поэтому на него нельзя ссылаться и его нельзя выполнить.

Фрагмент кода не будет обновляться при изменении зависимых от него фрагментов (isActive() == false); его Status больше никогда не изменится.

public static final Snippet.Status REJECTED

Фрагмент кода неактивен, поскольку при первоначальной оценке не прошёл компиляцию и не может стать корректным при дальнейших изменениях состояния JShell.

Фрагмент кода не виден другим фрагментам (isDefined() == false), поэтому на него нельзя ссылаться и его нельзя выполнить.

Фрагмент кода не будет обновляться при изменении зависимых от него фрагментов (isActive() == false); его Status больше никогда не изменится.

public static final Snippet.Status NONEXISTENT

Фрагмент кода неактивен, поскольку он ещё не существует. Используется только в SnippetEvent.previousStatus() для новых фрагментов. JShell.status(Snippet) никогда не вернёт это Status.

Тривиально, isDefined() и isActive() имеют значение false.

public static Snippet.Status[] values()

Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

public static Snippet.Status valueOf(String name)

Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, использованным для объявления константы перечисления в этом классе. (Лишние пробельные символы не допускаются.)

public boolean isActive()

Показывает, активен ли фрагмент кода, то есть будет ли постоянный фрагмент повторно вычислен при вызове нового JShell.eval(String) или JShell.drop(Snippet), способного изменить его состояние. Это понятие шире, чем isDefined(), поскольку фрагмент кода в состоянии RECOVERABLE_NOT_DEFINED будет обновлён.

public boolean isDefined()

Показывает, является ли фрагмент кода в данный момент частью определённого состояния JShell. Видим ли он при компиляции других фрагментов кода?