この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

コントローラ拡張の作成

コントローラ拡張は、ApexPages.StandardController または CustomControllerName 型の単一の引数を取るコンストラクタが含まれる Apex クラスです。CustomControllerName は、拡張するカスタムコントローラの名前です。

次のクラスは、コントローラ拡張の単純な例です。

次の Visualforce マークアップは、上記のコントローラ拡張をページ内で使用する方法を示します。

拡張は、<apex:page> コンポーネントの extensions 属性を使用してページに関連付けられます。

すべてのコントローラメソッドと同様に、ページマークアップで {! } 表記を使用して、コントローラ拡張メソッドを参照できます。上記の例では、ページ上部の {!greeting} 式は、コントローラ拡張の getGreeting メソッドを参照しています。

この拡張は、Account 標準コントローラと共に機能するため、標準コントローラメソッドも利用できます。たとえば、<apex:inputField> タグの value 属性は、標準コントローラ機能を使用して取引先の名前を取得します。同様に、<apex:commandButton> タグは、action 属性のある標準 Account の save メソッドを参照します。

カンマ区切りのリストを使って、単一のページに対し複数のコントローラ拡張を定義できます。これにより、同じ名前のメソッドを上書きできます。たとえば、次のようなページがあったとします。
さらに、次の拡張があったとします。
<apex:outputText> コンポーネントの値は、foo-One として表示されます。上書きは、一番左の拡張、つまりカンマ区切りリストの最初の拡張で定義されているメソッドによって定義されます。したがって、ExtOnegetFoo メソッドは、ExtTwo のメソッドを上書きします。

他の Apex クラスと同様に、コントローラ拡張はシステムモードで実行します。したがって、現在のユーザの資格情報はコントローラのロジックの実行に使用されていないため、ユーザの権限と項目レベルのセキュリティは適用されません。ただし、コントローラ拡張が標準コントローラを拡張する場合、標準コントローラのロジックはシステムモードで実行されません。代わりに、ユーザモードで実行されます。このモードでは現在のユーザの権限、項目レベルのセキュリティ、共有ルールが適用されます。

クラスの定義で with sharing キーワードを使用することによって、コントローラ拡張でユーザの組織の共有設定、ロール階層、および共有ルールを適用するかを選択できます。詳細は、『Apex コード開発者ガイド』の「with sharing または without sharing キーワードの使用」を参照してください。

メモ