База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници