Wagbyではモデルに対応した「サービスクラス」を自動生成します。これはトランザクション境界となっており、CRUD処理に関するメソッドを提供します。詳細は"Service/Daoクラス"をお読みください。

スクリプトでは、次のコードを用いてServiceオブジェクトを取得することができます。
var entityService = p.appctx.getBean(Serviceオブジェクト名);
サービス名は "<モデルID>EntityService" となります。モデルIDはキャメル記法で表現します。例えば customer モデルに対するServiceオブジェクト名は "CustomerEntityService" になります。
具体的なコード例を紹介します。
var entityService = p.appctx.getBean("JuserEntityService");
var user = entityService.findById("user01", true); /* 1件のデータを取得 */
stdout.println(user); /* デバッグ用ログ出力 */
user.name = "ジャスミン太郎";
entityService.update(user); /* 更新 */
これにより、任意のモデルのデータを取得したり、更新することができます。
トランザクションスクリプトでは、このスクリプトを実行する前にトランザクションが開始されています。このとき、任意のモデルに関するDaoを用いてデータの取得や更新を行うことができます。
スクリプトでは、次のコードを用いてDaoを取得することができます。
var dao = p.appctx.getBean(Dao名);
Dao名は "<モデルID>Dao" となります。モデルIDはキャメル記法で表現します。例えば customer モデルに対するDao名は "CustomerDao" になります。
具体的なコード例を紹介します。
var dao = p.appctx.getBean("JuserDao");
var user = dao.get("admin", true); /* 1件のデータを取得 */
stdout.println(user); /* デバッグ用ログ出力 */
user.name = "ジャスミン太郎";
dao.update(user); /* 更新 */
Daoはトランザクション宣言を含みません。そのため dao.update メソッドの前にトランザクションは開始される必要があります。かつ dao.update メソッドのあとにトランザクションを終了する必要があります。
この制約から、Daoを使える場所はトランザクションスクリプトに限られます。トランザクションスクリプトは呼び出しの前後でトランザクションの開始と終了が自動的に実行されるため、Daoによる更新処理は正しく処理されます。
Wagbyが内部で利用しているデータベース操作のためのミドルウェアHibernateが提供するsessionオブジェクトを用いて、任意のSQLを実行することができます。トランザクションスクリプト内では、このsessionという変数(オブジェクト)を利用できます。
次の例は、アカウントモデル(juser)の個数を求めるSQLを実行します。
try {
if (session != null) {
var o = session.createSQLQuery(
"SELECT COUNT(*) FROM \"juser\"").uniqueResult();
stdout.println("o="+o);/* デバッグ用 */
}
} catch (e) {
e.printStackTrace();
}
トランザクションスクリプト以外の場所で session を利用する必要がある場合は、まず session が使えるかどうかを確認してください。session が null の場合、スクリプト内で HibernateUtil.openSession() を使って取得して下さい。例を示します。
var HibernateUtil = Java.type("jp.jasminesoft.jfc.app.HibernateUtil");
var session = HibernateUtil.openSession();
try {
/* session を利用した処理を実装する */
...
} catch (e) {
e.printStackTrace();
} finally {
if (session !== null) {
session.close();/* 忘れないこと */
}
}
スクリプトで (Wagbyが自動生成した) ヘルパクラスを使うことができます。設計情報に記述した初期値や式を再利用できるだけでなく、s2p や p2s メソッドを用いたストアモデルとプレゼンテーションモデルの変換も再利用できます。
例を示します。quotation というストアモデルをプレゼンテーションモデルに変換し、それを po という変数に格納します。
var IPresentationHelper = Java.type("jp.jasminesoft.jfc.IPresentationHelper");
var helperClass = p.appctx.getBean("QuotationPHelper");
var po = helperClass.s2p(quotation, p, IPresentationHelper.SHOW);
stdout.println(po);
次のコードは条件によって更新処理を行うサンプルです。このコードはロックの処理に問題があります。(なお、ここでは悲観ロックを利用した場合についての説明となっています。)
var entityService = p.appctx.getBean("JuserEntityService");
var user = entityService.findById("user01", true);
if (user.kind == 1) {
user.name = "ジャスミン太郎";
entityService.update(user);
}
具体的には条件に合致しない場合は update メソッドが呼び出されません。このとき、findById の第二引数に true を指定したためロックを取得していますが、このロックが解放されずにスクリプトが終わる可能性があります。
ロック解除が行われない場合、メニュー表示時またはログオフ時までは、このロックは掛かったままとなります。
findById メソッドでロックを取得するのではなく、update メソッドの直前でロックを取得するようにしてください。コード例を示します。
var LockUtils = Java.type("jp.jasminesoft.jfc.core.util.LockUtils");
var userDaoHelper = p.appctx.getBean("JuserDaoHelper");
var entityService = p.appctx.getBean("JuserEntityService");
var user = entityService.findById("user01");
if (user.kind == 1) {
try {
LockUtils.lock(user, userDaoHelper);/*ロック取得*/
user.name = "ジャスミン太郎";
entityService.update(user);
} catch (e) {
throw e;/*ロールバックのため*/
} finally {
LockUtils.release(user, userDaoHelper);/*ロック解放*/
}
}
ServiceまたはDaoを使って複数件のデータを取得する場合、クライテリアを使って任意の検索条件を指定できます。モデル設計で、検索条件を有効にしていない項目であってもクライテリアとして(条件を)指定することができます。
モデル毎に用意される CriteriaConverter を使います。コード例を示します。
var criteriaConverter = p.appctx.getBean("Model1CriteriaConverter");
var criteria = criteriaConverter.defaultCriteria();
モデル毎に用意される Meta クラスを使って、criteria に検索条件を設定します。コード例を示します。
var Model1Meta = Java.type("jp.jasminesoft.wagby.model.model1.Model1Meta");
var model1Meta = new Model1Meta();
criteria.eq(model1Meta.item1, 1000); /* item1 の値が 1000 のデータで絞り込む */
eq は等しい、という条件になります。検索条件の詳細は"検索制御 > スクリプトで検索条件をカスタマイズする > 利用できる検索条件"をお読みください。
Service オブジェクト利用時は、第一引数にクライテリアを渡します。戻り値はリストとなっており、複数のストアモデルが格納されています。
var list = Model1Service.find(criteria);
if (list != null && list.size() > 0) {
/* 処理 */
}
Order クラスを使って、criteria に並び替え条件を追加することができます。例を示します。
var OrderClass = Java.type("org.hibernate.criterion.Order");
var order = OrderClass.desc(Model1Meta.start_date.name());
criteria.addOrder(order);
/*criteriaを使って検索する*/
Wagbyでは、主キーは必ずソートキーとして扱われます。すなわち SQL の ORDER BY 句に主キーが含まれます。
この制約を回避するために、CriteriaConverter クラスの defaultCriteria(Order[]) メソッドを使うことができます。開発者が引数に指定した並べ替え条件を優先し、主キーによる並び替えは ORDER BY 句の最後に行うようにすることができます。(つまり優先度を下げることで影響を抑えます。)
var OrderClass = Java.type("org.hibernate.criterion.Order");
var CustomerMetaClass = Java.type("jp.jasminesoft.wagby.model.customer.CustomerMeta");
var customerMeta = new CustomerMetaClass();
var orders = [
OrderClass.asc(customerMeta.companyname.name()),
OrderClass.asc(customerMeta.deptname.name())
];
var criteriaConverter = p.appctx.getBean("CustomerCriteriaConverter");
/* 開発者が並び順を指定する */
var criteria = criteriaConverter.defaultCriteria(orders);
スクリプトでクライテリアをカスタマイズすることもできます。詳細は"検索制御 > スクリプトで検索条件をカスタマイズする"をお読みください。
複合キークラスをストアモデルのインナークラスとして用意しています。
zaiko モデルが複合キーの場合は次のような記述となります。
var Zaiko = Java.type("jp.jasminesoft.wagby.model.zaiko.Zaiko");
var key = new Zaiko.Key();
key.pkey1 = xxx;/* xxx には、主キーの値が入ります */
key.pkey2 = yyy;/* yyy には、主キーの値が入ります */
var zaiko = zaikoEntityService.findById(key,true);/* 第二引数がtrueのときロックをかける */
トランザクションスクリプトでは、return 文で任意の文字列を返すことで、処理をロールバックさせることができます。
また、例外をスローすることでもロールバックします。このとき BusinessLogicException をスローすることで、画面上に任意のエラーメッセージを表示することができます。この方法を説明します。
スクリプト内で BusinessLogicException をスローすることで、このトランザクションをロールバックさせることができます。
throw new Packages.jp.jasminesoft.jfc.core.exception.BusinessLogicException("エラーメッセージ");
エラーメッセージは画面に表示されます。
この方法が利用できるスクリプトは、ヘルパ系で、かつ session (Hibernateのsession) が null でない場合に有効です。
適用する前に、if (session != null) {...} で session が有効かどうかを確認してください。
トランザクションで、次のような例を想定します。

