開発者によって記述されたコードは、次に示すテンプレートコードの内部に埋め込まれます。process という名前の関数の中にコードが含まれます。
function process() {
var ExcelFunction = Java.type("jp.jasminesoft.util.ExcelFunction");
var Jfcerror = Java.type("jp.jasminesoft.jfc.error.Jfcerror");
var Jfcwarn = Java.type("jp.jasminesoft.jfc.error.Jfcwarn");
var Jfcinfo = Java.type("jp.jasminesoft.jfc.error.Jfcinfo");
var JFCUtils = Java.type("jp.jasminesoft.jfc.JFCUtils");
var HolidayManager = Java.type("jp.jasminesoft.util.HolidayManager");
var stdout = java.lang.System.out;
...ここに開発者独自のコードが埋め込まれる...
}
Designerで入力したスクリプトは、wagbyapp フォルダに存在するスクリプトファイル wagbyapp/webapp/$(APPNAME)/WEB-INF/script/モデルID/スクリプトファイル.js に上書き保存されます。
そのため再ビルドなしで、動作しているアプリケーションの挙動を確認することができます。
基本テンプレートを使わないようにすることもできます。例えば、独自の関数を用意する場合などです。
この場合、開発するコードは必ず function process() から開始してください。コードの先頭がこの記述で始まる場合、基本テンプレートは使わないと判断します。
例えば、次のように記述します。
function process() {
var ExcelFunction = Java.type("jp.jasminesoft.util.ExcelFunction");
var Jfcerror = Java.type("jp.jasminesoft.jfc.error.Jfcerror");
var Jfcwarn = Java.type("jp.jasminesoft.jfc.error.Jfcwarn");
var Jfcinfo = Java.type("jp.jasminesoft.jfc.error.Jfcinfo");
var JFCUtils = Java.type("jp.jasminesoft.jfc.JFCUtils");
var HolidayManager = Java.type("jp.jasminesoft.util.HolidayManager");
var stdout = java.lang.System.out;
...開発者独自のコードを記述する...
}
function foo() {...独自の関数を記述する...}
function bar() {...独自の関数を記述する...}
スクリプトに関する詳細なルールは次のとおりです。
Designerに用意された設定欄でスクリプトを編集すると、編集内容が上書きされます。しかしビルド処理を行うと、customize以下のスクリプトに上書きされます。すなわち、customizeフォルダのファイルが優先されます。
スクリプト中に、Javaが提供する標準クラスを利用することができます。これらは Java.type で再宣言する必要はありません。パッケージ名も含めたクラス名を使ってください。
var list = new java.util.ArrayList();
list.add("Apple");
list.add("Orange");
list.add("Banana");
stdout.println(list);
スクリプト内で利用できる変数をまとめます。
| 名前 | スクリプト内での表現 | 例 | 説明 |
|---|---|---|---|
| ストアモデル | モデル名 | customer | データベースに保存されるオブジェクト |
| プレゼンテーションモデル | モデル名_p | customer_p | Webフォームから入力された値。 すべて文字列型。 |
| コンディションモデル | モデル名_c | customer_c | 検索条件が格納されたオブジェクト。 |
| リストモデル | モデル名_l | customer_l | 一覧表示される値が格納されたオブジェクト |
| エラーメッセージ | errorManager | errorManager | (エラーメッセージで解説) |
| SCREENTYPE | if (SCREENTYPE == "copy") {...} | SCREENTYPE関数と同じ。[例..] | |
| DbActionParameter | p | p | p.appctxで(Springの)ApplicationContextを参照できるなどの使い方がある。 |
| ExcelFunctionクラス (*) | var s = ExcelFunction.FIND(...); | (Wagby関数の利用で解説) | |
| Jfcerrorクラス (*) | var error = new Jfcerror; | (エラーメッセージで解説) | |
| Jfcwarnクラス (*) | var warn = new Jfcwarn; | (エラーメッセージで解説) | |
| Jfcinfoクラス (*) | var info = new Jfcinfo; | (エラーメッセージで解説) | |
| JFCUtilクラス (*) | var s = JFCUtils.Message(p, "M0001") | (Wagby関数で解説) | |
| HolidayManagerクラス (*) | var d = HolidayManager.getInstance().getEigyoDayAsSQLDate(model1.item1, 7) | (Wagby関数で解説) | |
| stdout (*) | java.lang.System.out | stdout.println(...); | Java 8 利用時のみ。 |
開発者は WEB-INF/script/myfunction.js を用意することができます。 このファイルが存在した時、その内容をスクリプトに含めます。
スクリプトで、次のように記載します。
stdout.println(foo(1,2));
開発者は myfunction.js を用意し、関数 foo を定義します。
function foo(a1,a2) {
return a1+a2;
}
スクリプトを実行すると、コンソールに 3.0 と表示されます。
ヘルパの次のタイミングで、関数 preprocess を用意することができます。それぞれ、処理の前に呼び出されます。
| 実行タイミング | ファイル名 |
|---|---|
| 登録 | モデルIDHelper_beforeInsert.js |
| 登録(初期データ作成) | モデルIDHelper_initialize.js |
| 更新 | モデルIDHelper_beforeUpdate.js |
| 詳細画面表示 | モデルIDHelper_beforeShow.js |
開発者は WEB-INF/script/<モデルID> フォルダに作成された上記ファイルを直接、テキストエディタで修正し、関数 preprocess を用意してください。
function preprocess() {
var ExcelFunction = Java.type("jp.jasminesoft.util.ExcelFunction");
var Jfcerror = Java.type("jp.jasminesoft.jfc.error.Jfcerror");
var Jfcwarn = Java.type("jp.jasminesoft.jfc.error.Jfcwarn");
var Jfcinfo = Java.type("jp.jasminesoft.jfc.error.Jfcinfo");
var stdout = java.lang.System.out;
...ここに開発者独自のコードが埋め込まれる...
}