Класс StackTraceElement

public StackTraceElement(String declaringClass, String methodName, String fileName, int lineNumber)

Параметры:

declaringClass — двоичное имя класса, содержащего точку выполнения, представленную элементом трассировки стека

methodName — имя метода, содержащего точку выполнения, представленную элементом трассировки стека

fileName — имя файла, содержащего точку выполнения, представленную элементом трассировки стека, или null, если эти сведения недоступны

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

Вызывает исключение:

NullPointerException — если declaringClass или methodName равно null

Начиная с:

1.5

public StackTraceElement(String classLoaderName, String moduleName, String moduleVersion, String declaringClass, String methodName, String fileName, int lineNumber)

Параметры:

classLoaderName — имя загрузчика класса, если загрузчику класса, которому принадлежит класс с точкой выполнения, представленной трассировкой стека, присвоено имя; в противном случае null

moduleName — имя модуля, если класс, содержащий точку выполнения, представленную трассировкой стека, находится в именованном модуле; в противном случае null

moduleVersion — версия модуля, если класс, содержащий точку выполнения, представленную трассировкой стека, находится в именованном модуле с версией; в противном случае null

declaringClass — двоичное имя класса, содержащего точку выполнения, представленную элементом трассировки стека

methodName — имя метода, содержащего точку выполнения, представленную элементом трассировки стека

fileName — имя файла, содержащего точку выполнения, представленную элементом трассировки стека, или null, если эти сведения недоступны

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

Вызывает исключение:

NullPointerException — если declaringClass равно null или methodName равно null

Начиная с:

9

public String getFileName()

Возвращает:

имя файла, содержащего точку выполнения, представленную этим элементом трассировки стека, или null, если эти сведения недоступны.

public int getLineNumber()

Возвращает:

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

public String getModuleName()

Возвращает:

имя модуля Module, содержащего точку выполнения, представленную этим элементом трассировки стека; null, если имя модуля недоступно.

Начиная с:

9

См. также:

• Module.getName()

public String getModuleVersion()

Возвращает:

версию модуля Module, содержащего точку выполнения, представленную этим элементом трассировки стека; null, если версия модуля недоступна.

Начиная с:

9

См. также:

• ModuleDescriptor.Version

public String getClassLoaderName()

Возвращает:

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

Начиная с:

9

См. также:

• ClassLoader.getName()

public String getClassName()

Возвращает:

двоичное имя Class, содержащего точку выполнения, представленную этим элементом трассировки стека

public String getMethodName()

Возвращает:

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

public boolean isNativeMethod()

Возвращает:

true, если метод, содержащий точку выполнения, представленную этим элементом трассировки стека, является нативным методом.

public String toString()

Переопределяет:

toString в классе Object

Примечание к API:

Формат этой строки зависит от реализации, но следующие примеры можно считать типичными:

• "com.foo.loader/foo@9.0/com.foo.Main.run(Main.java:101)" — см. описание ниже.
• "com.foo.loader/foo@9.0/com.foo.Main.run(Main.java)" — номер строки недоступен.
• "com.foo.loader/foo@9.0/com.foo.Main.run(Unknown Source)" — недоступны ни имя файла, ни номер строки.
• "com.foo.loader/foo@9.0/com.foo.Main.run(Native Method)" — метод, содержащий точку выполнения, является нативным методом.
• "com.foo.loader//com.foo.bar.App.run(App.java:12)" — класс точки выполнения определен в безымянном модуле загрузчика класса с именем com.foo.loader.
• "acme@2.1/org.acme.Lib.test(Lib.java:80)" — класс точки выполнения определен в модуле acme, загруженном встроенным загрузчиком классов, например загрузчиком классов приложения.
• "MyClass.mash(MyClass.java:9)" — класс MyClass находится в пути классов приложения.

Первый пример показывает элемент трассировки стека, состоящий из трех частей, разделенных "/", за которыми следуют имя исходного файла и номер строки исходного кода, содержащей точку выполнения. Первая часть "com.foo.loader" — это имя загрузчика класса. Вторая часть "foo@9.0" — имя и версия модуля. Третья часть — метод, содержащий точку выполнения; "com.foo.Main"" — двоичное имя, а "run" — имя метода. "Main.java" — имя исходного файла, а "101" — номер строки.

Если класс определен в безымянном модуле, вторая часть опускается, как показано в "com.foo.loader//com.foo.bar.App.run(App.java:12)".

Если загрузчик класса является встроенным загрузчиком классов или ему не присвоено имя, первая часть и следующий за ней "/" опускаются, как показано в "acme@2.1/org.acme.Lib.test(Lib.java:80)". Если первая часть опущена, а модуль является безымянным, вторая часть и следующий за ней "/" также опускаются, как показано в "MyClass.mash(MyClass.java:9)".

Метод toString может возвращать разные значения для двух экземпляров StackTraceElement, которые равны, например для экземпляра, созданного с помощью конструктора, и экземпляра, полученного из Throwable или StackWalker.StackFrame, поскольку реализация может решить опустить некоторые части возвращаемой строки.

Возвращает:

строковое представление объекта

См. также:

• Throwable.printStackTrace()

public boolean equals(Object obj)

    equals(a.getClassLoaderName(), b.getClassLoaderName()) &&
    equals(a.getModuleName(), b.getModuleName()) &&
    equals(a.getModuleVersion(), b.getModuleVersion()) &&
    equals(a.getClassName(), b.getClassName()) &&
    equals(a.getMethodName(), b.getMethodName())
    equals(a.getFileName(), b.getFileName()) &&
    a.getLineNumber() == b.getLineNumber()

Переопределяет:

equals в классе Object

Параметры:

obj — объект, сравниваемый с этим элементом трассировки стека.

Возвращает:

true, если указанный объект является другим экземпляром StackTraceElement, представляющим ту же точку выполнения, что и этот экземпляр.

См. также:

• Object.hashCode()
• HashMap

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этого объекта

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)