Visualforce 開発者ガイド
jカスタムコントローラの作成
カスタムコントローラは、引数をとらないデフォルトのコンストラクタを外部の最上位クラスに使用する Apex クラスです。パラメータを含むカスタムコントローラコンストラクタを作成することはできません。
カスタムコントローラを作成する手順は、次のとおりです。
- [設定] から、[クイック検索] ボックスに「Apex クラス」と入力し、[Apex クラス] を選択します。
- [新規] をクリックします。
- [Version Settings (バージョン設定)] をクリックして、このクラスで使用する Apex および API のバージョンを指定します。組織が AppExchange から管理パッケージをインストールしている場合は、このクラスで使用する各管理パッケージのバージョンも指定できます。すべてのバージョンでデフォルト値を使用します。デフォルト値では、Apex および API についても、各管理パッケージについても、クラスを最新バージョンに関連付けます。最新バージョンのパッケージのものとは異なるコンポーネントや機能にアクセスする場合は、管理パッケージの古いバージョンを指定することもできます。特定の動作を維持するために、Apex および API の古いバージョンを指定できます。
- クラスエディタで、クラスの Apex コードを入力します。1 つのクラスの長さは、最大 1,000,000 文字です。@isTest を使用して定義したコメント、テストメソッド、またはクラスは含みません。
- [保存] をクリックし、変更を保存してクラスの詳細画面に戻るか、[適用] をクリックし、変更を保存してクラスの編集を続行します。作成した Apex クラスは、クラスに保存する前に正しくコンパイルする必要があります。
次のクラスは、カスタムコントローラの単純な例です。
1public class MyController {
2
3 private final Account account;
4
5 public MyController() {
6 account = [SELECT Id, Name, Site FROM Account
7 WHERE Id = :ApexPages.currentPage().getParameters().get('id')];
8 }
9
10 public Account getAccount() {
11 return account;
12 }
13
14 public PageReference save() {
15 update account;
16 return null;
17 }
18}次の Visualforce マークアップは、上記のカスタムコントローラをページ内で使用する方法を示します。
1<apex:page controller="myController" tabStyle="Account">
2 <apex:form>
3 <apex:pageBlock title="Congratulations {!$User.FirstName}">
4 You belong to Account Name: <apex:inputField value="{!account.name}"/>
5 <apex:commandButton action="{!save}" value="save"/>
6 </apex:pageBlock>
7 </apex:form>
8</apex:page>カスタムコントローラは、<apex:page> コンポーネントの controller 属性が使用されているため、ページと関連付けられています。
標準コントローラおよびコントローラ拡張と同様に、カスタムコントローラのメソッドは、関連付けられたページマークアップで {! } 表記を使って参照できます。上記の例では、getAccount メソッドは <apex:inputField> タグの value 属性で参照されており、<apex:commandButton> タグは、action 属性が設定された save メソッドを参照しています。
カスタムコントローラは、新しいレコードを作成する場合にも使用できます。次に例を示します。
1public class NewAndExistingController {
2
3 public Account account { get; private set; }
4
5 public NewAndExistingController() {
6 Id id = ApexPages.currentPage().getParameters().get('id');
7 account = (id == null) ? new Account() :
8 [SELECT Name, Phone, Industry FROM Account WHERE Id = :id];
9 }
10
11 public PageReference save() {
12 try {
13 upsert(account);
14 } catch(System.DMLException e) {
15 ApexPages.addMessages(e);
16 return null;
17 }
18 // After successful Save, navigate to the default view page
19 PageReference redirectSuccess = new ApexPages.StandardController(Account).view();
20 return (redirectSuccess);
21 }
22}次の Visualforce マークアップは、上記のカスタムコントローラをページ内で使用する方法を示します。
1<apex:page controller="NewAndExistingController" tabstyle="Account">
2 <apex:form>
3 <apex:pageBlock mode="edit">
4 <apex:pageMessages/>
5 <apex:pageBlockSection>
6 <apex:inputField value="{!Account.name}"/>
7 <apex:inputField value="{!Account.phone}"/>
8 <apex:inputField value="{!Account.industry}"/>
9 </apex:pageBlockSection>
10 <apex:pageBlockButtons location="bottom">
11 <apex:commandButton value="Save" action="{!save}"/>
12 </apex:pageBlockButtons>
13 </apex:pageBlock>
14 </apex:form>
15</apex:page>