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     */
016    package org.opengion.hayabusa.resource;
017    
018    import org.opengion.hayabusa.common.HybsSystem;
019    import org.opengion.hayabusa.common.HybsSystemException;
020    import org.opengion.fukurou.util.ApplicationInfo;
021    import org.opengion.fukurou.db.DBUtil;
022    
023    import java.util.HashMap;
024    import java.util.Map;
025    import java.util.WeakHashMap;
026    import java.util.Collections ;
027    
028    /**
029     * systemId と lang に対応したラベル??タを作?する??タロードクラスです?
030     *
031     * ラベル??タは??目(CLM)に対して、各種ラベル??を持って?す?
032     * ラベル??タは、名?ORG)と名前(短)と名前(長)を持って?す?従来のラベルは、表示名称と
033     * して、?類しか持って?せんでした?
034     * 名前(ORG)は、従来の表示名称にあたります?これは、??ラベルとして
035     * 使用されます?名前(短)は、テーブル?のヘッ??の様に、特殊なケースで?
036     * 簡略化された名称を使用するときに利用されます?こ??替え?、?動で判断されます?
037     * 名前(短)に、なにも設定されて???合?、名?長)が?動的に使用されます?で
038     * 初期??タ移行時には、そのまま??常時も??ブルヘッ??時も同じ???
039     * 使用されます?
040     * 名前(短)と名前(長)は、コメント情報が存在する場合?、Tips表示を行います?
041     *
042     * ラベル??タを作?する場合?、同?ベルで、作?区?KBSAKU)違いの場合??
043     * ?大きな作?区?持つコードを使用します?
044     * 作?区?KBSAKU)='0' の??タは、?スタリソースとして、エンジンとともに
045     * 配?れるリソースになります?
046     *
047     * 読込フラグ(FGLOAD)='1'のラベルリソースは、このLabelDataLoaderオブジェクトが
048     * 構築された時に、すべてキャ?ュとして?メモリに読み取ります?
049     * 読込フラグが?'1' 以外???タは、?期起動時には、メモリにキャ?ュされ?
050     * 実際に使用されるまで、オブジェクトが作?されません?
051     * これは、使用されるかど?判らな?ベル??タを?予め作?しな?とで、メモリの
052     * ??図って?す?
053     * ただし?リソースのキャ?ュに、WeakHashMap クラスを使用して?ため?
054     * メモリオーバ?時には、クリアされるため?単独での読み取りも行います?
055     *
056     * SYSTEM_ID='**' は、?通リソースです?
057     * これは、シス?間で共通に使用されるリソース??を登録しておきます?
058     *
059     * @og.rev 4.0.0.0 (2004/12/31) 新規作?
060     * @og.group リソース管?
061     *
062     * @version  4.0
063     * @author   Kazuhiko Hasegawa
064     * @since    JDK5.0,
065     */
066    final class LabelDataLoader {
067            // リソースの接続?を?取得します?
068            private final String DBID = HybsSystem.sys( "RESOURCE_DBID" );
069    
070            // ??リソースの初期?読み込みのクエリー
071    //      private static final String QUERY = "select CLM,SNAME,LNAME,DESCRIPTION"
072    //                                                                      + " from GEA08 where SYSTEM_ID in ( ?,'**')"
073    //                                                                      + " and LANG=? and FGJ='1' and FGLOAD='1'"
074    //                                                                      + " order by SYSTEM_ID,CLM,KBSAKU" ;
075            // 4.3.5.7 (2009/03/22) FGLOADの影響で個別シス?のリソースが読まれな?題?対?
076            private static final String QUERY = "select CLM,SNAME,LNAME,DESCRIPTION"
077                                                                            + " ,FGLOAD"
078                                                                            + " from GEA08 where SYSTEM_ID in ( ?,'**')"
079                                                                            + " and LANG=? and FGJ='1'"
080                                                                            + " order by SYSTEM_ID,CLM,KBSAKU" ;
081    
082            // ??リソースの個別読み込み時?クエリー
083            private static final String QUERY2 = "select CLM,SNAME,LNAME,DESCRIPTION"
084                                                                            + " from GEA08 where SYSTEM_ID in ( ?,'**')"
085                                                                            + " and LANG=? and CLM=? and FGJ='1'"
086                                                                            + " order by SYSTEM_ID,KBSAKU" ;
087    
088            private final Map<String,LabelData> pool = Collections.synchronizedMap( new WeakHashMap<String,LabelData>() );      // キャ?ュ用プ?ル
089            private final String  SYSTEM_ID ;               // シス?ID
090            private final String  LANG ;                    // ??
091    
092            /** コネクションにアプリケーション??を追記するかど???*/
093            public static final boolean USE_DB_APPLICATION_INFO  = HybsSystem.sysBool( "USE_DB_APPLICATION_INFO" ) ;
094    
095            // 3.8.7.0 (2006/12/15) アクセスログ取得?為,ApplicationInfoオブジェクトを設?
096            private final ApplicationInfo appInfo;
097    
098            /**
099             *  SystemId と lang 毎に ファクトリオブジェクトを作?します?
100             *
101             * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得?為,ApplicationInfoオブジェクトを設?
102             *
103             * @param systemId シス?ID
104             * @param lang  ??
105             * @param initLoad リソース??タの先読み可否(true:先読みする)
106             */
107            LabelDataLoader( final String systemId,final String lang,final boolean initLoad ) {
108                    SYSTEM_ID = systemId;
109                    LANG      = lang;
110    
111                    // 3.8.7.0 (2006/12/15) アクセスログ取得?為,ApplicationInfoオブジェクトを設?
112                    if( USE_DB_APPLICATION_INFO ) {
113                            appInfo = new ApplicationInfo();
114                            // ユーザーID,IPアドレス,ホスト名
115                            appInfo.setClientInfo( SYSTEM_ID,HybsSystem.HOST_ADRS,HybsSystem.HOST_NAME );
116                            // 画面ID,操?プログラ?D
117                            appInfo.setModuleInfo( "LabelDataLoader",null,null );
118                    }
119                    else {
120                            appInfo = null;
121                    }
122    
123                    // ApplicationInfo の設定が終わってから実行します?
124                    if( initLoad ) { loadDBResource(); }
125            }
126    
127            /**
128             * ??リソースより ラベル??タを取得?設定します?
129             * 取得データは、CLM,SNAME,LNAME,DESCRIPTION です?
130             *
131             * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得?為,ApplicationInfoオブジェクトを設?
132             * @og.rev 4.3.5.7 (2009/03/22)  FGLOADの影響でシス?個別リソースが読まれな?題対?
133             */
134            private void loadDBResource() {
135                    String[] args = new String[] { SYSTEM_ID,LANG };
136    
137                    String[][] vals = DBUtil.dbExecute( QUERY,args,appInfo,DBID );
138    
139                    int len = vals.length;
140                    for( int i=0; i<len; i++ ) {
141                            if( "1".equals( vals[i][LabelData.FG_LOAD] ) ){ // 4.3.5.7 (2009/03/22)
142                                    pool.put( vals[i][0],new LabelData( vals[i] ) );
143                            }
144                            // より上?作?区?、FGLOAD='0'(個別読込)が来た?合?、下位?FGLOAD='1'(?読込)を??
145                            else if( pool.get( vals[i][0]) != null ){
146                                    pool.remove( vals[i][0] );
147                            }
148                    }
149    
150                    System.out.println( "  LabelDataLoader [" + len + "] loaded" );
151            }
152    
153            /**
154             * LabelData オブジェクトを取得します?
155             * 作?したLabelDataオブジェクト???部にプ?ルしておき?同じリソース要求が
156             * あったとき???ールの LabelDataを返します?
157             * リソースDBに存在しな??合?、NULLラベルを作?します?こ?オブジェクトも
158             * キャ?ュします?
159             *
160             * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得?為,ApplicationInfoオブジェクトを設?
161             *
162             * @param   key        ラベルのキー
163             *
164             * @return  LabelData  オブジェク?
165             */
166            public LabelData getLabelData( final String key ) {
167                    LabelData label = pool.get( key ) ;
168    
169                    if( label == null ) {
170                            String[] args = new String[] { SYSTEM_ID,LANG,key };
171                            String[][] vals = DBUtil.dbExecute( QUERY2,args,appInfo,DBID );
172    
173                            if( vals.length > 0 ) {
174                                    label = new LabelData( vals[vals.length-1] );           // ????タ
175                            }
176                            else {
177                                    label = new LabelData( key );           // null ラベル
178                            }
179                            pool.put( key,label );
180                    }
181    
182                    return label ;
183            }
184    
185            /**
186             * ?されたクエリを発行し、ラベルマップを作?します?
187             *
188             * ここで作?されたラベル??は、?部?キャ?ュされません?
189             * ?面で??ラベル??を追?たい場合に使用します?
190             *
191             * 発行するクエリでは、第1カラ?ラベルキーを?第2カラ?ラベル名称を設定します?
192             * 第3カラ?存在する場合?、名称(短)として使用されます?(??ではありません)
193             * クエリが指定されて??は、検索したカラ??以下?場合?エラーを返します?
194             *
195             * @og.rev 4.3.4.0 (2008/12/01) 新規作?
196             *
197             * @param       query           ラベルマップを作?するクエリ
198             *
199             * @return  labelMap    ラベルマッ?
200             */
201            public Map<String, LabelData> getLabelMap( final String query ) {
202                    if( query == null || query.length() == 0 ) {
203                            String errMsg = "ラベルを取得するクエリが指定されて?せん?;
204                            throw new HybsSystemException( errMsg );
205                    }
206    
207                    String[][] rtn = DBUtil.dbExecute( query, new String[0], appInfo );
208                    if( rtn == null || rtn.length == 0 ) { // ??タが存在しな??合?そ?まま終?ます?
209                            return null;
210                    }
211    
212                    int confSize = rtn[0].length;
213                    if( confSize < 2 ) {
214                            String errMsg = "ラベルキー、ラベル名称の????です?"
215                                                    + " SQL=" + query ;                                     // 5.1.8.0 (2010/07/01) errMsg 修正
216                            throw new HybsSystemException( errMsg );
217                    }
218    
219                    Map<String, LabelData> labelMap = new HashMap<String, LabelData>();
220                    for ( int i = 0; i < rtn.length; i++ ) {
221                            String[] ldconf = new String[5];
222                            ldconf[0] = rtn[i][0];
223                            ldconf[1] = ( confSize == 2 ? rtn[i][1] : rtn[i][2] ); // SNAME
224                            ldconf[2] = rtn[i][1]; // LNAME
225                            ldconf[3] = "";
226                            ldconf[4] = "";
227    
228                            labelMap.put( rtn[i][0], new LabelData( ldconf ) );
229                    }
230                    return labelMap;
231            }
232    
233            /**
234             * LabelData オブジェクト?キャ?ュを?別にクリアします?
235             * リソース??タの更新など、???更新時に、すべてのキャ?ュ?
236             * 破?る?ではなく?????み破?きる機?です?
237             *
238             * @param   key        ラベルのキー
239             */
240            public void clear( final String key ) {
241                    pool.remove( key );
242            }
243    
244            /**
245             * LabelData オブジェクト?キャ?ュをクリアします?
246             *
247             */
248            public void clear() {
249                    pool.clear();
250            }
251    }