売上伝票モデルの明細(繰り返しコンテナ)に含まれる「商品コード」は、販売商品モデルへの参照項目となっています。この項目にトランザクションクリプトを記述します。
実行したい内容は、売上伝票登録時に、明細に含まれる(いくつ購入したか、という)数量を、商品在庫から減じることです。

具体的なトランザクションスクリプトは次のようになります。
var suryou = product4s.stock;
var syukko_num = precord.PNumber;
/*stdout.println("suryou="+suryou+",syukko_num="+syukko_num);*/
if (suryou - syukko_num < 0) {
return precord.PName + "の在庫 "+suryou+" に対して "+syukko_num+" を出庫しようとしました。";
}
product4s.stock = suryou - syukko_num;
return null;
更新のスクリプトは、登録と同じではありません。
更新の場合は「一度、登録した値」と「更新画面で変更した値」の差をとって、在庫数を再計算する必要があります。 ここで、一度登録した値というのは、データベースの保存された値を指します。 すなわちデータベース上の値と、画面から再入力された値の差を求めるという処理になります。
更新対象のデータとの比較のために更新前のデータをデータベースから取得する場合は別トランザクションで取得する必要があります。
この対応のために、別トランザクションで get 処理を行う仕組み newTransactionEntityService を用いてください。コード例を示します。

