Apex 開発者ガイド
jsObject のリストの並び替え
sObject の場合、並び替えは昇順で、次のセクションで説明する一連の比較ステップを使用します。または、「sObject のカスタム並び替え順」に示されるように、sObject を Apex クラスでラップして Comparable インターフェースを実装することで、sObject のカスタム並び替え順を実装することもできます。
sObject のデフォルトの並び替え順
- sObject 型の表示ラベル。
たとえば、Account sObject は Contact の前になります。
- Name 項目 (該当する場合)。
たとえば、リストに Alpha と Beta という名前の 2 つの取引先がある場合、取引先 Alpha が取引先 Beta よりも前になります。
- 標準項目。ID 項目と Name 項目を除き、アルファベット順で最初の項目から使用されます。
たとえば、2 つの取引先が同じ名前の場合、並び替えに使用される最初の標準項目は AccountNumber です。
- カスタム項目。アルファベット順で最初の項目から使用されます。
たとえば、2 つの取引先の名前と標準項目が同じで、FieldA と FieldB という 2 つのカスタム項目がある場合、並び替えでは FieldA の値が最初に使用されます。
この一連のすべてのステップが実行されるとは限りません。たとえば、リストに同じ種別で一意の Name 値がある 2 つの sObject が含まれる場合、これらは Name 項目に基づいて並び替えられ、並び替えはステップ 2 で停止します。別の例で、名前が同じか sObject に Name 項目がない場合、並び替えはステップ 3 まで進み、標準項目を基準に並び替えられます。
テキスト項目の場合、並び替えアルゴリズムは Unicode 並び替え順を使用します。また、空の項目は並び替え順で空でない項目より前になります。
Account sObject のリストの並び替えの例を次に示します。この例では、Name 項目が使用されて、リスト内で Acme 取引先が 2 つの sForce 取引先より前に配置されることを示します。sForce という名前の取引先が 2 つあり、アルファベット順で Industry 項目は Site 項目より前になるため、Industry 項目が残りの取引先の並び替えに使用されます。
1Account[] acctList = new List<Account>();
2acctList.add( new Account(
3 Name='sForce',
4 Industry='Biotechnology',
5 Site='Austin'));
6acctList.add(new Account(
7 Name='sForce',
8 Industry='Agriculture',
9 Site='New York'));
10acctList.add(new Account(
11 Name='Acme'));
12System.debug(acctList);
13
14acctList.sort();
15Assert.areEqual('Acme', acctList[0].Name);
16Assert.areEqual('sForce', acctList[1].Name);
17Assert.areEqual('Agriculture', acctList[1].Industry);
18Assert.areEqual('sForce', acctList[2].Name);
19Assert.areEqual('Biotechnology', acctList[2].Industry);
20System.debug(acctList);次の例は前の例と同様ですが、Merchandise__c カスタムオブジェクトを使用する点が異なります。この例では、Name 項目が使用されて、リスト内で Notebooks 商品が Pens より前に配置されることを示します。Name 項目値が Pens の商品 sObject が 2 つあり、アルファベット順で Description 項目は Price および Total_Inventory 項目より前になるため、Description 項目が残りの商品品目の並び替えに使用されます。
1Merchandise__c[] merchList = new List<Merchandise__c>();
2merchList.add( new Merchandise__c(
3 Name='Pens',
4 Description__c='Red pens',
5 Price__c=2,
6 Total_Inventory__c=1000));
7merchList.add( new Merchandise__c(
8 Name='Notebooks',
9 Description__c='Cool notebooks',
10 Price__c=3.50,
11 Total_Inventory__c=2000));
12merchList.add( new Merchandise__c(
13 Name='Pens',
14 Description__c='Blue pens',
15 Price__c=1.75,
16 Total_Inventory__c=800));
17System.debug(merchList);
18
19merchList.sort();
20Assert.areEqual('Notebooks', merchList[0].Name);
21Assert.areEqual('Pens', merchList[1].Name);
22Assert.areEqual('Blue pens', merchList[1].Description__c);
23Assert.areEqual('Pens', merchList[2].Name);
24Assert.areEqual('Red pens', merchList[2].Description__c);
25System.debug(merchList);sObject のカスタム並び替え順
リストを sObject のカスタム並び替え順にするには、sObject のラッパークラスを作成し、Comparable インターフェースを実装します。ラッパークラスに対象の sObject を含め、並び替えロジックを指定する compareTo メソッドを実装します。
次の例では、Opportunity のラッパークラスを作成する方法を示します。このクラスの compareTo メソッドの実装では、Amount 項目 (このインスタンスに含まれるクラスメンバー変数)、およびメソッドに渡された商談オブジェクトに基づいて 2 つの商談を比較します。
1public class OpportunityWrapper implements Comparable {
2
3 public Opportunity oppy;
4
5 // Constructor
6 public OpportunityWrapper(Opportunity op) {
7 // Guard against wrapping a null
8 if(op == null) {
9 Exception ex = new NullPointerException();
10 ex.setMessage('Opportunity argument cannot be null');
11 throw ex;
12 }
13 oppy = op;
14 }
15
16 // Compare opportunities based on the opportunity amount.
17 public Integer compareTo(Object compareTo) {
18 // Cast argument to OpportunityWrapper
19 OpportunityWrapper compareToOppy = (OpportunityWrapper)compareTo;
20
21 // The return value of 0 indicates that both elements are equal.
22 Integer returnValue = 0;
23 if ((oppy.Amount == null) && (compareToOppy.oppy.Amount == null)) {
24 // both wrappers have null Amounts
25 returnValue = 0;
26 } else if ((oppy.Amount == null) && (compareToOppy.oppy.Amount != null)){
27 // nulls-first implementation
28 returnValue = -1;
29 } else if ((oppy.Amount != null) && (compareToOppy.oppy.Amount == null)){
30 // nulls-first implementation
31 returnValue = 1;
32 } else if (oppy.Amount > compareToOppy.oppy.Amount) {
33 // Set return value to a positive value.
34 returnValue = 1;
35 } else if (oppy.Amount < compareToOppy.oppy.Amount) {
36 // Set return value to a negative value.
37 returnValue = -1;
38 }
39 return returnValue;
40 }
41}次の例には、OpportunityWrapper クラスのテストが含まれています。OpportunityWrapper オブジェクトのリストを並び替え、リストの要素が商談金額を基準に並び替えられていることを確認します。
1@isTest
2private class OpportunityWrapperTest {
3 static testmethod void test1() {
4 // Add the opportunity wrapper objects to a list.
5 OpportunityWrapper[] oppyList = new List<OpportunityWrapper>();
6 Date closeDate = Date.today().addDays(10);
7 oppyList.add( new OpportunityWrapper(new Opportunity(
8 Name='Edge Installation',
9 CloseDate=closeDate,
10 StageName='Prospecting',
11 Amount=50000)));
12 oppyList.add( new OpportunityWrapper(new Opportunity(
13 Name='United Oil Installations',
14 CloseDate=closeDate,
15 StageName='Needs Analysis',
16 Amount=100000)));
17 oppyList.add( new OpportunityWrapper(new Opportunity(
18 Name='Grand Hotels SLA',
19 CloseDate=closeDate,
20 StageName='Prospecting',
21 Amount=25000)));
22
23 // Sort the wrapper objects using the implementation of the
24 // compareTo method.
25 oppyList.sort();
26
27 // Verify the sort order
28 Assert.areEqual('Grand Hotels SLA', oppyList[0].oppy.Name);
29 Assert.areEqual(25000, oppyList[0].oppy.Amount);
30 Assert.areEqual('Edge Installation', oppyList[1].oppy.Name);
31 Assert.areEqual(50000, oppyList[1].oppy.Amount);
32 Assert.areEqual('United Oil Installations', oppyList[2].oppy.Name);
33 Assert.areEqual(100000, oppyList[2].oppy.Amount);
34
35 // Write the sorted list contents to the debug log.
36 System.debug(oppyList);
37 }
38}