package java.lang;
/**
*
* 表示栈轨迹的元素,它定位在某类的某个方法的某行
*
* comment by liqiang
*
* @author Josh Bloch
*/
public final class StackTraceElement implements java.io.Serializable {
//由虚拟机初始化
private String declaringClass;
//抛出异常的方法名
private String methodName;
//Class文件名
private String fileName;
//抛出异常所在的行数
private int lineNumber;
//此类实例只能被虚拟机创建,虽然它是private的,但是虚拟机可以神奇的创建此类的实例
private StackTraceElement() {}
/**
*
* 获取源文件名
*
*/
public String getFileName() {
return fileName;
}
/**
*
* 返回错误抛出点所在的行数
*
*/
public int getLineNumber() {
return lineNumber;
}
/**
*
* 获取抛出异常所在的类名
*
*/
public String getClassName() {
return declaringClass;
}
/**
*
* 获取抛出异常的方法名
*
*/
public String getMethodName() {
return methodName;
}
/**
*
* 由此对象表示的异常抛出点是本地方法产生的
*
*/
public boolean isNativeMethod() {
//如果lineNumber为2表示抛出异常的方法是本地方法
return lineNumber == -2;
}
/**
*
* 此对象的字符串表示
*
*/
public String toString() {
return getClassName() + "." + methodName +
(isNativeMethod() ? "(Native Method)" :
(fileName != null && lineNumber >= 0 ?
"(" + fileName + ":" + lineNumber + ")" :
(fileName != null ? "("+fileName+")" : "(Unknown Source)")));
}
/**
*
* 判断两个对象是否相等
*
*/
public boolean equals(Object obj) {
//如果是同一对象直接返回true
if (obj==this)
return true;
//如果不是此类对象直接返回false
if (!(obj instanceof StackTraceElement))
return false;
//转型
StackTraceElement e = (StackTraceElement)obj;
//对应的类名,抛出行数,抛出方法名,源文件名都相等是,两个对象才相等
return e.declaringClass.equals(declaringClass) && e.lineNumber == lineNumber
&& eq(methodName, e.methodName) && eq(fileName, e.fileName);
}
//判断练个对象是否相等
private static boolean eq(Object a, Object b) {
return a==b || (a != null && a.equals(b));
}
/**
* 返回此类的hashCode
*/
public int hashCode() {
int result = 31*declaringClass.hashCode() + methodName.hashCode();
result = 31*result + (fileName == null ? 0 : fileName.hashCode());
result = 31*result + lineNumber;
return result;
}
private static final long serialVersionUID = 6992337162326171013L;
}