CKTIS / Java
Comparable — orden natural de los objetos
java.lang.Comparable<T> define el orden natural de los objetos mediante compareTo(T o). El resultado indica el orden, no la distancia entre los valores.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
public interface Comparable<T> {
int compareTo(T o);
}java.lang.Comparable<T> define un orden total natural. Comparable.compareTo, declarado como int compareTo(T o), devuelve un valor negativo, cero o un valor positivo cuando este objeto es, respectivamente, menor, equivalente en el orden o mayor que el argumento. Lo que importa es el signo, no que el valor sea exactamente -1 o 1.
El contrato exige signos opuestos al invertir los argumentos, transitividad y signos de comparación idénticos frente a cualquier tercer objeto cuando dos objetos se comparan como cero. Si se produce una excepción en una dirección, también debe producirse en la dirección inversa.
Se recomienda encarecidamente que compareTo == 0 sea coherente con equals; documenta cualquier diferencia. Sin esa coherencia, un conjunto ordenado puede rechazar un objeto distinto por considerarlo duplicado. compareTo(null) lanza NullPointerException; un tipo incompatible puede causar ClassCastException.
El ejemplo ordena Score mediante Arrays.sort. Usar Integer.compare en vez de una resta evita el desbordamiento; el único campo del record hace que su orden sea coherente con equals.
Ejemplos
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());
}
}
}Resultado
10 20 30
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.