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