Class SnippetEvent
java.lang.Object
jdk.jshell.SnippetEvent
A description of a change to a Snippet. These are generated by direct changes
to state with
JShell.eval(String)
or
JShell.drop(Snippet)
,
or indirectly by these same methods as
dependencies change or Snippets are overwritten. For direct changes, the
causeSnippet()
is null
.
SnippetEvent
is immutable: an access to
any of its methods will always return the same result.
and thus is thread-safe.
- Since:
- 9
-
Method Summary
Modifier and TypeMethodDescriptionEither the snippet whose change caused this update ornull
.An instance ofUnresolvedReferenceException
, if an unresolved reference was encountered, or an instance ofEvalException
if an exception was thrown during execution, otherwisenull
.boolean
Indicates whether the signature has changed.The status before the transition.snippet()
The Snippet which has changedstatus()
The after status.toString()
Return a string representation of the eventvalue()
The result value of successful run.Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Modifier and TypeMethodDescriptionprotected Object
clone()
Creates and returns a copy of this object.boolean
Indicates whether some other object is "equal to" this one.protected void
finalize()
Deprecated, for removal: This API element is subject to removal in a future version.Finalization is deprecated and subject to removal in a future release.final Class
<?> getClass()
Returns the runtime class of thisObject
.int
hashCode()
Returns a hash code value for this object.final void
notify()
Wakes up a single thread that is waiting on this object's monitor.final void
Wakes up all threads that are waiting on this object's monitor.final void
wait()
Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final void
wait
(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.final void
wait
(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
-
Method Details
-
snippet
The Snippet which has changed- Returns:
- the return the Snippet whose
Status
has changed.
-
previousStatus
The status before the transition. If this event describes a Snippet creation returnNONEXISTENT
.- Returns:
- the previousStatus
-
status
The after status. Note: this may be the same as the previous status (not all changes cause aStatus
change.- Returns:
- the status
-
isSignatureChange
public boolean isSignatureChange()Indicates whether the signature has changed. Coming in or out of definition is always a signature change. An overwritten Snippet(status == OVERWRITTEN)
is alwaysfalse
as responsibility for the definition has passed to the overwriting definition.- Returns:
true
if the signature changed; otherwisefalse
-
causeSnippet
-
exception
An instance ofUnresolvedReferenceException
, if an unresolved reference was encountered, or an instance ofEvalException
if an exception was thrown during execution, otherwisenull
.- Returns:
- the exception or
null
.
-
value
The result value of successful run. The value is null if not executed or an exception was thrown.- Returns:
- the value or
null
.
-
toString
-