intra-mart Accel Kaiden! / プログラミングガイド

第2版 2014-08-01

«  4.2.3.5. バリデーション   ::   コンテンツ   ::   4.2.3.7. ログ出力  »

4.2.3.6. マネージャ(Manager)

intra-mart Accel Kaiden! のマネージャはデータベース操作のAPIを提供しています。
本項ではマネージャの呼び出しと作成方法について解説します。

4.2.3.6.1. マネージャの構成

intra-mart Accel Kaiden! のマネージャには、継承するクラスの違いにより「マスタマネージャ」「申請書ガジェットマネージャ」「その他マネージャ」に分類できます。
../../../_images/manager.png

4.2.3.6.2. マネージャの呼び出し

呼び出す場所については特に制限はなく、どこからでも使用できます。
intra-mart Accel Kaiden! の勘定科目マスタマネージャクラスを呼び出すサンプルを以下に掲載します。

@Resourceアノテーションによるコンポーネント取得

    @Resource
    public AccountManager accountManager;
    
    public void xxxMethod() {
        accountManager.xxxx();
    }

コンポーネント名を指定してコンポーネント取得

    public AccountManager accountManager;
    
    public void xxxMethod() {
        accountManager = SingletonS2Container.getComponent("accountManager");
        accountManager.xxxx();
    }

コラム

intra-mart Accel Kaiden! 標準ではマネージャクラスでは、@Resourceアノテーションを使用しないコンポーネント取得はコンポーネント名指定で行っています。

4.2.3.6.3. マネージャの作成

最上位クラスのjp.co.slcs.kaiden2.base.foundation.manager.AbstractGenericManagerで提供している機能について、ポイントのみ解説していきます。
基本的な検索・登録・更新・削除のメソッドについては言及しません。

4.2.3.6.3.1. 会社認可

会社認可を参照するメソッド、しないメソッドが用意されていますので、必要に応じてマネージャに実装できます。

会社認可を参照するAPIはjp.co.slcs.kaiden2.base.foundation.manager.AuthorityCriteriaDtoを引数で受け取ります。
AuthorityCriteriaDtoには以下の内容が設定されており、認可設定で許可されているかどうかを判定します。
  • アクション
  • 認可判定基準日
  • 認可判定ユーザ (省略時はログインユーザを利用)
  • 認可判定ロケール

4.2.3.6.3.2. SQLファイル検索

複雑なSQL文を実行するためにSQLファイルによる検索メソッドが用意されています。

サービスクラスとSQLファイル名(パス除く)を引数で受け取ります。
「”WEB-INF/classes/META-INF/sql” + “サービスクラスのパッケージ” + “サービスクラス名”」のSQLファイルを
intra-mart Accel Kaiden! 基底クラスが取得しています。

また、引数のlikeTargetにカラムを指定すると、部分一致検索条件に変換されます。

4.2.3.6.3.3. キーワード検索

キーワード検索を実行するメソッドを用意しています。
intra-mart Accel Kaiden! ではマスタメンテナンス画面の汎用検索画面で使用しており、
一つのテキストボックスに入力した値を複数カラムに対して検索を実施できます。

«  4.2.3.5. バリデーション   ::   コンテンツ   ::   4.2.3.7. ログ出力  »