java.lang
클래스 StackTraceElement

java.lang.Object 
  java.lang.StackTraceElement

모든 구현된 인터페이스:

Serializable

public final class StackTraceElement
extends Object 
implements Serializable 

스택 트레이스내의 요소로,Throwable.getStackTrace() 에 의해 반환되는 값. 각 요소는 단일의 스택 프레임을 나타냅니다. 스택의 선두에 있는 스택 프레임을 제외한, 모든 스택 프레임은, 메소드 호출을 나타냅니다. 스택의 선두의 프레임은, 스택 트레이스가 생성된 실행 포인트를 나타냅니다. 일반적으로, 이것은, 스택 트레이스에 대응하는 throw 가능 객체가 작성된 포인트가 됩니다.

도입된 버젼:

1.4

관련 항목:

직렬화 된 형식

생성자 의 개요

StackTraceElement (String declaringClass, String methodName, String fileName, int lineNumber)
지정된 실행 포인트를 나타내는 스택 트레이스 요소를 작성합니다.

메소드의 개요

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

생성자 의 상세

StackTraceElement

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

지정된 실행 포인트를 나타내는 스택 트레이스 요소를 작성합니다.

파라미터:

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

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

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

lineNumber - 이 스택 트레이스 요소가 나타내는 실행 포인트를 포함한 소스행의 행 번호, 또는 부의 수치 (이 정보를 사용할 수 없는 경우). -2 의 값은, 실행 포인트를 포함한 메소드가 네이티브 메소드인 것을 나타낸다

예외:

NullPointerException - declaringClass 또는 methodName 가 null 의 경우

도입된 버젼:

1.5

메소드의 상세

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> 를 돌려줍니다 ( 「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