はじめに

この記事では、Comparableインターフェースを使ったカスタムソートの方法を解説します。
「インターフェース？implements？よく分からん！」
と拒否反応をお持ちの方にも読んでもらえるよう、なるべく噛み砕いて説明していきます。

sortメソッドの基本

まず最初にsortメソッドの基本的な使い方について説明します。（そんなのいらねえ知ってるわって人は飛ばしてこちらへ）
Comparableインターフェースを使用していないリストに対してsortメソッドを使用した際は、一定のルールに従って全て昇順で並び替えられます。

プリミティブ型

特別なルールは無く、シンプルに昇順で並び替えが行われます。

1. String型

List<String> strList = new List<String>();

strList.add('b');
strList.add('c');
strList.add('a');

strList.sort();
System.debug(strList);

// 結果 → (a, b, c)

2. Integer型

List<Integer> intList = new List<Integer>();

intList.add(2);
intList.add(3);
intList.add(1);

intList.sort();
System.debug(intList);

// 結果 → (1, 2, 3)

3. Date型

List<Date> dateList = new List<Date>();

dateList.add(Date.newInstance(2023, 5, 1));
dateList.add(Date.newInstance(2023, 9, 1));
dateList.add(Date.newInstance(2023, 1, 1));

dateList.sort();
System.debug(dateList);

// 結果 → (2023-01-01 00:00:00, 2023-05-01 00:00:00, 2023-09-01 00:00:00)

SObject型

SObject型のリストに対してsortメソッドを使用した場合、以下の優先順位で並び替えが行われます。

sObject 型の表示ラベル。
たとえば、Account sObject は Contact の前になります。

Name 項目 (該当する場合)。
たとえば、リストに A と B という名前の 2 つの取引先がある場合、取引先 A が取引先 B よりも前になります。

標準項目。ID 項目と Name 項目を除き、アルファベット順で最初の項目から使用されます。
たとえば、2 つの取引先が同じ名前の場合、並び替えに使用される最初の標準項目は AccountNumber です。

カスタム項目。アルファベット順で最初の項目から使用されます。
たとえば、2 つの取引先の名前と標準項目が同じで、FieldA と FieldB という 2 つのカスタム項目がある場合、並び替えでは FieldA の値が最初に使用されます。

Apex開発者ガイド：sObject のリストの並び替え

1. sObject型の表示ラベルによるソート

List<SObject> sobjectList = new List<SObject>();

sobjectList.add(new Contact());
sobjectList.add(new Opportunity());
sobjectList.add(new Account());

sobjectList.sort();
System.debug(sobjectList);

 // 結果 → (Account:{}, Contact:{}, Opportunity:{})

2. Name項目によるソート

List<Account> accountList = new List<Account>();

accountList.add(new Account(Name = 'Bob', AccountNumber = '2', Description = 'b', Age__c = 20));
accountList.add(new Account(Name = 'Charlie', AccountNumber = '1', Description = 'c', Age__c = 18));
accountList.add(new Account(Name = 'Alice', AccountNumber = '3', Description = 'a', Age__c = 19));

accountList.sort();
System.debug(accountList);

// 結果：Name項目が存在するため最優先でで並び替えられる
// Account:{Name=Alice, AccountNumber=3, Description=a, Age__c=19}, 
// Account:{Name=Bob, AccountNumber=2, Description=b, Age__c=20},
// Account:{Name=Charlie, AccountNumber=1, Description=c, Age__c=18}

3. 標準項目によるソート

List<Account> accountList = new List<Account>();

accountList.add(new Account(AccountNumber = '2', Description = 'b', Age__c = 20));
accountList.add(new Account(AccountNumber = '1', Description = 'c', Age__c = 18));
accountList.add(new Account(AccountNumber = '3', Description = 'a', Age__c = 19));

accountList.sort();
System.debug(accountList);

// 結果：標準項目の中で最もアルファベット順が若いAccountNumber基準で並び替えられる
// Account:{AccountNumber=1, Description=c, Age__c=18},
// Account:{AccountNumber=2, Description=b, Age__c=20},
// Account:{AccountNumber=3, Description=a, Age__c=19}

4. カスタム項目によるソート

List<Account> accountList = new List<Account>();

accountList.add(new Account(Age__c = 20, mail__c = 'aaa@example.jp'));
accountList.add(new Account(Age__c = 18, mail__c = 'bbb@example.jp'));
accountList.add(new Account(Age__c = 19, mail__c = 'ccc@example.jp'));

accountList.sort();
System.debug(accountList);

