java.lang

Класс StackTraceElement

java.lang. Объект

java.lang. StackTraceElement

Все Реализованные Интерфейсы:

Сериализуемый

public final class StackTraceElement
extends Object
implements Serializable

Элемент в трассировке стека, как возвращено Throwable.getStackTrace(). Каждый элемент представляет единственный стековый фрейм. Все стековые фреймы за исключением того наверху стека представляют вызов метода. Фрейм наверху стека представляет точку выполнения, в которой была сгенерирована трассировка стека. Как правило, это - точка, в которой создавалось соответствие throwable трассировке стека.

С тех пор:

1.4

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
StackTraceElement(String declaringClass, String methodName, String fileName, int lineNumber) Создает микроэлемент стека, представляющий указанную точку выполнения.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	equals(Object obj) Возвращает true, если указанный объект - другой StackTraceElement экземпляр, представляющий ту же самую точку выполнения как этот экземпляр.
Строка	getClassName() Возвращает полностью определенное имя класса, содержащего точку выполнения, представленную этим микроэлементом стека.
Строка	getFileName() Возвращает имя исходного файла, содержащего точку выполнения, представленную этим микроэлементом стека.
int	getLineNumber() Возвращает номер строки исходной строки, содержащей точку выполнения, представленную этим микроэлементом стека.
Строка	getMethodName() Возвращает имя метода, содержащего точку выполнения, представленную этим микроэлементом стека.
int	hashCode() Возвращает значение хэш-кода для этого микроэлемента стека.
boolean	isNativeMethod() Возвращает true, если метод, содержащий точку выполнения, представленную этим микроэлементом стека, является собственным методом.
Строка	toString() Возвращает строковое представление этого микроэлемента стека.

Методы java.lang унаследованный от класса. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

StackTraceElement

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

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

Параметры:

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

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

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

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

Броски:

NullPointerException - если declaringClass или methodName нуль

С тех пор:

1.5

Деталь метода

getFileName

public String getFileName()

Возвращает имя исходного файла, содержащего точку выполнения, представленную этим микроэлементом стека. Обычно, это соответствует SourceFile атрибут соответствующего class файл (согласно Спецификации виртуальной машины Java, Раздел 4.7.7). В некоторых системах имя может обратиться к некоторому модулю исходного кода кроме файла, такого как запись в исходном репозитарии.

Возвраты:

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

getLineNumber

public int getLineNumber()

Возвращает номер строки исходной строки, содержащей точку выполнения, представленную этим микроэлементом стека. Обычно, это получается из LineNumberTable атрибут соответствующего class файл (согласно Спецификации виртуальной машины Java, Раздел 4.7.8).

Возвраты:

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

getClassName

public String getClassName()

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

Возвраты:

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

getMethodName

public String getMethodName()

Возвращает имя метода, содержащего точку выполнения, представленную этим микроэлементом стека. Если точка выполнения будет содержаться в экземпляре или инициализаторе класса, то этот метод возвратит соответствующее специальное имя метода, <init> или <clinit>, согласно Разделу 3.9 из Спецификации виртуальной машины Java.

Возвраты:

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

isNativeMethod

public boolean isNativeMethod()

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

Возвраты:

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

toString

public String toString()

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

• "MyClass.mash(MyClass.java:9)" - Здесь, "MyClass" полностью определенное имя класса, содержащего точку выполнения, представленную этим микроэлементом стека, "mash" имя метода, содержащего точку выполнения, "MyClass.java" исходный файл, содержащий точку выполнения, и "9" номер строки исходной строки, содержащей точку выполнения.
• "MyClass.mash(MyClass.java)" - Как выше, но номер строки недоступно.
• "MyClass.mash(Unknown Source)" - Как выше, но ни имя файла, ни номер строки не доступны.
• "MyClass.mash(Native Method)" - Как выше, но ни имя файла, ни номер строки не доступны, и метод, содержащий точку выполнения, как известно, является собственным методом.

Переопределения:

toString в классе Object

Возвраты:

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

См. Также:

Throwable.printStackTrace()

равняется

public boolean equals(Object obj)

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

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

где equals имеет семантику Objects.equals.

Переопределения:

equals в классе Object

Параметры:

obj - объект быть по сравнению с этим микроэлементом стека.

Возвраты:

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

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

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

Переопределения:

hashCode в классе Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

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