Класс SnippetEvent

java.lang.Object

jdk.jshell.SnippetEvent

public class SnippetEvent extends Object

Описание изменения в фрагменте кода (Snippet). Эти события генерируются при прямых изменениях состояния с помощью JShell.eval(String) или JShell.drop(Snippet), или косвенно, когда изменяются зависимости или фрагменты кода перезаписываются. При прямых изменениях, causeSnippet() является null.

SnippetEvent неизменяема: обращение к любому из её методов всегда возвращает один и тот же результат. и, следовательно, потокобезопасна.

Since:: 9

Краткое описание методов

Модификатор и тип	Метод	Описание
`Snippet`	`causeSnippet()`	Либо фрагмент кода, вызвавший это обновление, либо `null`.
`JShellException`	`exception()`	Экземпляр `UnresolvedReferenceException`, если была обнаружена неразрешённая ссылка, или экземпляр `EvalException`, если во время выполнения возникло исключение, в противном случае `null`.
`boolean`	`isSignatureChange()`	Указывает, изменилась ли сигнатура.
`Snippet.Status`	`previousStatus()`	Статус до перехода.
`Snippet`	`snippet()`	Фрагмент кода, который был изменён
`Snippet.Status`	`status()`	Статус после перехода.
`String`	`toString()`	Возвращает строковое представление события
`String`	`value()`	Значение результата успешного выполнения.

Методы, объявленные в классе java.lang.Object

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

Подробное описание методов

snippet

public Snippet snippet()

Фрагмент кода, который был изменён

Возвращает:: возвращает фрагмент кода, чьё Status было изменено.

previousStatus

public Snippet.Status previousStatus()

Статус до перехода. Если это событие описывает создание фрагмента кода, возвращает NONEXISTENT.

Возвращает:: previousStatus

status

public Snippet.Status status()

Статус после перехода. Примечание: он может быть таким же, как и предыдущий статус (не все изменения приводят к Status изменению).

Возвращает:: статус

isSignatureChange

public boolean isSignatureChange()

Указывает, изменилась ли сигнатура. Вход или выход из определения всегда является изменением сигнатуры. Перезаписанный фрагмент кода (status == OVERWRITTEN) всегда является false, так как ответственность за определение перешла к перезаписывающему определению.

Возвращает:: true, если сигнатура изменилась; в противном случае false

causeSnippet

public Snippet causeSnippet()

Либо фрагмент кода, вызвавший это обновление, либо null. Это возвращает null, если это изменение является созданием нового фрагмента кода через eval или это явное удаление фрагмента кода с помощью drop.

Возвращает:: фрагмент кода, который вызвал это изменение, или null, если изменение вызвано действием API.

exception

public JShellException exception()

Экземпляр UnresolvedReferenceException, если была обнаружена неразрешённая ссылка, или экземпляр EvalException, если во время выполнения возникло исключение, в противном случае null.

Возвращает:: исключение или null.

value

public String value()

Значение результата успешного выполнения. Значение равно null, если не было выполнено или возникло исключение.

Возвращает:: значение или null.

toString

public String toString()

Возвращает строковое представление события

Overrides:: toString в классе Object
Возвращает:: описательное представление SnippetEvent

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.jshell/jdk/jshell/SnippetEvent.html