Javadoc 注释 - CompareTo？

Question

我的书要求我为一段代码编写 Javadoc 注释。大多数情况下，我了解如何执行 javadocs，但我不了解该程序在做什么。

“为类 Person 的以下方法编写 Javadoc 注释。假设类 Person 有两个字符串数据字段lastName 和firstName，其含义很明显。如果需要，请提供前置条件和后置条件。”

public int compareTo(Person per) {
    if (lastName.equals(per.lastName))
        return firstName.compareTo(per.firstName);
    else
        return lastName.compareTo(per.lastName);
}

/**
 * Method to return?
 *
 * @param compare the firstName lexicographically
 * @param compare the lastName  lexicographically
*/

我其实不知道这是在做什么。它返回一个数字吗？我查看了

上的示例

http://www.tutorialspoint.com/java/java_string_compareto.htm

Answer 1

你确定它看起来不像这样吗？

Public int compareTo(Person per) {
    if(firstName.compareTo(per.firstName) != 0){
        return firstName.compareTo(per.firstName);
    }
    else{
        return lastName.compareTo(per.lastName);
    }

}

此代码将根据名字的字典顺序进行排序，如果它们相同，则会对姓氏进行排序。

每个compareTo方法返回-1、0或1，具体取决于第一个字符串在排序中是否较早出现。