Visualforce 開発者ガイド
jコントローラ拡張の作成
コントローラ拡張は、ApexPages.StandardController または CustomControllerName 型の単一の引数を取るコンストラクタが含まれる Apex クラスです。CustomControllerName は、拡張するカスタムコントローラの名前です。
次のクラスは、コントローラ拡張の単純な例です。
1swfobject.registerObject("clippy.extension_code", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public class myControllerExtension {
18
19 private final Account acct;
20
21 // The extension constructor initializes the private member
22 // variable acct by using the getRecord method from the standard
23 // controller.
24 public myControllerExtension(ApexPages.StandardController stdController) {
25 this.acct = (Account)stdController.getRecord();
26 }
27
28 public String getGreeting() {
29 return 'Hello ' + acct.name + ' (' + acct.id + ')';
30 }
31}次の Visualforce マークアップは、上記のコントローラ拡張をページ内で使用する方法を示します。
1swfobject.registerObject("clippy.extension_markup", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<apex:page standardController="Account" extensions="myControllerExtension">
18 {!greeting} <p/>
19 <apex:form>
20 <apex:inputField value="{!account.name}"/> <p/>
21 <apex:commandButton value="Save" action="{!save}"/>
22 </apex:form>
23</apex:page>拡張は、<apex:page> コンポーネントの extensions 属性を使用してページに関連付けられます。
すべてのコントローラメソッドと同様に、ページマークアップで {! } 表記を使用して、コントローラ拡張メソッドを参照できます。上記の例では、ページ上部の {!greeting} 式は、コントローラ拡張の getGreeting メソッドを参照しています。
この拡張は、Account 標準コントローラと共に機能するため、標準コントローラメソッドも利用できます。たとえば、<apex:inputField> タグの value 属性は、標準コントローラ機能を使用して取引先の名前を取得します。同様に、<apex:commandButton> タグは、action 属性のある標準 Account の save メソッドを参照します。
カンマ区切りのリストを使��て、単一のページに対し複数のコントローラ拡張を定義できます。これにより、同じ名前のメソッドを上書きできます。たとえば、次のようなページがあったとします。
1<apex:page standardController="Account"
2 extensions="ExtOne,ExtTwo" showHeader="false">
3 <apex:outputText value="{!foo}" />
4</apex:page>1public class ExtOne {
2 public ExtOne(ApexPages.StandardController acon) { }
3
4 public String getFoo() {
5 return 'foo-One';
6 }
7}1public class ExtTwo {
2 public ExtTwo(ApexPages.StandardController acon) { }
3
4 public String getFoo() {
5 return 'foo-Two';
6 }
7}