    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.taglib;
    017
    018import org.opengion.fukurou.util.TagBuffer;                                             // 6.1.1.0 (2015/01/17)
    019import org.opengion.fukurou.util.XHTMLTag;
    020import org.opengion.fukurou.util.ToString;                                              // 6.1.1.0 (2015/01/17)
    021import org.opengion.hayabusa.common.HybsSystem;
    022import org.opengion.hayabusa.common.HybsSystemException;                // 6.4.0.5 (2016/01/09)
    023import org.opengion.hayabusa.db.DBColumn;
    024import org.opengion.hayabusa.db.DBEditConfig;
    025// import org.opengion.hayabusa.db.DBEditConfigManager;                 // 6.4.5.0 (2016/04/08) , 6.9.2.1 (2018/03/12) 廃止
    026
    027import static org.opengion.fukurou.util.StringUtil.nval;
    028
    029/**
    030 * query.jsp での検索ボタンを表示します。
    031 * 検索ボタン以外に、pageSize、maxRowCount、prevNext、timeView などの
    032 * 項目も表示可能です。
    033 * また、BODY部に登録した値は、table 要素として、td 部に追記されます。
    034 *
    035 * @og.formSample
    036 * ●形式：&lt;og:queryButton /&gt;
    037 * ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{&#064;XXXX} を解析します)
    038 *
    039 * ●Tag定義：
    040 *   &lt;og:queryButton
    041 *       command            【TAG】リクエストとして送信するコマンドを指定します(初期値:NEW)
    042 *       pageSize           【TAG】pageSize プルダウンメニューの初期値を指定します (初期値:HTML_PAGESIZE[=100])
    043 *       maxRowCount        【TAG】maxRowCount プルダウンメニューの初期値を指定します (初期値:DB_MAX_ROW_COUNT[=1000])
    044 *       type               【TAG】典型的なボタンの形状に設定します(初期値:null)
    045 *       scope              【TAG】リクエストとして送信するスコープを指定します(初期値:null)
    046 *       lbl                【TAG】ラベルリソースのラベルIDを指定します
    047 *       accesskey          【TAG】検索ボタンに使用するショートカットキー文字を指定します(初期値:F)
    048 *       usePrevNext        【TAG】進む／戻るのprev_next リンクを表示するかどうかを指定します(初期値:true)
    049 *       usePageSize        【TAG】pageSize 引数を使用するかどうかを指定します(初期値:true)
    050 *       useRowCount        【TAG】maxRowCount 引数を使用するかどうかを指定します(初期値:true)
    051 *       useTimeView        【TAG】処理時間を表示する TimeView を表示するかどうかを指定します
    052 *                                                                              (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
    053 *       clearAccesskey     【TAG】クリアボタンに使用するショートカットキー文字を指定します(初期値:C)
    054 *       useDummy           【TAG】IE用ダミーinputを出力するかどうか
    055 *       useEditMenu        【TAG】編集プルダウンを出すかどうか(初期値:true)
    056 *       blockUIMsg         【TAG】検索中表示を画面上に表示するメッセージリソースIDを指定します (初期値:MSG0090(検索中です・・・)) 6.4.8.0 (2016/06/24)
    057 *       useClear           【TAG】JavaScriptによる初期化(クリア)ボタンを使用するかどうか[true/false/none]を指定します(初期値:true) 6.4.3.4 (2016/03/11)
    058 *       clearTarget        【TAG】useClear=true時のターゲット名（フレーム名）を指定します(初期値:QUERY) 5.9.21.1 (2017/06/16)  。
    059 *       clearHref          【TAG】useClear=true時の遷移先JSPを指定します(初期値:query.jsp) 5.9.21.1 (2017/06/16)。
    060 *       clearCommand       【TAG】useClear=true時のcommandを指定します(初期値:NEW) 5.9.21.1 (2017/06/16) 。
    061 *       clearKeys          【TAG】useClear=true時の遷移先に渡すキーをCSV形式で複数指定します  7.0.3.0 (2019/05/13)
    062 *       clearVals          【TAG】useClear=true時の遷移先に渡す値をCSV形式で複数指定します    7.0.3.0 (2019/05/13)
    063 *       title              【HTML】要素に対する補足的情報(title)を設定します
    064 *       style              【HTML】この要素に対して適用させるスタイルシート(style)を設定します
    065 *       disabled           【HTML】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない)
    066 *       tabindex           【HTML】タブの移動順(tabindex)を指定します(0 ～ 32767)
    067 *       clazz              【HTML】要素に対して class 属性を設定します
    068 *       onClick            【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');")
    069 *       onBlur             【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();")
    070 *       onFocus            【HTML】JavaScriptのイベント onFocus を設定します
    071 *       ondblClick         【HTML】JavaScriptのイベント ondblClick を設定します
    072 *       onMouseDown        【HTML】JavaScriptのイベント onMouseDown を設定します
    073 *       onMouseUp          【HTML】JavaScriptのイベント onMouseUp を設定します
    074 *       onMouseMove        【HTML】JavaScriptのイベント onMouseMove を設定します
    075 *       onMouseOut         【HTML】JavaScriptのイベント onMouseOut を設定します
    076 *       onMouseOver        【HTML】JavaScriptのイベント onMouseOver を設定します
    077 *       autofocus          【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます。
    078 *       caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)
    079 *       caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)
    080 *       caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない)
    081 *       caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない)
    082 *       caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
    083 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
    084 *   &gt;   ... Body ...
    085 *   &lt;/og:queryButton&gt;
    086 *
    087 * 【廃止】6.4.3.4 (2016/03/11) つづり間違いを訂正。useCrear → useClear。
    088 *   //  useCrear           【TAG】JavaScriptによる初期化(クリア)ボタンを使用するかどうか[true/false/none]を指定します(初期値:true)
    089 *
    090 * ●使用例
    091 *    &lt;og:queryButton
    092 *        command     = "NEW"      NEW:通常の検索(初期値)／ENTRY:エントリ登録時
    093 *        type        = "ENTRY"    null:標準 , SELECT:検索ボタンのみ , ENTRY:登録ボタンのみ
    094 *        pageSize    = "100"      pageSize の初期値設定(初期値:HTML_PAGESIZE)
    095 *        maxRowCount = "100"      maxRowCount の初期値設定(初期値:DB_MAX_ROW_COUNT)
    096 *        useClear    = "true"     true:JavaScriptによる初期化(クリア)／false:通常のresetボタン／none:表示しない
    097 *        scope       = "request"  null(初期値)／session:セッション登録／request:リクエスト登録
    098 *        lbl         = "MSG0010"  検索ボタンに表示するメッセージID(初期値:MSG0010)
    099 *        accesskey   = "F"        ショートカットキー文字(初期値:F)
    100 *        usePrevNext = "true"     Prev-Nextリンクを使用するかどうか(初期値:true)
    101 *        usePageSize = "true"     pageSize 引数を使用するかどうか(初期値:true)
    102 *        useRowCount = "true"     maxRowCount 引数を使用するかどうか(初期値:true)
    103 *        useTimeView = "true"     timeView表示(実行時間表示)を使用するかどうか(初期値:VIEW_USE_TIMEBAR)
    104 *        useEditMenu = "true"     編集プルダウンを出すかどうか(初期値:true)
    105 *    /&gt;
    106 *
    107 *  標準的な検索ボタン
    108 *    &lt;og:queryButton /&gt;
    109 *
    110 *  標準的な登録ボタン(command="NEW" で、query.jsp で使用するボタン)
    111 *    &lt;og:queryButton type="ENTRY" /&gt;
    112 *
    113 *  BODY 部に追加要素を表示
    114 *    &lt;og:queryButton &gt;
    115 *        &lt;td&gt;&lt;jsp:directive.include file="/jsp/common/timeViewImage.jsp" /&gt;&lt;/td&gt;
    116 *    &lt;/og:queryButton &gt;
    117 *
    118 * 7.4.2.1 (2021/05/21)
    119 *   ｼｽﾃﾑ定数 USE_ACCESSKEY を false に設定すると、accesskey は使用されません。
    120 *
    121 * @og.rev 4.0.0.0 (2005/01/31) 新規作成
    122 * @og.rev 5.7.1.0 (2013/12/06) HTMLTagSupport を継承し、ボタンに付ける属性を増やします。
    123 * @og.rev 7.3.2.3 (2021/04/09) ｼｽﾃﾑ定数のICON_DIRやIMAGE_DIRを使用します。
    124 * @og.rev 8.2.0.2 (2022/06/24) HTML5廃止対応
    125 * @og.group 画面制御
    126 *
    127 * @version  4.0
    128 * @author   Kazuhiko Hasegawa
    129 * @since    JDK5.0,
    130 */
    131public class QueryButtonTag extends HTMLTagSupport {
    132        /** このプログラムのVERSION文字列を設定します。   {@value} */
    133        private static final String VERSION = "8.2.0.2 (2022/06/24)" ;
    134        private static final long serialVersionUID = 820220220624L ;
    135
    136        // 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。
    137        private static final String COMMAND     =
    138//              "<input type=\"hidden\" name=\"command\" value=\"NEW\" id=\"h_cmd\" />";
    139                "<input type=\"hidden\" name=\"command\" value=\"NEW\" id=\"h_cmd\" >";                 // 7.0.1.0 (2018/10/15)
    140
    141        private static final String JSP = HybsSystem.sys( "JSP" );
    142        // 7.3.2.3 (2021/04/09) ｼｽﾃﾑ定数のICON_DIRやIMAGE_DIRを使用します。
    143        private static final String JSP_ICON = HybsSystem.sys( "JSP_ICON" ) ;
    144
    145        // 4.2.1.0 (2008/04/07) TDにIDを追加
    146        // 4.3.1.0 (2008/09/03) 戻る・進むボタンをsubmitにより実行する。
    147        // 6.0.2.4 (2014/10/17) img タグに、title 属性追記
    148        // 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。
    149//      private static final String PREV_NEXT =
    150//              "<td id=\"prev-next\"><a href=\"forward.jsp?command=FIRST\" target=\"RESULT\" >"                + CR +
    151//              "  <img src=\"" + JSP + "/image/FIRST.gif\" alt=\"FIRST\" title=\"FIRST\" border=\"0px\" " + CR +
    152////            "    onclick=\"return submitPrevNextForm('FIRST');\"/>" + CR +
    153//              "    onclick=\"return submitPrevNextForm('FIRST');\">"  + CR +                                  // 7.0.1.0 (2018/10/15)
    154//              "</a>"                                                                                                                          + CR +
    155//              "<a href=\"forward.jsp?command=PREV\" target=\"RESULT\" >"                      + CR +
    156//              "  <img src=\"" + JSP + "/image/PREV.gif\" alt=\"PREV\" title=\"PREV\" border=\"0px\" " + CR +
    157////            "    onclick=\"return submitPrevNextForm('PREV');\"/>"  + CR +
    158//              "    onclick=\"return submitPrevNextForm('PREV');\">"   + CR +                                  // 7.0.1.0 (2018/10/15)
    159//              "</a>"                                                                                                                          + CR +
    160//              "<a href=\"forward.jsp?command=NEXT\" target=\"RESULT\" >"                      + CR +
    161//              "  <img src=\"" + JSP + "/image/NEXT.gif\" alt=\"NEXT\" title=\"NEXT\" border=\"0px\" " + CR +
    162////            "    onclick=\"return submitPrevNextForm('NEXT');\"/>"  + CR +
    163//              "    onclick=\"return submitPrevNextForm('NEXT');\">"   + CR +                                  // 7.0.1.0 (2018/10/15)
    164//              "</a>"                                                                                                                          + CR +
    165//              "<a href=\"forward.jsp?command=LAST\" target=\"RESULT\" >"                      + CR +
    166//              "  <img src=\"" + JSP + "/image/LAST.gif\" alt=\"LAST\" title=\"LAST\" border=\"0px\" " + CR +
    167////            "    onclick=\"return submitPrevNextForm('LAST');\"/>"  + CR +
    168//              "    onclick=\"return submitPrevNextForm('LAST');\">"   + CR +                                  // 7.0.1.0 (2018/10/15)
    169//              "</a></td>" + CR ;
    170
    171        // 7.0.6.3 (2019/11/08) submitPrevNextForm で submit されるので、aタグは不要
    172        // 7.3.2.3 (2021/04/09) ｼｽﾃﾑ定数のICON_DIRやIMAGE_DIRを使用します。
    173        private static final String PREV_NEXT =
    174                "<td id=\"prev-next\">"         + CR +
    175//              "  <img src=\"" + JSP + "/image/FIRST.gif\" alt=\"FIRST\" title=\"FIRST\" border=\"0px\" " + CR +
    176                "  <img src=\"" + JSP_ICON + "/FIRST.gif\" alt=\"FIRST\" title=\"FIRST\" border=\"0px\" " + CR +
    177                "    onclick=\"submitPrevNextForm('FIRST');\">" + CR +
    178//              "  <img src=\"" + JSP + "/image/PREV.gif\" alt=\"PREV\" title=\"PREV\" border=\"0px\" "         + CR +
    179                "  <img src=\"" + JSP_ICON + "/PREV.gif\" alt=\"PREV\" title=\"PREV\" border=\"0px\" "  + CR +
    180                "    onclick=\"submitPrevNextForm('PREV');\">"  + CR +
    181//              "  <img src=\"" + JSP + "/image/NEXT.gif\" alt=\"NEXT\" title=\"NEXT\" border=\"0px\" " + CR +
    182                "  <img src=\"" + JSP_ICON + "/NEXT.gif\" alt=\"NEXT\" title=\"NEXT\" border=\"0px\" "  + CR +
    183                "    onclick=\"submitPrevNextForm('NEXT');\">"  + CR +
    184//              "  <img src=\"" + JSP + "/image/LAST.gif\" alt=\"LAST\" title=\"LAST\" border=\"0px\" " + CR +
    185                "  <img src=\"" + JSP_ICON + "/LAST.gif\" alt=\"LAST\" title=\"LAST\" border=\"0px\" "  + CR +
    186                "    onclick=\"submitPrevNextForm('LAST');\">"  + CR +
    187                "</td>" + CR ;
    188
    189        private static final String TIME_VIEW =         // 4.2.1.0 (2008/04/07) 直接色指定をやめる。
    190                // 8.2.0.2 (2022/06/24) Modify
    191//              "<td><table cellspacing=\"0\" cellpadding=\"0\">"       + CR +
    192//              "<tr>"                                                                                          + CR +
    193//              "<td width=\"20px\"> </td>"                                                     + CR +
    194//              "<td width=\"0px\" id=\"queryTbl\" title=\"\" ></td>" + CR +                    // #ff0000
    195//              "<td width=\"0px\" id=\"viewTbl\"  title=\"\" ></td>" + CR +                    // #0000ff
    196//              "<td width=\"0px\" id=\"pageTbl\"  title=\"\" ></td>" + CR +                    // #00ff00
    197//              "<td width=\"10px\"></td>"                                              + CR +
    198//              "<td style=\"background-color:transparent;\" id=\"totalTbl\"></td>" + CR +
    199                "<td><table style=\"border-spacing:0px;\" >"    + CR +
    200                "<tr>"                                                                                  + CR +
    201                "<td style=\"width:20px; padding:0px;\"> </td>" + CR +
    202                "<td id=\"queryTbl\" title=\"\" ></td>"                 + CR +                                  // #ff0000
    203                "<td id=\"viewTbl\"  title=\"\" ></td>"                 + CR +                                  // #0000ff
    204                "<td id=\"pageTbl\"  title=\"\" ></td>"                 + CR +                                  // #00ff00
    205                "<td style=\"width:10px; padding:0px;\"></td>"  + CR +
    206                "<td id=\"totalTbl\"></td>"                                             + CR +
    207                "</tr>"                                                                                 + CR +
    208                "</table></td>" + CR ;
    209
    210        // 4.3.6.0 (2009/04/01) 件数をボタンで開閉させる
    211        // 6.0.2.4 (2014/10/17) img タグに、title 属性追記
    212        // 7.3.2.3 (2021/04/09) ｼｽﾃﾑ定数のICON_DIRやIMAGE_DIRを使用します。
    213        private static final String COUNT_SWITCH=
    214                "<td>" +
    215//              "  <img id=\"queryHide\" src=\"" + JSP + "/image/expand_r.png\" alt=\"pageSize\" title=\"pageSize\" border=\"0px\" "+   // 5.5.3.2 (2012/06/08)
    216                "  <img id=\"queryHide\" src=\"" + JSP_ICON + "/expand_r.png\" alt=\"pageSize\" title=\"pageSize\" border=\"0px\" "+    // 5.5.3.2 (2012/06/08)
    217                                " onClick=\"hideClass( event, this, 'hide', 'expand_r', 'shrink_r' )\"> "       + CR +
    218                "</td>";
    219
    220        // 6.1.1.0 (2015/01/17) DUMMY_INPUT_TAG は、システム共通で固定値でよい。
    221        // 5.6.1.0 (2013/02/01) display:noneのダミー出力(IEのEnterボタンのための、隠しinput出力)
    222        private static final String DUMMY_INPUT_TAG =
    223                new TagBuffer( "input" )
    224                        .add( "name"    , "HYBS_DUMMY_NPUT" )
    225                        .add( "style"   , "display:none;" )
    226                        .makeTag() ;
    227
    228        // 5.7.6.2 (2014/05/16) IEのHTML5機能が有効か無効かの判定値を飛ばす、hidden タグを作成します。
    229        // 判定方法は、HTML5で新規追加された canvas タグが、有効かどうか(内部メソッドの戻り値があるかどうか)で判定します。
    230        // 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。
    231        private static final String IE_HTML5_CHECK =
    232                        // 8.1.0.0 (2021/12/28) HTML5 準拠に見直し(<script> type属性削除)
    233//                      "<script type=\"text/javascript\">" + CR
    234                        "<script>" + CR
    235                +       "  (function($){" + CR
    236                +       "    var test = document.createElement('canvas');" + CR
    237                +       "    $.support.canvas = !(!test || !test.getContext);" + CR
    238                +       "  })(jQuery);" + CR
    239//              +       "  $('<input/>').attr('type','hidden').attr('name','"
    240                +       "  $('<input>').attr('type','hidden').attr('name','"                                    // 7.0.1.0 (2018/10/15)
    241                +                       HybsSystem.IE_HTML5_KEY
    242                +               "').val( $.support.canvas ).appendTo('form');" + CR
    243                +       "</script>" + CR ;
    244
    245        // 7.4.2.1 (2021/05/21) accesskey の設定の有効(true)/無効(false)を設定します(要再起動)
    246        // 8.0.2.0 (2021/11/30) useAccessKey → USE_ACCESSKEY 変更
    247//      private static final boolean useAccessKey = HybsSystem.sysBool( "USE_ACCESSKEY" );
    248        private static final boolean USE_ACCESSKEY = HybsSystem.sysBool( "USE_ACCESSKEY" );
    249
    250        private String  command         = "NEW";
    251        private String  pageSize        ;
    252        private String  maxRowCount     ;
    253        private String  accesskey       = "F";
    254        private String  useClear        = "true";       // 6.4.3.4 (2016/03/11) つづり間違いを訂正。useCrear → useClear
    255
    256        private String  type            ;                       // null:標準 , SELECT:検索ボタンのみ , ENTRY:登録ボタンのみ
    257        private String  scope           ;
    258        private boolean usePrevNext     = true;
    259        private boolean usePageSize     = true;
    260        private boolean useRowCount     = true;
    261        private boolean useTimeView     = HybsSystem.sysBool( "VIEW_USE_TIMEBAR" );             // 6.3.6.0 (2015/08/16)
    262        private String  body            ;
    263        private String  clearAcskey     = "C";
    264        // 6.9.5.0 (2018/04/23) USE_DUMMY_INPUT 廃止(false固定)
    265//      private boolean useDummy        = HybsSystem.sysBool( "USE_DUMMY_INPUT" );              // 5.6.1.0 (2013/02/01)
    266        private boolean useDummy        ;                               // 6.9.5.0 (2018/04/23) USE_DUMMY_INPUT 廃止(false固定)
    267        private boolean useEditMenu     = true;                 // 5.7.5.0 (2014/04/04) 編集プルダウンを出すかどうか(初期値:true)。
    268        private String  blockUIMsg      = "MSG0090";    // 6.4.8.0 (2016/06/24) 検索中です・・・
    269
    270        private String  clearTarget             = "QUERY";              // 5.9.21.1 (2017/06/16) クリアボタンのターゲット
    271        private String  clearHref               = "query.jsp";  // 5.9.21.1 (2017/06/16) クリアボタンの遷移アドレス
    272        private String  clearCommand    = "NEW";                // 5.9.21.1 (2017/06/16) クリア時のコマンド
    273        private String[]        clearKeys       ;                               // 7.0.3.0 (2019/05/13) クリア時の遷移先に渡すキー
    274        private String[]        clearVals       ;                               // 7.0.3.0 (2019/05/13) クリア時の遷移先に渡す値
    275
    276        /**
    277         * デフォルトコンストラクター
    278         *
    279         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    280         */
    281        public QueryButtonTag() { super(); }            // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    282
    283        /**
    284         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
    285         *
    286         * @og.rev 6.3.4.0 (2015/08/01) caseKey,caseVal,caseNN,caseNull,caseIf 属性対応
    287         *
    288         * @return      後続処理の指示( EVAL_BODY_BUFFERED )
    289         */
    290        @Override
    291        public int doStartTag() {
    292                // 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
    293                // 反転注意
    294                return useTag() ? EVAL_BODY_BUFFERED : SKIP_BODY ;
    295        }
    296
    297        /**
    298         * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
    299         *
    300         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
    301         * @og.rev 3.0.0.0 (2002/12/25) StringUtil#changeString 廃止
    302         * @og.rev 3.1.1.0 (2003/03/28) ボディの内容を取得する処理を、CommonTagSupport で行う。
    303         *
    304         * @return      後続処理の指示(SKIP_BODY)
    305         */
    306        @Override
    307        public int doAfterBody() {
    308                body = nval( getBodyString(),body );
    309
    310                return SKIP_BODY ;
    311        }
    312
    313        /**
    314         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    315         *
    316         * @og.rev 5.3.6.0 (2011/06/01) 集計、合計などのEdit機能に対応します。
    317         * @og.rev 5.6.5.1 (2013/06/14) debugプルダウンの追加。ついでに、PageSize と MaxRowCount の 表示条件を、整備します。
    318         * @og.rev 5.6.9.4 (2013/10/31) editNameの初期値を外部から与えられるようにする
    319         * @og.rev 5.7.1.0 (2013/12/06) HTMLTagSupportを継承する為、メソッドを、getSubmit() ⇒ makeTag() に変更
    320         * @og.rev 5.7.1.2 (2013/12/20) USE_DEFAULT_EDITNAMEでeditNameの初期値変更
    321         * @og.rev 5.7.5.0 (2014/04/04) useEditMenu 追加
    322         * @og.rev 5.7.6.2 (2014/05/16) IEのHTML5機能が有効か無効かの判定値を飛ばす、hidden タグを作成します。
    323         * @og.rev 6.3.4.0 (2015/08/01) caseKey,caseVal,caseNN,caseNull,caseIf 属性対応
    324         * @og.rev 6.4.5.0 (2016/04/08) UserInfo のEditConfig関連機能を、DBEditConfigManagerに移植します。
    325         * @og.rev 5.9.12.0 (2016/09/02) tableのframe属性を削除する
    326         * @og.rev 6.9.2.1 (2018/03/12) DBEditConfigManagerを直接取り出す処理を、廃止します。
    327         * @og.rev 8.2.0.2 (2022/06/24) HTML5廃止対応
    328         *
    329         * @return      後続処理の指示
    330         */
    331        @Override
    332        public int doEndTag() {
    333                debugPrint();           // 4.0.0 (2005/02/28)
    334                if( !useTag() ) { return EVAL_PAGE ; }  // 6.3.4.0 (2015/08/01)
    335
    336                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
    337                        .append( getHiddenScope() ).append( CR )
    338//                      .append( "<table border=\"0\" summary=\"submit\" ><tr>" )                                               // 5.9.12.0 (2016/090/02)
    339                        .append( "<table border=\"0\" ><tr>" )                                                                                  // 8.2.0.2 (2022/06/24) Modify
    340                        .append( CR )
    341                        .append( "<td>" ).append( makeTag()             ).append( "</td>" ).append( CR )                // 5.7.1.0 (2013/12/06)
    342                        .append( "<td>" ).append( getReset()    ).append( "</td>" ).append( CR )
    343                        .append( "<td>" ).append( getCommand()  ).append( "</td>" ).append( CR )
    344                        .append( "<td>" ).append( getGamenId()  ).append( "</td>" ).append( CR );
    345                if( usePrevNext ) { buf.append( PREV_NEXT       ).append( CR ); }
    346                buf.append( "<td><span id=\"query-button-append\"></span></td>").append( CR );          //4 3.6.0 (2009/04/01)
    347                // if( usePageSize ) { buf.append( getPageSize()        ).append( CR ); }
    348                // if( useRowCount ) { buf.append( getMaxRowCount()).append( CR ); }
    349                if( body != null ) {
    350                        buf.append( "<td>" ).append( body ).append( "</td>" ).append( CR );
    351                }
    352
    353                // 5.7.5.0 (2014/04/04) useEditMenu 追加。trueで、編集プルダウンを出力します。
    354                if( useEditMenu ) {
    355                        // 6.9.2.1 (2018/03/12) DBEditConfigManagerを直接取り出す処理を、廃止します。
    356//                      final DBEditConfigManager dbConfMgr = getUser().getEditConfigManager();         // 6.4.5.0 (2016/04/08)
    357
    358                        // 5.3.6.0 (2011/06/01) 集計、合計などのEdit機能に対応します。
    359                        final String guikey = getGUIInfoAttri( "KEY" );
    360                        // 6.1.0.0 (2014/12/26) findBugs: null ではなく長さが0の配列を返す。
    361                        // 6.9.2.1 (2018/03/12) DBEditConfigManagerを直接取り出す処理を、廃止します。
    362//                      final DBEditConfig[] configs = dbConfMgr.getEditConfigs( guikey );
    363                        final DBEditConfig[] configs = getUser().getEditConfigs( guikey );
    364                        if( configs.length > 0 ) {
    365        //                      String selEditName = getUser().getSelectedEdit( getGUIInfoAttri( "KEY" ) );
    366        //                      String selEditName = nval( getRequestValue( "editName" ) , getUser().getSelectedEdit( getGUIInfoAttri( "KEY" ) ));      // 5.6.9.4 (2013/10/31)
    367                                String selEditName ; // 5.7.1.2 (2013/12/20)
    368                                if( "FALSE".equalsIgnoreCase( sys( "USE_DEFAULT_EDITNAME" ) ) ){
    369                                        selEditName = getRequestValue( "editName" );
    370                                }
    371                                else{
    372                                        selEditName = nval( getRequestValue( "editName" ) , getUser().getSelectedEdit( guikey ));                                               // 5.6.9.4 (2013/10/31)
    373        //                              selEditName = nval( getRequestValue( "editName" ) , dbConfMgr.getSelectedEdit( guikey ) );                                              // 6.4.5.0 (2016/04/08)
    374                                }
    375                                buf.append( getEditSelect( configs, selEditName ) ).append( CR );
    376                        }
    377                }
    378
    379                // 5.6.5.1 (2013/06/14) debugプルダウンの追加。ついでに、PageSize と MaxRowCount の 表示条件を、整備します。
    380                if( usePageSize || useRowCount) {
    381                        buf.append( COUNT_SWITCH ).append( CR );
    382                        if( usePageSize ) { buf.append( getPageSize()   ).append( CR ); }
    383                        if( useRowCount ) { buf.append( getMaxRowCount()).append( CR ); }
    384                        // デバッグは、ユーザーのロールが、root の場合のみ表示するようにします。
    385                        if( "root".equalsIgnoreCase( getUser().getRoles() ) ) {
    386                                buf.append( getDebugClm() ).append( CR );                                               // 5.6.5.1 (2013/06/14) debugプルダウンの追加
    387                        }
    388                }
    389
    390                if( useTimeView ) { buf.append( TIME_VIEW ).append( CR ); }
    391
    392                buf.append( "</tr></table>" ).append( CR );
    393
    394                // 5.7.6.2 (2014/05/16) IEのHTML5機能が有効か無効かの判定値を飛ばす、hidden タグを作成します。
    395                // IE_HTML5_KEY をキーとする設定値がなければ、まだ未設定なので、hidden タグを作成します。
    396                if( getSessionAttribute( HybsSystem.IE_HTML5_KEY ) == null ) {
    397                        buf.append( IE_HTML5_CHECK );
    398                }
    399
    400                jspPrint( buf.toString() );
    401                if( useDummy ){ jspPrint( DUMMY_INPUT_TAG ); }  // 6.1.1.0 (2015/01/17) 固定値でよい
    402
    403                return EVAL_PAGE ;              // ページの残りを評価する。
    404        }
    405
    406        /**
    407         * タグリブオブジェクトをリリースします。
    408         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
    409         *
    410         * @og.rev 5.6.1.0 (2013/02/01) useDummy 追加
    411         * @og.rev 5.7.5.0 (2014/04/04) useEditMenu 追加
    412         * @og.rev 6.3.6.0 (2015/08/16) useTimeView の初期値を、VIEW_USE_TIMEBAR にする。
    413         * @og.rev 6.4.0.5 (2016/01/09) true/false に加えて、none:表示しない を追加。
    414         * @og.rev 6.4.8.0 (2016/06/24) blockUIMsg を追加。 検索中です・・・
    415         * @og.rev 5.9.21.1 (2017/06/16) clearTarget , clearHref , clearCommand追加
    416         * @og.rev 6.9.5.0 (2018/04/23) USE_DUMMY_INPUT 廃止(false固定)
    417         * @og.rev 7.0.3.0 (2019/05/13) clearKeys , clearVals属性を追加
    418         */
    419        @Override
    420        protected void release2() {
    421                super.release2();
    422                command                 = "NEW";
    423                pageSize                = null;
    424                maxRowCount             = null;
    425                accesskey               = "F";
    426                useClear                = "true";       // 6.4.0.5 (2016/01/09) true/false に加えて、none:表示しない を追加。
    427                scope                   = null;
    428                usePrevNext             = true;
    429                usePageSize             = true;
    430                useRowCount             = true;
    431                useTimeView             = HybsSystem.sysBool( "VIEW_USE_TIMEBAR" );     // 6.3.6.0 (2015/08/16)
    432                clearAcskey             = "C";                                                                          // 5.3.5.0 (2011/05/01) クリアボタンアクセスキー対応
    433//              useDummy                = HybsSystem.sysBool( "USE_DUMMY_INPUT" );      // 5.6.1.0 (2013/02/01)
    434                useDummy                = false;                                                                        // 6.9.5.0 (2018/04/23) USE_DUMMY_INPUT 廃止(false固定)
    435                useEditMenu             = true;                                                                         // 5.7.5.0 (2014/04/04) 編集プルダウンを出すかどうか(初期値:true)。
    436                blockUIMsg              = "MSG0090";    // 6.4.8.0 (2016/06/24) 検索中です・・・
    437                clearTarget             = "QUERY";              // 5.9.21.1 (2017/06/16) クリアボタンのターゲット
    438                clearHref               = "query.jsp";  // 5.9.21.1 (2017/06/16)
    439                clearCommand    = "NEW";                // 5.9.21.1 (2017/06/16)
    440                clearKeys               = null;                 // 7.0.3.0 (2019/05/13) クリア時の遷移先に渡すキー
    441                clearVals               = null;                 // 7.0.3.0 (2019/05/13) クリア時の遷移先に渡す値
    442        }
    443
    444        /**
    445         * サブミットボタンを作成します。
    446         *
    447         * @og.rev 5.3.6.0 (2011/06/01) accessKeyを削除できるように対応
    448         * @og.rev 5.5.7.1 (2012/10/05) 不要な括弧出力を削除
    449         * @og.rev 5.6.9.3 (2013/10/25) IDを出力する
    450         * @og.rev 5.7.1.0 (2013/12/06) HTMLTagSupportを継承する為、メソッドを、getSubmit() ⇒ makeTag() に変更
    451         * @og.rev 6.2.2.0 (2015/03/27) 互換モード／ネイティブモード対応。検索ボタンをbutton→input に変更
    452         * @og.rev 6.4.8.0 (2016/06/24) blockUIMsg を追加。 検索中です・・・
    453         * @og.rev 7.4.2.1 (2021/05/21) accesskey の設定の有効(true)/無効(false)を設定
    454         * @og.rev 8.0.2.0 (2021/11/30) useAccessKey → USE_ACCESSKEY 変更
    455         *
    456         * @return      サブミットボタン
    457         * @og.rtnNotNull
    458         */
    459        @Override
    460        protected String makeTag() {
    461                String msglbl = getLongLabel();         // 4.0.0 (2005/01/31)
    462                if( msglbl == null ) {
    463                        if( "ENTRY".equalsIgnoreCase( type ) ) {
    464                                msglbl = getLabel( "ENTRY" );
    465                        }
    466                        else {
    467                                msglbl = getLabel( "QUERY" );
    468                        }
    469                }
    470
    471                // 5.7.1.0 (2013/12/06) XHTMLTag を使用することで、各種属性を追加できるようにします。
    472//              if( accesskey != null ) {
    473//              if( useAccessKey && accesskey != null ) {               // 7.4.2.1 (2021/05/21)
    474                if( USE_ACCESSKEY && accesskey != null ) {              // 8.0.2.0 (2021/11/30)
    475                        set( "accesskey" , accesskey );
    476                        msglbl = msglbl + "(" + accesskey + ")" ;
    477                }
    478
    479                // 6.4.8.0 (2016/06/24) blockUIMsg を追加。 検索中です・・・
    480                if( blockUIMsg != null && !blockUIMsg.isEmpty() ) {
    481                        final String uiMsg = getResource().getLabel( blockUIMsg );
    482                        set( "alt" , uiMsg );
    483                }
    484
    485                set( "type"     , "submit" );
    486                set( "id"       , "queryButtonSubmit" );
    487                // 6.2.2.0 (2015/03/27) 互換モード／ネイティブモード対応。検索ボタンをbutton→input に変更
    488                set( "value", msglbl );                                                 // 6.2.2.0 (2015/03/27)
    489
    490                return XHTMLTag.input( getAttributes() );               // 6.2.2.0 (2015/03/27)
    491        }
    492
    493        /**
    494         * リセットボタンを作成します。
    495         *
    496         * @og.rev 4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage ⇒ getResource().getLabel )
    497         * @og.rev 5.0.2.0 (2009/11/01) 戻るボタンが出力されている状態で、クリアボタンを押すと、戻るボタンが消える不具合を修正
    498         * @og.rev 5.3.5.0 (2011/05/01) クリアボタンにもアクセスキーが付加できるように対応
    499         * @og.rev 5.3.6.0 (2011/06/01) accessKeyを削除できるように対応
    500         * @og.rev 6.2.2.0 (2015/03/27) 互換モード／ネイティブモード対応。クリアボタンをbutton→input に変更
    501         * @og.rev 6.4.0.5 (2016/01/09) true/false に加えて、none:表示しない を追加。
    502         * @og.rev 5.9.21.1 (2017/06/16) クリアボタンのターゲットとページを変更可能にする
    503         * @og.rev 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。
    504         * @og.rev 7.0.3.0 (2019/05/13) clearKeys , clearVals属性を追加
    505         * @og.rev 7.4.2.1 (2021/05/21) accesskey の設定の有効(true)/無効(false)を設定
    506         * @og.rev 8.0.2.0 (2021/11/30) useAccessKey → USE_ACCESSKEY 変更
    507         *
    508         * @return      リセットボタン
    509         * @og.rtnNotNull
    510         */
    511        private String getReset() {
    512                final String rtn ;
    513
    514//              final boolean noAccs = !useAccessKey || clearAcskey == null ;                           // 7.4.2.1 (2021/05/21)
    515                final boolean noAccs = !USE_ACCESSKEY || clearAcskey == null ;                          // 8.0.2.0 (2021/11/30)
    516
    517                // 6.4.0.5 (2016/01/09) true/false に加えて、none:表示しない を追加。
    518                if( "true".equalsIgnoreCase( useClear ) ) {
    519                        final String urlEnc = XHTMLTag.urlEncode( clearKeys,clearVals );                // 7.0.3.0 (2019/05/13)
    520
    521                        final char ch = clearHref.indexOf( '?' ) < 0 ? '?' : '&' ;                              // 連結文字列
    522
    523                        rtn = "<input type=\"button\" onClick=\"window.open('" + JSP + '/' + getGUIInfoAttri( "ADDRESS" ) +
    524                                '/' + clearHref + ch + "GAMENID=" + getGUIInfoAttri( "KEY" ) +
    525                                ( urlEnc.isEmpty() ? "" : "&" + urlEnc ) +                                                      // 7.0.3.0 (2019/05/13)
    526                                "&command=" + clearCommand + "','" + clearTarget +"')\" " +                     // 5.9.21.1 (2017/06/16)
    527//                              ( clearAcskey == null ? "" : "accesskey=\"" + clearAcskey + '"' ) +
    528                                ( noAccs ? "" : "accesskey=\"" + clearAcskey + '"' ) +                          // 7.4.2.1 (2021/05/21)
    529                                " value=\"" + getResource().getLabel( "MSG0011" ) +
    530//                              ( clearAcskey == null ? "" : '(' + clearAcskey + ')' ) +
    531                                ( noAccs ? "" : '(' + clearAcskey + ')' ) +                                                     // 7.4.2.1 (2021/05/21)
    532//                              "\" />" ;
    533                                "\" >" ;                        // 7.0.1.0 (2018/10/15)
    534                }
    535                else if( "false".equalsIgnoreCase( useClear ) ) {
    536                        rtn = "<input type=\"reset\" " +
    537//                              ( clearAcskey == null ? "" : "accesskey=\"" + clearAcskey + '"' ) +
    538                                ( noAccs ? "" : "accesskey=\"" + clearAcskey + '"' ) +                          // 7.4.2.1 (2021/05/21)
    539                                " value=\"" + getResource().getLabel( "MSG0011" ) +
    540//                              ( clearAcskey == null ? "" : '(' + clearAcskey + ')' ) +
    541                                ( noAccs ? "" : '(' + clearAcskey + ')' ) +                                                     // 7.4.2.1 (2021/05/21)
    542//                              "\" />" ;
    543                                "\" >" ;                        // 7.0.1.0 (2018/10/15)
    544                }
    545                else {                                          // "none" を想定
    546                        rtn = "" ;                              // none:表示しない
    547                }
    548
    549                return rtn;
    550        }
    551
    552        /**
    553         * コマンドを出力する hidden を作成します。
    554         *
    555         * @og.rev 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。
    556         *
    557         * @return      コマンドを出力する hidden
    558         * @og.rtnNotNull
    559         */
    560        private String getCommand() {
    561                // 6.1.1.0 (2015/01/17) refactoring. ロジックを見直します。
    562
    563                return "NEW".equals( command )
    564                                        ? COMMAND
    565                                        : "<input type=\"hidden\" name=\"command\" value=\"" +
    566//                                              command + "\" id=\"h_cmd\" />" ;
    567                                                command + "\" id=\"h_cmd\" >" ;                 // 7.0.1.0 (2018/10/15)
    568        }
    569
    570        /**
    571         * スコープを出力する hidden を作成します。
    572         *
    573         * @og.rev 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。
    574         *
    575         * @return      スコープを出力する hidden
    576         * @og.rtnNotNull
    577         */
    578        private String getHiddenScope() {
    579                // 6.1.1.0 (2015/01/17) refactoring. ロジックを見直します。
    580
    581                return scope == null
    582                                ? ""
    583                                : "<input type=\"hidden\" name=\"scope\" value=\"" +
    584//                                              scope + "\" />" ;
    585                                                scope + "\" >" ;                                                // 7.0.1.0 (2018/10/15)
    586        }
    587
    588        /**
    589         * 画面IDを出力する hidden を作成します。
    590         *
    591         * @og.rev 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"／＞" 止めを、"＞" に変更します)。
    592         *
    593         * @return      画面IDを出力する hidden
    594         * @og.rtnNotNull
    595         */
    596        private String getGamenId() {
    597                // 6.1.1.0 (2015/01/17) refactoring. ロジックを見直します。
    598                return "<input type=\"hidden\" name=\"GAMENID\" value=\"" +
    599//                                              getGUIInfoAttri("KEY") + "\" />";
    600                                                getGUIInfoAttri("KEY") + "\" >";                // 7.0.1.0 (2018/10/15)
    601        }
    602
    603        /**
    604         * ページサイズプルダウンメニューを作成します。
    605         *
    606         * @og.rev 4.3.6.0 (2008/04/01) idとclassの変更
    607         *
    608         * @return      ページサイズプルダウンメニュー
    609         * @og.rtnNotNull
    610         */
    611        private String getPageSize() {
    612                if( pageSize == null ) {
    613                        final String PAGESIZE  = sys( "HTML_PAGESIZE" );
    614                        pageSize = nval( getRequestValue( "pageSize" ),PAGESIZE ) ;
    615                }
    616
    617                final DBColumn column = getDBColumn( "pageSize" );
    618                final String tag = column.getEditorValue( pageSize );
    619
    620                // return ( "<td id=\"label\">" +
    621                return "<td class=\"label pageSize hide\">"                                     // 4.3.6.0 (2008/04/01) class出力
    622                                +       column.getLongLabel()
    623                                +       ":</td><td class=\"pageSize hide\">" + tag + "</td>" ;
    624        }
    625
    626        /**
    627         * 検索時の最大検索数のプルダウンメニューを作成します。
    628         *
    629         * @og.rev 4.3.6.0 (2008/04/01) idとclassの変更
    630         *
    631         * @return      最大検索数のプルダウンメニュー
    632         * @og.rtnNotNull
    633         */
    634        private String getMaxRowCount() {
    635                if( maxRowCount == null ) {
    636                        final String ROW_COUNT = sys( "DB_MAX_ROW_COUNT" );
    637                        maxRowCount = nval( getRequestValue( "maxRowCount" ), ROW_COUNT ) ;
    638                }
    639
    640                final DBColumn column = getDBColumn( "maxRowCount" );
    641                final String tag = column.getEditorValue( maxRowCount );
    642
    643                // return ( "<td id=\"label\">" +
    644                return "<td class=\"label maxRowCount hide\">"                  // 4.3.6.0 (2008/04/01) class出力
    645                                +       column.getLongLabel()
    646                                +       ":</td><td class=\"maxRowCount hide\">" + tag + "</td>" ;
    647        }
    648
    649        /**
    650         *  debugプルダウンメニューを作成します。
    651         *
    652         * @og.rev 5.6.5.1 (2013/06/14) 新規追加
    653         *
    654         * @return      debugプルダウンメニュー
    655         * @og.rtnNotNull
    656         */
    657        private String getDebugClm() {
    658                final DBColumn column = getDBColumn( "debug" );
    659                final String tag = column.getEditorValue( "false" );
    660
    661                return "<td class=\"label debug hide\">"
    662                                +       column.getLongLabel()
    663                                +       ":</td><td class=\"debug hide\">" + tag + "</td>" ;
    664        }
    665
    666        /**
    667         * 編集名一覧のプルダウンメニューを作成します。
    668         *
    669         * @og.rev 5.3.6.0 (2011/06/01) 新規追加
    670         * @og.rev 5.9.1.2 (2015/10/23) 自己終了タグ修正
    671         *
    672         * @param configs 編集名一覧(配列)
    673         * @param selEditName 選択中の編集名
    674         *
    675         * @return      編集名一覧のプルダウン
    676         * @og.rtnNotNull
    677         */
    678        private String getEditSelect( final DBEditConfig[] configs, final String selEditName ) {
    679                final DBColumn column = getDBColumn( "editName" );
    680
    681                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
    682                        .append( "<td class=\"label editName\">" )
    683                        .append( column.getLongLabel() )
    684                        .append( ":</td><td class=\"editName\">" )
    685                        .append( "<select name=\"editName\">" )
    686                        .append( "<option><!-- --></option>" ); // 5.9.1.2 (2015/10/23)
    687
    688                for( final DBEditConfig config : configs ) {
    689                        final String name = config.getEditName();
    690                        if( name != null && name.length() > 0 ) {
    691                                buf.append( "<option value=\"" ).append( name ).append( '"' );          // 6.0.2.5 (2014/10/31) char を append する。
    692                                if( config.isCommon() ) {
    693                                        buf.append( " class=\"commonEdit\"" );
    694                                }
    695                                if( name.equals( selEditName ) ) {
    696                                        buf.append( " selected" );
    697                                }
    698                                buf.append( '>' ).append( name ).append( "</option>" );                         // 6.0.2.5 (2014/10/31) char を append する。
    699                        }
    700                }
    701                buf.append( "</select></td>" );
    702                return buf.toString();
    703        }
    704
    705        /**
    706         * 【TAG】リクエストとして送信するコマンドを指定します(初期値:NEW)。
    707         *
    708         * @og.tag
    709         *  NEW:通常の検索(初期値)／ENTRY:エントリ登録時
    710         *
    711         * @param       cmd     送信するコマンド
    712         */
    713        public void setCommand( final String cmd ) {
    714                command = nval( getRequestParameter( cmd ),command );
    715        }
    716
    717        /**
    718         * 【TAG】JavaScriptによる初期化(クリア)ボタンを使用するかどうか[true/false/none]を指定します(初期値:true)。
    719         *
    720         * @og.tag
    721         * 通常の初期化(クリア)ボタンでは、HTMLが作成された状態に戻すだけです。
    722         * 例えば、引数付きで設定された場合、その引数が設定されている状態へ戻します。
    723         * このJavaScriptによる初期化ボタンの場合(trueの場合)は、JavaScriptにより
    724         * INIT状態でもう一度QUERYフレームを呼び出しますので、指定された引数もクリアされます。
    725         * none を指定すると、クリアボタンを表示しません。
    726         *
    727         * true:  JavaScriptによる初期化ボタン(すべての引数がクリアされます)
    728         * false: HTMLによる RESET処理(type="reset" のinputタグが出力されます。)
    729         * none:  クリアボタンを表示しません。 (※ 6.4.0.5 (2016/01/09) 以降 )
    730         *
    731         * 初期値は、true:JavaScriptによる初期化です。
    732         *
    733         * @og.rev 6.4.0.5 (2016/01/09) true/false に加えて、none:表示しない を追加。
    734         * @og.rev 6.4.3.4 (2016/03/11) つづり間違いを訂正。useCrear → useClear。
    735         *
    736         * @param   flag JavaScriptによる初期化ボタン使用可否 [true:JavaScript初期化ボタン/false:通常のresetボタン]
    737         */
    738        public void setUseClear( final String flag ) {
    739                useClear = nval( getRequestParameter( flag ),useClear );
    740
    741                // 6.4.0.5 (2016/01/09) true/false に加えて、none:表示しない を追加。
    742                if( useClear != null &&
    743                        !"true".equalsIgnoreCase( useClear ) &&
    744                        !"false".equalsIgnoreCase( useClear ) &&
    745                        !"none".equalsIgnoreCase( useClear ) ) {
    746                                final String errMsg = "useClear は、[true:全クリア/false:リセット/none:表示しない] から選んでください。"
    747                                                                + "useClear=[" + flag + "]" + CR ;
    748                                throw new HybsSystemException( errMsg );
    749                }
    750        }
    751
    752//      /**
    753//       * 【廃止】JavaScriptによる初期化(クリア)ボタンを使用するかどうか[true/false/none]を指定します(初期値:true)。
    754//       *
    755//       * @og.tag
    756//       * 通常の初期化(クリア)ボタンでは、HTMLが作成された状態に戻すだけです。
    757//       * 例えば、引数付きで設定された場合、その引数が設定されている状態へ戻します。
    758//       * このJavaScriptによる初期化ボタンの場合(trueの場合)は、JavaScriptにより
    759//       * INIT状態でもう一度QUERYフレームを呼び出しますので、指定された引数もクリアされます。
    760//       * none を指定すると、クリアボタンを表示しません。
    761//       *
    762//       * true:  JavaScriptによる初期化ボタン(すべての引数がクリアされます)
    763//       * false: HTMLによる RESET処理(type="reset" のinputタグが出力されます。)
    764//       * none:  クリアボタンを表示しません。 (※ 6.4.0.5 (2016/01/09) 以降 )
    765//       *
    766//       * 初期値は、true:JavaScriptによる初期化です。
    767//       *
    768//       * @og.rev 6.4.0.5 (2016/01/09) true/false に加えて、none:表示しない を追加。
    769//       * @og.rev 6.4.3.4 (2016/03/11) つづり間違いを訂正。useCrear → useClear。
    770//       *
    771//       * @param   flag JavaScriptによる初期化ボタン使用可否 [true:JavaScript初期化ボタン/false:通常のresetボタン]
    772//       */
    773//      public void setUseCrear( final String flag ) {
    774//              setUseClear( flag );
    775//      }
    776
    777        /**
    778         * 【TAG】useClear時のターゲットを指定します(初期値=QUERY)。
    779         *
    780         * @og.tag
    781         * useClearをtrueにしている場合、window.openを利用した初期化を行います。
    782         * この際に検索部分の名称がQUERY以外の場合にこの属性で指定します。
    783         * 初期値はQUERYです。
    784         *
    785         * @og.rev 5.9.21.1 (2017/06/16) 新規追加
    786         *
    787         * @param   tgt ターゲット名
    788         */
    789        public void setClearTarget( final String tgt ) {
    790                clearTarget = nval( getRequestParameter( tgt ), clearTarget );
    791        }
    792
    793        /**
    794         * 【TAG】useClear時の遷移先を指定します(初期値=query.jsp)。
    795         *
    796         * @og.tag
    797         * useClearをtrueにしている場合、window.openを利用した初期化を行います。
    798         * この際に検索画面のURLがquery.jspでない場合にこの属性で指定します。
    799         * また、query.jsp でも、特定の値を再設定したい場合、query.jsp?KEY=VALUE という
    800         * 記述が可能です。指定のキーだけ、クリアしないということが出来るようになります。
    801         * 初期値はquery.jspです。
    802         *
    803         * @og.rev 5.9.21.1 (2017/06/16) 新規追加
    804         *
    805         * @param   page 遷移先
    806         */
    807        public void setClearHref( final String page ) {
    808                clearHref = nval( getRequestParameter( page ), clearHref );
    809        }
    810
    811        /**
    812         * 【TAG】useClear時のcommandを指定します(初期値=NEW)。
    813         *
    814         * @og.tag
    815         * useClearをtrueにしている場合、window.openを利用した初期化を行います。
    816         * この際に読み込む画面に対してcommand=NEW以外を送信したい場合にこの属性で指定します。
    817         * 初期値はNEWです。
    818         *
    819         * @og.rev 5.9.21.1 (2017/06/16) 新規追加
    820         *
    821         * @param   cmd コマンド
    822         */
    823        public void setClearCommand( final String cmd ) {
    824                clearCommand = nval( getRequestParameter( cmd ), clearCommand );
    825        }
    826
    827        /**
    828         * 【TAG】useClear=true時の遷移先に渡すキーをCSV形式で複数指定します。
    829         *
    830         * @og.tag 遷移先に渡すキーを指定します。
    831         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
    832         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
    833         *
    834         * @og.rev 7.0.3.0 (2019/05/13) clearKeys , clearVals属性を追加
    835         *
    836         * @param       key キー(CSV形式)
    837         */
    838        public void setClearKeys( final String key ) {
    839                clearKeys = getCSVParameter( key );
    840        }
    841
    842        /**
    843         * 【TAG】useClear=true時の遷移先に渡す値をCSV形式で複数指定します。
    844         *
    845         * @og.tag 遷移先に渡す値を指定します。
    846         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
    847         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
    848         * keys,vals を使用すると、URLエンコードされます。
    849         *
    850         * @og.rev 7.0.3.0 (2019/05/13) clearKeys , clearVals属性を追加
    851         *
    852         * @param       val 値(CSV形式)
    853         */
    854        public void setClearVals( final String val ) {
    855                clearVals = getCSVParameter( val );
    856        }
    857
    858        /**
    859         * 【TAG】典型的なボタンの形状に設定します(初期値:null)。
    860         *
    861         * @og.tag
    862         * クエリーボタンでは、検索ボタン以外に、pageSize、maxRowCount、
    863         * prevNext、timeView などの項目も表示可能です。
    864         * これらを、個別に設定可能ですが、通常使用するタイプとして、３タイプを
    865         * 用意します。これは、設定状態の初期値といえます。
    866         * null  :通常の検索ボタンで、フル装備の指定です。
    867         * SELECT:１件のみ検索するようなケースで使用します。
    868         *        検索ボタンとクリアボタンのみを表示します。
    869         * ENTRY :いきなり登録するようなケースで使用します。
    870         *        登録ボタンとクリアボタンのみを表示します。(command="NEW" です。)
    871         *
    872         * @og.rev 6.4.0.5 (2016/01/09) accesskey="" が効かなかったので、対応。
    873         * @og.rev 7.4.2.1 (2021/05/21) accesskey の設定の有効(true)/無効(false)を設定
    874         * @og.rev 8.0.2.0 (2021/11/30) useAccessKey → USE_ACCESSKEY 変更
    875         *
    876         * @param       tp      タイプ指定 [null/SELECT/ENTRY]
    877         */
    878        public void setType( final String tp ) {
    879                type = nval( getRequestParameter( tp ),type );
    880
    881                // 6.4.0.5 (2016/01/09) accesskey="" が効かなかったので、対応。
    882                // accesskey の初期値が "F" なので、ENTRYの場合のみ、"F" のときは "W" に変更します。
    883
    884                if( "SELECT".equalsIgnoreCase( type ) ) {
    885                        usePrevNext     = false;
    886                        usePageSize     = false;
    887                        useRowCount     = false;
    888                        useTimeView     = false;
    889                }
    890                else if( "ENTRY".equalsIgnoreCase( type ) ) {
    891//                      if( "F".equals( accesskey ) ) { accesskey = "W"; }                                              // ENTRYの場合は、"F" の場合のみ、"W" に置き換えます。
    892//                      if( useAccessKey && "F".equals( accesskey ) ) { accesskey = "W"; }              // ENTRYの場合は、"F" の場合のみ、"W" に置き換えます。
    893                        if( USE_ACCESSKEY && "F".equals( accesskey ) ) { accesskey = "W"; }             // ENTRYの場合は、"F" の場合のみ、"W" に置き換えます。
    894                        usePrevNext     = false;
    895                        usePageSize     = false;
    896                        useRowCount     = false;
    897                        useTimeView     = false;
    898                }
    899        }
    900
    901        /**
    902         * 【TAG】リクエストとして送信するスコープを指定します(初期値:null)。
    903         *
    904         * @og.tag
    905         * リクエスト時に、付与する引数情報のうちの、スコープを指定します。
    906         * これは、検索専用画面の場合は、scope="request" にする事で、メモリの
    907         * 無駄な確保を行わずに、検索結果を表示できます。
    908         * ただし、その結果に対して、NEXT-PREV や、ヘッダーソートリンクなどの
    909         * 機能が使えなくなります。
    910         * 通常は、何も指定しない状態(null)で、RESULT画面の設定に任せるのが良いでしょう。
    911         * 初期値は、null = session(セッション登録) です。
    912         *
    913         * @param   scp スコープ [session:セッション登録/request:リクエスト登録]
    914         */
    915        @Override
    916        public void setScope( final String scp ) {
    917                scope = nval( getRequestParameter( scp ),scope );
    918        }
    919
    920        /**
    921         * 【TAG】検索ボタンに使用するショートカットキー文字を指定します(初期値:F)。
    922         *
    923         * @og.tag
    924         * ボタンを、Alt-XX で実行できるようにするショートカットキーを設定します。
    925         * 標準では、検索ボタンは、"F" に設定していますので、Alt-F となります。
    926         * ゼロ文字列を指定すると、ショートカットキーなしに設定できます。
    927         * 初期値は、Find の "F" です。
    928         *
    929         * 7.4.2.1 (2021/05/21)
    930         *   ｼｽﾃﾑ定数 USE_ACCESSKEY を false に設定すると、accesskey は使用されません。
    931         *
    932         * @og.rev 5.3.6.0 (2011/06/01) accessKeyを削除できるように対応
    933         * @og.rev 5.6.0.3 (2012/01/24) getRequestParameter を何度も呼んでいるので修正。
    934         * @og.rev 7.4.2.1 (2021/05/21) accesskey の設定の有効(true)/無効(false)を設定
    935         * @og.rev 8.0.2.0 (2021/11/30) useAccessKey → USE_ACCESSKEY 変更
    936         *
    937         * @param       accsKey ショートカットキー文字(初期値:F)
    938         */
    939        @Override
    940        public void setAccesskey( final String accsKey ) {
    941//              if( useAccessKey ) {
    942                if( USE_ACCESSKEY ) {
    943                        final String val = getRequestParameter( accsKey );
    944                        if( val == null || val.isEmpty() ) {
    945                                accesskey = null;
    946                        }
    947                        else {
    948                                accesskey = val;                                                                // 5.6.0.3 (2012/01/24)
    949                        }
    950                }
    951        }
    952
    953        /**
    954         * 【TAG】クリアボタンに使用するショートカットキー文字を指定します(初期値:C)。
    955         *
    956         * @og.tag
    957         * ボタンを、Alt-XX で実行できるようにするショートカットキーを設定します。
    958         * 標準では、検索ボタンは、"C" に設定していますので、Alt-C となります。
    959         * ゼロ文字列を指定すると、ショートカットキーなしに設定できます。
    960         * 初期値は、Clear の "C" です。
    961         *
    962         * 7.4.2.1 (2021/05/21)
    963         *   ｼｽﾃﾑ定数 USE_ACCESSKEY を false に設定すると、accesskey は使用されません。
    964         *
    965         * @og.rev 5.3.6.0 (2011/06/01) accessKeyを削除できるように対応
    966         * @og.rev 5.6.0.3 (2012/01/24) getRequestParameter を何度も呼んでいるので修正。
    967         * @og.rev 7.4.2.1 (2021/05/21) accesskey の設定の有効(true)/無効(false)を設定
    968         * @og.rev 8.0.2.0 (2021/11/30) useAccessKey → USE_ACCESSKEY 変更
    969         *
    970         * @param       accsKey クリアボタンのショートカットキー文字(初期値:C)
    971         */
    972        public void setClearAccesskey( final String accsKey ) {
    973//              if( useAccessKey ) {
    974                if( USE_ACCESSKEY ) {
    975                        final String val = getRequestParameter( accsKey );
    976                        if( val == null || val.isEmpty() ) {
    977                                clearAcskey = null;
    978                        }
    979                        else {
    980                                clearAcskey = val;                                                              // 5.6.0.3 (2012/01/24)
    981                        }
    982                }
    983        }
    984
    985        /**
    986         * 【TAG】進む／戻るのprev_next リンクを表示するかどうかを指定します(初期値:true)。
    987         *
    988         * @og.tag
    989         * 進む／戻るリンクは、RESULT画面にコマンド (FIRST,PREV,NEXT,LAST) という
    990         * コマンドを送る事で実現している画像リンクです。
    991         * PREV_NEXT が存在しない画面では、消去しておく必要があります。
    992         * 初期値は、true(表示する)です。
    993         *
    994         * @param       flag    prev_nextリンク表示 [true:する/false:しない]
    995         */
    996        public void setUsePrevNext( final String flag ) {
    997                usePrevNext = nval( getRequestParameter( flag ),usePrevNext );
    998        }
    999
    1000        /**
    1001         * 【TAG】pageSize 引数を使用するかどうかを指定します(初期値:true)。
    1002         *
    1003         * @og.tag
    1004         * pageSize 引数は、RESULT画面のviewタグで使用する 一回の表示に
    1005         * 何件のデータを表示させるかを指定する引数です。
    1006         * この件数が多いと、多くのデータを見ることが出来ますが、その分表示が
    1007         * 遅くなります。逆に、少ないと、PREV_NEXT を多用することになり、
    1008         * 目的の行を探し出しにくくなります。
    1009         * pageSize の値は、pageSizeパラメータで画面単位に指定するか、システム
    1010         * パラメータの HTML_PAGESIZE でシステム単位に指定できます。
    1011         * 初期値は、true(使用する)です。
    1012         *
    1013         * @param       flag    pageSize引数使用 [true:する/false:しない]
    1014         * @see     #setPageSize( String )
    1015         */
    1016        public void setUsePageSize( final String flag ) {
    1017                usePageSize = nval( getRequestParameter( flag ),usePageSize );
    1018        }
    1019
    1020        /**
    1021         * 【TAG】maxRowCount 引数を使用するかどうかを指定します(初期値:true)。
    1022         *
    1023         * @og.tag
    1024         * maxRowCount 引数は、RESULT画面のqueryタグで使用する 一回の検索時に
    1025         * 何件のデータを取得させるかを指定する引数です。
    1026         * この件数が多いと、多くのデータを検索することが出来ますが、その分表示が
    1027         * 遅くなります。逆に、少ないと、目的の行まで探し出せないかもしれません。
    1028         * maxRowCount の値は、rowCountパラメータで画面単位に指定するか、システム
    1029         * パラメータの DB_MAX_ROW_COUNT でシステム単位に指定できます。
    1030         *
    1031         * 初期値は、true(使用する)です。
    1032         *
    1033         * @param       flag    maxRowCount引数使用 [true:する/false:しない]
    1034         * @see     #setMaxRowCount( String )
    1035         */
    1036        public void setUseRowCount( final String flag ) {
    1037                useRowCount = nval( getRequestParameter( flag ),useRowCount );
    1038        }
    1039
    1040        /**
    1041         * 【TAG】処理時間を表示する TimeView を表示するかどうか[true:する/false:しない]を指定します
    1042         *              (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
    1043         *
    1044         * @og.tag
    1045         * true に設定すると、処理時間を表示するバーイメージが表示されます。
    1046         * これは、DB検索、APサーバー処理、画面表示の各処理時間をバーイメージで
    1047         * 表示させる機能です。処理時間の目安になります。
    1048         * (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
    1049         *
    1050         * @og.rev 6.3.6.0 (2015/08/16) useTimeView の初期値を、VIEW_USE_TIMEBAR にする。
    1051         *
    1052         * @param       flag    処理時間を表示 [true:する/false:しない]
    1053         */
    1054        public void setUseTimeView( final String flag ) {
    1055                useTimeView = nval( getRequestParameter( flag ),useTimeView );
    1056        }
    1057
    1058        /**
    1059         * 【TAG】pageSize プルダウンメニューの初期表示件数を指定します
    1060         *              (初期値:HTML_PAGESIZE[={@og.value SystemData#HTML_PAGESIZE}])。
    1061         *
    1062         * @og.tag
    1063         * プルダウンメニューを表示する場合の初期値を指定します。
    1064         * (初期値:ユーザー定数のHTML_PAGESIZE[={@og.value SystemData#HTML_PAGESIZE}])。
    1065         *
    1066         * @param       pSize   表示件数
    1067         * @see     #setUsePageSize( String )
    1068         * @see         org.opengion.hayabusa.common.SystemData#HTML_PAGESIZE
    1069         */
    1070        public void setPageSize( final String pSize ) {
    1071                pageSize = nval( getRequestParameter( pSize ),pageSize );
    1072        }
    1073
    1074        /**
    1075         * 【TAG】maxRowCount プルダウンメニューの初期値を指定します
    1076         *              (初期値:DB_MAX_ROW_COUNT[={@og.value SystemData#DB_MAX_ROW_COUNT}])。
    1077         *
    1078         * @og.tag
    1079         * プルダウンメニューを表示する場合のmaxRowCountの初期値を指定します。
    1080         * (初期値:ユーザー定数のDB_MAX_ROW_COUNT[={@og.value SystemData#DB_MAX_ROW_COUNT}])。
    1081         *
    1082         * @param       maxSize 最大件数
    1083         * @see     #setUseRowCount( String )
    1084         * @see         org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT
    1085         */
    1086        public void setMaxRowCount( final String maxSize ) {
    1087                maxRowCount = nval( getRequestParameter( maxSize ),maxRowCount );
    1088        }
    1089
    1090        /**
    1091         * 【TAG】ダミーのinputタグ(display:none)を出力するか設定します(初期値:false)。
    1092         *
    1093         * @og.tag
    1094         * ダミーのinputタグ(display:none)を出力するか設定します。
    1095         * IEではinputが１つだけの場合にエンターでのsubmitが上手くいかないため、ダミーを配置する必要があります。
    1096         * trueに設定するとWriteCheckタグがダミーを（常に）出力します。
    1097         * (初期値:false)。
    1098         *
    1099         * @og.rev 5.6.1.0 (2013/02/01) 新規追加
    1100         *
    1101         * @param   flag 出力可否 [true:する/false:しない]
    1102         */
    1103        public void setUseDummy( final String flag ) {
    1104                useDummy = nval( getRequestParameter( flag ), useDummy );
    1105        }
    1106
    1107        /**
    1108         * 【TAG】query画面等で編集プルダウンを出力するかどうか[true:する/false:しない]を指定します(初期値:true)。
    1109         *
    1110         * @og.tag
    1111         * falseを指定すると編集プルダウンを出さない。
    1112         * popup画面等、画面ID単位では編集機能は使うが、部分的に使いたくない場合に
    1113         * タグのパラメータとして個別に指定できるようにします。
    1114         * 初期値は、互換性の関係から、編集プルダウンを出力する(=true)です。
    1115         *
    1116         * @og.rev 5.7.5.0 (2014/04/04) 新規追加
    1117         *
    1118         * @param       flag    編集メニュー出力 [true:する/false:しない]
    1119         * @see         org.opengion.hayabusa.taglib.FileUDTag#setUseEditLink(String)
    1120         */
    1121        public void setUseEditMenu( final String flag ) {
    1122                useEditMenu = nval( getRequestParameter( flag ),useEditMenu );
    1123        }
    1124
    1125        /**
    1126         * 【TAG】検索ボタンを押下した際に表示されるメッセージリソースIDを指定します
    1127         *              (初期値:MSG0090[検索中です・・・])。
    1128         *
    1129         * @og.tag
    1130         * headタグのuseBlockUI=true のときに、検索ボタンを押下すると、｢検索中です・・・｣と表示されます。
    1131         * このメッセージのリソースIDを指定します。
    1132         * 表示させたくない場合は, blockUIMsg = "" をセットするか、headタグのuseBlockUI=false をセットしてください。
    1133         *
    1134         * @og.rev 6.4.8.0 (2016/06/24) blockUIMsg を追加。 検索中です・・・
    1135         *
    1136         * @param       id 検索中ですメッセージID
    1137         */
    1138        public void setBlockUIMsg( final String id ) {
    1139                final String ids = getRequestParameter( id );
    1140                if( ids != null ) { blockUIMsg = ids; }
    1141        }
    1142
    1143        /**
    1144         * このオブジェクトの文字列表現を返します。
    1145         * 基本的にデバッグ目的に使用します。
    1146         *
    1147         * @return このクラスの文字列表現
    1148         * @og.rtnNotNull
    1149         */
    1150        @Override
    1151        public String toString() {
    1152                return ToString.title( this.getClass().getName() )
    1153                                .println( "VERSION"                     , VERSION               )
    1154                                .println( "command"                     , command               )
    1155                                .println( "pageSize"            , pageSize              )
    1156                                .println( "maxRowCount"         , maxRowCount   )
    1157                                .println( "accesskey"           , accesskey             )
    1158                                .println( "scope"                       , scope                 )
    1159                                .println( "useClear"            , useClear              )
    1160                                .println( "usePrevNext"         , usePrevNext   )
    1161                                .println( "usePageSize"         , usePageSize   )
    1162                                .println( "useRowCount"         , useRowCount   )
    1163                                .println( "useTimeView"         , useTimeView   )
    1164                                .println( "clearTarget"         , clearTarget   )
    1165                                .println( "clearHref"           , clearHref             )
    1166                                .println( "clearCommand"        , clearCommand  )
    1167                                .println( "body"                        , body                  )
    1168                                .println( "Other..."            , getAttributes().getAttribute() )
    1169                                .fixForm().toString() ;
    1170        }
    1171}