Force.com Apex コード開発者ガイド
jStandardSetController クラス
StandardSetController オブジェクトを使用すると、Salesforce が提供する、プリビルドされた Visualforce リストコントローラと同様のリストコントローラ、またはその拡張としてリストコントローラを作成できます。
名前空間
使用方法
StandardSetController クラスには、プロトタイプオブジェクトも含まれます。これは、Visualforce の StandardSetController クラスに含まれる単一の sObject です。プロトタイプオブジェクトの項目が設定されている場合、それらの値は、保存操作中に使用されます。つまり、値は設定されたコントローラコレクションのすべてのレコードに適用されます。これは、一括更新 (オブジェクトのコレクション内の項目に同一の変更を適用) を実行するページを記述するときに役立ちます。
インスタンス化
次のいずれかの方法で、StandardSetController をインスタンス化することができます。
- sObjects のリストを使用する場合:
1List<account> accountList = [SELECT Name FROM Account LIMIT 20]; 2ApexPages.StandardSetController ssc = new ApexPages.StandardSetController(accountList); - クエリロケータを使用する場合:
1ApexPages.StandardSetController ssc = 2new ApexPages.StandardSetController(Database.getQueryLocator([SELECT Name,CloseDate FROM Opportunity]));
例
次の例では、StandardSetController オブジェクトのカスタムリストコントローラのコンストラクタでの使用方法を示します。
1swfobject.registerObject("clippy.codeblock-2", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public class opportunityList2Con {
18 // ApexPages.StandardSetController must be instantiated
19 // for standard list controllers
20 public ApexPages.StandardSetController setCon {
21 get {
22 if(setCon == null) {
23 setCon = new ApexPages.StandardSetController(Database.getQueryLocator(
24 [SELECT Name, CloseDate FROM Opportunity]));
25 }
26 return setCon;
27 }
28 set;
29 }
30
31 // Initialize setCon and return a list of records
32 public List<Opportunity> getOpportunities() {
33 return (List<Opportunity>) setCon.getRecords();
34 }
35}次の Visualforce マークアップは、上記のコントローラをページ内で使用する方法を示します。
1swfobject.registerObject("clippy.codeblock-3", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<apex:page controller="opportunityList2Con">
18 <apex:pageBlock>
19 <apex:pageBlockTable value="{!opportunities}" var="o">
20 <apex:column value="{!o.Name}"/>
21 <apex:column value="{!o.CloseDate}"/>
22 </apex:pageBlockTable>
23 </apex:pageBlock>
24</apex:page>StandardSetController コンストラクタ
StandardSetController のコンストラクタは次のとおりです。
StandardSetController(sObjectList)
クエリロケータによって返される sObject のリストの ApexPages.StandardSetController クラスの新しいインスタンスを作成します。
署名
public StandardSetController(Database.QueryLocator sObjectList)
パラメータ
- sObjectList
- 型: Database.QueryLocator
- sObject のリストを返すクエリロケータ。
StandardSetController メソッド
StandardSetController のメソッドは次のとおりです。すべてインスタンスメソッドです。
cancel()
元のページ (わかっている場合)、またはホームページの PageReference を返します。
署名
public System.PageReference cancel()
戻り値
getCompleteResult()
セット内に存在するレコード数がレコード数の上限を超えているかどうかを示します。false の場合、レコード数がリストコントローラを使用して処理できる数を超えています。レコード数の上限は 10,000 レコードです。
署名
public Boolean getCompleteResult()
戻り値
型: Boolean
getListViewOptions()
現在のユーザが使用できるリストビューのリストを返します。
署名
public System.SelectOption getListViewOptions()
戻り値
型: System.SelectOption[]
getRecord()
選択したレコードへの変更を示す sObject を返します。クラス内に含まれるプロトタイプオブジェクトを取得し、一括更新の実行に使用されます。
署名
public sObject getRecord()
戻り値
型: sObject
getRecords()
現在のページセットにある sObject のリストを返します。このリストは不変であるため、clear() をコールできません。
署名
public sObject[] getRecords()
戻り値
型: sObject[]
save()
新しいレコードを挿入するか、変更された既存のレコードを更新します。この操作が完了した後、元のページ (わかっている場合)、またはホームページの PageReference を返します。
署名
public System.PageReference save()
戻り値
setFilterID(filterId)
コントローラの検索条件 ID を設定します。
署名
public Void setFilterID(String filterId)
パラメータ
- filterId
- 型: String
戻り値
型: Void
setpageNumber(pageNumber)
ページ番号を設定します。
署名
public Void setpageNumber(Integer pageNumber)
パラメータ
- pageNumber
- 型: Integer
戻り値
型: Void
setPageSize(pageSize)
各ページセット内のレコード数を設定します。
署名
public Void setPageSize(Integer pageSize)
パラメータ
- pageSize
- 型: Integer
戻り値
型: Void
setSelected(selectedRecords)
選択したレコードを設定します。
署名
public Void setSelected(sObject[] selectedRecords)
パラメータ
- selectedRecords
- 型: sObject[]
戻り値
型: Void