e Builder Application ProducerでDAO開発♪

こんにちは、開発本部の江本です。

前回の記事「e Builder Application ProducerでDB設計♪」で、DB設計を紹介しました。
今回は、設計したDBに対して検索用DAOの作成方法を紹介します。
※e Builder Application Producer って何？という方は「過去の記事」をご覧ください。
※Application Producer、名前が長いので、「AppPro」と略します！

AppProで検索用DAOを作成する

ここでは、商品コードから売上伝票情報を取得するDAOを作成します。
このとき、以下のような検索条件を指定できるようにします。

商品コード ※必須条件
売上日以降 ※オプション条件
売上日以前 ※オプション条件

AppProのDAOでは、オプション条件を含むDAOを効率よく作成できます。

その前に、、前回の記事「e Builder Application ProducerでDB設計♪」で作成したDB設計は、致命的な設計ミス(伝票テーブルがなかった...)があったため更新しました。最新のAppProプロジェクトは下部よりダウンロードしてください。

このようにテーブル設計はシステム開発における設計時、場合によっては開発時にも変更が発生するものですねぇ。。
テーブル構造が変更する場合、どこに影響するか、影響範囲を分析する必要があります。
AppProでは、テーブル構造を変更したり、テーブル名を変更するなどのリファクタリングを行なう場合、それを利用しているCTR/BIZなどのコンポーネントをバリデーションし、問題がリストアップされるので、楽にリファクタリングを行なえます！

さて、商品コードから売上伝票情報を取得するDAOを作成する場合、どのような実装方法あるでしょうか？
オプション条件があるため、指定された条件に応じたSQLが実行されるようなDAOを開発しなければなりません。
具体的には、以下のように４パターンがあります。

商品コードのみ
商品コード+売上日以降
商品コード+売上日以前
商品コード+売上日以降+売上日以前

それぞれSQLで表現すると、以下のようになります。
[code:sql]
/* 商品コードのみ /
SELECT
*
FROM
eb_s_sales_slip
WHERE
sales_slip_cd IN (
SELECT
DISTINCT sales_slip_cd
FROM
eb_s_sales_slip_detail
WHERE
product_cd = ?
)
[/code]
[code:sql]
/ 商品コード+売上日以降 /
SELECT
*
FROM
eb_s_sales_slip
WHERE
sales_slip_cd IN (
SELECT
DISTINCT sales_slip_cd
FROM
eb_s_sales_slip_detail
WHERE
product_cd = ?
)
AND
sales_date >= ?
[/code]
[code:sql]
/ 商品コード+売上日以前 */
SELECT
*
FROM
eb_s_sales_slip
WHERE
sales_slip_cd IN (
SELECT
DISTINCT sales_slip_cd
FROM
eb_s_sales_slip_detail
WHERE
product_cd = ?
)
AND
sales_date = ?
AND
sales_date <= ?
[/code]

AppProではどのようにして作るか？

AppProでは、上記のような場合、４つ目のすべての条件を含んだSQL(商品コード+売上日以降+売上日以前)を利用して、DAOを作ります。
そして、DAOエディタの「DAOインターフェース設定」で各条件の「実行時null時」に対して、それぞれ「必須項目」「is null置換」「条件削除」「固定値指定」から以下のように設定します。

productCd：「必須項目」
startSalesDate：「条件削除」
endSalesDate：「条件削除」

「条件削除」とは、実行時の値が null の場合に条件を削除することを意味します。
たとえば、このDAOが実行されたときにendSalesDateの実行時の値がnullのとき、以下のSQLが実行されます。
[code:sql]
/* 商品コード+売上日以降 */
SELECT
*
FROM
eb_s_sales_slip
WHERE
sales_slip_cd IN (
SELECT
DISTINCT sales_slip_cd
FROM
eb_s_sales_slip_detail
WHERE
product_cd = ?
)
AND
sales_date >= ?
[/code]
このように、すべての条件を含むSQLを開発し、各条件に対して「実行時null時」の動作を設定するだけで、以下のような検索条件を指定できるDAOを作ることができます。

商品コード ※必須条件
売上日以降 ※オプション条件
売上日以前 ※オプション条件

[参考] AppProプロジェクト「シンプル売上管理」のダウンロード

AppProプロジェクト「シンプル売上管理」です。

simplesales_apppro.zip

ダウンロード後、以下の手順でe Builder(eclipse)のワークスペースにインポートしてご利用ください。

ウィンドウメニュー[ファイル]-[インポート]をクリック
表示されたウィザードのメニュー[一般]-[既存プロジェクトをワークスペースへ]を選択し、[次へ]ボタンをクリック
ラジオボタン[アーカイブ・ファイルの選択]をクリックし、[参照]ボタンをクリックし、ダウンロードしたZIPファイルを選択
[完了]ボタンをクリック。※プロジェクトのインポートが開始されます。

ZIPファイルを解凍ツールで解凍すると、文字化けたファイルやフォルダが生成されます。。
必ず上記方法でワークスペースにインポートしてください。