Apex 開発者ガイド
jカスタムイテレーター
イテレーターは、コレクション内のすべての項目を辿ります。たとえば、Apex の while ループで、ループを終了する条件を定義し、コレクションを辿るいくつかの方法、つまりイテレーターを提供する必要があります。次の例では、ループが実行されるごとに count が 1 ずつ増加します。
Iterator インターフェースを使用して、ループ全体のリストを辿るためのカスタムの一連の指示を作成できます。イテレーターは、通常 SELECT ステートメントを使用して範囲を定義する Salesforce 外の提供元にあるデータに役立ちます。複数の SELECT ステートメントがある場合にもイテレーターを使用できます。
カスタムイテレーターの使用
カスタムイテレーターを使用するには、Iterator インターフェースを実装する Apex クラスを作成する必要があります。
Iterator クラスには次のインスタンスメソッドがあります。
| 名前 | 引数 | 戻り値 | 説明 |
|---|---|---|---|
| hasNext | Boolean | コレクション内の別の項目が辿られている場合は true が返され、そうでない場合は false が返されます。 | |
| next | anyType | コレクション内の次の項目を返します。 |
Iterator インターフェース内のすべてのメソッドは global または public として宣言する必要があります。
カスタムイテレーターは while ループでのみ使用できます。次に例を示します。
Iterable とカスタムイテレーターの使用
リストでカスタムイテレーターを使用せずに独自のデータ構造を作成する場合、Iterable インターフェースを使用してデータ構造を生成できます。
Iterable インターフェースには次のメソッドがあります。
| 名前 | 引数 | 戻り値 | 説明 |
|---|---|---|---|
| iterator | Iterator クラス | このインターフェースのイテレーターへの参照を返します。 |
iterator メソッドは global または public として宣言する必要があります。データ構造の走査に使用できるイテレーターへの参照を作成します。
次の例では、コレクションのカスタムイテレーターの例を示します。
次は、イテレーターを使用する一括処理ジョブです。