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.