Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes