java.lang
클래스 StackTraceElement

java.lang.Object 
  |
  +--java.lang.StackTraceElement

모든 구현 인터페이스:

Serializable

public final class StackTraceElement

extends Object

implements Serializable

스택 트레이스내의 요소로,Throwable.getStackTrace() 에 의해 돌려주어지는 값. 각 요소는 단일의 스택 프레임을 나타냅니다. 스택의 선두에 있는 스택 프레임을 제외한, 모든 스택 프레임은 메소드 호출을 나타냅니다. 스택의 선두의 프레임은 스택 트레이스가 생성된 실행 포인트를 나타냅니다. 통상, 이것은 스택 트레이스에 대응하는 슬로우 가능 오브젝트가 작성된 포인트가 됩니다.

도입된 버젼:

1.4

관련 항목:

직렬화 된 형식

메소드의 개요

boolean	equals (Object obj) 지정된 오브젝트가, 이 인스턴스와 같은 실행 포인트를 나타내는 다른 StackTraceElement 인스턴스인 경우, true 를 돌려줍니다.
String	getClassName () 이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 클래스의 완전 수식명을 돌려줍니다.
String	getFileName () 이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 원시 파일의 이름을 돌려줍니다.
int	getLineNumber () 이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 원시 파일의 행 번호를 돌려줍니다.
String	getMethodName () 이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 메소드의 이름을 돌려줍니다.
int	hashCode () 이 스택 트레이스 요소의 해시 코드치를 돌려줍니다.
boolean	isNativeMethod () 이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 메소드가 네이티브 메소드의 경우, true 를 돌려줍니다.
String	toString () 이 스택 트레이스 요소의 캐릭터 라인 표현을 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

메소드의 상세

getFileName

public String  getFileName()

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 원시 파일의 이름을 돌려줍니다. 통상, 이것은 관련하는 class 파일의 SourceFile 속성을 나타냅니다 ( 「Java 가상 머신 사양」의 섹션 4.7. 7 을 참조). 시스템에 따라서는 이름이, 파일은 아니고 원시 코드 단위를 참조하는 경우도 있습니다 (소스 리포지터리(repository)내의 엔트리 등).

반환값:

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 파일의 이름, 또는 null (이 정보를 사용할 수 없는 경우)

getLineNumber

public int getLineNumber()

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 원시 파일의 행 번호를 돌려줍니다. 통상, 이 값은 관련하는 class 파일의 LineNumberTable 속성으로부터 도출됩니다 ( 「Java 가상 머신 사양」의 섹션 4.7. 8 을 참조).

반환값:

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 소스행의 행 번호, 또는 부의 수치 (이 정보를 사용할 수 없는 경우)

getClassName

public String  getClassName()

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 클래스의 완전 수식명을 돌려줍니다.

반환값:

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 Class 의 완전 수식명

getMethodName

public String  getMethodName()

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 메소드의 이름을 돌려줍니다. 실행 포인트가 인스턴스 또는 클래스 초기화자에게 포함되는 경우, 이 메소드는 적절한 「특수 메소드명」 <init> 또는 <clinit> 를 돌려줍니다 ( 「The Java 가상 머신 사양」의 섹션 3.9 를 참조).

반환값:

이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 메소드의 이름

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)" - 상기와 같다. 다만, 파일명도 행 번호도 이용하지 못하고, 실행 포인트를 포함한 메소드가 네이티브 메소드라고 보여지는 점이 다르다

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 오브젝트의 캐릭터 라인 표현

관련 항목:

Throwable.printStackTrace()

equals

public boolean equals(Object  obj)

지정된 오브젝트가, 이 인스턴스와 같은 실행 포인트를 나타내는 다른 StackTraceElement 인스턴스인 경우, true 를 돌려줍니다. 2 개의 스택 트레이스 요소 a 및 b 가 등가가 되는 것은 다음의 경우 뿐입니다.

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

여기서,equals 는 다음의 식에 의해 정의됩니다.

     static boolean equals(Object a, Object b) {
         return a==b || (a ! = null && a.equals(b));
     }
 

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 스택 트레이스 요소라고 비교되는 오브젝트

반환값:

지정된 오브젝트가, 이 인스턴스와 같은 실행 포인트를 나타내는 다른 StackTraceElement 인 경우, true 를 돌려주는

관련 항목:

Object.hashCode() , Hashtable

hashCode

public int hashCode()

이 스택 트레이스 요소의 해시 코드치를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 오브젝트의 해시 코드치

관련 항목:

Object.equals(java.lang.Object) , Hashtable