    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 org.opengion.hayabusa.common.HybsSystemException;
    019import org.opengion.fukurou.util.StringUtil;
    020import org.opengion.fukurou.util.HybsEntry;
    021import static org.opengion.fukurou.system.HybsConst.CR ;                                // 6.1.0.0 (2014/12/26)
    022import static org.opengion.fukurou.system.HybsConst.BUFFER_MIDDLE;              // 6.1.0.0 (2014/12/26) refactoring
    023
    024import java.util.List;
    025import java.util.ArrayList;
    026import java.util.Deque;                                                                                 // 6.8.4.2 (2017/12/25)
    027import java.util.concurrent.ConcurrentLinkedDeque;                              // 6.8.4.2 (2017/12/25)
    028import java.util.stream.Collectors;                                                             // 6.4.3.4 (2016/03/11)
    029
    030/**
    031 * 画面情報の取得の為のインターフェースです。
    032 *
    033 * {&#064;GUI.XXXX} で、XXXX 部に、GUIInfo オブジェクトで定義されている
    034 * 属性情報を取り出すことが出来ます。
    035 *
    036 * ・KEY           画面ID
    037 * ・ADDRESS       実行アドレス
    038 * ・REALADDRESS   実行実アドレス
    039 * ・SEQUENCE      表示順
    040 * ・GROUPS        メニュグループ
    041 * ・CLASSIFY      メニュ分類
    042 * ・LEVEL         メニュ階層番号
    043 * ・LABEL         画面名称
    044 * ・NAME          画面名称(=SNAME)
    045 * ・SNAME         画面名称(short)
    046 * ・LNAME         画面名称(long)
    047 * ・ROLES         ロールズ
    048 * ・MODE          アクセスモード列(mr,mw,-r,-w の羅列)
    049 * ・TARGET        ターゲット
    050 * ・PARAM         設定値(パラメータ)
    051 * ・KBLINK        リンク区分
    052 * ・DESCRIPTION   概要説明
    053 * ・IMAGEKEY      イメージキー
    054 * ・DYUPD         更新日時
    055 * ・ISREAD        読取り許可[true/false]
    056 * ・ISWRITE       書込み許可[true/false]
    057 *
    058 * @og.group リソース管理
    059 *
    060 * @version  4.0
    061 * @author   Kazuhiko Hasegawa
    062 * @since    JDK5.0,
    063 */
    064public final class GUIInfo implements Comparable<GUIInfo> {     // 4.3.3.6 (2008/11/15) Generics警告対応
    065
    066        private static final String YOYAKU = "|KEY|ADDRESS|REALADDRESS|SEQUENCE"
    067                                                                                + "|GROUPS|CLASSIFY|LEVEL|LABEL|NAME"
    068                                                                                + "|SNAME|LNAME|ROLES|MODE|TARGET"
    069                                                                                + "|PARAM|KBLINK|DESCRIPTION|DYUPD|IMAGEKEY|" ;         // 5.5.2.5 (2012/05/21) イメージアイコン
    070
    071        private final GUIData   guiData         ;
    072        private final LabelData labelData       ;
    073        private final String[]  groupKeys       ;
    074
    075        private final boolean   menuFlag        ;               // メニューへの表示可否属性
    076        private final boolean   writeFlag       ;               // 書き込み許可属性
    077        private final byte              bitMode         ;               // ビットモード(UserInfo 加味済み)
    078        private final boolean   pulldownFlag;           // 4.3.3.0 (2008/10/01) 強制プルダウン化属性
    079
    080        private final GUIAccessCount accessCount ;      // この画面へのアクセス統計を管理します。
    081
    082        private int   level     ;
    083
    084        // 6.8.4.2 (2017/12/25) nextGui を、後入れ先出しに変更します。
    085        private final Deque<String> nextGui = new ConcurrentLinkedDeque<>();    // 6.8.4.2 (2017/12/25) nextGui を、後入れ先出しに変更します。
    086
    087        /**
    088         * コンストラクター
    089         *
    090         * 引数の bitMode は、UserInfo と加味済み
    091         *
    092         * @og.rev 4.3.0.0 (2008/07/04) ファイル入出力制御追加
    093         * @og.rev 4.3.3.0 (2008/10/01) 強制プルダウンモード追加
    094         *
    095         * @param       guiData         画面データオブジェクトID
    096         * @param       labelData       ラベルデータオブジェクト
    097         * @param       bitMode ビットモード配列 "--:000","-r:001","-w:010","mr:101","mw:110" に対応した数字(0,1,2,5,6)
    098         */
    099        public GUIInfo( final GUIData   guiData ,
    100                                        final LabelData labelData ,
    101                                        final byte              bitMode ) {
    102                this.guiData    = guiData;
    103                this.labelData  = labelData;
    104                groupKeys               = StringUtil.csv2Array( guiData.getGroups() );
    105
    106                menuFlag        = RoleMode.isMenu( bitMode );
    107                writeFlag       = RoleMode.isWrite( bitMode );
    108                pulldownFlag = RoleMode.isPulldown( bitMode ); // 4.3.3.0 (2008/10/01)
    109                accessCount = new GUIAccessCount( guiData.getGuiKey() ) ;
    110                this.bitMode = bitMode ;
    111
    112                level = guiData.getGuiLevel();
    113        }
    114
    115        /**
    116         * 画面情報 画面ID を取得します。
    117         *
    118         * @return      画面ID
    119         */
    120        public String getKey() {
    121                return guiData.getGuiKey();
    122        }
    123
    124        /**
    125         * 実行アドレス情報を取得します。
    126         *
    127         * @return      実行アドレス
    128         */
    129        public String getAddress() {
    130                return guiData.getAddress();
    131        }
    132
    133        /**
    134         * トップからの実行アドレス情報を取得します。
    135         * コンテキスト名とリンク区分属性を利用して、サーバートップからのアドレスを
    136         * 返します。ただし、GUIリソースに、http://～ または、.～ から始まるアドレスは
    137         * そのまま、なにも変換せずに返します。
    138         * 実アドレスには、param属性の情報を付加します。param属性は、接続文字を用いずに
    139         * そのまま連結されますので、/index.jsp?AAA=XX&amp;BBB=YY という感じで "/" から
    140         * はじめます。
    141         *
    142         * http://AAAA  ⇒  http://AAAA
    143         * ../../AAAA/  ⇒  ../../AAAA/
    144         * AAAA         ⇒  /CONTEXT_NAME/KBLINK/AAAA/    param なし
    145         * AAAA         ⇒  /CONTEXT_NAME/KBLINK/AAAA/index.jsp?AAA=XX&amp;BBB=YY  param あり
    146         *
    147         * @og.rev 3.5.5.0 (2004/03/12) 新規追加
    148         * @og.rev 4.0.0.0 (2005/01/31) param属性追加
    149         *
    150         * @return      実行実アドレス
    151         */
    152        public String getRealAddress() {
    153                return guiData.getRealAddress();
    154        }
    155
    156        /**
    157         * トップからの実行アドレス情報を取得します。
    158         * コンテキスト名とリンク区分属性を利用して、サーバートップからのアドレスを
    159         * 返します。ただし、GUIリソースに、http://～ または、.～ から始まるアドレスは
    160         * そのまま、なにも変換せずに返します。
    161         * 実アドレスには、param属性の情報を付加します。param属性は、接続文字を用いずに
    162         * そのまま連結されますので、/index.jsp?AAA=XX&amp;BBB=YY という感じで "/" から
    163         * はじめます。
    164         * また、アドレスの最後がスラッシュ(/)で終了している場合は、page属性を追加します。
    165         *
    166         * http://AAAA  ⇒  http://AAAA
    167         * ../../AAAA/  ⇒  ../../AAAA/
    168         * AAAA         ⇒  /CONTEXT_NAME/KBLINK/AAAA/    param なし
    169         * AAAA         ⇒  /CONTEXT_NAME/KBLINK/AAAA/index.jsp?AAA=XX&amp;BBB=YY  param あり
    170         *
    171         * @og.rev 4.0.0.0 (2005/01/31) 新規追加(param属性追加)
    172         *
    173         * @param    page          実行ページ(index.jsp など)
    174         *
    175         * @return      実行実アドレス
    176         */
    177        public String getRealAddress( final String page ) {
    178                return guiData.getRealAddress( page );
    179        }
    180
    181        /**
    182         * 画面の表示順を取得します。
    183         *
    184         * @return      画面の表示順
    185         */
    186        public int getSequence() {
    187                return guiData.getSeqno();
    188        }
    189
    190        /**
    191         * 画面の階層番号(レベル)を取得します。
    192         * 画面階層は、
    193         * 　0:予約階層(将来的にタブブラウザ対応時に使用
    194         * 　1:トップ階層(通常のメニューの分類として表示されます。)
    195         * 　2:選択階層(通常の折りたたみメニューの画面選択時に使用されます。)
    196         * 　3以下:下位階層(通常の選択メニューとして、１段下げて表示されます。)
    197         * です。
    198         * なお、これらの意味は、実際にメニューを作成/表示するクラスに依存します。
    199         *
    200         * @return      画面の表示順
    201         */
    202        public int getLevel() {
    203                return level;
    204        }
    205
    206        /**
    207         * 画面の階層番号(レベル)をアップします。
    208         *
    209         * これは、レベルが３の場合(階層時の隠しメニュー)をレベル２に
    210         * することで、常に見えているメニューに格上げします。
    211         * 具体的には、設定値が隠しメニューの場合に、アクセスするとレベル２へ格上げ
    212         * することで、個人単位で、過去の履歴に応じたメニュー配置が可能になります。
    213         */
    214        public void setLevelUp() {
    215                if( level == 4 ) { level = 3; } // 4.0.0.0 (2007/10/30)
    216        }
    217
    218        /**
    219         * 画面情報 メニュグループのオリジナルキー を取得します。
    220         * メニュグループは、CSV形式で複数登録できます。
    221         *
    222         * @return      メニュ分類のキー
    223         */
    224        public String getGroups() {
    225                return guiData.getGroups();
    226        }
    227
    228        /**
    229         * 指定の文字列がグループに含まれているかどうかを判定します。
    230         * メニュグループは、CSV形式で複数登録できますので、そのうちの
    231         * どれかに含まれていれば、true を返します。
    232         * このメニューそのものに、グループが指定されていない場合は、
    233         * デフォルトグループという扱いで、true を返します。
    234         * 引数が、null または、ゼロ文字列の場合も、同様に、true を返します。
    235         *
    236         * @param       group   判定するグループ
    237         *
    238         * @return      グループに含まれているかどうか
    239         */
    240        public boolean isGroupIn( final String group ) {
    241                if( groupKeys.length == 0 || group == null || group.isEmpty() ) {
    242                        return true;
    243                }
    244
    245                for( int i=0; i<groupKeys.length; i++ ) {
    246                        if( group.equals( groupKeys[i] ) ) {
    247                                return true;
    248                        }
    249                }
    250                return false;
    251        }
    252
    253        /**
    254         * 画面情報 メニュ分類のオリジナルキー を取得します。
    255         *
    256         * @return      メニュ分類のキー
    257         */
    258        public String getClassify() {
    259                return guiData.getClassify();
    260        }
    261
    262        /**
    263         * 画面情報 画面名称 を取得します。
    264         * これは、加工前のラベルリソースに登録されている値です。
    265         *
    266         * @return      画面名称
    267         */
    268        public String getLabel() {
    269                return labelData.getLabel();
    270        }
    271
    272        /**
    273         * 画面情報 画面名称を、指定のﾌﾗｸﾞに応じて取得します。
    274         * true の場合、#getLongName() を、falseの場合、#getName() を
    275         * 返します。
    276         * この名称は、チップ表示付きの文字列を返します。
    277         *
    278         * @og.rev 8.2.1.0 (2022/07/15) 新規追加
    279         *
    280         * @param       flag true:名前(長) / false:名前(短)
    281         * @return      画面名称(short)
    282         */
    283        public String getName( final boolean flag ) {
    284                return flag ? getLongName() : getName();
    285        }
    286
    287        /**
    288         * 画面情報 画面名称(short) を取得します。
    289         * この名称は、チップ表示付きの文字列を返します。
    290         *
    291         * @return      画面名称(short)
    292         */
    293        public String getName() {
    294                return labelData.getShortLabel();
    295        }
    296
    297        /**
    298         * 画面情報 画面名称(long) を取得します。
    299         * この名称は、チップ表示付きの文字列を返します。
    300         *
    301         * @return      画面名称(long)
    302         */
    303        public String getLongName() {
    304                return labelData.getLongLabel();
    305        }
    306
    307        /**
    308         * 画面情報 ロール を取得します。
    309         * ロールは、AAA|BBB|CCC と『|』の区切り文字で複数登録できます。
    310         * ユーザーのロール(こちらも、XXX|YYY|AAAと複数登録可能)とマッチする
    311         * ロールがあれば、その画面のアクセス許可があります。
    312         * 読み書きと、メニュー表示は、アクセスモードで指定します。
    313         *
    314         * @return      ロール
    315         */
    316        public String getRoles() {
    317                return guiData.getRoles();
    318        }
    319
    320        /**
    321         * アクセスモードを取得します。
    322         *
    323         * r,w,_ を各ロール毎に設定します。
    324         * mr:メニューよりアクセスできる読取専用画面です。登録ボタンは表示されません。
    325         * mw:メニューよりアクセスできる登録編集画面です。表示もします。
    326         * -r:メニューに現れませんが、アクセスすることは可能です。読取専用。
    327         * -w:メニューに現れませんが、アクセスすることは可能です。読み書き出来ます。
    328         *
    329         * この２文字ずつのセットが、各ロールに対応付けられたアクセス制御になります。
    330         * ロールが、AAA|BBB|CCC|DDD で、モードが mw|mr|-r|-w であれば、
    331         * AAA は、mw , BBB は、mr ，CCC は、-r ，DDD は -w と設定されたことになります。
    332         * 特別に、２文字のみ登録された場合は、全ロールが同一モードに設定
    333         * されたとみなします。
    334         *
    335         * @return      ロール毎のアクセスモード列(mr,mw,-r,-w の羅列)
    336         */
    337        public String getMode() {
    338                return guiData.getMode();
    339        }
    340
    341        /**
    342         * 画面を表示する時のターゲット属性を取得します。
    343         *
    344         * @return      ターゲット
    345         */
    346        public String getTarget() {
    347                return guiData.getTarget();
    348        }
    349
    350        /**
    351         * 画面を表示する時のパラメータ属性を取得します。
    352         *
    353         * @return      パラメータ
    354         */
    355        public String getParam() {
    356                return guiData.getParam();
    357        }
    358
    359        /**
    360         * リンク区分属性を取得します。
    361         *
    362         * @og.rev 3.4.0.0 (2003/09/01) リンク区分(KBLINK)属性を追加。
    363         *
    364         * @return      リンク区分
    365         */
    366        public String getKblink() {
    367                return guiData.getKblink();
    368        }
    369
    370        /**
    371         * 概要説明属性を取得します。
    372         * 概要説明が設定されていない場合は、longName を返します。
    373         *
    374         * @og.rev 3.5.6.5 (2004/08/09) 概要説明(DESCRIPTION)属性を追加。
    375         *
    376         * @return      概要説明
    377         */
    378        public String getDescription() {
    379                return labelData.getDescription() ;
    380        }
    381
    382        /**
    383         * 更新日時を取得します。
    384         *
    385         * @og.rev 5.3.3.0 (2011/03/01) 新規作成
    386         *
    387         * @return      更新日時
    388         */
    389        public String getDyupd() {
    390                return guiData.getDyupd();
    391        }
    392
    393        /**
    394         * イメージアイコンのキーを返します。
    395         *
    396         * 画面にアイコンを追加する場合、jsp/menuImage フォルダに、画面ID と同じ名称の
    397         * 画像ファイルを置く必要があります。
    398         *
    399         * ※ 6.3.8.4 (2015/10/09)
    400         *    従来は、PARAM 属性に、IMAGE_KEY=XXXX と指定していましたが、
    401         *    KBLINK(リンク区分) を使用するように変更しました。
    402         *
    403         * @og.rev 5.5.2.5 (2012/05/21) 新規追加
    404         * @og.rev 6.3.8.4 (2015/10/09) KBLINK(リンク区分)を画面のイメージファイルに割り当てます。
    405         *
    406         * @return      イメージアイコンのキー
    407         */
    408        public String getImageKey() {
    409                return guiData.getImageKey();
    410        }
    411
    412        /**
    413         * ロールモード情報を取得します。
    414         *
    415         * @og.rev 4.3.0.0 (2008/07/04) 新規追加
    416         *
    417         * @return      ロールモード
    418         */
    419        public RoleMode getRoleMode() {
    420                return guiData.getRoleMode() ;
    421        }
    422
    423        /**
    424         * リードアクセス(読取り許可)の 可否を チェックします。
    425         * アクセスチェックは、画面のロールをユーザーの
    426         * それと比較して条件が含まれているかどうかを確認します。
    427         * 条件が null (または０ストリング)の場合は, true となります。
    428         * 条件の判断は、AND 条件です。
    429         * さらに、その他の条件部分を判断して、OR 条件で先の結果と突き合わせます。
    430         * ユーザーのロールが、 "root" の場合は,rw 属性のみのチェックで判断します。
    431         *
    432         * @og.rev 3.5.4.0 (2003/11/25) 引数にロールズを渡します。
    433         *
    434         * @return  アクセスOK：true  アクセス拒否：false
    435         */
    436        public boolean isRead() {
    437                return menuFlag;
    438        }
    439
    440        /**
    441         * ライトアクセス(書込み許可)の 可否を チェックします。
    442         * アクセスチェックは、画面のロールをユーザーの
    443         * それと比較して条件が含まれているかどうかを確認します。
    444         * 条件が null (または０ストリング)の場合は, true となります。
    445         * 条件の判断は、AND 条件です。
    446         * さらに、その他の条件部分を判断して、OR 条件で先の結果と突き合わせます。
    447         * ユーザーのロールが、 "root" の場合は,rw 属性のみのチェックで判断します。
    448         *
    449         * @og.rev 3.5.4.0 (2003/11/25) 引数にロールズを渡します。
    450         *
    451         * @return  アクセスOK：true  アクセス拒否：false
    452         */
    453        public boolean isWrite() {
    454                return writeFlag;
    455        }
    456
    457        /**
    458         * ボタンメニューにプルダウンを指定するのかをチェックします。
    459         *
    460         * @og.rev 4.3.3.0 (2008/10/01) 新規作成
    461         *
    462         * @return プルダウン化の場合true
    463         */
    464        public boolean isPulldown() {
    465                return pulldownFlag;
    466        }
    467
    468        /**
    469         * 指定のユーザーロールに対するビット条件を取得します。
    470         * この bitMode は、すでにユーザー単位に作成された値です。
    471         *
    472         * @og.rev 4.3.0.0 (2008/07/04) ロールモードマルチ対応
    473         *
    474         * @return アクセスビット
    475         */
    476        public byte getBitMode() {
    477                return bitMode;
    478        }
    479
    480        /**
    481         * GUIInfoの属性文字列を取得します。
    482         *
    483         * ・KEY           画面ID
    484         * ・ADDRESS       実行アドレス
    485         * ・REALADDRESS   実行実アドレス
    486         * ・SEQUENCE      表示順
    487         * ・GROUPS        メニュグループ
    488         * ・CLASSIFY      メニュ分類
    489         * ・LEVEL         メニュ階層番号
    490         * ・LABEL         画面名称
    491         * ・NAME          画面名称(=SNAME)
    492         * ・SNAME         画面名称(short)
    493         * ・LNAME         画面名称(long)
    494         * ・ROLES         ロール
    495         * ・MODE          アクセスモード列(mr,mw,-r,-w の羅列)
    496         * ・TARGET        ターゲット
    497         * ・PARAM         設定値(パラメータ)
    498         * ・KBLINK        リンク区分
    499         * ・DESCRIPTION   概要説明
    500         * ・IMAGEKEY      イメージキー
    501         * ・DYUPD         更新日時
    502         * ・ISREAD        読取り許可[true/false]
    503         * ・ISWRITE       書込み許可[true/false]
    504         *
    505         * @og.rev 3.4.0.0 (2003/09/01) リンク区分(KBLINK)属性を追加。
    506         * @og.rev 3.5.5.0 (2004/03/12) 実行実アドレス(REALADDRESS)属性を追加。
    507         * @og.rev 3.5.6.5 (2004/08/09) 概要説明(DESCRIPTION)属性を追加。
    508         * @og.rev 4.0.0.0   (2005/11/30) ISREAD,ISWRITE 属性を追加。
    509         * @og.rev 5.3.3.0 (2011/03/01) 更新日時を追加
    510         * @og.rev 5.5.2.5 (2012/05/21) IMAGEKEY 追加
    511         * @og.rev 5.6.4.3 (2013/05/25) FAQ追加
    512         * @og.rev 6.3.8.4 (2015/10/09) GE80(FAQﾃｰﾌﾞﾙ)の取得は廃止。(helpタグで行う)
    513         * @og.rev 6.4.1.1 (2016/01/16) PMD refactoring. Position literals first in String comparisons for EqualsIgnoreCase.
    514         *
    515         * @param       key     キー
    516         *
    517         * @return      属性文字列の値
    518         */
    519        public String getAttribute( final String key ) {
    520                final String rtn ;
    521
    522                if( key == null ) { rtn = null; }
    523                else {
    524                        if(      "KEY"         .equalsIgnoreCase( key ) ) { rtn = getKey(); }
    525                        else if( "GUICLM"      .equalsIgnoreCase( key ) ) { rtn = labelData.getKey(); }
    526                        else if( "ADDRESS"     .equalsIgnoreCase( key ) ) { rtn = getAddress(); }
    527                        else if( "REALADDRESS" .equalsIgnoreCase( key ) ) { rtn = getRealAddress(); }
    528                        else if( "SEQUENCE"    .equalsIgnoreCase( key ) ) { rtn = String.valueOf( getSequence() ); }
    529                        else if( "GROUPS"      .equalsIgnoreCase( key ) ) { rtn = getGroups(); }
    530                        else if( "CLASSIFY"    .equalsIgnoreCase( key ) ) { rtn = getClassify(); }
    531                        else if( "LEVEL"       .equalsIgnoreCase( key ) ) { rtn = String.valueOf( getLevel() ); }
    532                        else if( "LABEL"       .equalsIgnoreCase( key ) ) { rtn = getLabel(); }
    533                        else if( "NAME"        .equalsIgnoreCase( key ) ) { rtn = getName(); }
    534                        else if( "SNAME"       .equalsIgnoreCase( key ) ) { rtn = getName(); }
    535                        else if( "LNAME"       .equalsIgnoreCase( key ) ) { rtn = getLongName(); }
    536                        else if( "ROLE"        .equalsIgnoreCase( key ) ) { rtn = getRoles(); }
    537                        else if( "ROLES"       .equalsIgnoreCase( key ) ) { rtn = getRoles(); }
    538                        else if( "MODE"        .equalsIgnoreCase( key ) ) { rtn = getMode(); }
    539                        else if( "TARGET"      .equalsIgnoreCase( key ) ) { rtn = getTarget(); }
    540                        else if( "PARAM"       .equalsIgnoreCase( key ) ) { rtn = getParam(); }
    541                        else if( "KBLINK"      .equalsIgnoreCase( key ) ) { rtn = getKblink(); }
    542                        else if( "DESCRIPTION" .equalsIgnoreCase( key ) ) { rtn = getDescription(); }                           // 3.5.6.5 (2004/08/09)
    543                        else if( "IMAGEKEY"    .equalsIgnoreCase( key ) ) { rtn = getImageKey(); }                                      // 3.5.6.5 (2004/08/09)
    544                        else if( "DYUPD"       .equalsIgnoreCase( key ) ) { rtn = getDyupd(); }                                         // 5.5.2.5 (2012/05/21)
    545                        else if( "ISREAD"      .equalsIgnoreCase( key ) ) { rtn = String.valueOf( isRead() ); }         // 4.0.0 (2005/11/30)
    546                        else if( "ISWRITE"     .equalsIgnoreCase( key ) ) { rtn = String.valueOf( isWrite() ); }        // 4.0.0 (2005/11/30)
    547        //              // 6.3.8.4 (2015/10/09) GE80(FAQﾃｰﾌﾞﾙ)の取得は廃止。(helpタグで行う)
    548        //              else if( "FAQ"         .equalsIgnoreCase( key ) ) { rtn = String.valueOf(isFaq()); }            // 5.6.4.3 (2013/05/24)
    549                        else {
    550                                final String errMsg = "属性文字列キーが不正です。 key=[" + key + "]"
    551                                                        + CR
    552                                                        + "予約語(" + YOYAKU + ") 以外は指定できません。" ;
    553                                throw new HybsSystemException( errMsg );
    554                        }
    555                }
    556                return rtn ;
    557        }
    558
    559        /**
    560         * GUIInfoの属性文字列の内部情報を返します。
    561         * この内部情報の中には、getAttribute( String ) で取得できる管理情報です。
    562         *
    563         * @og.rev 4.0.0.0 (2004/12/31) 新規作成
    564         * @og.rev 5.3.3.0 (2011/03/01) 更新日時を追加
    565         * @og.rev 5.5.2.5 (2012/05/21) IMAGEKEY 追加
    566         *
    567         * @return      属性文字列のHybsEntryオブジェクト配列
    568         * @og.rtnNotNull
    569         */
    570        public HybsEntry[] getEntrys() {
    571                final List<HybsEntry> list = new ArrayList<>();
    572
    573                list.add( new HybsEntry( "GUI.KEY"         , getAttribute( "KEY"         ) , "画面ID" ) );
    574                list.add( new HybsEntry( "GUI.GUICLM"      , getAttribute( "GUICLM"      ) , "画面カラムID" ) );
    575                list.add( new HybsEntry( "GUI.ADDRESS"     , getAttribute( "ADDRESS"     ) , "実行アドレス" ) );
    576                list.add( new HybsEntry( "GUI.REALADDRESS" , getAttribute( "REALADDRESS" ) , "実行実アドレス" ) );
    577                list.add( new HybsEntry( "GUI.SEQUENCE"    , getAttribute( "SEQUENCE"    ) , "表示順" ) );
    578                list.add( new HybsEntry( "GUI.GROUPS"      , getAttribute( "GROUPS"      ) , "メニュグループ" ) );
    579                list.add( new HybsEntry( "GUI.CLASSIFY"    , getAttribute( "CLASSIFY"    ) , "メニュ分類" ) );
    580                list.add( new HybsEntry( "GUI.LEVEL"       , getAttribute( "LEVEL"       ) , "メニュ階層番号" ) );
    581                list.add( new HybsEntry( "GUI.LABEL"       , getAttribute( "LABEL"       ) , "画面名称" ) );
    582                list.add( new HybsEntry( "GUI.NAME"        , getAttribute( "NAME"        ) , "画面名称(=SNAME)" ) );
    583                list.add( new HybsEntry( "GUI.SNAME"       , getAttribute( "SNAME"       ) , "画面名称(short)" ) );
    584                list.add( new HybsEntry( "GUI.LNAME"       , getAttribute( "LNAME"       ) , "画面名称(long)" ) );
    585                list.add( new HybsEntry( "GUI.ROLES"       , getAttribute( "ROLES"       ) , "ロール" ) );
    586                list.add( new HybsEntry( "GUI.MODE"        , getAttribute( "MODE"        ) , "アクセスモード列(mr,mw,-r,-w の羅列)" ) );
    587                list.add( new HybsEntry( "GUI.TARGET"      , getAttribute( "TARGET"      ) , "ターゲット" ) );
    588                list.add( new HybsEntry( "GUI.PARAM"       , getAttribute( "PARAM"       ) , "パラメータ" ) );
    589                list.add( new HybsEntry( "GUI.KBLINK"      , getAttribute( "KBLINK"      ) , "リンク区分" ) );
    590                list.add( new HybsEntry( "GUI.DESCRIPTION" , getAttribute( "DESCRIPTION" ) , "概要説明" ) );
    591                list.add( new HybsEntry( "GUI.IMAGEKEY"    , getAttribute( "IMAGEKEY"    ) , "イメージキー" ) );      // 5.5.2.5 (2012/05/21)
    592                list.add( new HybsEntry( "GUI.DYUPD"       , getAttribute( "DYUPD"       ) , "更新日時" ) );                // 5.3.3.0 (2011/03/01)
    593                list.add( new HybsEntry( "GUI.ISREAD"      , getAttribute( "ISREAD"      ) , "読取り許可[true/false]" ) );
    594                list.add( new HybsEntry( "GUI.ISWRITE"     , getAttribute( "ISWRITE"     ) , "書込み許可[true/false]" ) );
    595
    596                return list.toArray( new HybsEntry[list.size()] );
    597        }
    598
    599        /**
    600         * データベース検索した数と、掛かった時間(ms)を、セットします。
    601         * これは、セキュリティ上の監視フラグで、不必要に、大量の
    602         * データが検索された場合や、不正なデータアクセスがあるかどうかを
    603         * 監視するための統計情報を取得します。
    604         * 画面オブジェクトは、各ユーザー毎に作成されているため、個々の
    605         * ユーザー毎/画面毎のアクセス状況を見ることが可能になります。
    606         *
    607         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
    608         *
    609         * @param  cnt データベース検索した数
    610         * @param  time データベース検索した数
    611         * @param  query そのときのSQL文
    612         */
    613        public void addReadCount( final int cnt,final long time,final String query ) {
    614                accessCount.addReadCount( cnt,time,query );
    615        }
    616
    617        /**
    618         * データベース登録した数と、掛かった時間(ms)を、セットします。
    619         * これは、セキュリティ上の監視フラグで、不必要に、大量の
    620         * データが登録された場合や、不正なデータアクセスがあるかどうかを
    621         * 監視するための統計情報を取得します。
    622         * 画面オブジェクトは、各ユーザー毎に作成されているため、個々の
    623         * ユーザー毎/画面毎のアクセス状況を見ることが可能になります。
    624         *
    625         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
    626         *
    627         * @param  cnt データベース登録した数
    628         * @param  time データベース検索した数
    629         * @param  query そのときのSQL文
    630         */
    631        public void addWriteCount( final int cnt,final long time,final String query ) {
    632                accessCount.addWriteCount( cnt,time,query );
    633        }
    634
    635        /**
    636         * この画面へのアクセス回数を、＋１します。
    637         * アクセス回数は、このメソッドの呼び出し回数のことです。
    638         * 現状では、result.jsp 画面でセットすることで、アクセス数を
    639         * 数えることにします。
    640         *
    641         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
    642         *
    643         */
    644        public void addAccessCount() {
    645                if( level == 4 ) { level = 3; } // 4.0.0.0 (2007/10/30)
    646                accessCount.addAccessCount();
    647        }
    648
    649        /**
    650         * エラー発生時の件数を＋１します。
    651         * これは、エラー発生時に呼び出すことで、エラー件数をチェックすることが
    652         * 可能になります。
    653         * 一般にエラーには、予期するエラー(必須入力登録漏れ等)と、予期しないエラー
    654         * がありますが、ここでは、Java の Exceptionが発生する予期しないエラーの
    655         * 件数をカウントします。
    656         *
    657         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
    658         *
    659         */
    660        public void addErrorCount() {
    661                accessCount.addErrorCount();
    662        }
    663
    664        /**
    665         * この画面のアクセス統計オブジェクトを取得します。
    666         *
    667         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
    668         *
    669         * @return      アクセス統計オブジェクト
    670         */
    671        public GUIAccessCount getGUIAccessCount() {
    672                return accessCount;
    673        }
    674
    675        /**
    676         * この画面の次にアクセスされた画面IDをセットします。
    677         *
    678         * これは、画面アクセスの履歴(順番)を管理する機能を提供します。
    679         * 自分自身の次にアクセスされる画面IDの集合を管理することで
    680         * QUERY画面上部のショートカットリンクに、次に使用する画面の
    681         * リンクを用意することが可能になります。
    682         *
    683         * @og.rev 5.2.3.0 (2010/12/01) アクセス履歴管理
    684         * @og.rev 6.8.4.2 (2017/12/25) nextGui を、後入れ先出しに変更します。
    685         *
    686         * @param       guiKey  この画面の次にアクセスされた画面ID
    687         */
    688        public void setNextGuiKey( final String guiKey ) {
    689                // 自分自身の場合は、セットしない。
    690                if( guiKey != null && !guiKey.equals( getKey() ) ) {
    691                        nextGui.remove( guiKey );                       // 実装は、List なので、一旦削除(Setの代用のつもり)
    692                        nextGui.addFirst( guiKey );                     // 要素の最初に挿入
    693                }
    694        }
    695
    696        /**
    697         * この画面の次にアクセスされた画面IDのCSV文字列を取得します。
    698         *
    699         * これは、画面アクセスの履歴(順番)をCSV形式で取り出します。
    700         * アクセス履歴を外部記憶媒体に出力する場合に使用します。
    701         *
    702         * @og.rev 5.2.3.0 (2010/12/01) アクセス履歴管理
    703         * @og.rev 6.4.3.4 (2016/03/11) CSV形式の文字連結を、stream 経由で行います。
    704         *
    705         * @return      この画面の次にアクセスされた画面IDのCSV文字列
    706         * @og.rtnNotNull
    707         */
    708        public String getNextGuiKeys() {
    709                return nextGui.stream()
    710                                        .collect( Collectors.joining( "," ) );
    711        }
    712
    713        /**
    714         * この画面の次にアクセスされた画面IDの文字列配列で取得します。
    715         *
    716         * これは、画面アクセスの履歴(順番)を文字列配列で取り出します。
    717         *
    718         * @og.rev 5.2.3.0 (2010/12/01) アクセス履歴管理
    719         *
    720         * @return      この画面の次にアクセスされた画面IDの文字列配列
    721         */
    722        public String[] getNextGuiArray() {
    723                // 6.9.8.0 (2018/05/28) FindBugs:java.util.concurrent のインスタンスで同期化している
    724                return nextGui.toArray( new String[nextGui.size()] );
    725
    726//              final String[] rtnAry ;
    727//              synchronized( nextGui ) {
    728//                      rtnAry = nextGui.toArray( new String[nextGui.size()] );
    729//              }
    730//
    731//              return rtnAry ;
    732        }
    733
    734        /**
    735         * 自然比較メソッド
    736         * インタフェース Comparable の 実装に関連して、再定義しています。
    737         * 登録されたシーケンス(画面の表示順)で比較します。
    738         * equals メソッドでは、キーの同一性のみに着目して判定しています。
    739         * この比較では、(運用上同一キーは発生しませんが)たとえ同一キーが存在した
    740         * としても、その比較値が同じになることを保証していません。
    741         *
    742         * @param   other 比較対象のObject
    743         *
    744         * @return  このオブジェクトが指定されたオブジェクトより小さい場合は負の整数、等しい場合はゼロ、大きい場合は正の整数
    745         * @throws  ClassCastException 引数が GUIInfo ではない場合
    746         * @throws  IllegalArgumentException 引数が null の場合
    747         */
    748        @Override       // Comparable
    749        public int compareTo( final GUIInfo other ) {           // 4.3.3.6 (2008/11/15) Generics警告対応
    750                if( other == null ) {
    751                        final String errMsg = "引数が、null です。" ;
    752                        throw new IllegalArgumentException( errMsg );
    753                }
    754                return getSequence() - other.getSequence();             // 4.3.3.6 (2008/11/15) Generics警告対応
    755        }
    756
    757        /**
    758         * このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    759         * 画面は、画面IDが等しければ、言語や表示順に関係なく同一とみなされます。
    760         * GUIInfo は、ユーザー個別に扱われ、そのグループには、key は唯一で、かつ
    761         * 同一言語内で扱われるオブジェクトの為、同一とみなします。
    762         *
    763         * @param   object 比較対象の参照オブジェクト
    764         *
    765         * @return      引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false
    766         */
    767        @Override
    768        public boolean equals( final Object object ) {
    769                // 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
    770                return object instanceof GUIInfo && getKey().equals( ((GUIInfo)object).getKey() );
    771        }
    772
    773        /**
    774         * オブジェクトのハッシュコード値を返します。
    775         * このメソッドは、java.util.Hashtable によって提供されるような
    776         * ハッシュテーブルで使用するために用意されています。
    777         * equals( Object ) メソッドをオーバーライトした場合は、hashCode() メソッドも
    778         * 必ず 記述する必要があります。
    779         * この実装では、getKey().hashCode() と同値を返します。
    780         *
    781         * @return  このオブジェクトのハッシュコード値
    782         */
    783        @Override
    784        public int hashCode() {
    785                return getKey().hashCode() ;
    786        }
    787
    788        /**
    789         * オブジェクトの識別子として，詳細な画面情報を返します。
    790         *
    791         * @og.rev 3.4.0.0 (2003/09/01) リンク区分(KBLINK)属性を追加。
    792         * @og.rev 3.5.5.0 (2004/03/12) 実行アドレス(ADDRESS)属性を追加。
    793         * @og.rev 5.3.3.0 (2011/03/01) 更新日時を追加
    794         * @og.rev 5.5.2.5 (2012/05/21) IMAGEKEY 追加
    795         *
    796         * @return  詳細な画面情報
    797         * @og.rtnNotNull
    798         */
    799        @Override
    800        public String toString() {
    801                final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE )
    802                        .append( "key        :").append( getKey()           ).append( CR )      // 画面ID
    803                        .append( "lvlclm     :").append( labelData.getKey() ).append( CR )      // 画面カラムID
    804                        .append( "address    :").append( getAddress()       ).append( CR )      // 実行アドレス
    805                        .append( "sequence   :").append( getSequence()      ).append( CR )      // 表示順
    806                        .append( "groups     :").append( getGroups()        ).append( CR )      // メニュグループ
    807                        .append( "classify   :").append( getClassify()      ).append( CR )      // メニュ分類
    808                        .append( "level      :").append( getLevel()         ).append( CR )      // 階層レベル
    809                        .append( "name       :").append( getName()          ).append( CR )      // 画面名称
    810                        .append( "longName   :").append( getLongName()      ).append( CR )      // 画面名称(long)
    811                        .append( "roles      :").append( getRoles()         ).append( CR )      // ロール
    812                        .append( "mode       :").append( getMode()          ).append( CR )      // アクセスモード  "rwrwrw"
    813                        .append( "target     :").append( getTarget()        ).append( CR )      // ターゲット
    814                        .append( "kblink     :").append( getKblink()        ).append( CR )      // リンク区分
    815                        .append( "description:").append( getDescription()   ).append( CR )      // 概要説明
    816                        .append( "imageKey   :").append( getImageKey()      ).append( CR )      // イメージキー 5.5.2.5 (2012/05/21)
    817                        .append( "dyupd      :").append( getDyupd()         ).append( CR );     // 更新日時
    818                return rtn.toString();
    819        }
    820}