「画面 > スクリプト > コントローラ」を設定します。
はじめに、どの画面についてのスクリプトを記述するかを指定します。
画面ごとに「実行タイミング」が用意されています。スクリプトは、指定したタイミングが終了したあとに呼び出されます。
ヘルパの登録時は XXXHelper#beforeInsert メソッドがスクリプトを呼び出します。これはデータベースに登録する「直前」に呼び出されるものです。
一方、コントローラの登録処理は、データベース登録処理などがすべて完了し、画面表示 (JSP) に制御が移る直前に呼び出されます。
コントローラのスクリプトを作成する目的は、Wagby標準の画面遷移ルールを変更することです。 具体的には次のように記述します。
return "redirect:/" + 遷移先の画面種別 + モデルID + アクション文字列
return "forward:/" + 遷移先の画面種別 + モデルID + アクション文字列
接頭語 "redirect:/" または "forward:/" が必要です。両者の違いは「リダイレクトとフォワード」の節で説明します。標準は "redirect:/"を使うようにしてください。画面種別はSCREENTYPE関数の仕様に準じます。モデルIDは先頭を大文字とします。(例:customerモデルの場合、Customerとなる。)アクション文字列は、次節以降のサンプルで確認してください。
画面遷移に変更がない場合は、return文を省略できます。追加コードのみ記述してください。
連続した登録処理を行うため、登録画面終了後、再び登録画面に遷移するようにした例です。
return "redirect:/insertCustomer.do?action_New=New";
再呼出された登録画面に、前回の登録画面で選択した値を渡し、初期値として表示することができます。
例えば、他モデル参照(リストボックス)項目 item1 の値を渡す場合、次のようにします。
return "redirect:/insertCustomer.do?action_New=New&item1="+customer.getItem1();
受け取る側 (item1) は、初期値(登録画面表示時)に次のような式を書きます。
TOINT(REQUEST())
詳細は「画面遷移 (1) 詳細画面から登録画面へ遷移する > モデル参照項目の扱い」を参考にしてください。
複数のパラメータを付与する場合は、各パラメータを & で区切ります。
return "redirect:/insertCustomer.do?action_New=New&item1="+customer.getItem1()+"&item2="+customer.getItem2();
すべての受け取る側の項目には、初期値(登録画面表示時)に REQUEST() 関数を適用してください。
日本語文字列(を含む、英語圏以外の文字列)をパラメータとして付与する場合は、文字エンコーディングの配慮が必要となります。
ここではWagbyが提供するユーティリティクラス jp.jasminesoft.util.WebStringEncodeUtilities を使う方法を紹介します。
var WebUtils = Java.type("jp.jasminesoft.util.WebStringEncodeUtilities");
return "redirect:/insertCustomer.do?action_New=New&customername="+WebUtils.encodeString(customer.getCustomername());
return で次の画面遷移先を指定するとき、接頭語 forward または redirect のいずれかを指定します。両者の違いは次の通りです。
| フォワード | リダイレクト | |
|---|---|---|
| 処理の流れ | ブラウザからの要求(リクエスト)を、forward で指定した先に引き継ぐ。 | 処理がいったんブラウザに返されたあと、ブラウザが続けて redirect 先に新たに要求(リクエスト)を行う。 |
| 使い分け | ブラウザからみると、フォワード先の処理も含めて「一つの(一連の)」処理とみなせる場合に有効。同じ画面に戻る場合といった、限定的な用途で使う。 | いったん処理を完了し、新しく次の処理に進めたい場合に有効。別画面へ遷移する場合、原則はこちらを利用する。 |
| 利用者(ブラウザ)の視点 | 一回の通信で完結。内部で「処理2」も行われているが、利用者はそれに気づかない。処理2から結果が送信されるが、利用者は「処理1を要求した結果」だと解釈する。 | 通信は二回、発生する。最初の結果を受け取ってすぐ、次の画面を開く要求が生じる。 |
| p.requestの値 | forward で指定した先でも利用できる。遷移先が異なる画面の場合、遷移元の値が引き継がれると誤動作の原因となることに留意すること。 | redirect で指定した先では利用できない。 |
動作するスクリプトは、次のファイル命名規則に従って WEB-INF/script/モデルID フォルダ内に生成されます。
操作アクション + モデル名 + "_" + ボタン操作でサーバに送られる文字列.js
このスクリプトは所定のアクション処理が終了した後に呼び出されます。ファイル名の具体例を示します。
WEB-INF/script/juser/InsertJuser_Send.js
WEB-INF/script/customer/ShowCustomer_JFCPrintScreen.js
WEB-INF/script/customer/ShowListCustomer_JFCPrintScreen.js
WEB-INF/script/staff/UpdateStaff_Send.js
WEB-INF/script/staff/UpdateStaff_Cancel.js
一覧更新画面でのスクリプトは記述できません。一覧更新画面は内部の動作が複雑なため、スクリプトによる挙動変更による誤動作の危険があるためです。
帳票出力(一括出力を含む)のスクリプトでは、画面遷移を指定することができません。(指定しても無視されます。)