Интерфейс StackFrame

Location location()

Возвращает Location текущей инструкции в кадре. Метод, для которого был создан этот кадр, также доступен через возвращённую локацию. Для верхнего кадра в стеке эта локация определяет следующую выполняемую инструкцию. Для всех остальных кадров эта локация определяет инструкцию, которая вызвала метод следующего кадра. Если кадр представляет вызов нативного метода, возвращаемая локация указывает на класс и метод, но индекс кода не будет действительным (-1).

ThreadReference thread()

Возвращает поток, в котором выполняется метод этого кадра.

ObjectReference thisObject()

Возвращает значение 'this' для текущего кадра. ObjectReference для 'this' доступен только для не-нативных методов экземпляров.

List<LocalVariable> visibleVariables() throws AbsentInformationException

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

Видимость основана на индексе кода текущей инструкции этого StackFrame. Каждая переменная имеет диапазон индексов байткода, в котором она доступна. Если метод этого стек-кадра совпадает с методом этой переменной, и индекс кода этого StackFrame находится в диапазоне байткода переменной, переменная видна.

Диапазон байткода переменной по крайней мере такой же большой, как область видимости этой переменной, но может продолжаться за пределами области видимости в определенных обстоятельствах:

• компилятор/виртуальная машина не сразу повторно использует слот переменной.
• компилятор/виртуальная машина реализован таким образом, что сообщает расширенный диапазон, возникающий из вышеперечисленных пунктов.

Преимущество расширенного диапазона в том, что переменные из недавно вышедших областей видимости могут оставаться доступными для проверки (это особенно полезно для индексов циклов). Если в результате расширений выше текущее местоположение кадра находится в диапазоне нескольких локальных переменных с тем же именем, переменная с самым большим начальным диапазоном выбирается для возвращаемого списка.

LocalVariable visibleVariableByName(String name) throws AbsentInformationException

Находит LocalVariable, который соответствует заданному имени и виден в текущем местоположении кадра. См. visibleVariables() для получения дополнительной информации о видимости.

Value getValue(LocalVariable variable)

Получает Value LocalVariable в этом кадре. Переменная должна быть действительна для метода этого кадра и видимой в соответствии с правилами, описанными в visibleVariables().

Map<LocalVariable,Value> getValues(List<? extends LocalVariable> variables)

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

void setValue(LocalVariable variable, Value value) throws InvalidTypeException, ClassNotLoadedException

Устанавливает Value LocalVariable в этом кадре. Переменная должна быть действительна для метода этого кадра и видимой в соответствии с правилами, описанными в visibleVariables().

В случае виртуальных потоков целевая виртуальная машина поддерживает установку значений локальных переменных, когда этот кадр является верхним кадром, а поток приостановлен на событии. Целевая виртуальная машина может поддерживать установку локальных переменных и в других случаях.

Значения объектов должны быть совместимы с типом переменной (это подразумевает, что тип переменной должен быть загружен через загрузчик классов закрывающего класса). Примитивные значения должны быть либо совместимы по присваиванию с типом переменной, либо должны быть преобразуемы в тип переменной без потери информации. См. раздел JLS 5.2 для получения дополнительной информации о совместимости по присваиванию.

List<Value> getArgumentValues()

Возвращает значения всех аргументов в этом кадре. Значения возвращаются, даже если информация о локальных переменных отсутствует.