- All Implemented Interfaces:
- Serializable,- Comparable<Snippet.Status>,- Constable
- Enclosing class:
- Snippet
JShell.
 
 The Status changes as the state changes.
 For example, creation of another snippet with
 eval
 may resolve dependencies of this Snippet (or invalidate those dependencies), or
 overwrite
 this Snippet changing its
 Status.
 
 Important properties associated with Status are:
 isDefined(), if it is visible to other
 existing and new snippets; and
 isActive(), if, as the
 JShell state changes, the snippet will update, possibly
 changing Status.
 An executable Snippet can only be executed if it is in the
 VALID Status.
- See Also:
- 
Nested Class SummaryNested classes/interfaces declared in class java.lang.EnumEnum.EnumDesc<E extends Enum<E>>
- 
Enum Constant SummaryEnum ConstantsEnum ConstantDescriptionThe snippet is inactive because of an explicit call to theJShell.drop(Snippet).The snippet is inactive because it does not yet exist.The snippet is inactive because it has been replaced by a new snippet.The snippet is a declaration snippet with potentially recoverable unresolved references or other issues in its body (in the context of currentJShellstate).The snippet is a declaration snippet with potentially recoverable unresolved references or other issues (in the context of currentJShellstate).The snippet is inactive because it failed compilation on initial evaluation and it is not capable of becoming valid with further changes to the JShell state.The snippet is a valid snippet (in the context of currentJShellstate).
- 
Method SummaryModifier and TypeMethodDescriptionbooleanisActive()Indicates whether the Snippet is active, that is, will a persistent snippet be re-evaluated when a newJShell.eval(String)orJShell.drop(Snippet)that could change its status is invoked.booleanIndicates whether the snippet is currently part of the defined state of the JShell.static Snippet.StatusReturns the enum constant of this class with the specified name.static Snippet.Status[]values()Returns an array containing the constants of this enum class, in the order they are declared.
- 
Enum Constant Details- 
VALIDThe snippet is a valid snippet (in the context of currentJShellstate). Only snippets withVALIDStatuscan be executed (though not allVALIDsnippets have executable code).The snippet is defined ( isDefined() == true). If the snippet is a declaration or import (Snippet.Kind.isPersistent()), it is visible to other snippetsThe snippet will update as dependents change ( isActive() == true), its status could becomeRECOVERABLE_DEFINED,RECOVERABLE_NOT_DEFINED,DROPPED, orOVERWRITTEN.
- 
RECOVERABLE_DEFINEDThe snippet is a declaration snippet with potentially recoverable unresolved references or other issues in its body (in the context of currentJShellstate). Only aDeclarationSnippetcan have thisStatus.The snippet has a valid signature and it is visible to other snippets ( isDefined() == true) and thus can be referenced in existing or new snippets but the snippet cannot be executed. AnUnresolvedReferenceExceptionwill be thrown on an attempt to execute it.The snippet will update as dependents change ( isActive() == true), its status could becomeVALID,RECOVERABLE_NOT_DEFINED,DROPPED, orOVERWRITTEN.Note: both RECOVERABLE_DEFINEDandRECOVERABLE_NOT_DEFINEDindicate potentially recoverable errors, they differ in that, forRECOVERABLE_DEFINED, the snippet is defined.
- 
RECOVERABLE_NOT_DEFINEDThe snippet is a declaration snippet with potentially recoverable unresolved references or other issues (in the context of currentJShellstate). Only aDeclarationSnippetcan have thisStatus.The snippet has an invalid signature or the implementation is otherwise unable to define it. The snippet it is not visible to other snippets ( isDefined() == false) and thus cannot be referenced or executed.The snippet will update as dependents change ( isActive() == true), its status could becomeVALID,RECOVERABLE_DEFINED,DROPPED, orOVERWRITTEN.Note: both RECOVERABLE_DEFINEDandRECOVERABLE_NOT_DEFINEDindicate potentially recoverable errors, they differ in that, forRECOVERABLE_DEFINED, the snippet is defined.
- 
DROPPEDThe snippet is inactive because of an explicit call to theJShell.drop(Snippet).The snippet is not visible to other snippets ( isDefined() == false) and thus cannot be referenced or executed.The snippet will not update as dependents change ( isActive() == false), itsStatuswill never change again.
- 
OVERWRITTENThe snippet is inactive because it has been replaced by a new snippet. This occurs when the new snippet added withevalmatches a previous snippet. ATypeDeclSnippetwill match anotherTypeDeclSnippetif the names match. For exampleclass X { }will overwriteclass X { int ii; }orinterface X { }. AMethodSnippetwill match anotherMethodSnippetif the names and parameter types match. For examplevoid m(int a) { }will overwriteint m(int a) { return a+a; }. AVarSnippetwill match anotherVarSnippetif the names match. For exampledouble z;will overwritelong z = 2L;. Only aPersistentSnippetcan have thisStatus.The snippet is not visible to other snippets ( isDefined() == false) and thus cannot be referenced or executed.The snippet will not update as dependents change ( isActive() == false), itsStatuswill never change again.
- 
REJECTEDThe snippet is inactive because it failed compilation on initial evaluation and it is not capable of becoming valid with further changes to the JShell state.The snippet is not visible to other snippets ( isDefined() == false) and thus cannot be referenced or executed.The snippet will not update as dependents change ( isActive() == false), itsStatuswill never change again.
- 
NONEXISTENTThe snippet is inactive because it does not yet exist. Used only inSnippetEvent.previousStatusfor new snippets.JShell.status(Snippet)will never return thisStatus.Vacuously, isDefined()andisActive()are both definedfalse.
 
- 
- 
Method Details- 
valuesReturns an array containing the constants of this enum class, in the order they are declared.- Returns:
- an array containing the constants of this enum class, in the order they are declared
 
- 
valueOfReturns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)- Parameters:
- name- the name of the enum constant to be returned.
- Returns:
- the enum constant with the specified name
- Throws:
- IllegalArgumentException- if this enum class has no constant with the specified name
- NullPointerException- if the argument is null
 
- 
isActivepublic boolean isActive()Indicates whether the Snippet is active, that is, will a persistent snippet be re-evaluated when a newJShell.eval(String)orJShell.drop(Snippet)that could change its status is invoked. This is more broad thanisDefined()since a Snippet which isRECOVERABLE_NOT_DEFINEDwill be updated.- Returns:
- trueif the Snippet is active; otherwise- false
 
- 
isDefinedpublic boolean isDefined()Indicates whether the snippet is currently part of the defined state of the JShell. Is it visible to compilation of other snippets?- Returns:
- trueif the Snippet is defined; otherwise- false
 
 
-