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