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 }