Интерфейс Comparable<T>

public interface Comparable<T>

Этот интерфейс накладывает полное упорядочение на объекты каждого класса, его реализующего. Это упорядочение называется естественным упорядочением класса, а метод класса compareTo называется его естественным методом сравнения.

Списка (и массивы) объектов, реализующих этот интерфейс, можно автоматически сортировать с помощью Collections.sort (и Arrays.sort). Объекты, реализующие этот интерфейс, могут использоваться в качестве ключей в отсортированном отображении или как элементы в отсортированном наборе, без необходимости указания компаратора.

Естественное упорядочение для класса C считается совместимым с equals тогда и только тогда, когда e1.compareTo(e2) == 0 имеет то же булево значение, что и e1.equals(e2) для каждого e1 и e2 класса C. Обратите внимание, что null не является экземпляром какого-либо класса, и e.compareTo(null) должен бросать NullPointerException, даже если e.equals(null) возвращает false.

Настоятельно рекомендуется (хотя и не обязательно), чтобы естественные упорядочения были согласованы с equals. Это важно, потому что отсортированные наборы (и отсортированные отображения) без явных компараторов ведут себя «странно», когда они используются с элементами (или ключами), естественное упорядочение которых не согласовано с equals. В частности, такой отсортированный набор (или отсортированное отображение) нарушает общий контракт для множества (или отображения), который определяется методом equals.

Например, если добавить два ключа a и b, такие что (!a.equals(b) && a.compareTo(b) == 0) в отсортированный набор, который не использует явный компаратор, вторая операция add возвращает false (и размер отсортированного набора не увеличивается), потому что a и b эквивалентны с точки зрения отсортированного набора.

Практически все основные классы Java, реализующие Comparable, имеют естественные упорядочения, которые согласованы с equals. Исключением является BigDecimal, чье естественное упорядочение уравнивает BigDecimal объекты с равными числовыми значениями и разными представлениями (например, 4.0 и 4.00). Для BigDecimal.equals() возвращения true, представление и числовое значение двух BigDecimal объектов должны быть одинаковыми.

Для математически настроенных, отношение, определяющее естественное упорядочение для данного класса C, является:

       {(x, y) such that x.compareTo(y) <= 0}.
 

Фактор для этого полного порядка:

       {(x, y) such that x.compareTo(y) == 0}.
 

Из контракта для compareTo непосредственно следует, что фактор является отношением эквивалентности на C, и что естественное упорядочение является полным порядком на C. Когда мы говорим, что естественное упорядочение класса совместимо с equals, мы имеем в виду, что фактор для естественного упорядочения представляет собой отношение эквивалентности, определённое методом класса equals(Object) :

     {(x, y) such that x.equals(y)}. 

Другими словами, когда естественное упорядочение класса совместимо с equals, классы эквивалентности, определяемые отношением эквивалентности метода equals и классы эквивалентности, определяемые фактором метода compareTo, совпадают.

Этот интерфейс является членом Фреймворка Java Collections.