Class SnippetEvent

java.lang.Object

jdk.jshell.SnippetEvent

public class SnippetEvent
extends Object

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 Type	Method	Description
Snippet	causeSnippet()	Either the snippet whose change caused this update or null.
JShellException	exception()	An instance of UnresolvedReferenceException, if an unresolved reference was encountered, or an instance of EvalException if an exception was thrown during execution, otherwise null.
boolean	isSignatureChange()	Indicates whether the signature has changed.
Snippet.Status	previousStatus()	The status before the transition.
Snippet	snippet()	The Snippet which has changed
Snippet.Status	status()	The after status.
String	toString()	Return a string representation of the event
String	value()	The result value of successful run.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Method Details

snippet

public Snippet snippet()

The Snippet which has changed

Returns:

the return the Snippet whose Status has changed.

previousStatus

public Snippet.Status previousStatus()

The status before the transition. If this event describes a Snippet creation return NONEXISTENT.

Returns:

the previousStatus

status

public Snippet.Status status()

The after status. Note: this may be the same as the previous status (not all changes cause a Status 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 always false as responsibility for the definition has passed to the overwriting definition.

Returns:

true if the signature changed; otherwise false

causeSnippet

public Snippet causeSnippet()

Either the snippet whose change caused this update or null. This returns null if this change is the creation of a new Snippet via eval or it is the explicit drop of a Snippet with drop.

Returns:

the Snippet which caused this change or null if directly caused by an API action.

exception

public JShellException exception()

An instance of UnresolvedReferenceException, if an unresolved reference was encountered, or an instance of EvalException if an exception was thrown during execution, otherwise null.

Returns:

the exception or null.

value

public String 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

public String toString()

Return a string representation of the event

Overrides:

toString in class Object

Returns:

a descriptive representation of the SnippetEvent