StackTraceElement (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.lang
클래스 StackTraceElement

java.lang.Object 
  java.lang.StackTraceElement

모든 구현된 인터페이스:: Serializable

public final class StackTraceElement
extends Object
implements Serializable
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

개요