var entityService = p.appctx.getBean("SalesslipEntityService");
var newTransactionEntityService = entityService.newTransactionEntityService();/*別トランザクションになる*/
var o_salesslip = newTransactionEntityService.findById(salesslip.id, false);/* salesslip.idは主キー */
var o_precords = o_salesslip.precord;
var o_precord;
for (var i=0; i<o_precords.length; i++) {
o_precord = o_precords[i];
if (o_precord.PNo == precord.PNo) {
break;
}
}
if (o_precord != null) {
var suryou = product4s.stock;
var syukko_num = precord.PNumber - o_precord.PNumber;
/*stdout.println("now suryou="+suryou+",syukko_num_diff="+syukko_num);*/
if (syukko_num != 0) {
if (suryou - syukko_num < 0) {
return precord.PName + "の在庫 "+suryou+" に対して "+syukko_num+" を出庫しようとしました。";
}
product4s.stock = suryou - syukko_num;
}
}
return null;
図4で説明した更新時のトランザクションスクリプトの説明を続けます。このスクリプトでは入力された値とは別に、現在データベースに保持されている値を Dao を使って取得しています。Dao を使うと、参照連動項目もすべて解決します。そのため、データベースに発行するSQLは参照連動の数に比例して増大します。
しかし今回の例では、o_precord.PNo や o_precord.PNumber は参照連動項目ではありません。そこで、Dao 利用時に、不要な参照連動項目の解決をスキップさせることでパフォーマンス向上につなげる方法を説明します。
DataBindingContextはWagbyが提供するクラスです。このクラスに、参照連動の解決を行う項目名を明示することができます。使い方の例を示します。
var DataBindingContext = Java.type("jp.jasminesoft.jfc.dao.DataBindingContext");
var dao = p.appctx.getBean("SalesslipDao");
var dataBindingContext = new DataBindingContext();
var targetItemSet = new java.util.HashSet();
targetItemSet.add("customerName");/* 解決したい参照連動項目 */
dataBindingContext.setTargetItemSet(targetItemSet);
var o_salesslip = dao.get(salesslip.id, true, dataBindingContext);/* 第3引数に指定 */
このように、dao の get メソッドの第3引数に、dataBindingContext を渡します。この引数が未指定の場合、すべての参照連動項目を解決します。
解決したい参照連動項目が繰り返しコンテナ内の項目の場合、コンテナ名は含みません。項目名のみを指定します。
すべての参照連動処理をスキップする場合、空の dataBindingContext を渡します。
var DataBindingContext = Java.type("jp.jasminesoft.jfc.dao.DataBindingContext");
var dao = p.appctx.getBean("SalesslipDao");
var dataBindingContext = new DataBindingContext();
var targetItemSet = new java.util.HashSet();
dataBindingContext.setTargetItemSet(targetItemSet);/* 項目を明示しない */
var o_salesslip = dao.get(salesslip.id, true, dataBindingContext);/* 第3引数に指定 */
図4の更新用トランザクションスクリプトに、参照連動項目の解決をスキップするコードを加えた例を示します。
var DataBindingContext = Java.type("jp.jasminesoft.jfc.dao.DataBindingContext");
var dao = p.appctx.getBean("SalesslipDao");
var dataBindingContext = new DataBindingContext();
dataBindingContext.setTargetItemSet(new java.util.HashSet());/* 項目を明示しない */
var o_salesslip = dao.get(salesslip.id, true, dataBindingContext);/* 第3引数に指定 */
stdout.println(o_salesslip);/* コンソールに出力。確認用 */
var o_precords = o_salesslip.precord;
var o_precord;
for (var i=0; i<o_precords.length; i++) {
o_precord = o_precords[i];
if (o_precord.PNo == precord.PNo) {
break;
}
}
if (o_precord != null) {
var suryou = product4s.stock;
var syukko_num = precord.PNumber - o_precord.PNumber;
/*stdout.println("now suryou="+suryou+",syukko_num_diff="+syukko_num);*/
if (syukko_num != 0) {
if (suryou - syukko_num < 0) {
return precord.PName + "の在庫 "+suryou+" に対して "+syukko_num+" を出庫しようとしました。";
}
product4s.stock = suryou - syukko_num;
}
}
return null;
トランザクションスクリプト内で SQL を直接、実行することもできます。
ここでは上の題材を使って、Dao ではなく SQL を用いて明細データの数量を取得するコードを説明します。
try {
if (session != null) {
/*旧データ読み込み*/
var sql =
"SELECT \"p_number\" FROM \"salesslip$precord\"" +
" WHERE \"id\"=" + salesslip.id + " AND" +
" \"precordjshid\"=" + (precord.PNo - 1);
/*stdout.println("sql="+sql);*/
var o_PNumber = session.createSQLQuery(sql).uniqueResult();
/*stdout.println("o_PNumber="+o_PNumber);*/
var suryou = product4s.stock;
var syukko_num = precord.PNumber - o_PNumber;
stdout.println("now suryou="+suryou+",syukko_num_diff="+syukko_num);
if (syukko_num != 0) {
if (suryou - syukko_num < 0) {
return precord.PName + "の在庫 "+suryou+" に対して "+syukko_num+" を出庫しようとしました。";
}
product4s.stock = suryou - syukko_num;
}
}
} catch (e) {
e.printStackTrace();
}
return null;