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 }