CKTIS / Java
Comparable — ordenação natural de objetos
java.lang.Comparable<T> define a ordenação natural dos objetos através de compareTo(T o). O resultado indica a ordem, não a distância entre os valores.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
public interface Comparable<T> {
int compareTo(T o);
}java.lang.Comparable<T> define uma ordenação total natural. Comparable.compareTo, declarado como int compareTo(T o), devolve um valor negativo, zero ou um valor positivo quando este objeto é, respetivamente, menor, equivalente na ordenação ou maior do que o argumento. O que importa é o sinal, não o valor exato -1 ou 1.
O contrato exige sinais opostos quando se invertem os argumentos, transitividade e sinais de comparação idênticos em relação a qualquer terceiro objeto quando dois objetos se comparam como zero. Uma exceção num sentido exige também uma exceção no sentido inverso.
Recomenda-se vivamente que compareTo == 0 seja coerente com equals; documente quaisquer diferenças. Sem essa coerência, um conjunto ordenado pode rejeitar um objeto diferente por o considerar duplicado. compareTo(null) lança NullPointerException; um tipo incompatível pode causar ClassCastException.
O exemplo ordena Score usando Arrays.sort. Usar Integer.compare em vez de subtrair evita o overflow; o campo único do record torna a sua ordenação coerente com equals.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.