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.Arrays;
019import java.util.HashMap;
020import java.util.concurrent.ConcurrentMap;                                                      // 6.4.3.3 (2016/03/04)
021import java.util.concurrent.ConcurrentHashMap;                                          // 6.4.3.1 (2016/02/12) refactoring
022import java.util.HashSet;
023import java.util.LinkedHashMap;
024import java.util.Map;
025import java.util.Set;
026import java.util.LinkedHashSet;                                                                         // 8.0.0.0 (2021/10/01)
027
028import java.util.stream.Stream;                                                                         // 6.4.1.1 (2016/01/16)
029import java.util.stream.Collectors;                                                                     // 6.4.1.1 (2016/01/16)
030
031import org.opengion.fukurou.util.ErrMsg;
032import org.opengion.fukurou.util.StringUtil;
033import org.opengion.fukurou.db.DBUtil;                                                          // 7.2.9.2 (2020/10/30)
034import org.opengion.fukurou.db.ApplicationInfo;                                         // 7.2.9.2 (2020/10/30)
035import org.opengion.hayabusa.common.HybsSystem;                                         // 7.2.9.2 (2020/10/30)
036import org.opengion.hayabusa.common.HybsSystemException;                        // 6.4.3.3 (2016/03/04)
037import org.opengion.hayabusa.db.DBColumn;
038import org.opengion.hayabusa.db.DBColumnConfig;
039import static org.opengion.fukurou.system.HybsConst.BUFFER_LARGE;       // 6.1.0.0 (2014/12/26) refactoring
040
041/**
042 * java.util.ResourceBundle クラスを複数管理するリソースクラスです。
043 *
044 * ResourceManager は、
045 *      LabelResource.properties   ラベルリソース(テーブル定義やカラム名などの画面に表示するリソース)
046 *      CodeResource.properties    コードリソース(選択データなどプルダウンメニューで選択するリソース)
047 *      MessageResource.properties メッセージリソース(エラーコードやメッセージなどを表示するリソース)
048 *
049 * の3つのプロパティーファイルを内部に持っており,それぞれのメソッドにより,
050 * リソースの返す値を決めています。
051 *
052 * ResourceManagerは,単独でも生成できますが,各ユーザー毎に作成するよりも
053 * ResourceFactory#newInstance( lang )メソッドより生成した方が,プーリングされるので
054 * 効率的です。
055 *
056 * リソース作成時に指定するロケールは,ISO 言語コード(ISO-639 で定義される 2 桁の小文字)
057 * <a href ="http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt">
058 * http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt</a>を使用して下さい。
059 * ただし,内部的に Locale を構築していますが,その正しさは,チェックされていませんので,
060 * 指定するロケールに応じた properties ファイルを用意しておいて下さい。
061 *
062 * 日本語の場合は, 言語コードは "jp" なので,
063 *      LabelResource_jp.properties   ラベルリソース(日本語)
064 *      CodeResource_jp.properties    コードリソース(日本語)
065 *      MessageResource_jp.properties メッセージリソース(日本語)
066 *
067 * を用意して下さい。
068 *
069 * CodeResource については、リソースファイルから CodeSelectionオブジェクトを
070 * 作成して利用します。この、CodeSelectionオブジェクトの作成方法として、
071 * 3通り考えられます。
072 * 1つ目は、毎回 要求が発生する毎に CodeSelection を作成し、プールしていきます。こうすることで、
073 * 初めて使用されたときだけオブジェクト化されますので、メモリの節約が可能です。ただし、
074 * プールにヒットしなかった場合は、やはりリソースから検索しますので、元々ヒットしない
075 * キーに対しては、毎回リソースを検索するため、非効率です。
076 * 2つめは、元々ヒットしないキーに対して、NullCodeSelectionオブジェクトを登録しておくことで、
077 * プールにため込んで行くと言う方法です。この場合は、シングルトーンにしてメモリを節約しますが、
078 * それでもプール自体の容量は、確保しておく必要があります。
079 * 3つめは、この ResourceManager がインスタンス化されるときに、すべての CodeSelectionオブジェクトを
080 * あらかじめ プールしておく方法です。使わない CodeSelection もインスタンス化する変わりに、
081 * キャッシュにヒットしない場合は、即 CodeSelection が存在しないと判断できるため、
082 * もっともパフォーマンスが高くなります。
083 * 本 ResourceManager の実装は、3つめの、あらかじめ、すべてをキャッシュしておく方法を
084 * 採用しています。
085 *
086 * @og.group リソース管理
087 *
088 * @version  4.0
089 * @author       Kazuhiko Hasegawa
090 * @since    JDK5.0,
091 */
092public final class ResourceManager {
093        // 7.2.9.2 (2020/10/30) ベースとなるSYSTEM_ID(RESOURCE_BASE_SYSTEM_ID)の取得
094        private static final String QUERY = "select PARAM from GE12"
095                                                                                + " where SYSTEM_ID=? and FGJ='1' and PARAM_ID='RESOURCE_BASE_SYSTEM_ID'";
096
097        // 7.2.9.2 (2020/10/30) リソースの接続先を、取得します。
098        private final String DBID = HybsSystem.sys( "RESOURCE_DBID" );
099
100        private final ColumnDataLoader  columnLoader ;
101        private final CodeDataLoader    codeLoader;
102        private final LabelDataLoader   labelLoader;
103        private final GUIDataLoader             guiLoader;
104
105        /** 6.4.3.1 (2016/02/12) PMD refactoring. HashMap → ConcurrentHashMap に置き換え。  */
106        private final ConcurrentMap<String,DBColumn> columnPool = new ConcurrentHashMap<>( BUFFER_LARGE );
107        private final String    lang ;
108
109        /**
110         * コンストラクター
111         * システムIDと言語コードを指定して,生成します。
112         *
113         * @og.rev 7.2.9.2 (2020/10/30) ベースとなるSYSTEM_ID(RESOURCE_BASE_SYSTEM_ID)の取得
114         * @og.rev 8.0.0.0 (2021/10/01) RESOURCE_BASE_SYSTEM_ID は、CSV形式で複数指定できる(先頭優先)。
115         *
116         * @param       systemId システムID
117         * @param       lang 言語コード
118         * @param       initLoad リソースデータの先読み可否(true:先読みする)
119         */
120        public ResourceManager( final String systemId,final String lang,final boolean initLoad ) {
121                this.lang = lang;
122
123                // 8.0.0.0 (2021/10/01)
124                final Set<String> sysSet = new LinkedHashSet<>();                       // 順序をキープし、重複を排除する。
125                sysSet.add( systemId );         // 通常システムIDは、一番最初
126
127                // 7.2.9.2 (2020/10/30)  ベースとなるSYSTEM_ID(RESOURCE_BASE_SYSTEM_ID)の取得
128                final String[] args = new String[] { systemId };
129                final String[][] vals = DBUtil.dbExecute( QUERY,args,(ApplicationInfo)null,DBID );
130//              final String baseSys = vals != null && vals.length > 0 && vals[0].length > 0 && vals[0][0].length() > 0 ?
131//                                                                      StringUtil.nval( vals[0][0] , "**" ) : "**" ;
132                if( vals != null && vals.length > 0 && vals[0].length > 0 && vals[0][0].length() > 0 ) {
133                        for( final String sysId : vals[0][0].split( "," ) ) {   // AA,BB,CC 形式を分割
134                                final String sys = sysId.trim();
135                                if( !sys.isEmpty() ) { sysSet.add( sys ); }                     // 空文字列は登録しない。
136                        }
137                }
138                sysSet.add( "**" );             // "**" は、一番最後に追加する。
139
140                final String[] sysAry = sysSet.toArray( new String[sysSet.size()] );
141
142//              columnLoader    = new ColumnDataLoader( systemId,baseSys,initLoad );
143//              labelLoader             = new LabelDataLoader(  systemId,baseSys,lang,initLoad );
144//              codeLoader              = new CodeDataLoader(   systemId,baseSys,initLoad,labelLoader );
145//              guiLoader               = new GUIDataLoader(    systemId,baseSys );
146
147                columnLoader    = new ColumnDataLoader( sysAry,initLoad );
148                labelLoader             = new LabelDataLoader(  sysAry,lang,initLoad );
149                codeLoader              = new CodeDataLoader(   sysAry,initLoad,labelLoader );
150                guiLoader               = new GUIDataLoader(    sysAry );
151        }
152
153        /**
154         * 設定されている言語を返します。
155         *
156         * @return      言語
157         */
158        public String getLang() {
159                return lang;
160        }
161
162        /**
163         * DBColumn オブジェクトを取得します。
164         * 作成したDBColumnオブジェクトは,内部にプールしておき,同じオブジェクト要求が
165         * あったときは,プールのオブジェクトを利用して,DBColumnを返します。
166         *
167         * @og.rev 3.4.0.0 (2003/09/01) ラベルカラム、コードカラム、表示パラメータ、編集パラメータ、文字パラメータの追加。
168         * @og.rev 3.5.6.4 (2004/07/16) 追加パラメータ取り込み時に、"_" は、null 扱いとする。
169         * @og.rev 3.6.0.7 (2004/11/06) DBColumn の official属性追加
170         * @og.rev 6.4.3.3 (2016/03/04) ConcurrentHashMap の not null制限のチェック追加
171         *
172         * @param       key     カラムID(not null)
173         *
174         * @return      DBColumnオブジェクト
175         */
176        public DBColumn getDBColumn( final String key ) {
177                // 6.4.3.3 (2016/03/04) ConcurrentHashMap の not null制限のチェック追加
178                if( key == null ) {
179                        final String errMsg = "カラムIDに、NULL は指定できません。";
180                        throw new HybsSystemException( errMsg );
181                }
182
183                DBColumn clm = columnPool.get( key );
184                if( clm == null ) {
185                        final ColumnData clmDt = columnLoader.getColumnData( key );
186                        if( clmDt != null ) {
187                                final String label_clm = clmDt.getLabelColumn();
188                                final String code_clm  = clmDt.getCodeColumn();
189
190                                clm = new DBColumn(
191                                                        lang,
192                                                        clmDt,
193                                                        labelLoader.getLabelData( label_clm ),
194                                                        codeLoader.getCodeData( code_clm ) );
195
196                                columnPool.put( key,clm );
197                        }
198                }
199                return clm;
200        }
201
202        /**
203         * DBColumn オブジェクトを作成します。
204         * 内部にプールに存在すればそれを、なければ新規に作成します。
205         * それでも存在しない場合は、DBColumnConfig より、ラベルと言語を指定して
206         * 新規に作成します。
207         *
208         * @param       key             カラムID(not null)
209         *
210         * @og.rev 7.1.0.0 (2020/01/27) LabelDataを直接呼び出します。
211         *
212         * @return      DBColumnオブジェクト
213         * @see         #getDBColumn( String )
214         */
215        public DBColumn makeDBColumn( final String key ) {
216                DBColumn dbColumn = getDBColumn( key );
217                if( dbColumn == null ) {
218                        final DBColumnConfig config = new DBColumnConfig( key );
219                        config.setLabelData( labelLoader.getLabelData( key ) );         // 7.1.0.0 (2020/01/27)
220                        config.setLang( lang );
221                        dbColumn = new DBColumn( config );
222                }
223                return dbColumn;
224        }
225
226        /**
227         * DBColumn オブジェクトを作成します。
228         * 内部にプールに存在すればそれを、なければ新規に作成します。
229         * それでも存在しない場合は、DBColumnConfig より、ラベルと言語を指定して
230         * 新規に作成します。
231         * lbl引数が、nullか、ゼロ文字列の場合は、#makeDBColumn(String) と同じです。
232         *
233         * @og.rev 6.9.1.0 (2018/02/26) unionLbls追加
234         * @og.rev 7.1.0.0 (2020/01/27) LabelDataを直接呼び出します。
235         *
236         * @param       key     カラムID(not null)
237         * @param       lbl     ラベル(nullか、ゼロ文字列の場合は、設定しません)
238         *
239         * @return      DBColumnオブジェクト
240         * @see         #getDBColumn( String )
241         */
242        public DBColumn makeDBColumn( final String key , final String lbl ) {
243                if( lbl == null || lbl.isEmpty() ) { return makeDBColumn( key ); }
244
245                final DBColumn dbColumn = getDBColumn( key );
246                final DBColumnConfig config ;
247
248                if( dbColumn == null ) {
249                        config = new DBColumnConfig( key );
250                        config.setLang( lang );
251                }
252                else {
253                        config = dbColumn.getConfig();
254                }
255
256                config.setLabelData( labelLoader.getLabelData( lbl ) );         // 7.1.0.0 (2020/01/27)
257
258                return new DBColumn( config );
259        }
260
261        /**
262         * メッセージリソースから,キーで指定されたメッセージに,
263         * 引数で指定された変数値をセットしたメッセージを返します。
264         *
265         * このメッセージは,リソースで選ばれたロケール毎のメッセージに,
266         * MessageFormat#format でフォーマットする事により,作成されます。
267         * メッセージがリソースに存在しない場合は,キーを返します。
268         *
269         * @og.rev 4.0.0.0 (2005/01/31) オラクルとWindowsとの間の "~"の文字化け対策
270         * @og.rev 4.0.0.0 (2007/10/17) メッセージリソース統合に伴いラベルローダーを使用する
271         * @og.rev 4.0.0.0 (2007/10/18) 名称変更 getMessage ⇒ getLabel
272         * @og.rev 5.1.1.0 (2009/12/01) #XXXXの変換で、カラム名が複数指定されている場合の対応
273         * @og.rev 6.1.0.0 (2014/12/26) LabelData が存在しなかった場合の処理
274         * @og.rev 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
275         * @og.rev 6.6.0.0 (2016/12/01) 引数の配列を可変長配列に変更します。
276         * @og.rev 7.0.7.0 (2019/12/13) #getLabel( String ) と統合します。
277         *
278         * @param       key キー
279         * @param       args メッセージの配列
280         *
281         * @return      メッセージ(無ければ キー)
282         */
283        public String getLabel( final String key,final String... args ) {                       // 6.6.0.0 (2016/12/01)
284                final LabelData lblData = labelLoader.getLabelData( key );
285
286                final String msglbl ;
287
288                if( args == null || args.length == 0 ){
289                        msglbl = lblData.getLabel();
290                }
291                else {
292                        // 6.1.0.0 (2014/12/26) メソッド化
293                        final String[] msgArgs = makeLabelArray( args );        // 6.1.0.0 (2014/12/26) メソッド化
294
295                        // 6.1.0.0 (2014/12/26) LabelData が存在しなかった場合の処理
296                        // 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
297                        msglbl = lblData.getMessage( msgArgs );
298                }
299
300                return msglbl == null ? key : msglbl ;          // なければ key を返す
301        }
302
303        /**
304         * ラベルリソースから,ラベルを返します。
305         * ただし、キーに、「スペース+%+記号」を判定、処理する機能を用意します。
306         *
307         * 記号は、Label,Short,Tips,Description,RawShortLabel,CodeData の頭文字一つ目です。
308         * ('L','S','T','D','R','C') となります。
309         * 'L' は通常のラベルと同じ。'C' は、'S'(Short)と同じになります。
310         *
311         * 「スペース+%+記号」が無ければ、通常のラベルと同じ処理を行います。
312         * つまり、このメソッドは、getLabel(String) より、ほんの少し処理時間を稼ぐために用意しました。
313         * なので、一応、内部からしか呼ばない事とし、private にしておきます。
314         *
315         * @og.rev 6.3.8.4 (2015/10/09) XXXX %S などの対応。getLabel(String) は汎用過ぎるので、少し分ける。
316         * @og.rev 6.3.9.0 (2015/11/06) switch 文の2つの case のために同じコードを使用している(findbugs)
317         * @og.rev 7.2.9.0 (2020/10/12) getRawShortLabelで、null時は key を返します。
318         * @og.rev 7.2.9.4 (2020/11/20) spotbugs:switch 文の2つの case のために同じコードを使用しているメソッド
319         *
320         * @param       key ラベルキー
321         *
322         * @return      リソースに応じたラベル文字列(無ければ ラベルキー)
323         */
324        private String getExtLabel( final String key ) {
325                final String val ;
326
327                final int ad = key.indexOf( " %" );
328                if( ad < 0 ) {
329                        val = getLabel( key );
330                }
331                else if( ad+2 <= key.length() ) {               // " %" の後ろの文字が存在しない場合
332                        val = getLabel( key.substring( 0,ad ) );
333                }
334                else {
335                        final String tmpKey = key.substring( 0,ad );
336                        // 6.3.9.0 (2015/11/06) switch 文の2つの case のために同じコードを使用している(findbugs)
337                        switch( key.charAt( ad+2 ) ) {
338                                case 'S':
339                                case 'C': val = getShortLabel(    tmpKey );     break;                  // 6.3.9.0 (2015/11/06) findbugs対応
340                                case 'T': val = getLongLabel(     tmpKey );     break;
341                                case 'D': val = getDescription(   tmpKey );     break;
342                                case 'R': val = getRawShortLabel( tmpKey,true );        break;  // 7.2.9.0 (2020/10/12)
343                                default : val = getLabel(         tmpKey );     break;
344                        }
345                }
346                return val;
347        }
348
349        /**
350         * ラベルリソースの引数で、#XXXXの変換で、カラム名が複数指定されている場合の対応を行います。
351         *
352         * 一つの引数に、#CLM,LANG,KBSAKU 等の項目名が複数指定指定された場合に、
353         * それぞれを解析してラベルに戻します。
354         * 該当するラベルが存在しない場合は、そのままの値を返します。
355         * 返される文字列配列は、元の引数とは異なる新しい文字列配列で返されます。
356         *
357         * @og.rev 6.1.0.0 (2014/12/26) #XXXXの変換で、カラム名が複数指定されている場合の対応
358         * @og.rev 6.3.8.4 (2015/10/09) #XXXX %S などの対応。getLabel(String) は汎用過ぎるので、少し分ける。
359         * @og.rev 6.4.1.1 (2016/01/16) PMD refactoring. Java8 ラムダ式を使用して、大幅書き直し。
360         * @og.rev 7.0.4.2 (2019/06/17) # のみの場合は、特別に、# を返すように対応。
361         *
362         * @param       args メッセージの配列
363         *
364         * @return      ラベル置換後の新しい文字列配列
365         */
366        private String[] makeLabelArray( final String[] args ) {
367                final int size = args.length;
368                final String[] msgArgs = new String[size];
369
370                for( int i=0; i<size; i++ ) {
371                        final String arg = args[i] ;
372                        if( StringUtil.startsChar( arg , '#' ) && arg.length() > 1 ) {                                  // 7.0.4.2 (2019/06/17)
373                                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid instantiating new objects inside loops
374                                msgArgs[i] = Stream.of( StringUtil.csv2Array( arg.substring( 1 ) ) )
375                                                                .map( lbl -> getExtLabel( lbl ) )
376                                                                .collect( Collectors.joining( "," ) );
377                        }
378                        else {
379                                msgArgs[i] = arg ;
380                        }
381                }
382                return msgArgs ;
383        }
384
385        /**
386         * ラベルリソースから,ラベル(短)を返します。
387         * 引数の言語コードに応じたリソースが登録されていない場合は,
388         * 引数のラベルキーそのまま返します。
389         *
390         * @og.rev 4.3.3.0 (2008/10/01) 新規作成
391         * @og.rev 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
392         *
393         * @param       key ラベルキー
394         *
395         * @return      リソースに応じたラベル文字列(無ければ ラベルキー)
396         */
397        public String getShortLabel( final String key ) {
398                final LabelData lblData = labelLoader.getLabelData( key );
399                // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
400                // 反転注意
401                final String rtn = lblData.getShortLabel();
402
403                return rtn == null ? key : rtn ;                // なければ key を返す
404        }
405
406        /**
407         * ラベルリソースから,ラベル(長)を返します。
408         * 概要説明が存在する場合は、ツールチップに概要説明が
409         * 表示されます。
410         * 引数の言語コードに応じたリソースが登録されていない場合は,
411         * 引数のラベルキーそのまま返します。
412         *
413         * @og.rev 6.3.8.4 (2015/10/09) #XXXX %S などの対応。getLabel(String) は汎用過ぎるので、少し分ける。
414         * @og.rev 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
415         *
416         * @param       key ラベルキー
417         *
418         * @return      リソースに応じたラベル(長)文字列(無ければ ラベルキー)
419         */
420        public String getLongLabel( final String key ) {
421                final LabelData lblData = labelLoader.getLabelData( key );
422                // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
423                // 反転注意
424                final String rtn = lblData.getLongLabel();
425
426                return rtn == null ? key : rtn ;                // なければ key を返す
427        }
428
429        /**
430         * ラベルリソースから,ラベル(長)ををそのままの形で返します。
431         * (discription等を付けない)
432         * 表示されます。
433         * 引数の言語コードに応じたリソースが登録されていない場合は,
434         * 引数のラベルキーそのまま返します。
435         *
436         * @og.rev 7.2.9.0 (2020/10/12) 新規追加
437         *
438         * @param       key ラベルキー
439         *
440         * @return      リソースに応じたラベル(長)そのままの文字列(無ければ ラベルキー)
441         * @og.rtnNotNull
442         */
443        public String getRawLongLabel( final String key ) {
444                final LabelData lblData = labelLoader.getLabelData( key );
445
446                return lblData.getRawLongLabel();
447        }
448
449        /**
450         * ラベルオブジェクトの名称(短)をspanタグを付けない状態で返します。
451         * SNAMEが未設定の場合は、LNAME が返されます。
452         * 引数の言語コードに応じたリソースが登録されていない場合は,
453         * 引数のラベルキーそのまま返します。
454         *
455         * @og.rev 6.3.8.4 (2015/10/09) #XXXX %S などの対応。getLabel(String) は汎用過ぎるので、少し分ける。
456         * @og.rev 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
457         * @og.rev 7.0.7.0 (2019/12/13) args パラメータ配列(可変長引数)を追加します。
458         * @og.rev 7.2.9.0 (2020/10/12) args パラメータ配列(可変長引数)廃止(旧メソッド復活)
459         *
460         * @param       key ラベルキー
461         * @param       useKey null時にキーを返す場合は、true , 空文字を返す場合は、false
462         *
463         * @return      リソースに応じたラベル(短)文字列(無ければ ラベルキー)
464         */
465        public String getRawShortLabel( final String key , final boolean useKey ) {
466                final LabelData lblData = labelLoader.getLabelData( key );
467
468                return lblData.getRawShortLabel( useKey ? key : "" );
469        }
470
471        /**
472         * ラベルリソースから,概要説明を返します。
473         * {0},{1}...の置換えを行います。
474         * キーのデータが存在しない場合はnullを返します。
475         * ただし、パラメータのデータがあれば、それを返します。
476         *
477         * @og.rev 4.3.7.6 (2009/07/15) 新規作成
478         * @og.rev 6.1.0.0 (2014/12/26) #XXXXの変換で、カラム名が複数指定されている場合の対応
479         * @og.rev 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
480         * @og.rev 7.0.7.0 (2019/12/13) #getDescription( String ) と統合します。
481         *
482         * @param       key ラベルキー
483         * @param       args パラメータ配列(可変長引数)
484         *
485         * @return      リソースに応じた概要説明(無ければ null)
486         */
487        public String getDescription( final String key,final String... args ) {                 // 6.6.0.0 (2016/12/01)
488                final LabelData lblData = labelLoader.getLabelData( key );
489
490                final String msgdesc ;
491                if( args == null || args.length == 0 ){
492                        msgdesc = lblData.getDescription();
493                }
494                else {
495                        // 6.1.0.0 (2014/12/26) getLabel( String ,String[] ) と同様に複数ラベル対応
496                        final String[] msgArgs = makeLabelArray( args );
497
498                        // 6.1.0.0 (2014/12/26) LabelData が存在しなかった場合の処理
499                        msgdesc = lblData.getDescription( msgArgs );
500                }
501
502                return msgdesc == null ? key : msgdesc ;                // なければ key を返す
503        }
504
505        /**
506         * メッセージリソースから,ErrMsgオブジェクトで指定されたメッセージを返します。
507         *
508         * このエラーメッセージは,リソースで選ばれたロケール毎のメッセージに,
509         * MessageFormat#format でフォーマットする事により,作成されます。
510         * エラーメッセージがリソースに存在しない場合は,エラーコードを返します。
511         *
512         * @og.rev 4.0.0.0 (2004/12/31) 新規追加
513         * @og.rev 4.0.0.0 (2007/10/18) メッセージリソースとの統合化
514         *
515         * @param       errMsgObj ErrMsgオブジェクト
516         *
517         * @return      エラーメッセージ(無ければ ErrMsgオブジェクトの toString() )
518         */
519        public String getLabel( final ErrMsg errMsgObj ) {
520                return getLabel( errMsgObj.getId(),errMsgObj.getArgs() );
521        }
522
523        /**
524         * メッセージリソースから,ErrMsgオブジェクトで指定されたショートメッセージを返します。
525         *
526         * このエラーメッセージは,リソースで選ばれたロケール毎のメッセージに,
527         * MessageFormat#format でフォーマットする事により,作成されます。
528         * エラーメッセージがリソースに存在しない場合は,エラーコードを返します。
529         *
530         * @og.rev 7.0.7.0 (2019/12/13) 新規追加
531         * @og.rev 7.2.9.0 (2020/10/12) 引数を分解して、直接処理します。…ついでにメソッド名変更
532         *
533         * @param       errMsgObj ErrMsgオブジェクト
534         *
535         * @return      エラーメッセージ(無ければ ErrMsgオブジェクトの toString() )
536         */
537        public String getShortErrorMsg( final ErrMsg errMsgObj ) {
538                final String   key  = errMsgObj.getId();
539                final String[] args = errMsgObj.getArgs();
540
541                final LabelData lblData = labelLoader.getLabelData( key );
542
543                final String msglbl ;
544                if( args == null || args.length == 0 ){
545                        msglbl = lblData.getRawShortLabel();
546                }
547                else {
548                        // 6.1.0.0 (2014/12/26) メソッド化
549                        final String[] msgArgs = makeLabelArray( args );        // 6.1.0.0 (2014/12/26) メソッド化
550
551                        // 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
552                        msglbl = lblData.getShortMessage( msgArgs );
553                }
554
555                return msglbl == null ? key : msglbl ;          // なければ key を返す
556        }
557
558        /**
559         * ErrMsgオブジェクトの内容を元に、ラベルリソースから,概要説明を返します。
560         * キーのデータが存在しない場合はnullを返します。
561         *
562         * @og.rev 4.3.7.6 (2009/07/15) 新規作成
563         *
564         * @param       errMsgObj ErrMsgオブジェクト
565         *
566         * @return      エラーメッセージ(キーが無ければnull)
567         */
568        public String getDescription( final ErrMsg errMsgObj ) {
569                return getDescription( errMsgObj.getId(),errMsgObj.getArgs() );
570        }
571
572        /**
573         * ラベルキーに対応する、LabelDataオブジェクトを返します。
574         *
575         * @og.rev 4.0.0.0 (2005/01/31) 新規作成
576         * @og.rev 6.3.9.0 (2015/11/06) labelLoader.getLabelDataは、nullを返しません。
577         *
578         * @param       key ラベルキー
579         *
580         * @return      LabelDataオブジェクト
581         * @og.rtnNotNull
582         */
583        public LabelData getLabelData( final String key ) {
584                return labelLoader.getLabelData( key );
585        }
586
587        /**
588         * コードキーに対応する、CodeDataオブジェクトを返します。
589         *
590         * @param       key コードキー
591         *
592         * @return      CodeDataオブジェクト(無ければ null)
593         */
594        public CodeData getCodeData( final String key ) {
595                return codeLoader.getCodeData( key );
596        }
597
598        /**
599         * コードリソースから,コード文字列を返します。
600         * 引数にQUERYを渡すことで、DBから、動的にコードリソースを作成できます。
601         *
602         * @og.rev 5.4.2.2 (2011/12/14) 新規追加。
603         *
604         * @param       key コードキー
605         * @param       query 検索SQL(引数に、? を一つ持つ)
606         *
607         * @return      コードデータオブジェクト(無ければ null)
608         */
609        public CodeData getCodeData( final String key,final String query ) {
610                return codeLoader.getCodeData( key,query );
611        }
612
613        /**
614         * ログインユーザーで使用する画面オブジェクトを、UserInfoにセットします。
615         * 各、UserInfo は、自分自身が使用する 画面オブジェクトのみを管理することで、
616         * 画面アクセス有無を、すばやく検索することが可能になります。
617         *
618         * @og.rev 3.1.0.1 (2003/03/26) GUIInfo のキー順サポートの為に、引数追加。
619         * @og.rev 4.0.0.0 (2005/01/31) 使用画面のMap を UserInfo にセットします。
620         * @og.rev 4.3.0.0 (2008/07/04) ロールモードマルチ対応
621         * @og.rev 5.2.0.0 (2010/09/01) アクセス禁止アドレスによる不正アクセス防止機能追加
622         * @og.rev 6.4.3.4 (2016/03/11) forループを、removeAll メソッドに置き換えます。
623         * @og.rev 6.4.4.2 (2016/04/01) guiMap.values() では、GUIInfo だが、remove するのは、gui.getAddress() の値。
624         * @og.rev 7.1.0.0 (2020/01/27) LabelDataを直接呼び出します。
625         *
626         * @param       user    指定のユーザーロールに対応する画面だけをMapにセットする。
627         */
628        public void makeGUIInfos( final UserInfo user ) {
629                final GUIData[] guiDatas = guiLoader.getAllData();
630
631                // guikey に対してユニークになるように Map に追加します。後登録が優先されます。
632                final Map<String,GUIInfo> guiMap = new HashMap<>();
633                final Set<String> forbidAddrSet  = new HashSet<>();
634                int size = guiDatas.length;
635                for( int i=0; i<size; i++ ) {
636                        final GUIData gui = guiDatas[i];
637                        final byte bitMode = user.getAccessBitMode( gui.getRoleMode() );
638                        if(  bitMode > 0 ) {
639                                final String      guikey        = gui.getGuiKey();
640                                final LabelData labelData       = labelLoader.getLabelData( gui.getLabelClm() );        // 7.1.0.0 (2020/01/27)
641                                guiMap.put( guikey,new GUIInfo( gui,labelData,bitMode ) );
642                        }
643                        // 5.2.0.0 (2010/09/01) アクセス禁止アドレスによる不正アクセス防止機能追加
644                        else {
645                                final String addr = gui.getAddress();
646                                if( addr.indexOf( '/' ) < 0 ) {
647                                        forbidAddrSet.add( addr );
648                                }
649                        }
650                }
651
652                // もし、禁止リストの中に画面ID違いで許可リストと同じアドレスが
653                // 含まれている場合は、禁止リスト中から該当のアドレスを削除する。
654                // 6.4.3.4 (2016/03/11) forループを、removeAll メソッドに置き換えます。
655                // 6.4.4.2 (2016/04/01) guiMap.values() では、GUIInfo だが、remove するのは、gui.getAddress() の値。
656                guiMap.forEach( (id,gui) -> forbidAddrSet.remove( gui.getAddress() ) );
657
658                // GUIInfo をその順番(SEQNO順)でソートし直します。SYSTEM_ID や、KBSAKU の影響を排除します。
659                final GUIInfo[] guiInfos = guiMap.values().toArray( new GUIInfo[ guiMap.size() ] ) ;
660                Arrays.sort( guiInfos );
661                final Map<String,GUIInfo> sortMap = new LinkedHashMap<>();
662                size = guiInfos.length;
663                for( int i=0; i<size; i++ ) {
664                        final GUIInfo guiInfo = guiInfos[i];
665                        final String guikey     = guiInfo.getKey();
666                        sortMap.put( guikey,guiInfo );
667                }
668
669                user.setGUIMap( sortMap, forbidAddrSet );
670        }
671
672        /**
673         * 指定されたクエリを発行し、ラベルマップを作成します。
674         *
675         * @og.rev 4.3.4.0 (2008/12/01) 新規作成
676         * @og.rev 6.4.0.5 (2016/01/09) useLabelMap="true" 時のSQL文の実行は、dbid を使用して行う。
677         *
678         * @param       query   ラベルマップを作成するクエリ
679         * @param       dbid    接続先ID
680         *
681         * @return      ラベルマップ
682         * @see org.opengion.hayabusa.resource.LabelDataLoader#getLabelMap( String,String )
683         */
684        public Map<String, LabelData> getLabelMap( final String query , final String dbid ) {
685                return labelLoader.getLabelMap( query , dbid );
686        }
687
688        /**
689         * リソースマネージャーをキーに基づいて部分クリアします。
690         * ここでは、部分クリアなため、GUIData に関しては、処理されません。
691         * また、存在しないキーを指定されたリソースは、何も処理されません。
692         *
693         * @og.rev 5.4.3.4 (2012/01/12) labelPool の削除追加
694         * @og.rev 6.4.3.3 (2016/03/04) ConcurrentHashMap の not null制限のチェック追加
695         * @og.rev 6.9.0.1 (2018/02/05) どのシステムIDのリソースがクリアされたかを表示します。
696         *
697         * @param   key         カラムのキー
698         */
699        public void clear( final String key ) {
700                // 6.4.3.3 (2016/03/04) ConcurrentHashMap の not null制限
701                if( key != null ) {
702                        columnLoader.clear( key );
703                        codeLoader.clear( key );
704                        labelLoader.clear( key );
705                        columnPool.remove( key );
706                }
707        }
708
709        /**
710         * GUI情報をクリアします。
711         * ここでは、関連するラベル、コードリソースの部分クリアも行います。
712         * GUI情報は、シーケンスに管理しているため、この処理1回ごとに、
713         * GUIData を全件再読み込みを行いますので、ご注意ください。
714         *
715         */
716        public void guiClear() {
717                final GUIData[] gui = guiLoader.getAllData();
718
719                for( int i=0; i<gui.length; i++ ) {
720                        final String key = gui[i].getGuiKey();
721                        labelLoader.clear( key );
722                }
723                codeLoader.clear( "CLASSIFY" );
724                guiLoader.clear();
725        }
726
727        /**
728         * リソースマネージャーをクリア(初期化)します。
729         *
730         * @og.rev 5.4.3.4 (2012/01/12) labelPool の削除追加
731         *
732         */
733        public void clear() {
734                columnLoader.clear();
735                codeLoader.clear();
736                labelLoader.clear();
737                guiLoader.clear();
738                columnPool.clear();
739        }
740}