Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Comparable — ordinamento naturale degli oggetti

java.lang.Comparable<T> definisce l’ordinamento naturale degli oggetti tramite compareTo(T o). Il risultato indica l’ordine, non la distanza tra i valori.

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

Sintassi

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

java.lang.Comparable<T> definisce un ordinamento totale naturale. Comparable.compareTo, dichiarato come int compareTo(T o), restituisce un valore negativo, zero o un valore positivo quando questo oggetto è rispettivamente minore, equivalente nell’ordinamento o maggiore dell’argomento. Conta il segno, non il valore esatto -1 o 1.

Il contratto richiede segni opposti quando si scambiano gli argomenti, transitività e segni di confronto identici rispetto a qualsiasi terzo oggetto per gli oggetti che si confrontano come zero. Un’eccezione in una direzione richiede un’eccezione anche nella direzione inversa.

Si raccomanda vivamente che compareTo == 0 sia coerente con equals; eventuali differenze vanno documentate. Senza questa coerenza, un insieme ordinato può rifiutare un oggetto diverso considerandolo un duplicato. compareTo(null) genera NullPointerException; un tipo incompatibile può causare ClassCastException.

L’esempio ordina Score usando Arrays.sort. Usare Integer.compare invece della sottrazione evita l’overflow; il singolo campo del record rende il suo ordinamento coerente con equals.

Esempi

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

Risultato

10
20
30

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti