Интерфейсный метод

Все суперинтерфейсы:: Accessible, Comparable<Method>, Locatable, Mirror, TypeComponent

public interface Method extends TypeComponent, Locatable, Comparable<Method>

Статический или экземплярный метод в целевой виртуальной машине. См. TypeComponent для общей информации о зеркалах полей и методов.

С:

1.3

См. также:

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

Модификатор и тип	Метод	Описание
`List<Location>`	`allLineLocations()`	Возвращает список, содержащий объект `Location` для каждой исполняемой строки исходного кода в этом методе.
`List<Location>`	`allLineLocations(String stratum, String sourceName)`	Возвращает список, содержащий объект `Location` для каждой исполняемой строки исходного кода в этом методе.
`List<LocalVariable>`	`arguments()`	Возвращает список, содержащий каждый `LocalVariable`, объявленный в качестве аргумента этого метода.
`List<String>`	`argumentTypeNames()`	Возвращает список, содержащий текстовое представление типа каждого формального параметра этого метода.
`List<Type>`	`argumentTypes()`	Возвращает список, содержащий тип каждого формального параметра этого метода.
`byte[]`	`bytecodes()`	Возвращает массив, содержащий байткоды для этого метода.
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этим методом на равенство.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого метода.
`boolean`	`isAbstract()`	Определяет, является ли этот метод абстрактным.
`boolean`	`isBridge()`	Определяет, является ли этот метод мостом.
`boolean`	`isConstructor()`	Определяет, является ли этот метод конструктором.
`default boolean`	`isDefault()`	Определяет, является ли этот метод методом по умолчанию
`boolean`	`isNative()`	Определяет, является ли этот метод нативным.
`boolean`	`isObsolete()`	Определяет, является ли этот метод устаревшим.
`boolean`	`isStaticInitializer()`	Определяет, является ли этот метод статической инициализацией.
`boolean`	`isSynchronized()`	Определяет, является ли этот метод синхронизированным.
`boolean`	`isVarArgs()`	Определяет, принимает ли этот метод переменное число аргументов.
`Location`	`location()`	Возвращает `Location` этого метода, если с ним связан исполняемый код.
`Location`	`locationOfCodeIndex(long codeIndex)`	Возвращает `Location` для данного индекса кода.
`List<Location>`	`locationsOfLine(int lineNumber)`	Возвращает список, содержащий все объекты `Location`, которые сопоставляются с данным номером строки.
`List<Location>`	`locationsOfLine(String stratum, String sourceName, int lineNumber)`	Возвращает список, содержащий все объекты `Location`, которые сопоставляются с данным номером строки и именем источника.
`Type`	`returnType()`	Возвращает тип возвращаемого значения, как указано в объявлении этого метода.
`String`	`returnTypeName()`	Возвращает текстовое представление типа возвращаемого значения, как указано в объявлении этого метода.
`List<LocalVariable>`	`variables()`	Возвращает список, содержащий каждый `LocalVariable`, объявленный в этом методе.
`List<LocalVariable>`	`variablesByName(String name)`	Возвращает список, содержащий каждый `LocalVariable` с данным именем в этом методе.

Методы, объявленные в интерфейсе com.sun.jdi.Accessible

isPackagePrivate, isPrivate, isProtected, isPublic, modifiers

Методы, объявленные в интерфейсе java.lang.Comparable

compareTo

Методы, объявленные в интерфейсе com.sun.jdi.Mirror

toString, virtualMachine

Методы, объявленные в интерфейсе com.sun.jdi.TypeComponent

declaringType, genericSignature, isFinal, isStatic, isSynthetic, name, signature

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

returnTypeName

String returnTypeName()

Возвращает текстовое представление типа возвращаемого значения, как указано в объявлении этого метода.

Это имя типа всегда доступно, даже если тип еще не создан или загружен.

Возвращает:: объект String, содержащий имя типа возвращаемого значения.

returnType

Type returnType() throws ClassNotLoadedException

Возвращает тип возвращаемого значения, как указано в объявлении этого метода.

Примечание: если тип возвращаемого значения этого метода является ссылочным типом (класс, интерфейс или массив) и он не был создан или загружен загрузчиком классов типа, объявляющего метод (то есть, declaringType() .classLoader()), то будет выброшено исключение ClassNotLoadedException. Также ссылочный тип может быть загружен, но еще не подготовлен, в этом случае тип будет возвращен, но попытки выполнить некоторые операции над возвращенным типом (например, fields()) приведут к выбросу исключения ClassNotPreparedException. Используйте ReferenceType.isPrepared(), чтобы определить, подготовлен ли ссылочный тип.

Возвращает:

тип возвращаемого значения Type этого метода.

Исключения:

ClassNotLoadedException - если тип еще не создан или загружен через соответствующий загрузчик классов.

См. также:

argumentTypeNames

List<String> argumentTypeNames()

Возвращает список, содержащий текстовое представление типа каждого формального параметра этого метода.

Этот список всегда доступен, даже если типы еще не созданы или загружены.

Возвращает:: список List строк String, по одному элементу для каждого параметра этого метода. Каждый элемент представляет тип формального параметра, как указано во время компиляции. Если формальный параметр объявлен с эллипсом, то он представляется как массив типа перед эллипсом.

argumentTypes

List<Type> argumentTypes() throws ClassNotLoadedException

Возвращает список, содержащий тип каждого формального параметра этого метода.

Примечание: если тип любого параметра является ссылочным типом (класс, интерфейс или массив) и он не был создан или загружен загрузчиком классов объявляющего типа (то есть, declaringType() .classLoader()), то будет выброшено исключение ClassNotLoadedException. Также ссылочный тип может быть загружен, но еще не подготовлен, в этом случае список будет возвращён, но попытки выполнить какие-либо операции над типом (например, fields()) приведут к выбросу исключения ClassNotPreparedException. Используйте ReferenceType.isPrepared() для определения, подготовлен ли ссылочный тип.

Возвращает:

возвращает список List типов Type, по одному элементу для каждого параметра этого метода. Каждый элемент представляет тип формального параметра, как указано во время компиляции. Если формальный параметр объявлен с эллипсом, то он представляется как массив типа перед эллипсом.

Исключения:

ClassNotLoadedException - если тип еще не загружен через соответствующий загрузчик классов.

См. также:

isAbstract

boolean isAbstract()

Определяет, является ли этот метод абстрактным.

Возвращает:: true, если метод объявлен абстрактным; false в противном случае.

isDefault

default boolean isDefault()

Определяет, является ли этот метод методом по умолчанию

Возвращает:: true, если метод объявлен по умолчанию; false в противном случае.
С:: 1.8

isSynchronized

boolean isSynchronized()

Определяет, является ли этот метод синхронизированным.

Возвращает:: true, если метод объявлен синхронизированным; false в противном случае.

isNative

boolean isNative()

Определяет, является ли этот метод нативным.

Возвращает:: true, если метод объявлен нативным; false в противном случае.

isVarArgs

boolean isVarArgs()

Определяет, принимает ли этот метод переменное количество аргументов.

Возвращает:: true, если метод принимает переменное количество аргументов, false в противном случае.
С:: 1.5

isBridge

boolean isBridge()

Определяет, является ли этот метод мостовым методом. Мостовые методы определены в Спецификации языка Java.

Возвращает:: true, если метод является мостовым методом; false в противном случае.
С:: 1.5

isConstructor

boolean isConstructor()

Определяет, является ли этот метод конструктором.

Возвращает:: true, если метод является конструктором; false в противном случае.

isStaticInitializer

boolean isStaticInitializer()

Определяет, является ли этот метод статической инициализацией.

Возвращает:: true, если метод является статической инициализацией; false в противном случае.

isObsolete

boolean isObsolete()

Определяет, является ли этот метод устаревшим.

Возвращает:: true, если этот метод был признан устаревшим операцией VirtualMachine.redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>).
С:: 1.4

allLineLocations

List<Location> allLineLocations() throws AbsentInformationException

Возвращает список, содержащий объект Location для каждой исполняемой строки исходного кода в этом методе.

Этот метод эквивалентен allLineLocations(vm.getDefaultStratum(),null) - см. allLineLocations(String,String) для получения дополнительной информации.

Возвращает:: список всех объектов Location исходных строк.
Исключения:: AbsentInformationException - если для этого метода (не нативного, не абстрактного) нет информации о номерах строк.

allLineLocations

List<Location> allLineLocations(String stratum, String sourceName) throws AbsentInformationException

Возвращает список, содержащий объект Location для каждой исполняемой строки исходного кода в этом методе.

Каждый объект локализации сопоставляет строку исходного кода с диапазоном индексов кода. Начало диапазона можно определить с помощью Location.codeIndex(). Возвращаемый список упорядочен по индексу кода (от низкого к высокому).

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

Если метод является нативным или абстрактным, возвращается пустой список.

Возвращаемый список предназначен для указанного слоя (см. Location для описания слоев).

Параметры:: stratum - Слой для извлечения информации или null для ReferenceType.defaultStratum(); sourceName - Возвращать локализации только из этого файла исходного кода или null для возврата всех локализаций.
Возвращает:: список объектов Location всех строк исходного кода.
Исключения:: AbsentInformationException - если для этого (не нативного, не абстрактного) метода нет информации о номерах строк. Или если sourceName не является null и информация о названии файла исходного кода отсутствует.
С:: 1.4

locationsOfLine

List<Location> locationsOfLine(int lineNumber) throws AbsentInformationException

Возвращает список, содержащий все объекты Location, которые сопоставляются с заданным номером строки.

Этот метод эквивалентен locationsOfLine(vm.getDefaultStratum(), null, lineNumber) - см. locationsOfLine(java.lang.String,java.lang.String,int) для получения дополнительной информации.

Параметры:: lineNumber - номер строки
Возвращает:: список объектов Location, которые сопоставляются с заданным номером строки.
Исключения:: AbsentInformationException - если для этого метода нет информации о номерах строк.

locationsOfLine

List<Location> locationsOfLine(String stratum, String sourceName, int lineNumber) throws AbsentInformationException

Возвращает список, содержащий все объекты Location, которые сопоставлены с заданным номером строки и именем источника.

Возвращает список, содержащий каждый объект Location, который сопоставлен с данной строкой. Возвращаемый список будет содержать расположение для каждого непересекающегося диапазона индексов кода, которые были назначены данной строке компилятором и/или виртуальной машиной. Каждый возвращенный объект расположения соответствует началу этого диапазона. Если в указанной строке нет исполняемого кода, будет возвращен пустой список; в частности, нативные и абстрактные методы всегда возвращают пустой список.

Возвращаемый список предназначен для указанного слоя (см. Location для описания слоев).

Parameters:: stratum - слой для сравнения номера строки и имени источника, или null для использования по умолчанию; sourceName - имя источника, содержащего номер строки, или null для сопоставления со всеми именами источников; lineNumber - номер строки
Returns:: список объектов Location, которые сопоставлены с заданным номером строки.
Throws:: AbsentInformationException - если для этого метода нет информации о номере строки. Или если sourceName не null и информация об имени источника отсутствует.
Since:: 1.4

locationOfCodeIndex

Location locationOfCodeIndex(long codeIndex)

Возвращает Location для данного индекса кода.

Returns:: Location, соответствующий данному индексу кода, или null, если указанный индекс кода не является допустимым индексом кода для этого метода (нативные и абстрактные методы всегда возвращают null).

variables

List<LocalVariable> variables() throws AbsentInformationException

Возвращает список, содержащий каждый объявленный в этом методе LocalVariable. Список включает любые переменные, объявленные в любом блоке внутри метода. Он может содержать несколько переменных с одинаковым именем, объявленных в непересекающихся блоках. Аргументы рассматриваются как локальные переменные и будут присутствовать в возвращаемом списке. Если информация о локальных переменных недоступна, значения фактических аргументов вызова метода можно получить, используя метод StackFrame.getArgumentValues()

Returns:: список объектов LocalVariable, которые отражают локальные переменные, объявленные в этом методе в целевой виртуальной машине. Если локальных переменных нет, возвращается список нулевой длины.
Throws:: AbsentInformationException - если нет информации о переменных для этого метода. Как правило, информация о локальных переменных недоступна для нативных или абстрактных методов (то есть информация об их именах аргументов недоступна), поэтому они будут вызывать это исключение.

variablesByName

List<LocalVariable> variablesByName(String name) throws AbsentInformationException

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

Returns:: список объектов LocalVariable с заданным именем. Если нет соответствующих локальных переменных, возвращается список нулевой длины.
Throws:: AbsentInformationException - если для этого метода нет информации о переменных. Как правило, информация о локальных переменных недоступна для нативных или абстрактных методов (то есть информация об их именах аргументов недоступна), поэтому они будут вызывать это исключение.

arguments

List<LocalVariable> arguments() throws AbsentInformationException

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

Returns:: список аргументов LocalVariable. Если аргументов нет, возвращается список нулевой длины.
Throws:: AbsentInformationException - если нет информации о переменных для этого метода. Как правило, информация о локальных переменных недоступна для нативных или абстрактных методов (то есть информация об их именах аргументов недоступна), поэтому они будут вызывать это исключение.

bytecodes

byte[] bytecodes()

Возвращает массив, содержащий байт-коды для этого метода.

Не все целевые виртуальные машины поддерживают эту операцию. Используйте VirtualMachine.canGetBytecodes(), чтобы определить, поддерживается ли операция.

Returns:: массив байт-кодов; абстрактные и нативные методы возвращают массив нулевой длины.
Throws:: UnsupportedOperationException - если целевая виртуальная машина не поддерживает получение байт-кодов.

location

Location location()

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

Specified by:: location в интерфейсе Locatable
Returns:: Location этого зеркала, или null, если это абстрактный метод; нативные методы возвращают объект Location, чьё значение codeIndex равно -1.

equals

boolean equals(Object obj)

Сравнивает указанный объект с этим методом на предмет равенства.

Overrides:

equals в классе Object

Parameters:

obj - объект-ссылка для сравнения.

Returns:

true, если Object является методом и оба зеркала отражают один и тот же метод (объявленный в одном и том же классе или интерфейсе, в одной и той же виртуальной машине).

See Also:

hashCode

int hashCode()

Возвращает значение хэш-кода для этого метода.

Overrides:

hashCode в классе Object

Returns:

целочисленное значение хэш-кода.

See Also:

© 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.jdi/com/sun/jdi/Method.html