WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Comparable — natürliche Ordnung von Objekten

java.lang.Comparable<T> definiert die natürliche Ordnung von Objekten über compareTo(T o). Das Ergebnis gibt die Reihenfolge an, nicht den Abstand zwischen Werten.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

public interface Comparable<T> {
    int compareTo(T o);
}

java.lang.Comparable<T> definiert eine natürliche totale Ordnung. Comparable.compareTo, deklariert als int compareTo(T o), gibt einen negativen Wert, null oder einen positiven Wert zurück, wenn dieses Objekt kleiner, in der Ordnung gleichwertig oder größer als das Argument ist. Entscheidend ist das Vorzeichen, nicht genau -1 oder 1.

Der Vertrag verlangt entgegengesetzte Vorzeichen beim Vertauschen der Argumente, Transitivität und identische Vergleichsvorzeichen gegenüber jedem dritten Objekt, wenn zwei Objekte den Vergleichswert null ergeben. Führt ein Vergleich in eine Richtung zu einer Ausnahme, muss dies auch in der umgekehrten Richtung der Fall sein.

Es wird dringend empfohlen, dass compareTo == 0 mit equals übereinstimmt; Abweichungen sollten dokumentiert werden. Andernfalls kann eine sortierte Menge ein ungleiches Objekt als Duplikat ablehnen. compareTo(null) löst NullPointerException aus; ein inkompatibler Typ kann ClassCastException verursachen.

Das Beispiel sortiert Score mit Arrays.sort. Integer.compare vermeidet im Gegensatz zur Subtraktion einen Überlauf; das einzelne Feld des Records sorgt dafür, dass die Ordnung mit equals übereinstimmt.

Beispiele

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

Ergebnis

10
20
30

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen