Интерфейс 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 Framework.