action メソッドの定義
action メソッドは、ユーザがボタンをクリックしたり、ページ内のある領域にマウスポインタを移動したりするなどのページイベントが発生すると、ロジックまたはナビゲーションを実行します。次のいずれかのタグの action パラメータに {! } 表記を使用することによって、ページマークアップから action メソッドをコールできます。
- <apex:commandButton> はアクションをコールするボタンを作成する
- <apex:commandLink> はアクションをコールするリンクを作成する
- <apex:actionPoller> は定期的にアクションをコールする
- <apex:actionSupport> は、別の名前つきのコンポーネントにイベント (「onclick」、「onmouseover」など) を作成し、アクションをコールする
- <apex:actionFunction> は、アクションをコールする新しい JavaScript 関数を定義する
- <apex:page> はページが読み込まれると、アクションをコールする
たとえば、「ページでの入力コンポーネントの使用」で説明されているサンプルページでは、コマンドボタンは、標準取引先コントローラの save メソッドにバインドされています。MyController カスタムコントローラを使用するように、前の例を適応させることができます。
上記のページを保存すると、Visualforce エディタで「クイック修正」オプションを使用して、MyController クラスに save メソッドを追加できます。クイック修正リンクをクリックすると、MyController は次のようになります。
クイック修正によって生成される save メソッドは、action メソッドに使用する標準署名を使用します。これは public であり、PageReferemce を返し、引数を含みません。
最終的に、save メソッドの定義は、新しい取引先値を使用してデータベースを更新する必要がありますが、まずその前にメンバー変数を定義して、データベースから取得される取引先情報を保存する必要があります。取引先のメンバー変数がない場合、データベースから取得されるレコードは、その値がページを表示するために使用された後で保持されないため、ユーザによるレコード更新は保存できません。このメンバー変数を導入するには、コントローラコードの 2 つの部分を変更する必要があります。
- メンバー変数をクラスに追加する
- getAccount が最初のクエリを実行するときにメンバー変数を設定する
メンバー変数が適切に配置されたため、save メソッドで行う必要があることはデータベースの更新だけです。
save に対するより堅牢なソリューションとしては、さまざまな例外の検出や重複の検索などを行うことが考えられます。ここでは単純な例を示すことを目的としているため、そのような詳細は省略しています。
このページをテストするために、[取引先名を変更] 項目の値を変更して、[新規取引先名を保存] をクリックします。標準取引先コントローラの例と同様に、ページは単に新しい取引先名で更新されます。次の例では、save アクションを拡張して、現在のページを更新する代わりにユーザを別の確認ページに移動します。