入力チェック処理をスクリプトコードとして記述することができます。
ここに書いた処理は、その他の(必須チェックや、文字数チェックといった設定で記述できる)チェックの後に実行されます。
Designerでスクリプトを修正すると、開発機上のアプリケーションへ即座に反映されます。ビルド処理なしで修正を確認することができます。
WagbyではWebフォームから入力された値は「プレゼンテーションモデル」が管理しています。
プレゼンテーションモデルの操作では、項目名の末尾に ".content" を付与することで、入力文字列を取得することができます。
次の例は、モデル schedule の日付項目 sch_date の入力が "H25" で始まる場合はエラーにする、というスクリプトです。
/* 日付を取り出す。*/
var s =
(schedule_p.schDate !== null) ? schedule_p.schDate.content : null;
/* slice は JavaScript が提供する */
if (s !== null && s.slice(0,3)=="H25") {
var error = new Jfcerror();
error.content = "平成25年はまだ入力できません。";
p.errors.addJfcerror(error);
}
画面に表示するメッセージは次の3種類を利用することができます。
処理が正常に終了した場合のメッセージです。青枠にメッセージが表示されます。
var info = new Jfcinfo(); info.content="..."; p.errors.addJfcinfo(info);
エラーメッセージです。赤枠にメッセージが表示されます。
var error = new Jfcerror(); error.content="..."; p.errors.addJfcerror(error);
メッセージの国際化にも対応しています。
エラーメッセージファイル $(DEVHOME)\customize\resources\myerrormsg_ja.properties.UTF8 に「キー=値」形式のメッセージを記述します。詳細は"メッセージの変更・国際化 > リソースファイルの編集"をお読みください。
次のコードでロケールに対応した適切なメッセージが出力されます。(この例では、キーに "error.original" という名称を使っています。)
p.errors.addJfcerror(errorManager.getJfcerror("error.original", p.locale));
エラーメッセージファイルにプレースホルダを指定することもできます。具体的には次のようになります。
var arrayOfStrings = Java.type("java.lang.String[]");
var obj = new arrayOfStrings(1);
obj[0] = "テストです。";
p.errors.addJfcerror(errorManager.getJfcerror("error.original", obj, p.locale));
エラーではなく警告を使う場合は、JFCHelperUtils クラスを使います。次のようにしてください。
var JFCHelperUtils = Java.type("jp.jasminesoft.jfc.JFCHelperUtils");
var s = model1.item1;
if (s != null && s == '(エラーとしたい値)') {
var warn = new Jfcwarn();
warn.content="..."; /*警告メッセージ*/
JFCHelperUtils.checkWarnedError(
p, s, warn, "model1.item1",
"model1.item1.error.input.generic");
}
JFCHelperUtils.checkWarnedErrorメソッドの第一引数は p となります。第二引数は「入力された値」です。第三引数は警告オブジェクト(warn)です。第四引数は「モデルID.項目ID」としてください。第五引数は国際化対応時、エラーメッセージのリソースのキー名となります。通常は上記例のように「モデルID.項目ID.error.input.generic」としてください。
プレゼンテーションモデルの入力項目に errorcode という属性が用意されています。ここに何らかの値を設定すると、当該入力欄の背景を赤色とします。
モデルID「AAA」の繰り返しコンテナ「AAAM」に含まれる項目「AAAM/item1」の errorcode をセットするコードは次のとおりです。
var AAAMClass = Java.type("jp.jasminesoft.wagby.model.AAA_p.AAAM");
var Item1Class = Java.type("jp.jasminesoft.wagby.model.AAA_p.Item1");
var cont_ary = AAA_p.AAAM;
if (cont_ary !== null) {
var values;
for (var i=0; i<cont_ary.length; i++) {
if (cont_ary[i].item1 === null) {
values = new Item1Class();
cont_ary[i].item1 = values;
} else {
values = cont_ary[i].item1;
}
values.errorcode = "ERROR";/* errorcode をセットする */
var error = new Jfcerror();
error.content = "ERROR";
p.errors.addJfcerror(error);
}
}
Webフォームからの入力ではなく、自動計算によって求められた値を使った「整合性チェック」を行うこともできます。この場合はストアモデルを用います。ストアモデルは画面から入力された文字列を適切な型(文字、数字、日付)に変換した値を保持します。また自動計算によって求められた値も保持します。
次の例は、親モデル Parent と子モデル Child (外部キーで関連する親子関係)において、親側の Parent に、子である Child モデルの数(COUNT)および、項目の最大値(MAX)が定義されているものとします。
このとき、countOfChild 項目は2以上、maxOfChildItem1 項目が100以上というルールは次のように記述します。
/* Parent はストアモデル */
if (Parent.countOfChild < 2) {
var error = new Jfcerror();
error.content = "子モデルの数は2以上です。";
p.errors.addJfcerror(error);
}
if (Parent.maxOfChildItem1 < 100) {
var error = new Jfcerror();
error.content = "子モデルitem1の最大値は100以上です。";
p.errors.addJfcerror(error);
}
親子モデル関係において、子モデルの同時更新を有効にします。
このとき「親モデルに、必ず1件以上の子モデルが必要」という入力チェックは次のように記述できます。子モデルを Child と定義しています。
/* 子モデル名を Child と定義している */
var Child_ary = p.request.getAttribute("Child_ary");/*子モデル配列の取得*/
var count = Child_ary.length;
if (count < 1) {
var error = new Jfcerror();
error.content = "子モデルChildは1件以上、必要です。";
p.errors.addJfcerror(error);
}
親子モデル同時更新機能では、入力チェック処理のタイミングで、対象となる子モデルの配列が、p.requestオブジェクトに格納されています。キー名は「子モデル名_ary」です。末尾に "_ary" をつけたキー名で、配列を取得できます。
これを取得し、配列の数をチェックすることで、子モデルの数を知ることができます。
なお、ここで取得した Child_ary はストアモデルです。
親子モデル関係において、子モデルの同時更新を有効にします。
このとき「親モデルの出荷日と、各子モデルの納期日を比較する」というスクリプトを次のように記述することができます。
/*親モデルの出荷日と、子モデルの納期を比較する*/
var syukkabi = Parent.sdate;/*Parentはストアモデル*/
var Child_ary = p.request.getAttribute("Child_ary");
var count = Child_ary.length;
for (var i=0; i<count; i++) {
var Child = Child_ary[i];/*Childもストアモデル*/
var nouki = Child.nouki;/*syukkabiもnoukiもJavaScriptのDate型オブジェクトとして扱える*/
if (syukkabi.getTime() > nouki.getTime()) {
var error = new Jfcerror();
error.content = (i+1)+"番目の納期は、出荷日よりも早い日になっています。";
p.errors.addJfcerror(error);
}
}
Parent ならびに Child_ary はストアモデルです。ストアモデルは文字列、数字、日付型を区別しているため、項目 sdate や nouki は日付型と認識されます。そのため JavaScript の日付オブジェクトとして操作できます。具体的には getTime() メソッドを利用した比較処理を行うことができます。
customer モデルが最大、10件までしか登録できない、というルールを想定します。このチェックのためには、現在データベースに格納されている「件数」を知る必要があります。
入力チェックのスクリプトでデータベースを操作するためには、開発者の方で「セッション」を取得します。
スクリプトの例を示します。
var HibernateUtil = Java.type("jp.jasminesoft.jfc.app.HibernateUtil");
var session = HibernateUtil.openSession();
try {
var o = session.createSQLQuery(
"SELECT COUNT(*) FROM \"customer\"").uniqueResult();
if (o > 10) {
var error = new Jfcerror();
error.content = "10件以上のデータを登録することはできません。";
p.errors.addJfcerror(error);
}
} catch (e) {
e.printStackTrace();
} finally {
if (session !== null) {
session.close();/*忘れないこと*/
}
}
商品 (product) モデルを想定します。主キー項目 pkey は順序による自動採番とし、また、主キーではない項目「商品コード (pcode)」を持つとします。ここで、重複する商品コードを事前にチェックし、重複があった場合はエラーメッセージを表示するスクリプトを紹介します。
var screentype = p.request.getAttribute("__jfc_screen_type");/* SCREENTYPE 関数のこと */
var service = p.appctx.getBean("ProductEntityService");
var criteriaConverter = p.appctx.getBean("ProductCriteriaConverter");
var criteria = criteriaConverter.defaultCriteria();
var metaClass = Java.type("jp.jasminesoft.wagby.model.product.ProductMeta");
var meta = new metaClass();
criteria.eq(meta.pcode, product.pcode);/* pcode の重複を確認する。*/
var list = service.find(criteria);
if (list !== null && list.size() >= 1) {
if (screentype === "update" && list.size() === 1) {
var o = list.get(0);
if (o.pkey === product.pkey) {
/* 自分自身なのでエラーとしない */
return;
}
}
var error = new Jfcerror();
error.content = "商品コード '"+product.pcode+"' が重複しています。";
p.errors.addJfcerror(error);
}
一覧更新画面に用意された「入力チェック」でスクリプトを呼び出します。値の変更があった行の数だけが対象となります。(変更せずに「入力チェック」ボタンを押下してもスクリプトは呼び出されません。)
「スクリプト > ヘルパ > 入力チェック(一覧更新)」を用意します。例を示します。
stdout.println("入力チェック "+customer+" "+customer_ulp);
if (customer.customername == "aaa") {
var error = new Jfcerror();
error.content = "顧客名に aaa は利用できません。";
p.errors.addJfcerror(error);
return error.content;
}
スクリプト内ではストアモデルの他、一覧更新画面でのみ利用できる、接尾語に "_ulp" が付与されたプレゼンテーションモデルを参照することができます。