java.lang.StackTraceElement source code

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;
}