// 結果：カスタム項目の中で最もアルファベット順が若いAge__cで並び替えられる
// Account:{Age__c=18, mail__c=bbb@example.jp},
// Account:{Age__c=19, mail__c=ccc@example.jp},
// Account:{Age__c=20, mail__c=aaa@example.jp}

SObjectがミックスされたリストはさておき、基本的に保持しているプロパティによって並び替え順序が決まります。
つまり、意図した順番で並び替えることはかなり難しいと言えるでしょう。

Comparableインターフェースの使い方

前置きが長くなりましたが、ここからはComparableインターフェースを実装して任意の並び替えを行う手順を紹介します。

基本的な使い方

ComparableAccount.cls

global with sharing class ComparableAccount implements Comparable {
    Account record;

    global ComparableAccount(Account acc) {
        this.record = acc;
    }

    global Integer compareTo(Object compareAcc) {
        ComparableAccount compareTo = (ComparableAccount)compareAcc;
        if(record.Age__c > compareTo.record.Age__c){
            return 1;
        } else if(record.Age__c < compareTo.record.Age__c){
            return -1;
        }
        return 0;
    }
}

List<Account> accountList = new List<Account>();

accountList.add(new Account(Name = 'Alice',   Age__c = 20));
accountList.add(new Account(Name = 'Ellen',   Age__c = 21));
accountList.add(new Account(Name = 'Dave',    Age__c = 19));
accountList.add(new Account(Name = 'Bob',     Age__c = 21));
accountList.add(new Account(Name = 'Charlie', Age__c = 18));

List<ComparableAccount> comparableAccountList = new List<ComparableAccount>();
for(Account acc : accountList){
    comparableAccountList.add(new ComparableAccount(acc));
}

comparableAccountList.sort();
System.debug(comparableAccountList);

// 結果：Age__cの順番で並び替えられる
// ComparableAccount:[record=Account:{Name=Charlie, Age__c=18}],
// ComparableAccount:[record=Account:{Name=Dave, Age__c=19}],
// ComparableAccount:[record=Account:{Name=Alice, Age__c=20}],
// ComparableAccount:[record=Account:{Name=Ellen, Age__c=21}],
// ComparableAccount:[record=Account:{Name=Bob, Age__c=21}]

ここではAge__c項目の昇順で並び替えを行いたいものとします。
インターフェースを使用せずaccountList.sort()を行った場合は、Name項目によるソートのルールが適用され、Age__cの順番では並び替えられません。
上記の例では、Comparableインターフェースを実装したComparableAccountクラスを用いて、Age__cの昇順で並び替えを行う処理をcompareToメソッドに実装しています。

実装のポイント

1. インターフェース実装

クラス名の後ろにimplements Comparableを付与することにより、このクラスがComparableインターフェースを実装していることを宣言しています。
クラスを継承する時に使うextends 〇〇と同じ感覚です。

2. compareToメソッド

しかし上記だけではインターフェースを実装したことにはなりません。
もし適当なクラスにimplements Comparableを付けてデプロイした場合、以下のコンパイルエラーが発生します。

Class 〇〇 must implement the method: Integer System.Comparable.compareTo(Object)

このエラー内容は、

Object型を引数に取り
Integer型が返り値の
compareToという名前のメソッド

上記全てを満たすメソッドが、Comparableインターフェースを実装したクラスには必須という意味合いになります。
なぜ必須なのか？と言うと、「ある機能が存在することを保証する」というのがインターフェースの目的の1つだからです。
言葉だけでは伝わりにくいと思うので、sort()が実行された際の簡略化した流れ（予想）を以下に示します。

List型に対してsort()を実行
Comparableインターフェースを実装したクラスか判定
2に該当する場合 → compareTo()のロジックに基づいてソート処理
該当しなかった場合 → 基本のソート処理に基づいてソート処理

「Comparableインターフェースを実装している＝compareToメソッドが存在する」ことが保証されているからこそ、2に該当したとき安全にcompareTo()を呼び出せるという仕組みです。
興味がある方は開発者ドキュメントにも目を通してみてください。

3. 並び替えのロジック

ある値に基づいて昇順で並び替えを行う場合、以下の処理を記述すればOKです（降順の場合は逆）

「基準となる値 > 比較対象の値」の場合は"1"を返却 → if(record.Age__c > compareTo.record.Age__c){return 1})
「基準となる値 < 比較対象の値」の場合は"-1"を返却 → if(record.Age__c < compareTo.record.Age__c){return -1}

「リストのインデックスをどちらに動かしたいか」という覚え方で問題ありません。

少しだけ応用編