CKTIS / Java
Comparable — естествено подреждане на обекти
java.lang.Comparable<T> дефинира естественото подреждане на обекти чрез compareTo(T o). Резултатът показва реда, а не разликата между стойностите.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
public interface Comparable<T> {
int compareTo(T o);
}java.lang.Comparable<T> дефинира естествена пълна наредба. Comparable.compareTo, деклариран като int compareTo(T o), връща отрицателна стойност, нула или положителна стойност, когато този обект е съответно по-малък, равностоен по наредба или по-голям от аргумента. Важен е знакът, а не точната стойност -1 или 1.
Договорът изисква противоположни знаци при разменяне на аргументите, транзитивност и еднакви знаци на сравнението спрямо всеки трети обект за обектите, които се сравняват като нула. Изключение в едната посока изисква изключение и в обратната посока.
Силно се препоръчва compareTo == 0 да е съгласувано с equals; документирайте отклоненията. Без това съгласуване подредено множество може да отхвърли неравен обект като дубликат. compareTo(null) хвърля NullPointerException; несъвместим тип може да причини ClassCastException.
Примерът сортира Score с Arrays.sort. Използването на Integer.compare вместо изваждане предотвратява препълване; единственото поле на записа прави наредбата му съгласувана с equals.
Примери
import java.util.Arrays;
public class Main {
record Score(int points) implements Comparable<Score> {
@Override
public int compareTo(Score other) {
return Integer.compare(points, other.points);
}
}
public static void main(String[] args) {
Score[] scores = {new Score(30), new Score(10), new Score(20)};
Arrays.sort(scores);
for (Score score : scores) {
System.out.println(score.points());
}
}
}Резултат
10 20 30
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.