001/*
002 * Copyright (c) 2009 The openGion Project.
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 *     http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
013 * either express or implied. See the License for the specific language
014 * governing permissions and limitations under the License.
015 */
016package org.opengion.hayabusa.resource;
017
018import java.util.ArrayList;
019import java.util.Collections;
020import java.util.List;
021
022import org.opengion.fukurou.db.DBUtil;
023import org.opengion.fukurou.util.ApplicationInfo;
024import org.opengion.hayabusa.common.HybsSystem;
025import org.opengion.fukurou.db.DBFunctionName; // 5.6.4.3 (2013/05/24)
026
027/**
028 * systemId と lang に対応した画面データを作成するデータロードクラスです。
029 *
030 * 画面データは、画面ID(GUIKEY)に対して、各種画面情報を持っています。
031 * 従来と異なるのは、同一画面IDに対して、アドレスやロールズを変えた情報を持てると言う
032 * 事です。これは、カスタマイズ時に、画面IDは変えずに、実際のアクセスされるアドレスを
033 * 変える事で、他のアプリケーションへの影響を最小限にして開発できます。
034 * linkタグや、submit などの gamenID を指定するカスタムタグでは、実際のアクセス先は、
035 * ログインユーザーのロールズでアクセス可能な画面のアドレスに転送されます。
036 * 作番毎のカスタマイズや、ユーザーロールに応じた飛び先変更などにも使用できます。
037 *
038 * 画面データでは、複数階層持てるように、画面階層(GUILVL)を持っています。このレベルに
039 * 応じて、分類(CLASSIFY)の表示方法が変わります。(擬似階層構造)
040 *
041 * 画面データでは、言語(LANG)は、条件から消えました。実際に名称を表示させる時は、
042 * 画面カラムID(LABEL_CLM)に対応する ラベル定義より、言語に応じたラベルを取得します。
043 * エンジン内部で使用している GUIInfo オブジェクト構築時に割り当てます。
044 * 分類(CLASSIFY)は、コードリソースに登録します。
045 *
046 * 画面データを作成する場合は、同一画面IDで、作成区分(KBSAKU)違いの場合は、
047 * 最も大きな作成区分を持つ画面情報を使用します。
048 * 作成区分(KBSAKU)='0' のデータは、マスタリソースとして、エンジンとともに
049 * 配布されるリソースになります。
050 *
051 * 画面データは、カラム定義のような、読込フラグ(FGLOAD)はありません。
052 * 画面情報(GUIInfo)は、ユーザーログイン毎に作成されます。(キャッシュは
053 * セッション情報に登録されます。)
054 * これは、画面アクセス条件を、ログイン時に済ますことで、高速化を図っています。
055 * 画面IDの件数が少ないことと、画面IDを自動作成した場合でも、
056 * ほとんどのケースで、すべて使用される可能性が非常に高い為です。
057 *
058 * SYSTEM_ID='**' は、共通リソースです。
059 * これは、システム間で共通に使用されるリソース情報を登録しておきます。
060 *
061 * @og.rev 4.0.0.0 (2004/12/31) 新規作成
062 * @og.group リソース管理
063 *
064 * @version  4.0
065 * @author   Kazuhiko Hasegawa
066 * @since    JDK5.0,
067 */
068final class GUIDataLoader {
069        // リソースの接続先を、取得します。
070        private final String DBID = HybsSystem.sys( "RESOURCE_DBID" );
071
072        // DBリソースの初期一括読み込みのクエリー
073        // ソート順は、画面IDオブジェクトの優先順(後優先)で、画面表示順ではありません。
074        // 5.6.4.3 (2013/05/24) FAQ追加 現段階ではシステムコードは考慮しない
075        private final String QUERY = "select GUIKEY,GUILVL,LABEL_CLM,ADDRESS,SEQNO"
076                                                                        + ",GROUPS,'',ROLES,RWMODE,TARGET,PARAM,KBLINK,DYUPD"
077                                                                        + ",case when exists(select 1 from GE80" // 5.6.4.3 (2013/05/24) FAQ追加 別途検索した方が良い?
078                                                                        + "                     where GE80.SYSTEM_ID = GEA11.SYSTEM_ID and GE80.FGJ='1' and KNRNGUI like '%'"
079                                                                        + DBFunctionName.getFunctionName("CON",DBID)
080                                                                        + "GEA11.GUIKEY"
081                                                                        + DBFunctionName.getFunctionName("CON",DBID)
082                                                                        +"'%')"
083                                                                        + " then 'true' else 'false' end as FAQ"
084                                                                        + " from GEA11 where SYSTEM_ID in ( ?,'**') and FGJ='1'"
085                                                                        + " order by SYSTEM_ID,KBSAKU,SEQNO,GUIKEY" ;
086
087        private final List<GUIData>     pool = Collections.synchronizedList(new ArrayList<GUIData>());  // キャッシュ用プール
088        private final String            SYSTEM_ID ;             // システムID
089
090        /** コネクションにアプリケーション情報を追記するかどうか指定 */
091        public static final boolean USE_DB_APPLICATION_INFO  = HybsSystem.sysBool( "USE_DB_APPLICATION_INFO" ) ;
092
093        // 3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfoオブジェクトを設定
094        private final ApplicationInfo appInfo;
095
096        /**
097         *  SystemId 毎に ファクトリオブジェクトを作成します。
098         *
099         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfoオブジェクトを設定
100         *
101         * @param systemId システムID
102         */
103        GUIDataLoader( final String systemId ) {
104                SYSTEM_ID = systemId;
105
106                // 3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfoオブジェクトを設定
107                if( USE_DB_APPLICATION_INFO ) {
108                        appInfo = new ApplicationInfo();
109                        // ユーザーID,IPアドレス,ホスト名
110                        appInfo.setClientInfo( SYSTEM_ID,HybsSystem.HOST_ADRS,HybsSystem.HOST_NAME );
111                        // 画面ID,操作,プログラムID
112                        appInfo.setModuleInfo( "CodeDataLoader",null,null );
113                }
114                else {
115                        appInfo = null;
116                }
117
118                // ApplicationInfo の設定が終わってから実行します。
119                loadDBResource();
120        }
121
122        /**
123         * DBリソースより 画面データを取得、設定します。
124         * DBリソースは、GUIKEY,GUILVL,LABEL_CLM,ADDRESS,SEQNO,GROUPS,
125         * CLASSIFY,ROLES,RWMODE,TARGET,PARAM,KBLINK の順番で、GUIKEY の重複を許します。
126         * 重複している場合(ロール違い等)は、一つのオブジェクトとして作成され、
127         * 個々のログインユーザー毎にユニークになるように、設定する必要があります。
128         *
129         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfoオブジェクトを設定
130         * @og.rev 4.0.0.0 (2007/10/31) ロールの継承機能の追加・分類の取得を追加(暫定対応)
131         * @og.rev 5.3.1.0 (2011/01/01) 通常画面に対してアドレスを設定しない場合にロールが効かないバグを修正します。
132         * @og.rev 5.3.1.0 (2011/01/01) ロール継承機能廃止
133         */
134        private void loadDBResource() {
135                String[] args = new String[] { SYSTEM_ID };
136
137                String[][] vals = DBUtil.dbExecute( QUERY,args,appInfo,DBID );
138                int len = vals.length;
139
140                int level ;
141                String classify = "";
142                for( int i=0; i<len; i++ ) {
143
144                        // ロールの継承対応
145                        level = Integer.parseInt( vals[i][GUIData.GUILVL] );
146                        if( level == 2 ) {
147                                classify = vals[i][GUIData.GUIKEY]; // 暫定対応
148                        }
149                        else if( level >= 3 ) {
150                                vals[i][GUIData.CLASSIFY] = classify; // 暫定対応
151                        }
152
153                        // 5.3.1.0 (2011/01/01) 通常画面に対してアドレスを設定しない場合にロールが効かないバグを修正します。
154                        if( ( level == 1 || level == 2 ) && ( vals[i][GUIData.ADDRESS] == null || vals[i][GUIData.ADDRESS].length() == 0 ) ) {
155                                        vals[i][GUIData.ROLES] = null;
156                        }
157
158                        pool.add( new GUIData( vals[i] ) );
159                }
160
161                System.out.println( "  GUIDataLoader [" + len + "] loaded" );
162        }
163
164        /**
165         * すべてのGUIData オブジェクト配列を取得します。
166         * プールに持っているすべてのキャッシュを、GUIData オブジェクト配列
167         * にして返します。
168         * このリソースは、List で管理しており、読み込み時にすべてキャッシュされます。
169         *
170         * @return   GUIData[]  すべてのGUIData オブジェクト配列
171         */
172        public GUIData[] getAllData() {
173                if( pool.isEmpty() ) { loadDBResource(); }
174                return pool.toArray( new GUIData[pool.size()] );
175        }
176
177        /**
178         * GUIData オブジェクトのキャッシュをクリアします。
179         *
180         */
181        public void clear() {
182                pool.clear();
183        }
184}