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.system.OgBuilder ;                                  // 6.4.4.2 (2016/04/01)
019import org.opengion.fukurou.system.DateSet;                                             // 6.4.2.0 (2016/01/29)
020import org.opengion.fukurou.security.HybsCryptography;                  // 5.9.6.3 (2016/03/18)
021import org.opengion.fukurou.util.ToString;                                              // 6.8.5.0 (2018/01/09)
022import org.opengion.fukurou.util.HybsDateUtil;                                  // 6.4.2.0 (2016/01/29)
023import org.opengion.fukurou.util.StringUtil;
024import org.opengion.fukurou.util.ArraySet;                                              // 6.4.3.4 (2016/03/11)
025import org.opengion.fukurou.db.Transaction;
026import static org.opengion.fukurou.util.StringUtil.nval;
027
028import org.opengion.hayabusa.common.HybsSystem;
029import org.opengion.hayabusa.common.HybsSystemException;
030import org.opengion.hayabusa.db.DBColumn;
031import org.opengion.hayabusa.db.DBTableModel;
032import org.opengion.hayabusa.db.Query;
033import org.opengion.hayabusa.db.QueryFactory;
034
035import java.util.Calendar;
036import java.util.Enumeration;
037import java.util.LinkedHashSet;
038import java.util.Locale;
039import java.util.List;                                                                                  // 7.3.1.1 (2021/02/25)
040import java.util.ArrayList;
041import java.util.Arrays;                                                                                // 7.3.1.1 (2021/02/25)
042import java.util.Set;
043import java.util.Map;
044import java.util.LinkedHashMap;                                                                 // 6.4.2.1 (2016/02/05)
045import java.util.stream.Collectors;                                                             // 8.1.0.1 (2022/01/07)
046import java.util.function.Predicate;                                                    // 8.0.1.2 (2021/11/19)
047import java.text.NumberFormat;                                                                  // 6.2.4.2 (2015/05/29)
048import java.text.DateFormat;                                                                    // 8.0.1.2 (2021/11/19)
049import java.text.SimpleDateFormat;                                                              // 8.0.1.2 (2021/11/19)
050
051import jakarta.servlet.jsp.PageContext;
052import javax.script.ScriptEngine;
053import javax.script.ScriptEngineManager;
054import javax.script.ScriptException;
055
056/**
057 * JSP上からキー、値を設定することにより、パラメータとして、値を
058 * 取出し可能にするタグです。
059 *
060 * 通常のリクエスト情報と同じ扱いができます(優先順位は、リクエストが上位)。
061 *
062 * 設定した値は、{@XXXX} 形式で 取り出すことができます。
063 * また、command ="GET" で 直接画面に値を書き出すことも可能です。
064 *
065 * ※ このタグは、Transaction タグの対象です。
066 *
067 * <style>
068 *   #valueJavaDoc th { vertical-align:top; margin:0px; padding:0px; }
069 *   #valueJavaDoc td { text-align:center;  margin:0px; padding:0px; }
070 *  .act {
071 *      background-color: #ccffcc;
072 *      height : 160px;
073 *  }
074 *  .cmd {
075 *      background-color: #ffcccc;
076 *      width  : 80px;
077 *  }
078 *  .arrow {
079 *     border-top:  160px solid #ccffcc;
080 *     border-left:  80px solid #ffcccc;
081 *     position: absolute;
082 *  }
083 *  .actarw { margin-left:20px; position: absolute; }
084 *  .cmdarw { margin-top:140px; position: absolute; }
085 * </style>
086 *
087 * @og.formSample
088 * ●形式:<og:value command="SET" key="ABC" value="123" />
089 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します)
090 *
091 * ●Tag定義:
092 *   <og:value
093 *       command            【TAG】コマンド (SET,GET,REMOVE,CLEAR,SQL,SETTBL,GETTBL,KEYTBL,SETMEM,SQLGET,DEBUG)をセットします(初期値:SET)
094 *       action             【TAG】アクション(UPPER,LOWER,MESSAGE,APPEND,ALL_APPEND,MAP,ALL_MAP,MAPOBJ,ALL_MAPOBJ,LIST,ALL_LIST,LIST_CSV,ALL_LIST_CSV,
095 *                                  MERGE,FIRST,VIEWFIRST,ROW_APPEND,REPLACE,INDEX_OF,LASTINDEX_OF,SUBSTR,LENGTH,SET,ALL_SET,SET_CSV,ALL_SET_CSV,
096 *                                  SPLIT,SPLIT_LIST,FOR,FOR_LIST,FORTM,FORTM_LIST,MAX_MIN,ALL_MAX_MIN,ADD,CASE,ESCAPE,TO_DATE,DAY_WEEK,
097 *                                  URL_ENCODE,URL_ENCODE2,URL_DECODE,TRIM,HASH,TO_NUMBER,HMCSV,CRYPT_ENC,CRYPT_DEC,REQUEST,FORMAT)をセットします
098 *                                  7.3.0.0 (2021/01/06) EXEC 廃止
099 *       key                【TAG】パラメータ に登録するキーをセットします
100 *       value              【TAG】パラメータ に登録する値をセットします
101 *       defaultVal         【TAG】value値がNULLの場合に、この初期値を設定します
102 *       separator          【TAG】各種アクションの文字列を連結/分解する項目区切り文字をセットします(初期値:",")
103 *       useMultiRows       【TAG】マルチデータ(複数件検索)を使用するかどうか[true/false]を指定します(初期値:false)
104 *       scope              【TAG】キャッシュする場合のスコープ(request,session)を指定します(初期値:request)
105 *       tableId            【TAG】sessionから取得する DBTableModelオブジェクトの ID
106 *       tblScope           【TAG】DBTableModel から取得する場合のスコープ(request,session)を指定します(初期値:session)
107 *       dbid               【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します
108 *       xssCheck           【TAG】パラメータの HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか[true/false]を設定します (初期値:USE_XSS_CHECK[=true])
109 *       caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)
110 *       caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)
111 *       caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない)
112 *       caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない)
113 *       caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
114 *       fromVal            【TAG】部分文字列置換の 置換え前の部分文字列(from)を指定します・・・HMCSVの開始時刻にも使用します
115 *       toVal              【TAG】部分文字列置換の 置換え後の部分文字列(to)を指定します・・・HMCSVの終了時刻にも使用します
116 *       skipVal            【TAG】HMCSVで使用する、ステップ時間を分で指定します(例:1時間=60 , 2時間=120 , 45分=45 など) 6.8.4.1 (2017/12/18)
117 *       format             【TAG】actionが、FORMAT,FOR,FOR_LIST,FORTM,FORTM_LIST の場合の文字列変換フォーマットを指定します。8.0.1.2 (2021/11/19)
118 *       cryptKey           【TAG】暗号化と復号化で利用する、暗号化キーを指定します。
119 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)  5.10.4.0 (2018/10/05)
120 *   >   ... Body ...
121 *   </og:value>
122 *
123 * 【廃止】5.1.8.0 (2010/07/01) 物理削除
124 *  //   nullSet            【廃止】value が NULL の時に、設定するかどうか[true/false]を指定します(初期値:true)
125 *
126 * ●使用例
127 *     ・ <og:value command="SET" key="ABC" value="123" />
128 *     ・ <og:value command="SQL">SELECT 1 TEST FROM DUAL</og:value>
129 *     ・ <og:value command="SET" key="DEF" value="{@NOCOMMAND}" defaultVal="0000" />
130 *     ・ <og:value command="GET" key="NOKEY" defaultVal="NODATA" />
131 *     ・ <og:value command="SET" key="{@ABC}4" value="TEST1234" />
132 *     ・ <og:value command="GET" key="ABC" />
133 *     ・ <og:value command="SET" action="LOWER" key="LOWERTEST" value="ABCDEF" /> ⇒ abcdef
134 *     ・ <og:value command="GET" key="LOWERTEST" />
135 *     ・ <og:value command="GET" action="UPPER" key="LOWERTEST" />
136 *     ・ <og:value command="REMOVE" key="ABC" />
137 *     ・ &lt;og:value command="SET" action="FORMAT" key="ABC" value="15" format="%05d" <del>fromVal="%05d"</del> /&gt; ⇒ 00015
138 *
139 * <table class="plain" id="valueJavaDoc">
140 *   <caption>command 一覧と使用可能 action の対応表</caption>
141 *   <tr>
142 *       <th><span class="arrow">Key</span><span class="actarw">action</span><span class="cmdarw">command</span></th>
143 *       <th class="act">UPPER<br>LOWER<br>MESSAGE<br>DAY_WEEK<br>MERGE<br>REPLACE<br>
144 *                      INDEX_OF<br>LASTINDEX_OF<br>SUBSTR<br>LENGTH<br>ADD<br>CASE<br>
145 *                      ESCAPE<br>URL_ENCODE<br>URL_ENCODE2<br>URL_DECODE<br>TRIM<br>HASH<br>
146 *                      TO_NUMBER<br>FORMAT</th>
147 *       <th class="act">APPEND<br>ALL_APPEND</th>
148 *       <th class="act">MAP<br>ALL_MAP<br>MAPOBJ<br>ALL_MAPOBJ<br>LIST<br>LIST_CSV<br>ALL_LIST<br>ALL_LIST_CSV<br>SET<br>SET_CSV<br>ALL_SET<br>ALL_SET_CSV</th>
149 *       <th class="act">FIRST<br>VIEWFIRST</th>
150 *       <th class="act">ROW_APPEND</th>
151 *       <th class="act">SPLIT<br>SPLIT_LIST<br>FOR<br>FOR_LIST<br><br>FORTM<br>FORTM_LIST<br>MAX_MIN<br>ALL_MAX_MIN</th>
152 *       <th class="act">HMCSV</th>                                                                             <!-- 6.8.4.1 (2017/12/18) -->
153 *   </tr>
154 *   <tr><td class="cmd">SET    </td><td>○</td><td>○</td><td>×</td><td>×</td><td>×</td><td>○</td><td>○</td></tr>
155 *   <tr><td class="cmd">GET    </td><td>○</td><td>×</td><td>×</td><td>×</td><td>×</td><td>×</td><td>○</td></tr>
156 *   <tr><td class="cmd">REMOVE </td><td>×</td><td>×</td><td>×</td><td>×</td><td>×</td><td>×</td><td>×</td></tr>
157 *   <tr><td class="cmd">CLEAR  </td><td>×</td><td>×</td><td>×</td><td>×</td><td>×</td><td>×</td><td>×</td></tr>
158 *   <tr><td class="cmd">SQL    </td><td>×</td><td>×</td><td>○</td><td>×</td><td>○</td><td>×</td><td>×</td></tr>
159 *   <tr><td class="cmd">SETTBL </td><td>○</td><td>○</td><td>○</td><td>○</td><td>×</td><td>○</td><td>×</td></tr>
160 *   <tr><td class="cmd">GETTBL </td><td>○</td><td>○</td><td>×</td><td>○</td><td>×</td><td>×</td><td>×</td></tr>
161 *   <tr><td class="cmd">KEYTBL </td><td>○</td><td>○</td><td>×</td><td>○</td><td>×</td><td>○</td><td>×</td></tr>
162 *   <tr><td class="cmd">SETMEM </td><td>○</td><td>○</td><td>×</td><td>×</td><td>×</td><td>○</td><td>×</td></tr>
163 *   <tr><td class="cmd">SQLGET </td><td>×</td><td>×</td><td>×</td><td>×</td><td>○</td><td>×</td><td>×</td></tr>
164 * </table>
165 *
166 * @og.group その他部品
167 *
168 * @version  4.0
169 * @author   M.Endou
170 * @since    JDK5.0,
171 */
172public class ValueTag extends CommonTagSupport {
173        /** このプログラムのVERSION文字列を設定します。 {@value} */
174        private static final String VERSION = "8.2.0.1 (2022/06/17)" ;
175        private static final long serialVersionUID = 820120220617L ;
176
177        /** command 引数に渡す事の出来る コマンド  セット {@value} */
178        public static final String CMD_SET              = "SET";
179        /** command 引数に渡す事の出来る コマンド  ゲット {@value} */
180        public static final String CMD_GET              = "GET";
181        /** command 引数に渡す事の出来る コマンド  リムーブ {@value} */
182        public static final String CMD_REMOVE   = "REMOVE";
183        /** command 引数に渡す事の出来る コマンド  クリア {@value} */
184        public static final String CMD_CLEAR    = "CLEAR";
185        /** command 引数に渡す事の出来る コマンド  SQL {@value} */
186        public static final String CMD_SQL              = "SQL";
187        /** command 引数に渡す事の出来る コマンド  セットテーブル {@value} */
188        public static final String CMD_SETTBL   = "SETTBL";
189        /** command 引数に渡す事の出来る コマンド  ゲットテーブル {@value} */
190        public static final String CMD_GETTBL   = "GETTBL";
191        /** command 引数に渡す事の出来る コマンド  キーテーブル {@value} */
192        public static final String CMD_KEYTBL   = "KEYTBL";
193        /** command 引数に渡す事の出来る コマンド  セットメモリ {@value} */
194        public static final String CMD_SETMEM   = "SETMEM";                     // 3.7.1.0 (2005/04/15)
195        /** command 引数に渡す事の出来る コマンド  SQLゲット {@value} */
196        public static final String CMD_SQLGET   = "SQLGET";                     // 5.1.7.0 (2010/06/01) SQLGET対応
197        /** command 引数に渡す事の出来る コマンド  デバッグ {@value} */
198        public static final String CMD_DEBUG    = "DEBUG";                      // 6.7.7.2 (2017/04/14)
199
200        // 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。
201        private static final Set<String> COMMAND_SET = new ArraySet<>( CMD_SET , CMD_GET , CMD_REMOVE , CMD_SQL , CMD_SETTBL , CMD_GETTBL ,
202                                                                                                                                   CMD_KEYTBL , CMD_CLEAR , CMD_SETMEM, CMD_SQLGET );
203
204        /** action 引数に渡す事の出来る アクション  アッパー(大文字化) {@value} */
205        public static final String ACT_UPPER            = "UPPER" ;
206        /** action 引数に渡す事の出来る アクション  ローワー(小文字化) {@value} */
207        public static final String ACT_LOWER            = "LOWER" ;
208        /** action 引数に渡す事の出来る アクション  メッセージ変換 {@value} */
209        public static final String ACT_MESSAGE          = "MESSAGE" ;
210        /** action 引数に渡す事の出来る アクション  データアペンド {@value} */
211        public static final String ACT_APPEND           = "APPEND" ;
212        /** action 引数に渡す事の出来る アクション  オールアペンド {@value} */
213        public static final String ACT_ALL_APPEND       = "ALL_APPEND" ;                                // 3.6.1.0 (2005/01/05)
214        /** action 引数に渡す事の出来る アクション  MAP {@value} */
215        public static final String ACT_MAP                      = "MAP" ;                                               // 5.5.0.3 (2012/03/12)
216        /** action 引数に渡す事の出来る アクション  ALL_MAP {@value} */
217        public static final String ACT_ALL_MAP          = "ALL_MAP" ;                                   // 5.5.0.3 (2012/03/12)
218        /** action 引数に渡す事の出来る アクション  MAP {@value} */
219        public static final String ACT_MAPOBJ           = "MAPOBJ" ;                                    // 6.2.4.2 (2015/05/29)
220        /** action 引数に渡す事の出来る アクション  ALL_MAP {@value} */
221        public static final String ACT_ALL_MAPOBJ       = "ALL_MAPOBJ" ;                                // 6.2.4.2 (2015/05/29)
222        /** action 引数に渡す事の出来る アクション  LIST {@value} */
223        public static final String ACT_LIST                     = "LIST" ;                                              // 4.3.7.5 (2009/07/13)
224        /** action 引数に渡す事の出来る アクション  ALL_LIST {@value} */
225        public static final String ACT_ALL_LIST         = "ALL_LIST" ;                                  // 4.3.7.5 (2009/07/13)
226        /** action 引数に渡す事の出来る アクション  LIST_CSV {@value} */
227        public static final String ACT_LIST_CSV         = "LIST_CSV" ;                                  // 8.1.0.1 (2022/01/07)
228        /** action 引数に渡す事の出来る アクション  ALL_LIST_CSV {@value} */
229        public static final String ACT_ALL_LIST_CSV     = "ALL_LIST_CSV" ;                              // 8.1.0.1 (2022/01/07)
230        /** action 引数に渡す事の出来る アクション  SET {@value} */
231        public static final String ACT_SET                      = "SET" ;                                               // 8.1.0.1 (2022/01/07)
232        /** action 引数に渡す事の出来る アクション  ALL_SET {@value} */
233        public static final String ACT_ALL_SET          = "ALL_SET" ;                                   // 8.1.0.1 (2022/01/07)
234        /** action 引数に渡す事の出来る アクション  SET_CSV {@value} */
235        public static final String ACT_SET_CSV          = "SET_CSV" ;                                   // 8.1.0.1 (2022/01/07)
236        /** action 引数に渡す事の出来る アクション  ALL_SET_CSV {@value} */
237        public static final String ACT_ALL_SET_CSV      = "ALL_SET_CSV" ;                               // 8.1.0.1 (2022/01/07)
238        /** action 引数に渡す事の出来る アクション  日付前方まるめ {@value} */
239        public static final String ACT_DAY_WEEK         = "DAY_WEEK" ;                                  // 3.7.1.0 (2005/04/15)
240        /** action 引数に渡す事の出来る アクション  マージ {@value} */
241        public static final String ACT_MERGE            = "MERGE" ;                                             // 3.7.1.1 (2005/05/23)
242        /** action 引数に渡す事の出来る アクション  ファースト {@value} */
243        public static final String ACT_FIRST            = "FIRST" ;                                             // 3.8.0.4 (2005/08/08)
244        /** action 引数に渡す事の出来る アクション  ビューファースト {@value} */
245        public static final String ACT_VIEWFIRST        = "VIEWFIRST" ;                                 // 7.3.1.1 (2021/02/25)
246        /** action 引数に渡す事の出来る アクション  縦横回転 {@value} */
247        public static final String ACT_ROW_APPEND       = "ROW_APPEND" ;                                // 3.8.9.2 (2007/07/28)
248        /** action 引数に渡す事の出来る アクション  文字列置換 {@value} */
249        public static final String ACT_REPLACE          = "REPLACE" ;                                   // 5.2.2.0 (2010/11/01)
250        /** action 引数に渡す事の出来る アクション  部分文字列 {@value} */
251        public static final String ACT_SUBSTR           = "SUBSTR" ;                                    // 5.2.2.0 (2010/11/01)
252        /** action 引数に渡す事の出来る アクション  文字数(char数) {@value} */
253        public static final String ACT_LENGTH           = "LENGTH" ;                                    // 7.2.6.0 (2020/06/30)
254        /** action 引数に渡す事の出来る アクション  INDEX_OF数 {@value} */
255        public static final String ACT_INDEX_OF         = "INDEX_OF" ;                                  // 7.2.6.0 (2020/06/30)
256        /** action 引数に渡す事の出来る アクション  LASTINDEX_OF数 {@value} */
257        public static final String ACT_LASTINDEX_OF     = "LASTINDEX_OF" ;                              // 7.2.6.0 (2020/06/30)
258        /** action 引数に渡す事の出来る アクション  文字列分割 {@value} */
259        public static final String ACT_SPLIT            = "SPLIT" ;                                             // 5.2.2.0 (2010/11/01)
260        /** action 引数に渡す事の出来る アクション  文字列分割後LIST登録 {@value} */
261        public static final String ACT_SPLIT_LIST               = "SPLIT_LIST" ;                        // 7.3.1.1 (2021/02/25)
262        /** action 引数に渡す事の出来る アクション  fromVal,toVal,skipVal を使用した連結文字列を作成する {@value} */
263        public static final String ACT_FOR                      = "FOR" ;                                               // 7.3.1.1 (2021/02/25)
264        /** action 引数に渡す事の出来る アクション  fromVal,toVal,skipVal を使用した文字列をLIST登録 {@value} */
265        public static final String ACT_FOR_LIST         = "FOR_LIST" ;                                  // 7.3.1.1 (2021/02/25)
266        /** action 引数に渡す事の出来る アクション  fromVal,toVal,skipVal を使用した日付文字列を作成する {@value} */
267        public static final String ACT_FORTM            = "FORTM" ;                                             // 8.0.1.2 (2021/11/19)
268        /** action 引数に渡す事の出来る アクション  fromVal,toVal,skipVal を使用した日付文字列をLIST登録 {@value} */
269        public static final String ACT_FORTM_LIST       = "FORTM_LIST" ;                                // 8.0.1.2 (2021/11/19)
270        /** action 引数に渡す事の出来る アクション  最大_最小値 {@value} */
271        public static final String ACT_MAX_MIN          = "MAX_MIN" ;                                   // 5.6.4.3 (2013/05/24)
272        /** action 引数に渡す事の出来る アクション  ALL_最大_最小値 {@value} */
273        public static final String ACT_ALL_MAX_MIN      = "ALL_MAX_MIN" ;                               // 5.6.4.3 (2013/05/24)
274        /** action 引数に渡す事の出来る アクション  計算処理結果 {@value} */
275        public static final String ACT_EXEC                     = "EXEC" ;                                              // 5.7.7.2 (2014/06/20)
276        /** action 引数に渡す事の出来る アクション  値をプラスする {@value} */
277        public static final String ACT_ADD                      = "ADD" ;                                               // 7.3.0.0 (2021/01/06)
278        /** action 引数に渡す事の出来る アクション  条件分岐 {@value} */
279        public static final String ACT_CASE                     = "CASE" ;                                              // 5.7.7.2 (2014/06/20)
280        /** action 引数に渡す事の出来る アクション  HTML上のエスケープ文字 {@value} */
281        public static final String ACT_ESCAPE           = "ESCAPE" ;                                    // 6.3.5.0 (2015/08/08)
282        /** action 引数に渡す事の出来る アクション  UTF-8 でURLエンコード {@value} */
283        public static final String ACT_ENCODE           = "URL_ENCODE" ;                                        // 6.9.7.0 (2018/05/14)
284        /** action 引数に渡す事の出来る アクション  UTF-8 で部分URLエンコード {@value} */
285        public static final String ACT_ENCODE2          = "URL_ENCODE2" ;                                       // 6.9.7.0 (2018/05/14)
286        /** action 引数に渡す事の出来る アクション  UTF-8 でURLデコード {@value} */
287        public static final String ACT_DECODE           = "URL_DECODE" ;                                        // 6.9.7.0 (2018/05/14)
288        /** action 引数に渡す事の出来る アクション  スペース削除 {@value} */
289        public static final String ACT_TRIM                     = "TRIM" ;                                              // 6.4.1.2 (2016/01/22)
290//      /** action 引数に渡す事の出来る アクション  MD5 {@value} */
291//      public static final String ACT_MD5                      = "MD5" ;                                               // 5.9.6.3 (2016/03/18) 8.1.2.0 (2022/03/10) Delete
292        /** action 引数に渡す事の出来る アクション  HASH {@value} */
293        public static final String ACT_HASH                     = "HASH" ;                                              // 8.1.2.0 (2022/03/10) Add
294        /** action 引数に渡す事の出来る アクション  TO_NUMBER {@value} */
295        public static final String ACT_TO_NUMBER        = "TO_NUMBER" ;                                 // 6.7.4.0 (2017/02/10)
296        /** action 引数に渡す事の出来る アクション  TO_DATE {@value} */
297        public static final String ACT_TO_DATE          = "TO_DATE" ;                                   // 8.0.1.2 (2021/11/19)
298        /** action 引数に渡す事の出来る アクション  HMCSV {@value} */
299        public static final String ACT_HMCSV            = "HMCSV" ;                                             // 6.8.4.1 (2017/12/18)
300        /** action 引数に渡す事の出来る アクション  CRYPT_ENC {@value} */
301        public static final String ACT_CRYPT_ENC        = "CRYPT_ENC";                                  // 5.10.4.0 (2018/10/05)
302        /** action 引数に渡す事の出来る アクション  CRYPT_DEC {@value} */
303        public static final String ACT_CRYPT_DEC        = "CRYPT_DEC";                                  // 5.10.4.0 (2018/10/05)
304        /** action 引数に渡す事の出来る アクション  REQUEST {@value} */
305        public static final String ACT_REQUEST          = "REQUEST";                                    // 7.2.6.1 (2020/07/17)
306        /** action 引数に渡す事の出来る アクション  FORMAT {@value} */
307        public static final String ACT_FORMAT           = "FORMAT";                                             // 7.4.2.0 (2021/05/08)
308
309        /** action 引数に渡す事の出来る アクション リスト  */
310        // 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。
311        // 6.8.4.1 (2017/12/18) ACT_HMCSV
312        // 6.9.7.0 (2018/05/14) ACT_ENCODE , ACT_ENCODE2 , ACT_DECODE
313        // 5.10.4.0 (2018/10/05) ACT_CRYPT_ENC, ACT_CRYPT_DEC
314        // 7.2.6.0 (2020/06/30) ACT_LENGTH
315        // 7.3.0.0 (2021/01/06) ACT_ADD , (ACT_EXECは基本廃止)
316        // 7.4.2.0 (2021/05/08) ACT_FORMAT追加
317        // 8.0.1.2 (2021/11/19) ACT_TO_DATE,ACT_FORTM,ACT_FORTM_LIST 追加
318        // 8.1.2.0 (2022/03/10) ACT_MD5 を ACT_HASH に変更
319        private static final Set<String> ACTION_SET = new ArraySet<>(
320                                ACT_UPPER,ACT_LOWER,ACT_MESSAGE,ACT_APPEND,ACT_ALL_APPEND,
321                                ACT_MAP,ACT_ALL_MAP,ACT_MAPOBJ,ACT_ALL_MAPOBJ,ACT_LIST,ACT_LIST_CSV,ACT_ALL_LIST,ACT_ALL_LIST_CSV,ACT_SET,ACT_SET_CSV,ACT_ALL_SET,ACT_ALL_SET_CSV,
322                                ACT_DAY_WEEK,ACT_MERGE,ACT_FIRST,ACT_VIEWFIRST,ACT_ROW_APPEND,ACT_REPLACE,ACT_INDEX_OF,ACT_LASTINDEX_OF,ACT_SUBSTR,ACT_LENGTH,
323                                ACT_SPLIT,ACT_SPLIT_LIST,ACT_FOR,ACT_FOR_LIST,ACT_FORTM,ACT_FORTM_LIST,ACT_MAX_MIN,ACT_ALL_MAX_MIN,ACT_EXEC,
324                                ACT_CASE,ACT_ESCAPE,ACT_ENCODE,ACT_ENCODE2,ACT_DECODE,
325                                ACT_TRIM,ACT_HASH,ACT_TO_NUMBER,ACT_TO_DATE,ACT_HMCSV,ACT_CRYPT_ENC,ACT_CRYPT_DEC,ACT_REQUEST,ACT_ADD,ACT_FORMAT
326        );
327
328//      /** 6.8.4.1 (2017/12/18) action="HMCSV" で、ループ制限します。 */
329//      8.2.0.1 (2022/06/17) MAX_CNT 廃止
330//      public static final int MAX_CNT = 361;  // 8.0.1.2 (2021/11/19) 300 → 361 に変更(360まで許可する)
331
332        /** 8.0.1.2 (2021/11/19) 日付のフォーマットの初期値 */
333        public static final String YMDHMS = "yyyyMMddHHmmss" ;
334        private static final String     HASH_CODE = HybsSystem.sys( "FILE_HASH_CODE" ); // 8.1.2.0 (2022/03/10)
335
336        private transient DBTableModel table;
337
338        private String          tableId         = HybsSystem.TBL_MDL_KEY;
339        private String          command         = CMD_SET;
340        private String          key                     ;
341        private String          inValue         ;               // 3.5.4.0 (2003/11/25)
342        private String          value           ;
343        private String          defaultVal      ;
344        private String          action          ;
345        private String          dbid            ;                               // 4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
346        private String          scope           = "request";    // "request","session"
347        private String          tblScope        = "session";    // 5.1.2.0 (2010/01/01) DBTableModel の取得先のscope
348        private String          separator       = ",";                  // 項目区切り文字
349        private boolean         useMultiRows ;                          // 3.2.4.0 (2003/06/12) マルチデータ(複数件検索)を使用するかしないか。初期値:使用せず
350        private boolean         xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" ); // 5.1.7.0 (2010/06/01) XSS対策
351
352        private String  fromVal                 ;                                       // 5.2.2.0 (2010/11/01)
353        private String  toVal                   ;                                       // 5.2.2.0 (2010/11/01)
354        private String  skipVal                 ;                                       // 6.8.4.1 (2017/12/18)
355        private String  format                  ;                                       // 8.0.1.2 (2021/11/19)
356        private String  cryptKey                ;                                       // 5.10.4.0 (2018/10/05) 暗号化キー
357
358        private boolean tmpSelectedAll  ;                                       // 5.6.4.3 (2013/05/24) action="ALL_xxx"を tmpSelectedAll="true" で内部処理します。
359
360        /**
361         * デフォルトコンストラクター
362         *
363         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
364         */
365        public ValueTag() { super(); }          // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
366
367        /**
368         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
369         *
370         * @og.rev 3.1.7.0 (2003/05/02) isNullSet 属性が true(初期値)のときは、リクエスト情報から値を取得。
371         * @og.rev 3.1.7.0 (2003/05/02) scope 属性を設定するタイミングを、早くする。
372         * @og.rev 3.5.4.0 (2003/11/25) getRequestParameter( value ) メソッドを setValue に移動。
373         * @og.rev 5.1.7.0 (2010/06/01) SQLGET対応
374         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
375         * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
376         * @og.rev 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動
377         *
378         * @return      後続処理の指示
379         */
380        @Override
381        public int doStartTag() {
382                // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
383                if( useTag() ) {
384                        useXssCheck( xssCheck );                // 6.4.8.1 (2016/07/02)
385
386                        super.setScope( scope );                // デフォルトscope が "request" なので、再設定している。
387
388        //              if( isNullSet ) {
389        //                      setUseValue( false );
390        //              }
391
392                        // 5.1.7.0 (2010/06/01) SQLGET対応
393                        if( CMD_SQL.equals( command ) || CMD_SET.equals( command ) || CMD_SQLGET.equals( command ) ) {
394                                return EVAL_BODY_BUFFERED ;             // Body を評価する
395                        }
396                }
397                return SKIP_BODY ;                              // Body を評価しない
398        }
399
400        /**
401         * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
402         *
403         * @og.rev 3.1.1.0 (2003/03/28) ボディの内容を取得する処理を、CommonTagSupport で行う。
404         * @og.rev 3.6.0.8 (2004/11/19) エラー発生時に確実にリリースされるように try finally 追加
405         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfoオブジェクトを設定
406         * @og.rev 4.0.0.0 (2005/01/31) lang ⇒ ResourceManager へ変更
407         * @og.rev 5.1.7.0 (2010/06/01) SQLGET対応
408         * @og.rev 5.1.7.0 (2010/06/01) XSS解除対応
409         * @og.rev 5.1.9.0 (2010/08/01) TransactionTag 対応。上位に TransactionTag があれば、そこからConnection をもらう。
410         * @og.rev 5.2.1.0 (2010/10/01) command="SET" action="APPEND"でvalueをbody部に書いた場合に動作しないバグを修正
411         * @og.rev 5.3.7.0 (2011/07/01) TransactionReal の引数変更
412         * @og.rev 5.3.8.0 (2011/08/01) Transaction発生箇所でclose()
413         * @og.rev 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
414         * @og.rev 6.3.6.1 (2015/08/28) QueryFactory.close( Query ) 廃止。Queryはキャッシュしません。
415         * @og.rev 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動
416         * @og.rev 8.0.2.0 (2021/11/30) 検索実行前に、SQL文字をdebugPrint出来るように修正
417         *
418         * @return      後続処理の指示(SKIP_BODY)
419         */
420        @Override
421        public int doAfterBody() {
422                if( value == null || value.length() <= 0 ) {
423                        // 5.1.7.0 (2010/06/01) XSS対策
424
425                        value = getBodyString();
426                        // 5.2.1.0 (2010/10/01)
427                        inValue = getBodyRawString();
428
429                        // 5.1.7.0 (2010/06/01) SQLGET対応
430                        if( CMD_SQL.equals( command ) || CMD_SQLGET.equals( command ) ) {
431                                // 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
432                                try( Transaction tran = getTransaction() ) {
433                                        final Query query = QueryFactory.newInstance();                 // 4.0.0 (2005/01/31)
434                                        value = value.trim();
435                                        debugPrint( value );                                                                    // 8.0.2.0 (2021/11/30)
436
437                                        query.setConnection( tran.getConnection( dbid ) );              // 6.3.6.1 (2015/08/28)
438                                        query.setResourceManager( getResource() );                              // 4.0.0 (2005/01/31)
439                                        query.setStatement( value );
440                                        query.execute();
441
442                                        table = query.getDBTableModel();
443                                        tran.commit();                                                                                  // 6.3.6.1 (2015/08/28)
444                                }       // 5.3.8.0 (2011/08/01) Transaction発生箇所でclose() (6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用)
445                        }
446                }
447
448                return SKIP_BODY ;
449        }
450
451        /**
452         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
453         *
454         * @og.rev 3.1.0.1 (2003/03/26) DBTableModelの値をSET/GETできる command , action を追加。
455         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
456         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
457         * @og.rev 3.1.5.0 (2003/04/22) DBTableModel が存在するときのみ実行するロジックになっていたバグ対応。
458         * @og.rev 5.1.2.0 (2010/01/01) DBTableModel の取得先の tblScope を追加。
459         * @og.rev 5.1.7.0 (2010/06/01) SQLGET対応
460         * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
461         *
462         * @return      後続処理の指示
463         */
464        @Override
465        public int doEndTag() {
466                debugPrint();           // 4.0.0 (2005/02/28)
467                // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
468                if( useTag() ) {
469                        if( check( command, COMMAND_SET ) ) {
470                                if( CMD_SETTBL.equals( command ) ||
471                                        CMD_GETTBL.equals( command ) ||
472                                        CMD_KEYTBL.equals( command ) ) {
473        //                                      table = (DBTableModel)getSessionAttribute( tableId );
474                                                // 5.1.2.0 (2010/01/01) DBTableModel の取得先の tblScope を追加。
475                                                if( "session".equals( tblScope ) ) { table = (DBTableModel) getSessionAttribute( tableId ); }
476                                                else if( "request".equals( tblScope ) ) { table = (DBTableModel) getRequestAttribute( tableId ); }
477                                                else {
478                                                        final String errMsg = "このスコープはサポートされていません。[" + tblScope + "]";
479                                                        throw new IllegalArgumentException( errMsg );
480                                                }
481                                }
482                        }
483
484                        commandExec( command );
485
486                        // 5.1.7.0 (2010/06/01) SQLGET対応
487                        if( CMD_GET.equals( command ) || CMD_GETTBL.equals( command ) || CMD_SQLGET.equals( command ) ) {
488                                if( value != null ) { jspPrint( value ); }
489                        }
490                }
491                return EVAL_PAGE ;
492        }
493
494        /**
495         * タグリブオブジェクトをリリースします。
496         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
497         *
498         * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
499         * @og.rev 3.1.0.1 (2003/03/26) DBTableModelの値をSET/GETできる command , action を追加。
500         * @og.rev 3.1.0.1 (2003/03/26) query 属性を削除します。
501         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
502         * @og.rev 3.2.4.0 (2003/06/12) マルチデータ(複数件検索)を使用するかしないか。
503         * @og.rev 3.5.4.0 (2003/11/25) inValue 変数の追加
504         * @og.rev 4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
505         * @og.rev 5.1.2.0 (2010/01/01) DBTableModel の取得先の tblScope を追加。
506         * @og.rev 5.1.7.0 (2010/06/01) XSS解除対応
507         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
508         * @og.rev 5.2.2.0 (2010/11/01) fromVal , toVal 属性 追加
509         * @og.rev 5.6.4.3 (2013/05/24) parameter 属性は、未使用なので削除
510         * @og.rev 5.6.4.3 (2013/05/24) tmpSelectedAll 属性追加。action="ALL_xxx"を tmpSelectedAll="true" に置き換えます。
511         * @og.rev 6.8.4.1 (2017/12/18) skipVal 属性 追加
512         * @og.rev 5.10.4.0 (2018/10/03) CRYPT追加
513         * @og.rev 8.0.1.2 (2021/11/19) format 属性 追加
514         *
515         */
516        @Override
517        protected void release2() {
518                super.release2();
519                tableId                 = HybsSystem.TBL_MDL_KEY;
520                command                 = CMD_SET;
521                key                             = null;
522                value                   = null;
523                defaultVal              = null;
524                action                  = null;
525                table                   = null;
526                dbid                    = null;
527                scope                   = "request";    // "request","session"
528                tblScope                = "session";    // 5.1.2.0 (2010/01/01) DBTableModel の取得先のscope
529                separator               = ",";
530                useMultiRows    = false;
531                inValue                 = null;                 // 3.5.4.0 (2003/11/25)
532                xssCheck                = HybsSystem.sysBool( "USE_XSS_CHECK" );        // 5.1.7.0 (2010/06/01) XSS解除対応
533                fromVal                 = null;                 // 5.2.2.0 (2010/11/01)
534                toVal                   = null;                 // 5.2.2.0 (2010/11/01)
535                skipVal                 = null;                 // 6.8.4.1 (2017/12/18)
536                format                  = null;                 // 8.0.1.2 (2021/11/19)
537                cryptKey                = null;                 // 5.10.4.0 (2018/10/05)
538                tmpSelectedAll  = false;                // 5.6.4.3 (2013/05/24)
539        }
540
541        /**
542         * コマンドを実行します。
543         *
544         * コマンドは,HTMLから(get/post)指定されますので,CMD_xxx で設定される
545         * フィールド定数値のいづれかを、指定できます。
546         * コマンドを登録すると同時に,実行も行ないます。
547         *
548         * @og.rev 3.1.0.1 (2003/03/26) command に、SETTBL / GETTBL / KEYTBL / CLEAR を追加。
549         * @og.rev 3.1.0.1 (2003/03/26) query 属性を削除します。
550         * @og.rev 3.1.7.0 (2003/05/02) scope 属性を設定するタイミングを、早くする。
551         * @og.rev 3.7.1.0 (2005/04/15) command に、SETMEM を追加。
552         * @og.rev 5.1.7.0 (2010/06/01) SQLGET対応
553         * @og.rev 6.7.7.2 (2017/04/14) command に、DEBUG 追加
554         * @og.rev 8.0.0.0 (2021/07/09) action="ADD" の時は、valueのnull時にdefaultValを設定しない。
555         *
556         * @param       command コマンド (public static final 宣言されている文字列)
557         * @see         <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.ValueTag.CMD_GET">コマンド定数</a>
558         */
559        private void commandExec( final String command ) {
560
561                if( CMD_SQL.equals( command ) ) {
562                        setSQLAttribute( table );
563                }
564                else if( CMD_SQLGET.equals( command ) ) {
565                        value = getSQLAttribute( table );
566                }
567                else if( CMD_SET.equals( command ) ) {
568                        // 8.0.0.0 (2021/07/09) action="ADD" の時は、valueのnull時にdefaultValを設定しない。
569                        if( !ACT_ADD.equals( action ) ) {                       // つまり、ADD 以外は、設定する。
570                                value = nval( value, defaultVal );
571                        }
572                        setAttribute( key,value,action );
573                }
574                else if( CMD_GET.equals( command ) ) {
575                        value = getAttribute( key,action );
576                }
577                else if( CMD_REMOVE.equals( command ) ) {
578                        removeAttribute( key );
579                }
580                else if( CMD_CLEAR.equals( command ) ) {
581                        clearAttribute( key );
582                }
583                else if( CMD_SETTBL.equals( command ) ) {
584                        setTableAttribute( table,key,action );
585                }
586                else if( CMD_GETTBL.equals( command ) ) {
587                        value = getTableAttribute( table,key,action );
588                }
589                else if( CMD_KEYTBL.equals( command ) ) {
590                        setKeyTableAttribute( table,key,value,action );
591                }
592                else if( CMD_SETMEM.equals( command ) ) {               // 3.7.1.0 (2005/04/15)
593                        // 8.0.0.0 (2021/07/09) action="ADD" の時は、valueのnull時にdefaultValを設定しない。
594                        if( !ACT_ADD.equals( action ) ) {                       // つまり、ADD 以外は、設定する。
595                                value = nval( value, defaultVal );
596                        }
597                        setAttribute( key,value,action );
598                        setRequestCacheData( key,(String)getObject( key ) );
599                }
600                else if( CMD_DEBUG.equals( command ) ) {
601                        value = scopeAttributePrint();                          // 6.7.7.2 (2017/04/14)
602                }
603        }
604
605        /**
606         * アクションを実行します。
607         *
608         * コマンドは action 属性で指定します。
609         * action コマンド が、 null の場合は、なにも実行しません。
610         *
611         * @og.rev 3.0.1.3 (2003/03/11) MESSAGE action を追加
612         * @og.rev 3.1.0.1 (2003/03/26) 引数を与えて処理する様に変更する。
613         * @og.rev 3.7.1.0 (2005/04/15) action に、DAY_WEEK を追加。
614         * @og.rev 3.7.1.1 (2005/05/23) action に、MERGE を追加。
615         * @og.rev 4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage ⇒ getResource().getLabel )
616         * @og.rev 5.2.2.0 (2010/11/01) ACT_MERGE 時には、カンマで分解、separator で合成を行います。
617         * @og.rev 5.2.2.0 (2010/11/01) ACT_REPLACE 処理を新規追加します。
618         * @og.rev 5.5.7.2 (2012/10/09) HybsDateUtil を利用するように修正します。
619         * @og.rev 5.6.6.1 (2013/07/12) value が null の場合は、無視します。
620         * @og.rev 5.7.7.2 (2014/06/20) EXEC と CASE アクションを追加
621         * @og.rev 6.3.1.1 (2015/07/10) action="REPLACE" の、fromVal,toVal は、CSV形式で指定可能にする。
622         * @og.rev 6.3.1.1 (2015/07/10) action="ESCAPE" 追加
623         * @og.rev 6.3.5.0 (2015/08/08) action="ESCAPE" 追加
624         * @og.rev 6.3.9.0 (2015/11/06) 文字列配列を toString() する。
625         * @og.rev 6.4.1.2 (2016/01/22) TRIM アクションを追加。
626         * @og.rev 6.4.2.0 (2016/01/29) HybsDateUtil.getCalendar( String ) を直接利用するように修正します。
627         * @og.rev 5.9.6.3 (2016/02/18) MD5 アクションを追加
628         * @og.rev 6.7.4.0 (2017/02/10) TO_NUMBER アクションを追加
629         * @og.rev 6.8.4.1 (2017/12/18) HMCSV アクションを追加
630         * @og.rev 6.9.1.0 (2018/02/26) HMCSV アクションに、MAX,MIN,HMF を追加
631         * @og.rev 6.9.2.1 (2018/03/12) HybsDateUtil.getDateFormat の メソッド変更(引数の簡素化)
632         * @og.rev 6.9.7.0 (2018/05/14) URL_ENCODE,URL_ENCODE2,URL_DECODE を追加
633         * @og.rev 5.10.4.0 (2018/10/05) CRYPT追加
634         * @og.rev 7.2.6.0 (2020/06/30) INDEX_OF ,LASTINDEX_OF, LENGTH追加
635         * @og.rev 7.2.6.1 (2020/07/17) ACT_REQUEST追加
636         * @og.rev 7.3.0.0 (2021/01/06) JavaScriptエンジンをNashornからGraalJSに移行(ただし、未対応)
637         * @og.rev 7.3.0.0 (2021/01/06) ADDアクションを追加
638         * @og.rev 7.3.1.3 (2021/03/09) REPLACEアクションで、fromVal,toValの分割を、カンマ固定から、separator 使用に変更
639         * @og.rev 7.4.2.0 (2021/05/08) FORMAT追加
640         * @og.rev 8.0.1.2 (2021/11/19) TO_DATE,FORTM,FORTM_LIST追加
641         * @og.rev 8.1.2.0 (2022/03/10) ACT_MD5 を ACT_HASH に変更
642         * @og.rev 8.2.0.1 (2022/06/17) ACT_HMCSV アクションで、fromVal,toVal に日付指定を可能にする。
643         *
644         * @param action        コマンド (public static final 宣言されている文字列)
645         * @param value         旧の値
646         *
647         * @return      処理後の値
648         */
649        private String actionExec( final String action,final String value ) {
650                String rtn = value;
651
652                // 8.2.0.1 (2022/06/17) ACT_HMCSV アクションで、fromVal が null でなく、8桁以上(つまり時:分:秒 でなく年月日を含むケース)
653                final boolean hmCSVfrom = ACT_HMCSV.equals( action ) && fromVal != null && fromVal.length() > 8 ;
654
655                // 5.6.6.1 (2013/07/12) value が null の場合は、無視します。
656//              if( action == null || value == null ) { return rtn; }
657                if( action == null || value == null && !hmCSVfrom ) { return rtn; }
658
659                if( ACT_UPPER.equals( action ) ) {
660                        // Localeを共通管理するようになった場合、String.toUpperCase( Locale locale )使用の事
661                        rtn = value.toUpperCase(Locale.JAPAN);
662                }
663                else if( ACT_LOWER.equals( action ) ) {
664                        // Localeを共通管理するようになった場合、String.toLowerCase( Locale locale )使用の事
665                        rtn = value.toLowerCase(Locale.JAPAN);
666                }
667                else if( ACT_MESSAGE.equals( action ) ) {
668                        // 引数をメッセージリソースのキーとして、メッセージ変換する。
669                        rtn = getResource().getLabel( value );
670                }
671                else if( ACT_DAY_WEEK.equals( action ) ) {
672                        // 日付型文字列(YYYYMMDD) の入力データを、開始日を月曜日にセットします。
673                        // SUNDAY=1 , MONDAY=2 になります。月曜日との差だけ、前に戻します。
674                        // 指定日が日曜日の場合は、次の日(月曜日)に進めます。
675                        final Calendar ymd = HybsDateUtil.getCalendar( value );                         // 6.4.2.0 (2016/01/29)
676                        final int shu = ymd.get( Calendar.DAY_OF_WEEK ) - Calendar.MONDAY ;
677
678                        if( shu != 0 ) { ymd.add( Calendar.DATE, -shu ); }
679
680                        rtn = DateSet.getDate( ymd.getTimeInMillis() , "yyyyMMdd" );            // 5.5.7.2 (2012/10/09) HybsDateUtil を利用
681                }
682                // 3.7.1.1 (2005/05/23)
683                else if( ACT_MERGE.equals( action ) ) {
684                        final Set<String> set = new LinkedHashSet<>();
685                        // 引数をカンマで文字列配列に分解します。
686                        final String[] vals = StringUtil.csv2Array( value );
687                        // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
688                        for( final String str : vals ) {
689                                if( str != null && str.length() > 0 ) {
690                                        set.add( str );
691                                }
692                        }
693//                      final String[] str = StringUtil.csv2Array( value );
694//                      for( int i=0; i<str.length; i++ ) {
695//                              if( str[i] != null && str[i].length() > 0 ) {
696//                                      set.add( str[i] );
697//                              }
698//                      }
699
700                        // 分解後、マージ(Setで)されます。 登録順は、キープします。
701                        rtn = StringUtil.iterator2line( set.iterator(),separator );     // 5.2.2.0 (2010/11/01) separator 使用
702                }
703                // 5.2.2.0 (2010/11/01) ACT_REPLACE 処理を新規追加
704                else if( ACT_REPLACE.equals( action ) ) {
705                        // value.replaceAll( from, to ) という文法で処理します。
706                        // 6.0.2.5 (2014/10/31) null でないことがわかっている値の冗長な null チェックがあります。
707                        if( fromVal != null && toVal != null ) {
708                                // 6.3.1.1 (2015/07/10) CSV形式可能にする。
709                                if( fromVal.indexOf( ',' ) < 0 ) {
710                                        rtn = value.replaceAll( fromVal, toVal );
711                                }
712                                else {
713//                                      final String[] frmStr = fromVal.split( "," );
714//                                      final String[] toStr  = toVal.split( "," );
715                                        final String[] frmStr = fromVal.split( separator );                     // 7.3.1.3 (2021/03/09) カンマ固定から、separator 使用に変更
716                                        final String[] toStr  = toVal.split( separator );                       // 7.3.1.3 (2021/03/09) カンマ固定から、separator 使用に変更
717                                        if( frmStr.length == toStr.length ) {
718                                                for( int i=0; i<frmStr.length; i++ ) {
719                                                        rtn = rtn.replaceAll( frmStr[i], toStr[i] );
720                                                }
721                                        }
722                                        else {
723//                                              final String errMsg = "REPLACE時の fromValのカンマの数が、toValの数と一致しません。"
724                                                final String errMsg = "REPLACE時の fromValとtoValの数と一致しません。(separator=[" + separator + "])" + CR
725                                                                                // 6.3.9.0 (2015/11/06) 文字列配列を toString() する。
726                                                                                + " fromVal=[" + String.join( ",",frmStr ) + "] , toVal=[" + toVal + "] , value=[" + value + "]";
727                                                throw new HybsSystemException( errMsg );
728                                        }
729                                }
730                        }
731                }
732                // 5.2.2.0 (2010/11/01) SUBSTR 処理を新規追加
733                else if( ACT_SUBSTR.equals( action ) ) {
734                        // value.substring( from, to ) という文法で処理します。
735                        // 6.0.2.5 (2014/10/31) null でないことがわかっている値の冗長な null チェックがあります。
736                                final int from = fromVal == null || fromVal.isEmpty() ? 0              : Integer.parseInt( fromVal );   // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
737                                final int to   =   toVal == null || toVal.isEmpty()   ? value.length() : Integer.parseInt( toVal );             // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
738
739                                if(   from >= value.length() ) { rtn = ""; }
740                                else if( to > value.length() ) { rtn = value.substring( from ); }
741                                else {
742                                        rtn = value.substring( from, to );
743                                }
744                }
745                // 7.2.6.0 (2020/06/30) INDEX_OF ,LASTINDEX_OF, LENGTH追加
746                else if( ACT_INDEX_OF.equals( action ) ) {
747                        final int from = fromVal == null || fromVal.isEmpty() ? 0 : Integer.parseInt( fromVal );
748                        rtn = String.valueOf( value.indexOf( separator,from ) );
749                }
750                // 7.2.6.0 (2020/06/30) INDEX_OF ,LASTINDEX_OF, LENGTH追加
751                else if( ACT_LASTINDEX_OF.equals( action ) ) {
752                        final int to = toVal == null || toVal.isEmpty() ? value.length() : Integer.parseInt( toVal );
753                        rtn = String.valueOf( value.lastIndexOf( separator,to ) );
754                }
755                // 7.2.6.0 (2020/06/30) INDEX_OF ,LASTINDEX_OF, LENGTH追加
756                else if( ACT_LENGTH.equals( action ) ) {
757                        rtn = String.valueOf( value.length() );
758                }
759                // 5.7.7.2 (2014/06/20) CASE 処理を新規追加
760                else if( ACT_CASE.equals( action ) ) {
761                        // fromVal="A:1 B:2 C:3 D:4" 形式
762                        if( fromVal != null && fromVal.length()>0 ) {
763                                final String[] keys = StringUtil.csv2Array( fromVal , ' ' );
764                                // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
765                                for( final String fkey : keys ) {
766                                        final int idx = fkey.indexOf( ':' );
767                                        if( idx >= 0 ) {                                                                        // 分解した値にコロン(:)がなければ、パス
768                                                final String key = fkey.substring( 0,idx );             // 左辺(キー)
769                                                if( value.equalsIgnoreCase( key ) ) {
770                                                        rtn = fkey.substring( idx+1 );                          // 右辺(値)
771                                                        break;
772                                                }
773                                        }
774                                }
775//                              for( int i=0; i<keys.length; i++ ) {
776//                                      final int idx = keys[i].indexOf( ':' );
777//                                      if( idx >= 0 ) {                                                                        // 分解した値にコロン(:)がなければ、パス
778//                                              final String key = keys[i].substring( 0,idx );  // 左辺(キー)
779//                                              if( value.equalsIgnoreCase( key ) ) {
780//                                                      rtn = keys[i].substring( idx+1 );                       // 右辺(値)
781//                                                      break;
782//                                              }
783//                                      }
784//                              }
785                        }
786                }
787                // 5.7.7.2 (2014/06/20) EXEC 処理を新規追加
788                else if( ACT_EXEC.equals( action ) ) {
789//                      final ScriptEngine jsEngine = new ScriptEngineManager().getEngineByName( "JavaScript" );
790                        ScriptEngine jsEngine = new ScriptEngineManager().getEngineByName( "graal.js" );                // 7.3.0.0 (2021/01/06)
791
792                        if( jsEngine == null ) {
793                                jsEngine = new ScriptEngineManager().getEngineByName( "nashorn" );              // 7.3.0.0 (2021/01/06)
794                                if( jsEngine == null ) {
795                                        final String errMsg = "ScriptEngine(Nashorn) は、廃止されました。" + CR
796                                                                + " 別の方法に変更するか、GraalJSに移行してください。" + CR
797                                                                + " command=" + command ;
798                                        throw new HybsSystemException( errMsg );
799                                }
800                        }
801
802                        try {
803                                final Object obj = jsEngine.eval( value );
804                                rtn = String.valueOf( obj );
805                        }
806                        catch( final ScriptException ex ) {
807                                final String errMsg = "JavaScript式のパースに失敗しました。[" + value + "]";
808                                throw new HybsSystemException( errMsg , ex );
809                        }
810                }
811                // 7.3.0.0 (2021/01/06) ADDアクションを追加
812                else if( ACT_ADD.equals( action ) ) {
813                        // defaultVal の 値と、(value またはBODY部の)値を、加算した結果をキー変数にセットします。
814                        final int addVal = nval( defaultVal,0 ) + nval( value,0 );
815                        rtn = String.valueOf( addVal );
816                }
817                // 6.3.5.0 (2015/08/08) action="ESCAPE" 追加
818                else if( ACT_ESCAPE.equals( action ) ) {
819                        rtn = StringUtil.htmlFilter( value );
820                }
821                // 6.9.7.0 (2018/05/14) action="URL_ENCODE" 追加
822                else if( ACT_ENCODE.equals( action ) ) {
823                        rtn = StringUtil.urlEncode( value );
824                }
825                // 6.9.7.0 (2018/05/14) action="URL_ENCODE" 追加
826                else if( ACT_ENCODE2.equals( action ) ) {
827                        rtn = StringUtil.urlEncode2( value );
828                }
829                // 6.9.7.0 (2018/05/14) action="URL_DECODE" 追加
830                else if( ACT_DECODE.equals( action ) ) {
831                        rtn = StringUtil.urlDecode( value );
832                }
833                // 6.4.1.2 (2016/01/22) TRIM アクションを追加。
834                else if( ACT_TRIM.equals( action ) ) {
835                        rtn = value.trim();
836                }
837                // 5.9.6.3 (2016/02/18) 8.1.2.0 (2022/03/10) Delete
838//              else if( ACT_MD5.equals( action ) ){
839//                      rtn = HybsCryptography.getMD5( value );
840//              }
841                // action="HASH" 追加 8.1.2.0 (2022/03/10) Add
842                else if( ACT_HASH.equals( action ) ){
843                        final String hash = format != null ? format : HASH_CODE ;
844                        rtn = HybsCryptography.getHash( hash, value );
845                }
846
847                // 6.7.4.0 (2017/02/10)
848                else if( ACT_TO_NUMBER.equals( action ) ){
849                        rtn = delChar( value , ch -> ( '-' == ch || '0'<=ch && ch<='9' ) );
850
851        //              final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
852        //              for( int i=0; i<value.length(); i++ ) {
853        //                      final char ch = value.charAt( i );
854        //                      if( '-' == ch || '0'<=ch && ch<='9' ) {
855        //                              buf.append( ch );
856        //                      }
857        //              }
858        //              rtn = buf.toString();
859                }
860                // 8.0.1.2 (2021/11/19) ACT_TO_NUMBER との違いは、マイナス記号も削除します。
861                else if( ACT_TO_DATE.equals( action ) ){
862                        rtn = delChar( value , ch -> ( '0'<=ch && ch<='9' ) );
863
864//                      final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
865//                      for( int i=0; i<value.length(); i++ ) {
866//                              final char ch = value.charAt( i );
867//                              if( '0'<=ch && ch<='9' ) {
868//                                      buf.append( ch );
869//                              }
870//                      }
871//                      rtn = buf.toString();
872                }
873                // 6.8.4.1 (2017/12/18)
874                // 6.9.1.0 (2018/02/26) HMCSV アクションに、MAX,MIN,HMF を追加
875                // 8.2.0.1 (2022/06/17) ACT_HMCSV アクションで、fromVal,toVal に日付指定を可能にする。
876                else if( ACT_HMCSV.equals( action ) && fromVal != null && fromVal.length()>0 ) {
877                        fromVal = delChar( fromVal , ch -> ( '0'<=ch && ch<='9' ) );    // フォーマットされていた場合の処理
878                        toVal   = delChar( toVal   , ch -> ( '0'<=ch && ch<='9' ) );    //
879
880                        // 8.2.0.1 (2022/06/17) ACT_HMCSV アクションで、fromVal が null でなく、8桁以上(つまり時:分:秒 でなく年月日を含むケース)
881                        if( !hmCSVfrom ) {                                                                                              // 上記の否定形なので従来と同じ処理
882                                final int fromNum = Integer.parseInt( fromVal );
883                                final int toNum   = Integer.parseInt( toVal   );
884
885                                // value には、基準となる日付データ
886                                fromVal = HybsDateUtil.getDateFormat( "YMDHMS" , value, "HM" , fromNum );
887                                toVal   = HybsDateUtil.getDateFormat( "YMDHMS" , value, "HM" , toNum   );       // HM (時分形式の加算)
888                        }
889
890                        final Calendar stCal  = HybsDateUtil.getCalendar( fromVal );
891                        final Calendar edCal  = HybsDateUtil.getCalendar( toVal );
892
893                        final int field  = Calendar.MINUTE ;                            // 加算するフィールド(単位は分)
894                        final int amount = nval( skipVal , 60 );                        // 初期値の間隔は、60分
895
896                        final DateFormat ymdhms  = new SimpleDateFormat( "yyyyMMddHHmmss",Locale.JAPAN );
897                        final DateFormat hmFmt   = new SimpleDateFormat( "HH:mm",Locale.JAPAN );
898                        final DateFormat mdhmFmt = new SimpleDateFormat( "M/d HH:mm",Locale.JAPAN );
899
900                        final StringBuilder buf  = new StringBuilder( BUFFER_MIDDLE );
901                        final StringBuilder slbl = new StringBuilder( BUFFER_MIDDLE );  // 6.9.1.0 (2018/02/26) HMF を追加
902
903                        int lastDay = 0;                                                                        // 日付変更時のチェック用
904                        while( stCal.before( edCal ) ) {
905                                buf.append( ymdhms.format( stCal.getTime() ) ).append( separator );
906
907                                final int nowDay = stCal.get( Calendar.DATE ) ;
908                                if( lastDay == nowDay ) {                                               // 日付が同じ場合
909                                        slbl.append( hmFmt.format( stCal.getTime() ) ).append( separator );
910                                }
911                                else {
912                                        slbl.append( mdhmFmt.format( stCal.getTime() ) ).append( separator );
913                                }
914                                lastDay = nowDay;
915                                stCal.add( field, amount );
916                        }
917                        if( buf.length()  > 0 ) { buf.setLength(  buf.length()-separator.length()); }   // 最後のseparatorを削除する。 8.2.0.1 (2022/06/17)
918                        if( slbl.length() > 0 ) { slbl.setLength( slbl.length()-separator.length()); }  // 最後のseparatorを削除する。 8.2.0.1 (2022/06/17)
919                        rtn = buf.toString();
920
921                        // MAX,MIN を追加
922                        setObject( "MIN." + key , fromVal );
923                        setObject( "MAX." + key , toVal   );
924                        setObject( "HMF." + key , slbl.toString() );
925
926//                      final int fromNum = Integer.parseInt( StringUtil.deleteChar( fromVal , ':' ) );
927//                      final int toNum   = Integer.parseInt( StringUtil.deleteChar( toVal   , ':' ) );
928//
929//                      // value には、基準となる日付データ
930//                      final String fromS = HybsDateUtil.getDateFormat( "YMDHMS" , value, "HM" , fromNum );
931//                      final String toS   = HybsDateUtil.getDateFormat( "YMDHMS" , value, "HM" , toNum   );    // HM (時分形式の加算)
932//
933//                      final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
934//                      buf.append( fromS );
935//                      final StringBuilder slbl = new StringBuilder( BUFFER_MIDDLE );  // 6.9.1.0 (2018/02/26) HMF を追加
936//                      slbl.append( HybsDateUtil.getDateFormat( "HMF",fromS ) );               // 6.9.2.1 (2018/03/12)
937//
938//                      final int skip = nval( skipVal , 60 );  // 初期値の間隔は、60分
939//                      int cnt = 1;
940//                      String timeS = fromS;
941//                      String lastS = timeS.substring( 0,8 );  // 日付部分の比較のための変数
942//                      while( timeS.compareTo( toS ) < 0 && cnt < MAX_CNT ) {          // 最大件数で制限しておきます。
943//                              timeS = HybsDateUtil.getDateFormat( "YMDHMS" , fromS , "MI" , skip*cnt );                       // MI (分の数値の加算)
944//                              cnt++;
945//
946//                              buf.append( separator ).append( timeS );                // 区切り文字で、連結
947//
948//                              if( lastS.equals( timeS.substring( 0,8 ) ) ) {  // 日付が同じ場合
949//                                      slbl.append( separator ).append( HybsDateUtil.getDateFormat( "HMF",timeS ) );           // 6.9.2.1 (2018/03/12)
950//                              }
951//                              else {
952//                                      slbl.append( separator ).append( HybsDateUtil.getDateFormat( "M/d HH:mm",timeS ) );                     // 6.9.2.1 (2018/03/12)
953//                              }
954//                              lastS = timeS.substring( 0,8 ); // 日付部分の比較のための変数
955//                      }
956//                      rtn = buf.toString();
957
958//                      // 8.2.0.1 (2022/06/17) MAX_CNT 廃止
959//                      if( cnt >= MAX_CNT ) {
960//                              final String errMsg = "valueタグで、action=\"HMCSV\" で、最大件数をオーバーしました。 MAX_CNT=[" + MAX_CNT + "]" + CR
961//                                                              + " fromVal=[" + fromVal + "] , toVal=[" + toVal + "] , skipVal=[" + skipVal
962//                                                              + "] , key=[" + key + "] , value=[" + value + "]" ;
963////                                                            + " rtn=[" + rtn + "]" ;        // 8.0.1.2 (2021/11/19) rtn → key に変更
964//                              System.err.println( errMsg );
965//                      }
966//
967//                      // 6.9.1.0 (2018/02/26) MAX,MIN を追加
968//                      setObject( "MIN." + key , fromS );
969//                      setObject( "MAX." + key , toS   );
970//                      setObject( "HMF." + key , slbl.toString() );
971                }
972                // 6.9.1.0 (2018/02/26) HMCSV アクションで、from~to ではないケース
973                // 6.9.8.0 (2018/05/28) FindBugs:null でないことがわかっている値の冗長な null チェック
974                else if( ACT_HMCSV.equals( action ) && value.contains( "," ) ){         // valueは、nullチェック済み
975                        final String[] ymdhms = StringUtil.csv2Array( value );
976
977                        final StringBuilder slbl = new StringBuilder( BUFFER_MIDDLE );  // 6.9.1.0 (2018/02/26) HMF を追加
978
979//                      String lastS = ymdhms[0].substring( 0,8 );                      // 日付部分の比較のための変数
980                        String lastS = "";                                                                      // 8.2.0.1 (2022/06/17) 日付部分の比較のための変数(初回は空文字列)
981                        for( final String timeS : ymdhms ) {
982                                final String nowS = timeS.substring( 0,8 );
983                                if( lastS.equals( nowS ) ) {                                    // 日付が同じ場合
984                                        slbl.append( HybsDateUtil.getDateFormat( "HMF",timeS ) ).append( separator );                   // 6.9.2.1 (2018/03/12)
985                                }
986                                else {
987                                        slbl.append( HybsDateUtil.getDateFormat( "M/d HH:mm",timeS ) ).append( separator );             // 6.9.2.1 (2018/03/12)
988                                }
989                                lastS = nowS;           // 日付部分の比較のための変数(前回の日付)
990                        }
991                        if( slbl.length() > 0 ) { slbl.setLength( slbl.length()-separator.length()); }  // 最後のseparatorを削除する。 8.2.0.1 (2022/06/17)
992
993                        rtn = value;            // 元のvalue のまま、返します。
994
995                        // 6.9.1.0 (2018/02/26) MAX,MIN を追加
996                        setObject( "MIN." + key , ymdhms[0] );
997                        setObject( "MAX." + key , ymdhms[ymdhms.length-1] );
998                        setObject( "HMF." + key , slbl.toString() );
999                }
1000                // 5.10.4.0 (2018/10/05)
1001                else if( ACT_CRYPT_ENC.equals( action ) ) {
1002                        final HybsCryptography hc = new HybsCryptography(cryptKey);
1003                        rtn = hc.encrypt( value );
1004                }
1005                else if( ACT_CRYPT_DEC.equals( action ) ) {
1006                        final HybsCryptography hc = new HybsCryptography(cryptKey);
1007                        rtn = hc.decrypt( value );
1008                }
1009                // 7.2.6.1 (2020/07/17)
1010                else if( ACT_REQUEST.equals( action ) ) {
1011                        rtn = getRequestParameter( value );                     // setValue で変換された結果を、変換します。
1012                }
1013                // 7.4.2.0 (2021/05/08) FORMAT追加
1014//              else if( ACT_FORMAT.equals( action ) ) {
1015                else if( ACT_FORMAT.equals( action ) && format != null ) {              // 8.0.1.2 (2021/11/19) fromVal → format に変更
1016                        try {
1017                                final int val = Integer.parseInt(value);
1018//                              rtn = String.format(fromVal, val);
1019                                rtn = String.format(format, val);                                               // 8.0.1.2 (2021/11/19)
1020                        }
1021                        catch( final NumberFormatException ex ) {
1022                                final String errMsg = "value が数値ではありません。 value=[" + value + "]" ;
1023                                throw new HybsSystemException( errMsg );
1024                        }
1025                }
1026
1027                return rtn;
1028        }
1029
1030        /**
1031         * 指定の文字列から、特定のキャラクタを削除します。
1032         *
1033         * @og.rev 8.0.1.2 (2021/11/19) 新規追加
1034         *
1035         * @param org           キャラクタを削除するオリジナルの文字列
1036         * @param isOmit        キャラクタ削除の判定処理(Predicate)
1037         */
1038        private String delChar( final String org , final Predicate<Character> isOmit ) {
1039                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
1040                for( int i=0; i<org.length(); i++ ) {
1041                        final char ch = org.charAt( i );
1042                        if( isOmit.test( ch ) ) {
1043                                buf.append( ch );
1044                        }
1045                }
1046                return buf.toString();
1047        }
1048
1049        /**
1050         * 指定のスコープの内部キャッシュ情報を、キーで登録します。
1051         *
1052         * @og.rev 3.1.0.1 (2003/03/26) 引数を与えて処理する様に変更する。
1053         * @og.rev 3.5.4.0 (2003/11/25) APPENDアクションを有効にします。
1054         * @og.rev 3.5.6.5 (2004/08/09) APPEND時のセパレータを外部指定の変数を使用
1055         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
1056         * @og.rev 5.2.2.0 (2010/11/01) ACT_SPLIT 追加
1057         * @og.rev 5.6.4.3 (2013/05/24) ACT_MAX_MIN アクションの追加
1058         * @og.rev 5.6.6.1 (2013/07/12) value が null の場合は、無視します。
1059         * @og.rev 7.3.1.1 (2021/02/25) ACT_SPLIT_LIST,ACT_FOR,ACT_FOR_LIST 追加
1060         * @og.rev 8.0.1.2 (2021/11/19) ACT_TO_DATE,ACT_FORTM,ACT_FORTM_LIST 追加
1061         *
1062         * @param key           キー
1063         * @param value         値
1064         * @param action        アクション
1065         */
1066        private void setAttribute( final String key,final String value,final String action ) {
1067                if( key == null || key.isEmpty() ) {
1068                        final String errMsg = "key がセットされていません。"
1069                                                + " command=" + command + " , action=" + action
1070                                                + " , value=" + value ;                 // 5.1.8.0 (2010/07/01) errMsg 修正
1071                        throw new HybsSystemException( errMsg );
1072                }
1073
1074                // 7.3.1.1 (2021/02/25) ACT_FOR,ACT_FOR_LIST 追加
1075//              final boolean useFor = ACT_FOR.equals( action ) || ACT_FOR_LIST.equals( action ) ;
1076                // 8.0.1.2 (2021/11/19) ACT_FORTM,ACT_FORTM_LIST 追加
1077                final boolean useFor = ACT_FOR.equals( action ) || ACT_FOR_LIST.equals( action ) || ACT_FORTM.equals( action ) || ACT_FORTM_LIST.equals( action ) ;
1078                // 8.2.0.1 (2022/06/17) ACT_HMCSV アクションも追加
1079                final boolean useHmcsv = ACT_HMCSV.equals( action ) ;
1080
1081                // 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
1082                // 5.6.6.1 (2013/07/12) value が null の場合は、無視します。
1083                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
1084//              if( value == null ) {
1085//              if( value == null && !useFor ) {        // 7.3.1.1 (2021/02/25) ACT_FOR,ACT_FOR_LIST は、value 未指定も可能
1086                if( value == null && !useFor && !useHmcsv ) {   // 8.2.0.1 (2022/06/17) ACT_HMCSV アクションも追加
1087                        setObject( key, null );                 // 5.6.6.1 (2013/07/12) value が null の場合
1088                }
1089                else {
1090                        if( ACT_APPEND.equals( action ) ) {
1091                                final String[] array = getRequestParameterValues( inValue );
1092                                setObject( key, StringUtil.array2line( array,separator ) );
1093                        }
1094                        // 5.2.2.0 (2010/11/01) ACT_SPLIT 追加
1095                        else if( ACT_SPLIT.equals( action ) )  {
1096                                final String[] array = value.split( separator );
1097                                setObject( key , array[0] );            // キー自体には、分割時の先頭の文字列を設定しておく。
1098                                for( int i=0; i<array.length; i++ ) {
1099                                        setObject( key + i , array[i] );
1100                                }
1101                        }
1102                        // 7.3.1.1 (2021/02/25) ACT_SPLIT_LIST 追加
1103                        else if( ACT_SPLIT_LIST.equals( action ) )  {
1104                                final String[] array = value.split( separator );
1105                                final List<String> list = Arrays.asList( array );
1106                                setObject( key , list );
1107                        }
1108
1109                        // 7.3.1.1 (2021/02/25) ACT_FOR,ACT_FOR_LIST 追加
1110                        else if( ACT_FOR.equals( action ) || ACT_FOR_LIST.equals( action ) )  {
1111                                final String valKey = value == null ? "" : value ;
1112
1113                                final String stStr  = nval( fromVal , "0" );
1114                                final String edStr  = nval( toVal   , "10" );
1115                                final String stpStr = nval( skipVal , "1" );
1116
1117                                final int start = Integer.parseInt( stStr );
1118                                final int end   = Integer.parseInt( edStr );
1119                                final int step  = Integer.parseInt( stpStr );
1120
1121                                // 8.0.1.2 (2021/11/19) format属性追加に伴い、format指定を優先させる。
1122                                if( format == null ) {
1123                                        // ゼロ埋めフォーマットを判定する。
1124                                        final int len = stStr.length();
1125//                                      final String numFmt = len>1 && stStr.charAt(0) == '0' ? "%0" + len + "d" : "%d" ;
1126                                        format = len>1 && stStr.charAt(0) == '0' ? "%0" + len + "d" : "%d" ;
1127                                }
1128
1129                                if( ACT_FOR.equals( action ) ) {                                        // ACT_FOR
1130                                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
1131                                        for( int val=start; val<=end; val+=step ) {             // 終了は、endを含む
1132//                                              final String val2 = String.format( numFmt , val );
1133                                                final String val2 = String.format( format , val );              // 8.0.1.2 (2021/11/19) format属性追加
1134                                                buf.append( valKey ).append( val2 ).append( separator );
1135                                        }
1136//                                      if( buf.length() > 0 ) { buf.setLength( buf.length()-1); }      // 最後のseparatorを削除する。
1137                                        if( buf.length() > 0 ) { buf.setLength( buf.length()-separator.length()); }     // 最後のseparatorを削除する。 8.2.0.1 (2022/06/17)
1138
1139                                        setObject( key , buf.toString() );
1140                                }
1141                                else {                                                                                          // ACT_FOR_LIST
1142                                        final List<String> list = new ArrayList<>();
1143                                        for( int val=start; val<=end; val+=step ) {             // 終了は、endを含む
1144//                                              final String val2 = String.format( numFmt , val );
1145                                                final String val2 = String.format( format , val );              // 8.0.1.2 (2021/11/19) format属性追加
1146                                                list.add( valKey + val2 );
1147                                        }
1148
1149                                        setObject( key , list );
1150                                }
1151                        }
1152                        // 8.0.1.2 (2021/11/19) ACT_FORTM,ACT_FORTM_LIST 追加
1153                        else if( ACT_FORTM.equals( action ) || ACT_FORTM_LIST.equals( action ) )  {
1154                                // FORTM,FORTM_LIST では、fromVal,toVal は、必須になる。
1155                                if( StringUtil.isNull(fromVal,toVal) ) {
1156                                        final String errMsg = "fromVal,toVal は必須です。"
1157                                                                + " command=" + command + " , action=" + action;
1158                                        throw new HybsSystemException( errMsg );
1159                                }
1160
1161                                fromVal = delChar( fromVal , ch -> ( '0'<=ch && ch<='9' ) );    // フォーマットされていた場合の処理
1162                                toVal   = delChar( toVal   , ch -> ( '0'<=ch && ch<='9' ) );    //
1163
1164                                final Calendar stCal  = HybsDateUtil.getCalendar( fromVal );
1165                                final Calendar edCal  = HybsDateUtil.getCalendar( toVal );
1166
1167                                final String   stpStr = nval( skipVal , "1" );          // null や、"M" などがあり得るため
1168                                final int field = "M".equals( stpStr ) ? Calendar.MONTH : Calendar.DATE ;       // 加算するフィールド
1169                                final int amount= "M".equals( stpStr ) ? 1 : Integer.parseInt( stpStr );        // 追加量
1170
1171                                if( StringUtil.isNull( format) ) {
1172                                        format = YMDHMS.substring( 0,fromVal.length() ) ;       // format の初期値は、開始日付の長さ
1173                                }
1174                                final DateFormat formatter = new SimpleDateFormat( format,Locale.JAPAN );
1175
1176                                if( ACT_FORTM.equals( action ) ) {                                      // ACT_FORTM
1177                                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
1178                                        while( stCal.before( edCal ) ) {
1179                                                buf.append( formatter.format( stCal.getTime() ) ).append( separator );
1180                                                stCal.add( field, amount );
1181                                        }
1182//                                      if( buf.length() > 0 ) { buf.setLength( buf.length()-1); }      // 最後のseparatorを削除する。
1183                                        if( buf.length() > 0 ) { buf.setLength( buf.length()-separator.length()); }     // 最後のseparatorを削除する。 8.2.0.1 (2022/06/17)
1184
1185                                        setObject( key , buf.toString() );
1186                                }
1187                                else {                                                                                          // ACT_FORTM_LIST
1188                                        final List<String> list = new ArrayList<>();
1189                                        while( stCal.before( edCal ) ) {
1190                                                list.add( formatter.format( stCal.getTime() ) );
1191                                                stCal.add( field, amount );
1192                                        }
1193
1194                                        setObject( key , list );
1195                                }
1196                        }
1197                        // 5.6.4.3 (2013/05/24) ACT_MAX_MIN アクションの追加
1198                        else if( ACT_MAX_MIN.equals( action ) )  {
1199                                final String[] array = value.split( separator );
1200
1201                                // command="SET" では、数字型としてのみ処理します。
1202                                double minNum = Double.MAX_VALUE ;
1203                                double maxNum = Double.MIN_VALUE ;
1204                                double sumNum = 0d ;
1205                                int    cntSum = 0;              // 平均計算に有効な件数
1206
1207                                for( int i=0; i<array.length; i++ ) {
1208                                        final String val = array[i].trim().replaceAll( ",","" );                // 数字型フォーマットのカンマを取り除く
1209                                        if( val.isEmpty() ) { continue; }               // ゼロ文字列の場合は、取り直し
1210
1211                                        final double tmp = Double.parseDouble( val );
1212                                        if( minNum > tmp ) { minNum = tmp; }
1213                                        if( maxNum < tmp ) { maxNum = tmp; }
1214                                        sumNum += tmp ;  cntSum++ ;
1215                                }
1216
1217                                // command="SET" の場合は、数字型の場合のみ使用します。
1218                                if( cntSum > 0 ) {
1219                                        final NumberFormat nf = NumberFormat.getInstance();
1220                                        nf.setGroupingUsed( false );                                    // カンマ編集なし
1221                                        nf.setMaximumFractionDigits(2);                                 // 最大小数部は2桁
1222                                        nf.setMinimumFractionDigits(0);                                 // できれば、整数表示
1223
1224                                        setObject( "MIN." + key,nf.format( minNum ) );          // Double.toString( minNum ) の代わり。
1225                                        setObject( "MAX." + key,nf.format( maxNum ) );
1226                                        setObject( "SUM." + key,nf.format( sumNum ) );
1227                                        setObject( "AVG." + key,nf.format( sumNum/cntSum ) );
1228                                }
1229                                else {
1230                                        setObject( "MIN." + key,nval( defaultVal , "" ) );
1231                                        setObject( "MAX." + key,nval( defaultVal , "" ) );
1232                                        setObject( "SUM." + key,nval( defaultVal , "" ) );
1233                                        setObject( "AVG." + key,nval( defaultVal , "" ) );
1234                                }
1235                        }
1236                        else {
1237                                setObject( key, actionExec( action,value ) );
1238                        }
1239                }
1240        }
1241
1242        /**
1243         * 指定のスコープの内部キャッシュ情報を、キーで取得します。
1244         *
1245         * @og.rev 3.1.0.1 (2003/03/26) 引数を与えて処理する様に変更する。
1246         *
1247         * @param key           キー
1248         * @param action        アクション
1249         *
1250         * @return      キーに対する内部キャッシュ情報
1251         */
1252        private String getAttribute( final String key,final String action ) {
1253                if( key == null || key.isEmpty() ) {
1254                        final String errMsg = "key がセットされていません。"
1255                                                + " command=" + command + " , action=" + action;        // 5.1.8.0 (2010/07/01) errMsg 修正
1256                        throw new HybsSystemException( errMsg );
1257                }
1258
1259                String rtn = defaultVal;
1260                final Object obj = pageContext.findAttribute( key );
1261                if( obj != null ) { rtn = obj.toString(); }
1262
1263                return actionExec( action,rtn );
1264        }
1265
1266        /**
1267         * 指定のスコープの内部キャッシュ情報を削除します。
1268         *
1269         * @og.rev 3.1.0.1 (2003/03/26) 引数を与えて処理する様に変更する。
1270         *
1271         * @param key           キー
1272         */
1273        private void removeAttribute( final String key ) {
1274                if( key == null || key.isEmpty() ) {
1275                        final String errMsg = "key がセットされていません。"
1276                                                + " command=" + command ;                       // 5.1.8.0 (2010/07/01) errMsg 修正
1277                        throw new HybsSystemException( errMsg );
1278                }
1279                removeObject( key );
1280        }
1281
1282        /**
1283         * セッション/アプリケーションスコープのキャッシュ情報をクリアします。
1284         *
1285         * このクリアは、キーの前方一致で、大文字小文字の区別をせずにクリアします。
1286         * また、キーが null の場合は、"X_" で始めるもの以外のすべての値をクリアします。
1287         * また、Webエンジン内部で使用しているキーは、ここではクリアできません。
1288         *
1289         * @og.rev 3.1.0.1 (2003/03/26) クリアコマンドの追加。
1290         * @og.rev 4.3.4.0 (2008/12/01) PageContextのスコープをクラス変数としてアクセス
1291         *
1292         * @param key           キー
1293         */
1294        private void clearAttribute( final String key ) {
1295
1296                String lowKey = null;
1297                if( key != null ) { lowKey = key.toLowerCase(Locale.JAPAN); }
1298
1299                Enumeration<String> ekeys = pageContext.getAttributeNamesInScope( PageContext.APPLICATION_SCOPE );              // 4.3.3.6 (2008/11/15) Generics警告対応
1300                while( ekeys.hasMoreElements() ) {
1301                        final String ekey = ekeys.nextElement().toLowerCase(Locale.JAPAN);              // 4.3.3.6 (2008/11/15) Generics警告対応
1302                        if( ! ekey.startsWith( "h_") && ! ekey.startsWith( "x_") &&                             // 6.9.7.0 (2018/05/14) PMD Useless parentheses.
1303                                ( lowKey == null || ekey.startsWith( key ) ) ) {
1304                                        pageContext.removeAttribute( ekey, PageContext.APPLICATION_SCOPE ) ;
1305                        }
1306                }
1307
1308                ekeys = pageContext.getAttributeNamesInScope( PageContext.SESSION_SCOPE );
1309                while( ekeys.hasMoreElements() ) {
1310                        final String ekey = String.valueOf( ekeys.nextElement() ).toLowerCase(Locale.JAPAN);
1311                        if( ! ekey.startsWith( "h_") && ! ekey.startsWith( "x_") &&                             // 6.9.7.0 (2018/05/14) PMD Useless parentheses.
1312                                ( lowKey == null || ekey.startsWith( key ) ) ) {
1313                                        pageContext.removeAttribute( ekey, PageContext.SESSION_SCOPE ) ;
1314                        }
1315                }
1316        }
1317
1318        /**
1319         * 指定のスコープの内部キャッシュ情報を、指定のSQL文より作成します。
1320         *
1321         * @og.rev 3.1.0.1 (2003/03/26) 引数を与えて処理する様に変更する。
1322         * @og.rev 3.2.4.0 (2003/06/12) マルチデータ(複数件検索)を使用するかしないか。
1323         * @og.rev 3.8.6.0 (2006/08/07) nullSet="true"(初期値)の時は、検索結果がゼロ件時に "" をセットする。
1324         * @og.rev 3.8.9.2 (2007/07/28) action="ROW_APPEND" 追加
1325         * @og.rev 4.3.7.5 (2009/07/13) ACT_LIST、ACT_ALL_LIST アクションの追加
1326         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
1327         * @og.rev 5.5.0.3 (2012/03/12) ACT_MAP アクションの追加
1328         * @og.rev 5.6.4.3 (2013/05/24) tmpSelectedAll 属性追加。action="ALL_xxx"を tmpSelectedAll="true" に置き換えます。
1329         * @og.rev 6.2.4.2 (2015/05/29) ACT_MAPOBJ アクションの追加
1330         * @og.rev 6.2.6.0 (2015/06/19) キーの判定に、isEmpty() が漏れていた。
1331         * @og.rev 6.4.2.1 (2016/02/05) ACT_MAPOBJ アクションのMapを、TreeMap から LinkedHashMap に変更。
1332         * @og.rev 6.4.4.2 (2016/04/01) StringBuilderの代わりに、OgBuilderを使用する。
1333         * @og.rev 6.9.0.2 (2018/02/13) ACT_MAP,(ACT_ALL_MAP) で、第3カラム以降も、キー + '_番号(1~)' で、キーを作成します。
1334         * @og.rev 7.2.6.1 (2020/07/17) ACT_REQUEST追加
1335         * @og.rev 7.3.1.1 (2021/02/25) LIST アクションを、ArrayListからListに変更。
1336         * @og.rev 8.1.0.1 (2022/01/07) ACT_LIST_CSV、ACT_ALL_LIST_CSV,ACT_SET,ACT_ALL_SET,ACT_SET_CSV,ACT_ALL_SET_CSV アクションの追加
1337         *
1338         * @param table DBTableModelオブジェクト
1339         */
1340        private void setSQLAttribute( final DBTableModel table ) {
1341                if( table == null ) {           // 3.8.6.0 (2006/08/07)
1342                        return;
1343                }
1344
1345                final int clmCnt = table.getColumnCount();
1346                final int rowCnt = table.getRowCount();
1347                String sqlkey ;
1348                String sqlval ;
1349                String sufix = "";
1350
1351                if( ACT_ROW_APPEND.equals( action ) ) {
1352                        final OgBuilder buf = new OgBuilder();
1353                        for( int clmNo=0; clmNo<clmCnt; clmNo++ ) {
1354                                // 6.4.4.2 (2016/04/01)
1355                                final int clm = clmNo;                  // ラムダ式の引数に使えるのは、final変数のみ。
1356                                buf.clear();
1357                                buf.appendRoop( 0,rowCnt,separator
1358                                                                        , row -> table.getValue( row, clm ) );
1359                                sqlkey = table.getColumnName( clm );
1360                                setObject( sqlkey , buf.toString() );
1361                        }
1362                }
1363                // 4.3.7.5 (2009/07/13) ACT_LIST,ACT_LIST_CSV,ACT_ALL_LIST,ACT_ALL_LIST_CSV アクションの追加
1364                // 8.1.0.1 (2022/01/07) ACT_LIST_CSV,ACT_ALL_LIST_CSV 追加
1365//              else if( ACT_LIST.equals( action ) ) {
1366                else if( ACT_LIST.equals( action ) || ACT_LIST_CSV.equals( action ) ) {
1367                        final boolean useCSV = ACT_LIST_CSV.equals( action );
1368                        for( int clm=0; clm<clmCnt; clm++ ) {
1369//                              final ArrayList<String> list = new ArrayList<>();
1370                                final List<String> list = new ArrayList<>();                            // 7.3.1.1 (2021/02/25)
1371                                for( int row=0; row<rowCnt; row++ ) {
1372                                        sqlval = table.getValue( row, clm );
1373                                        list.add( sqlval );
1374                                }
1375                                sqlkey = table.getColumnName( clm );
1376//                              setObject( sqlkey , list );
1377                                if( useCSV ) {
1378                                        final String csv = list.stream().collect(Collectors.joining(","));
1379                                        setObject( sqlkey,csv );
1380                                }
1381                                else {
1382                                        setObject( sqlkey,list );
1383                                }
1384                        }
1385                }
1386                // 8.1.0.1 (2022/01/07) ACT_SET,ACT_ALL_SET,ACT_SET_CSV,ACT_ALL_SET_CSV アクションの追加
1387                else if( ACT_SET.equals( action ) || ACT_SET_CSV.equals( action ) ) {
1388                        final boolean useCSV = ACT_SET_CSV.equals( action );
1389                        for( int clm=0; clm<clmCnt; clm++ ) {
1390                                final Set<String> set = new LinkedHashSet<>();
1391                                for( int row=0; row<rowCnt; row++ ) {
1392                                        sqlval = table.getValue( row, clm );
1393                                        set.add( sqlval );
1394                                }
1395                                sqlkey = table.getColumnName( clm );
1396//                              setObject( sqlkey , set );
1397                                if( useCSV ) {
1398                                        final String csv = set.stream().collect(Collectors.joining(","));
1399                                        setObject( sqlkey , csv );
1400                                }
1401                                else {
1402                                        setObject( sqlkey , set );
1403                                }
1404                        }
1405                }
1406                // 5.5.0.3 (2012/03/12) ACT_MAP アクションの追加
1407                else if( ACT_MAP.equals( action )  ) {
1408                        if( clmCnt < 2 ) {
1409                                final String errMsg = "action=MAP 時には、カラムは、2つ以上必要です。カラム数=[" + clmCnt + "]";
1410                                throw new IllegalArgumentException( errMsg );
1411                        }
1412                        for( int row=0; row<rowCnt; row++ ) {
1413                                sqlkey = table.getValue( row, 0 );                      // 0番目カラムがキー
1414                                sqlval = table.getValue( row, 1 );                      // 1番目カラムが値
1415                                setObject( sqlkey , sqlval );
1416
1417                                // 6.9.0.2 (2018/02/13) ACT_MAP,(ACT_ALL_MAP) で、第3カラム以降も、キー + '_番号(1~)' で、キーを作成します。
1418                                for( int clm=2; clm<clmCnt; clm++ ) {
1419                                        final String keyN = sqlkey + "_" + (clm-1);             // 第3カラムは、キー + '_1' になります。
1420                                        sqlval = table.getValue( row, clm );                    // N番目カラムの値
1421                                        setObject( keyN , sqlval );
1422                                }
1423                        }
1424                }
1425                // 6.2.4.2 (2015/05/29) ACT_MAPOBJ アクションの追加
1426                else if( ACT_MAPOBJ.equals( action )  ) {
1427                        if( clmCnt < 2 ) {
1428                                final String errMsg = "action=MAPOBJ 時には、カラムは、2つ以上必要です。カラム数=[" + clmCnt + "]";
1429                                throw new IllegalArgumentException( errMsg );
1430                        }
1431                        if( key == null || key.isEmpty() ) {                    // 6.2.6.0 (2015/06/19)
1432                                key = table.getColumnName( 0 );                         // key が指定されていない場合は、最初のカラム名
1433                        }
1434                        final Map<String,String> mapObj = new LinkedHashMap<>();        // 6.4.2.1 (2016/02/05)
1435
1436                        for( int row=0; row<rowCnt; row++ ) {
1437                                sqlkey = table.getValue( row, 0 );                      // 0番目カラムがMapのキー
1438                                sqlval = table.getValue( row, 1 );                      // 1番目カラムがMapの値
1439                                mapObj.put( sqlkey,sqlval );
1440                        }
1441                        setObject( key , mapObj );
1442                }
1443                // 7.2.6.1 (2020/07/17) SQL処理なので、ループで判断させずにactionで分けておきます。
1444                else if( ACT_REQUEST.equals( action ) ) {
1445                        for( int row=0; row<rowCnt; row++ ) {
1446                                if( useMultiRows ) { sufix = String.valueOf( row ) ; }
1447                                for( int clm=0; clm<clmCnt; clm++ ) {
1448                                        sqlkey = table.getColumnName( clm );
1449                                        sqlval = table.getValue( row, clm );
1450                                        sqlval = getRequestParameter( sqlval );                 // SQLで取得した値を、変換します。
1451                                        setObject( sqlkey + sufix, sqlval );
1452                                }
1453                                if( ! useMultiRows ) { break; }
1454                        }
1455                }
1456                else {
1457                        // 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
1458                        if( rowCnt == 0 ) {
1459                                if( useMultiRows ) { sufix = "0" ; }
1460                                for( int clm=0; clm<clmCnt; clm++ ) {
1461                                        sqlkey = table.getColumnName( clm );
1462                                        sqlval = "";
1463                                        setObject( sqlkey + sufix, sqlval );
1464                                }
1465                        }
1466                        else {
1467                                for( int row=0; row<rowCnt; row++ ) {
1468                                        if( useMultiRows ) { sufix = String.valueOf( row ) ; }
1469                                        for( int clm=0; clm<clmCnt; clm++ ) {
1470                                                sqlkey = table.getColumnName( clm );
1471                                                sqlval = table.getValue( row, clm );
1472                                                setObject( sqlkey + sufix, sqlval );
1473                                        }
1474                                        if( ! useMultiRows ) { break; }
1475                                }
1476                        }
1477                }
1478        }
1479
1480        /**
1481         * 指定のSQL文の結果を文字列として画面に出力します。
1482         * 画面に出力される項目は、1項目だけで2項目以降は無視されます。
1483         *
1484         * @og.rev 5.1.7.0 (2010/06/01) SQLGET対応
1485         * @og.rev 6.4.4.2 (2016/04/01) StringBuilderの代わりに、OgBuilderを使用する。
1486         *
1487         * @param table DBTableModelオブジェクト
1488         *
1489         * @return SQL文の結果文字列
1490         */
1491        private String getSQLAttribute( final DBTableModel table ) {
1492                if( table == null ) {           // 3.8.6.0 (2006/08/07)
1493                        return "";
1494                }
1495
1496                final int rowCnt = table.getRowCount();
1497                final String rtn;
1498                if( ACT_ROW_APPEND.equals( action ) ) {
1499                        // 6.4.4.2 (2016/04/01)
1500                        rtn = new OgBuilder()
1501                                        .appendRoop( 0,rowCnt,separator
1502                                                                        , row -> table.getValue( row, 0 ) )
1503                                        .toString();
1504                }
1505                else if( rowCnt == 0 ) {
1506                        rtn = "";
1507                }
1508                else {
1509                        rtn = table.getValue( 0, 0 );
1510                }
1511
1512                return rtn;
1513        }
1514
1515        /**
1516         * 指定のスコープの内部キャッシュ情報に、DBTableModel の選択された値を登録します。
1517         *
1518         * 複数選択行が存在する場合は、先頭行を処理します。ただし、action="APPEND"の
1519         * 場合は、separator属性で指定された文字を使用して、連結します。
1520         *
1521         * @og.rev 3.1.0.1 (2003/03/26) 新規作成
1522         * @og.rev 3.5.6.5 (2004/08/09) ACT_APPEND 時の処理変更
1523         * @og.rev 3.6.1.0 (2005/01/05) ACT_ALL_APPEND アクションの追加
1524         * @og.rev 4.3.7.5 (2009/07/13) ACT_LIST、ACT_ALL_LIST アクションの追加
1525         * @og.rev 5.1.6.0 (2010/05/01) ALL_APPENDで選択行がない場合に処理されないバグを修正
1526         * @og.rev 5.5.0.3 (2012/03/12) ACT_MAP アクションの追加
1527         * @og.rev 5.6.4.3 (2013/05/24) ACT_MAX_MIN,ACT_ALL_MAX_MIN アクションの追加
1528         * @og.rev 5.6.4.3 (2013/05/24) tmpSelectedAll 属性追加。action="ALL_xxx"を tmpSelectedAll="true" に置き換えます。
1529         * @og.rev 6.2.4.2 (2015/05/29) ACT_MAPOBJ アクションの追加
1530         * @og.rev 6.4.2.1 (2016/02/05) ACT_MAPOBJ アクションのMapを、TreeMap から LinkedHashMap に変更。
1531         * @og.rev 6.4.4.2 (2016/04/01) StringBuilderの代わりに、OgBuilderを使用する。
1532         * @og.rev 6.4.4.2 (2016/04/01) contains 判定を行う新しいメソッドを使用します。
1533         * @og.rev 6.4.6.0 (2016/05/27) isNumber , isDate 追加。
1534         * @og.rev 7.3.1.1 (2021/02/25) LIST アクションを、ArrayListからListに変更。
1535         * @og.rev 8.1.0.1 (2022/01/07) ACT_LIST_CSV、ACT_ALL_LIST_CSV,ACT_SET,ACT_ALL_SET,ACT_SET_CSV,ACT_ALL_SET_CSV アクションの追加
1536         *
1537         * @param table         DBTableModelオブジェクト
1538         * @param key           キー
1539         * @param action        アクション
1540         */
1541        private void setTableAttribute( final DBTableModel table,final String key,final String action ) {
1542                if( table == null || table.getRowCount() == 0 || table.getColumnCount() == 0 ) { return ; }
1543
1544                final int[] rowNo = getParameterRows();
1545                // 5.1.6.0 (2010/05/01)
1546                if( rowNo.length == 0 ) { return; }                             // 5.6.4.3 (2013/05/24) tmpSelectedAll 属性を追加したので、0件判定が使える。
1547
1548                final String[] keys ;
1549                if( key == null || key.isEmpty() ) {
1550                        keys = table.getNames();
1551                }
1552                else if( key.indexOf( ',' ) >= 0 ) {
1553                        keys = StringUtil.csv2Array( key , ',' );       // 8.1.0.1 (2022/01/07) キーをカンマ区切りで渡せるようにする。
1554                }
1555                else {
1556                        keys = new String[] { key } ;
1557                }
1558
1559                // 5.6.4.3 (2013/05/24) tmpSelectedAll で、ロジックの共通化
1560                if( ACT_APPEND.equals( action ) ) {
1561                        final OgBuilder buf = new OgBuilder();
1562                        // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1563                        for( final String ky : keys ) {
1564                                final int clm = table.getColumnNo( ky );
1565//                      for( int i=0; i<keys.length; i++ ) {
1566//                              final int clm = table.getColumnNo( keys[i] );
1567                                // 6.4.4.2 (2016/04/01)
1568                                buf.clear();
1569                                buf.appendRoop( 0,rowNo.length,separator
1570                                                                        , j -> table.getValue( rowNo[j],clm ) );
1571                                setObject( ky,buf.toString() );
1572//                              setObject( keys[i],buf.toString() );
1573                        }
1574                }
1575
1576                // 5.5.0.3 (2012/03/12) ACT_MAP アクションの追加
1577                else if( ACT_MAP.equals( action ) ) {
1578                        int keyClm = table.getColumnNo( key   ,false );
1579                        int valClm = table.getColumnNo( value ,false );
1580
1581                        if( keyClm < 0 ) { keyClm = 0; }        // キーとなるカラムが指定されていない場合は、最初のカラム
1582                        if( valClm < 0 ) { valClm = 1; }        // 値となるカラムが指定されていない場合は、2番目のカラム
1583
1584                        // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1585                        for( final int row : rowNo ) {
1586                                final String mapkey = table.getValue( row, keyClm );
1587                                final String mapval = table.getValue( row, valClm );
1588                                setObject( mapkey , mapval );
1589                        }
1590//                      for( int j=0; j<rowNo.length; j++ ) {
1591//                              final String mapkey = table.getValue( rowNo[j], keyClm );
1592//                              final String mapval = table.getValue( rowNo[j], valClm );
1593//                              setObject( mapkey , mapval );
1594//                      }
1595                }
1596
1597                // 6.2.4.2 (2015/05/29) ACT_MAPOBJ アクションの追加
1598                else if( ACT_MAPOBJ.equals( action )  ) {
1599                        int keyClm = table.getColumnNo( key   ,false );
1600                        int valClm = table.getColumnNo( value ,false );
1601
1602                        if( keyClm < 0 ) { keyClm = 0; }        // キーとなるカラムが指定されていない場合は、最初のカラム
1603                        if( valClm < 0 ) { valClm = 1; }        // 値となるカラムが指定されていない場合は、2番目のカラム
1604
1605                        final Map<String,String> mapObj = new LinkedHashMap<>();        // 6.4.2.1 (2016/02/05)
1606                        // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1607                        for( final int row : rowNo ) {
1608                                final String mapkey = table.getValue( row, keyClm );
1609                                final String mapval = table.getValue( row, valClm );
1610                                mapObj.put( mapkey,mapval );
1611                        }
1612//                      for( int j=0; j<rowNo.length; j++ ) {
1613//                              final String mapkey = table.getValue( rowNo[j], keyClm );
1614//                              final String mapval = table.getValue( rowNo[j], valClm );
1615//                              mapObj.put( mapkey,mapval );
1616//                      }
1617                        setObject( key , mapObj );
1618                }
1619
1620                // 4.3.7.5 (2009/07/13) ACT_LIST,ACT_LIST_CSV,ACT_ALL_LIST,ACT_ALL_LIST_CSV アクションの追加
1621                // 8.1.0.1 (2022/01/07) ACT_LIST_CSV,ACT_ALL_LIST_CSV 追加
1622//              else if( ACT_LIST.equals( action ) ) {
1623                else if( ACT_LIST.equals( action ) || ACT_LIST_CSV.equals( action ) ) {
1624                        final boolean useCSV = ACT_LIST_CSV.equals( action );
1625                        // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1626                        for( final String ky : keys ) {
1627                                final int clm = table.getColumnNo( ky );
1628                                final List<String> list = new ArrayList<>();                            // 7.3.1.1 (2021/02/25)
1629                                // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1630                                for( final int row : rowNo ) {
1631                                        list.add( table.getValue( row,clm ) );
1632                                }
1633//                              setObject( ky,list );
1634                                if( useCSV ) {
1635                                        final String csv = list.stream().collect(Collectors.joining(","));
1636                                        setObject( ky,csv );
1637                                }
1638                                else {
1639                                        setObject( ky,list );
1640                                }
1641                        }
1642                }
1643
1644                // 8.1.0.1 (2022/01/07) ACT_SET,ACT_ALL_SET,ACT_SET_CSV,ACT_ALL_SET_CSV アクションの追加
1645                else if( ACT_SET.equals( action ) || ACT_SET_CSV.equals( action ) ) {
1646                        final boolean useCSV = ACT_SET_CSV.equals( action );
1647                        for( final String ky : keys ) {
1648                                final int clm = table.getColumnNo( ky );
1649                                final Set<String> set = new LinkedHashSet<>();
1650                                for( final int row : rowNo ) {
1651                                        set.add( table.getValue( row,clm ) );
1652                                }
1653//                              setObject( ky,set );
1654                                if( useCSV ) {
1655                                        final String csv = set.stream().collect(Collectors.joining(","));
1656                                        setObject( ky,csv );
1657                                }
1658                                else {
1659                                        setObject( ky,set );
1660                                }
1661                        }
1662                }
1663
1664                // 5.6.4.3 (2013/05/24) ACT_MAX_MIN アクションの追加
1665                else if( ACT_MAX_MIN.equals( action ) ) {
1666                        NumberFormat nf = null;
1667                        // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1668                        for( final String ky : keys ) {
1669                                final int clm = table.getColumnNo( ky );
1670//                      for( int i=0; i<keys.length; i++ ) {
1671//                              final int clm = table.getColumnNo( keys[i] );
1672                                final DBColumn clmObj = table.getDBColumn( clm );
1673                                // 6.4.4.2 (2016/04/01) contains 判定を行う新しいメソッドを使用します。
1674                                final boolean numFlag = clmObj.isNumberType();          // 6.4.6.0 (2016/05/27) 数字型:true
1675
1676                                String minVal = null ;
1677                                String maxVal = null ;
1678                                double minNum = Double.MAX_VALUE ;
1679                                double maxNum = Double.MIN_VALUE ;
1680                                double sumNum = 0d ;
1681                                int    cntSum = 0;              // 平均計算に有効な件数
1682
1683                                // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1684                                for( final int row : rowNo ) {
1685                                        final String val = table.getValue( row,clm );
1686//                              for( int j=0; j<rowNo.length; j++ ) {
1687//                                      final String val = table.getValue( rowNo[j],clm );
1688                                        if( val != null && val.length() > 0 ) {
1689                                                // 数字として比較
1690                                                if( numFlag ) {
1691                                                        final double tmp = Double.parseDouble( val );
1692                                                        if( minNum > tmp ) { minNum = tmp; minVal = val; }
1693                                                        if( maxNum < tmp ) { maxNum = tmp; maxVal = val; }
1694                                                        sumNum += tmp ;  cntSum++ ;
1695                                                }
1696                                                else {
1697                                                        // 文字列として比較
1698                                                        if( minVal == null || minVal.compareTo( val ) > 0 ) { minVal = val; }   // 最初のデータは、必ずセットする。
1699                                                        if( maxVal == null || maxVal.compareTo( val ) < 0 ) { maxVal = val; }   // 最初のデータは、必ずセットする。
1700                                                }
1701                                        }
1702                                }
1703                                if( minVal == null ) { minVal = nval( defaultVal , "" ); }              // 最後まで値が決まらなければ、""(空文字列) にする。
1704                                if( maxVal == null ) { maxVal = nval( defaultVal , "" ); }              // 最後まで値が決まらなければ、""(空文字列) にする。
1705                                setObject( "MIN." + ky,minVal );
1706                                setObject( "MAX." + ky,maxVal );
1707//                              setObject( "MIN." + keys[i],minVal );
1708//                              setObject( "MAX." + keys[i],maxVal );
1709
1710                                // SUM と AVG は、数字型の場合のみセットします。
1711                                if( cntSum > 0 ) {
1712                                        if( nf == null ) {
1713                                                nf = NumberFormat.getInstance();
1714                                                nf.setGroupingUsed( false );                                    // カンマ編集なし
1715                                                nf.setMaximumFractionDigits(2);                                 // 最大小数部は2桁
1716                                                nf.setMinimumFractionDigits(0);                                 // できれば、整数表示
1717                                        }
1718                                        setObject( "SUM." + ky,nf.format( sumNum ) );           // Double.toString( sumNum ) の代わり。
1719                                        setObject( "AVG." + ky,nf.format( sumNum/cntSum ) );
1720//                                      setObject( "SUM." + keys[i],nf.format( sumNum ) );              // Double.toString( sumNum ) の代わり。
1721//                                      setObject( "AVG." + keys[i],nf.format( sumNum/cntSum ) );
1722                                }
1723                                else {
1724                                        setObject( "SUM." + ky,nval( defaultVal , "" ) );
1725                                        setObject( "AVG." + ky,nval( defaultVal , "" ) );
1726//                                      setObject( "SUM." + keys[i],nval( defaultVal , "" ) );
1727//                                      setObject( "AVG." + keys[i],nval( defaultVal , "" ) );
1728                                }
1729                        }
1730                }
1731                else {
1732                        // 7.2.9.4 (2020/11/20) PMD:This for loop can be replaced by a foreach loop
1733                        for( final String ky : keys ) {
1734                                final int clm = table.getColumnNo( ky );
1735                                setAttribute( key,table.getValue( rowNo[0],clm ),action );
1736                        }
1737//                      for( int i=0; i<keys.length; i++ ) {
1738//                              final int clm = table.getColumnNo( keys[i] );
1739//                              setAttribute( keys[i],table.getValue( rowNo[0],clm ),action );
1740//                      }
1741                }
1742        }
1743
1744        /**
1745         * DBTableModel の選択された値を取得します。
1746         *
1747         * 複数選択行が存在する場合は、先頭行を処理します。ただし、action="APPEND"の
1748         * 場合は、separator属性で指定された文字を使用して、連結します。
1749         *
1750         * @og.rev 3.1.0.1 (2003/03/26) 新規作成
1751         * @og.rev 3.5.6.5 (2004/08/09) ACT_APPEND 時の処理変更
1752         * @og.rev 3.6.1.0 (2005/01/05) ACT_ALL_APPEND アクションの追加
1753         * @og.rev 5.1.6.0 (2010/05/01) ALL_APPENDで選択行がない場合に処理されないバグを修正
1754         * @og.rev 5.6.4.3 (2013/05/24) tmpSelectedAll 属性追加。action="ALL_xxx"を tmpSelectedAll="true" に置き換えます。
1755         * @og.rev 6.4.4.2 (2016/04/01) StringBuilderの代わりに、OgBuilderを使用する。
1756         *
1757         * @param       table   DBTableModelオブジェクト
1758         * @param       key             キー
1759         * @param       action  アクション
1760         *
1761         * @return      DBTableModelの選択された値
1762         */
1763        private String getTableAttribute( final DBTableModel table,final String key,final String action ) {
1764                if( table == null ) {
1765                        final String errMsg = "table がセットされていません。"
1766                                                + " command=" + command + " , action=" + action
1767                                                + " , key=" + key ;                     // 5.1.8.0 (2010/07/01) errMsg 修正
1768                        throw new HybsSystemException( errMsg );
1769                }
1770
1771                if( key == null || key.isEmpty() ) {
1772                        final String errMsg = "key がセットされていません。"
1773                                                + " command=" + command + " , action=" + action;                        // 5.1.8.0 (2010/07/01) errMsg 修正
1774                        throw new HybsSystemException( errMsg );
1775                }
1776
1777                final int[] rowNo = getParameterRows();
1778                // 5.1.6.0 (2010/05/01)
1779                if( rowNo.length == 0 ) { return "" ; }                         // 5.6.4.3 (2013/05/24) tmpSelectedAll 属性を追加したので、0件判定が使える。
1780
1781                // 3.6.1.0 (2005/01/05) ACT_ALL_APPEND アクションの追加
1782                final int clm = table.getColumnNo( key );
1783                if( ACT_APPEND.equals( action ) ) {
1784                        // 6.4.4.2 (2016/04/01)
1785                        return new OgBuilder()
1786                                        .appendRoop( 0,rowNo.length,separator
1787                                                                        , j -> table.getValue( rowNo[j],clm ) )
1788                                        .toString();
1789                }
1790                else {
1791                        return actionExec( action,table.getValue( rowNo[0],clm ) );
1792                }
1793        }
1794
1795        /**
1796         * 指定のスコープの内部キャッシュ情報に、DBTableModel の選択された値を登録します。
1797         *
1798         * これは、key で指定したカラムの値をキーとして、value で指定したカラムの値を
1799         * value 値として設定します。
1800         * setTableAttribute が、カラム(横持ち)データを処理するのに対して、
1801         * ロウ(縦持ち)データを処理することが出来ます。
1802         *
1803         * 8.1.0.1 (2022/01/07)
1804         *  command="SETTBL" の場合の action="APPEND,LIST,SET,MAX_MIN" の場合は、
1805         *  key をカンマで分解して、複数指定できるようにします。
1806         *
1807         * @og.rev 3.1.0.1 (2003/03/26) 新規作成
1808         * @og.rev 3.3.3.3 (2003/08/06) key 情報がデータの値になっていた。バグ修正。
1809         * @og.rev 3.5.6.5 (2004/08/09) ACT_APPEND 時の処理変更
1810         * @og.rev 6.4.4.2 (2016/04/01) StringBuilderの代わりに、OgBuilderを使用する。
1811         *
1812         * @param table         DBTableModelオブジェクト
1813         * @param key           キー
1814         * @param value         値
1815         * @param action        アクション
1816         */
1817        private void setKeyTableAttribute( final DBTableModel table,final String key,final String value,final String action ) {
1818                if( table == null ) { return ; }
1819
1820                if( key == null || key.isEmpty() ) {
1821                        final String errMsg = "key がセットされていません。"
1822                                                + " command=" + command + " , action=" + action
1823                                                + " , value=" + value ;                 // 5.1.8.0 (2010/07/01) errMsg 修正
1824                        throw new HybsSystemException( errMsg );
1825                }
1826
1827                final int[] rowNo = getParameterRows();
1828                if( rowNo.length == 0 ) { return ; }
1829
1830                final int[] valClm ;
1831                if( value == null || value.isEmpty() ) {
1832                        final String[] vals = table.getNames();
1833                        valClm = new int[vals.length];
1834                        for( int i=0; i<vals.length; i++ ) {
1835                                valClm[i] = table.getColumnNo( vals[i] );
1836                        }
1837                }
1838                else {
1839                        valClm = new int[] { table.getColumnNo( value ) } ;
1840                }
1841
1842                // 6.4.4.2 (2016/04/01)
1843                final OgBuilder buf = new OgBuilder();
1844                for( int j=0; j<rowNo.length; j++ ) {
1845                        final String rowKey = key + j ;
1846                        final int rNo = rowNo[j];
1847                        if( ACT_APPEND.equals( action ) ) {
1848                                buf.clear();
1849                                buf.appendRoop( 0,valClm.length,separator
1850                                                                        , i -> table.getValue( rNo,valClm[i] ) );
1851                                setObject( rowKey,buf.toString() );
1852                        }
1853                        else {
1854                                setAttribute( rowKey,table.getValue( rNo,valClm[0] ),action );
1855                        }
1856                }
1857        }
1858
1859        /**
1860         * 指定のスコープに登録されているパラメータ(アトリビュート)を返します。
1861         *
1862         * 従来は、debug="true" で出力していましたが、情報量が多すぎるため、
1863         * それぞれ指定することが出来るようにします。
1864         *
1865         * @og.rev 6.7.7.2 (2017/04/14) command に、DEBUG 追加
1866         *
1867         * @return      scopeに応じた値
1868         */
1869        private String scopeAttributePrint() {
1870                final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE )
1871                        .append( "====================================" ).append( CR );
1872
1873                if( "application".equals( scope ) ) {
1874                        rtn.append( "APPLICATION_SCOPE:" ).append( CR );
1875
1876                        final Enumeration<String> ekeys = pageContext.getAttributeNamesInScope( PageContext.APPLICATION_SCOPE );        // 4.3.3.6 (2008/11/15) Generics警告対応
1877                        while( ekeys.hasMoreElements() ) {
1878                                final String ekey = ekeys.nextElement();                // 4.3.3.6 (2008/11/15) Generics警告対応
1879                                // 6.0.2.5 (2014/10/31) char を append する。
1880                                rtn.append( "  key=[" ).append( ekey )
1881                                        .append( "] value=[" )
1882                                        .append( pageContext.getAttribute( ekey,PageContext.APPLICATION_SCOPE ) )
1883                                        .append( ']' ).append( CR );
1884                        }
1885                }
1886
1887                if( "session".equals( scope ) ) {
1888                        rtn.append( "SESSION_SCOPE:" ).append( CR );
1889                        final Enumeration<String> ekeys = pageContext.getAttributeNamesInScope( PageContext.SESSION_SCOPE );
1890                        while( ekeys.hasMoreElements() ) {
1891                                final String ekey = String.valueOf( ekeys.nextElement() );
1892                                // 6.0.2.5 (2014/10/31) char を append する。
1893                                rtn.append( "  key=[" ).append( ekey )
1894                                        .append( "] value=[" )
1895                                        .append( pageContext.getAttribute( ekey,PageContext.SESSION_SCOPE ) )
1896                                        .append( ']' ).append( CR );
1897                        }
1898                }
1899
1900                if( "request".equals( scope ) ) {
1901                        rtn.append( "REQUEST_SCOPE:" ).append( CR );
1902                        final Enumeration<String> ekeys = pageContext.getAttributeNamesInScope( PageContext.REQUEST_SCOPE );
1903                        while( ekeys.hasMoreElements() ) {
1904                                final String ekey = String.valueOf( ekeys.nextElement() );
1905                                // 6.0.2.5 (2014/10/31) char を append する。
1906                                rtn.append( "  key=[" ).append( ekey )
1907                                        .append( "] value=[" )
1908                                        .append( pageContext.getAttribute( ekey,PageContext.REQUEST_SCOPE ) )
1909                                        .append( ']' ).append( CR );
1910                        }
1911                }
1912
1913                if( "page".equals( scope ) ) {
1914                        rtn.append( "PAGE_SCOPE:" ).append( CR );
1915                        final Enumeration<String> ekeys = pageContext.getAttributeNamesInScope( PageContext.PAGE_SCOPE );
1916                        while( ekeys.hasMoreElements() ) {
1917                                final String ekey = String.valueOf( ekeys.nextElement() );
1918                                // 6.0.2.5 (2014/10/31) char を append する。
1919                                rtn.append( "  key=[" ).append( ekey )
1920                                        .append( "] value=[" )
1921                                        .append( pageContext.getAttribute( ekey,PageContext.PAGE_SCOPE ) )
1922                                        .append( ']' ).append( CR );
1923                        }
1924                }
1925
1926                rtn.append( "====================================" ).append( CR );
1927
1928                return rtn.toString();
1929        }
1930
1931        /**
1932         * 表示データの HybsSystem.ROW_SEL_KEY を元に、選ばれた 行を処理の対象とします。
1933         *
1934         * action="FIRST" 処理と、tmpSelectedAll 属性追加に伴う処理を、Override します。
1935         *
1936         * @og.rev 3.1.0.1 (2003/03/26) 新規作成
1937         * @og.rev 4.0.0.0 (2005/01/31) メイン処理を、super class で対応
1938         * @og.rev 3.8.0.4 (2005/08/08) action="FIRST" 機能の追加
1939         * @og.rev 5.6.4.3 (2013/05/24) tmpSelectedAll 属性の追加に伴い、全件選択状態のデータを作成します。
1940         * @og.rev 7.3.1.1 (2021/02/25) action="VIEWFIRST" 機能の追加
1941         *
1942         * @return      選択行の配列
1943         * @og.rtnNotNull
1944         */
1945        @Override
1946        protected int[] getParameterRows() {
1947                final int[] rowNo ;
1948                // 3.8.0.4 (2005/08/08) action="FIRST" 機能の追加
1949                if( ACT_FIRST.equals( action ) ) {
1950                        rowNo = new int[] { 0 };
1951                }
1952                // 7.3.1.1 (2021/02/25) action="VIEWFIRST" 機能の追加
1953                else if( ACT_VIEWFIRST.equals( action ) ) {
1954                        final int startNo = nval( getRequestCacheData( "startNo" ),0 );         // viewFormでリクエストキャッシュに登録している値を取り出す。
1955                        rowNo = new int[] { startNo };
1956                }
1957                // 5.6.4.3 (2013/05/24) tmpSelectedAll 属性の追加
1958                else if( tmpSelectedAll ) {
1959                        final int rowCnt = table.getRowCount();
1960                        rowNo = new int[ rowCnt ];
1961                        for( int i=0; i<rowCnt; i++ ) {
1962                                rowNo[i] = i;
1963                        }
1964                }
1965                else {
1966                        rowNo = super.getParameterRows() ;
1967                }
1968                return rowNo ;
1969        }
1970
1971        /**
1972         * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
1973         *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
1974         *
1975         * @og.tag
1976         * 検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に
1977         * 渡す場合に、通常は、session を利用します。その場合の登録キーです。
1978         * query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、
1979         * この tableId 属性を利用して、メモリ空間を分けます。
1980         *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
1981         *
1982         * @param       id テーブルID (sessionに登録する時のID)
1983         */
1984        public void setTableId( final String id ) {
1985                tableId   = nval( getRequestParameter( id ),tableId );
1986        }
1987
1988        /**
1989         * 【TAG】コマンド (SET,GET,REMOVE,SQL,SETTBL,GETTBL,KEYTBL,CLEAR,SETMEM)をセットします(初期値:SET)。
1990         *
1991         * @og.tag
1992         * コマンドは,HTMLから(get/post)指定されますので,CMD_xxx で設定される
1993         * フィールド定数値のいづれかを、指定できます。
1994         * 何も設定されない、または、null の場合は、"SET" が初期値にセットされます。
1995         *
1996         * CLEAR 以外のすべての処理は、指定のスコープの内部キャッシュ情報に対して行われます。
1997         * <table class="plain">
1998         *   <caption>コマンド 一覧</caption>
1999         *   <tr><th>command </th><th>名称      </th><th>機能</th></tr>
2000         *   <tr><td>SET     </td><td>セット       </td><td>指定のキーに、value値を登録します。</td></tr>
2001         *   <tr><td>GET     </td><td>ゲット      </td><td>指定のキーの値を画面に出力します。</td></tr>
2002         *   <tr><td>REMOVE  </td><td>リムーブ     </td><td>指定のキーの値を削除します。</td></tr>
2003         *   <tr><td>CLEAR   </td><td>クリア       </td><td>セッション/アプリケーションスコープのキャッシュ情報をクリアします。</td></tr>
2004         *   <tr><td>SQL     </td><td>SQL    </td><td>指定のSQL文の実行結果を、カラム名をキーとして設定します。(useMultiRows="false" 時は、最初のデータを使用)</td></tr>
2005         *   <tr><td>SQLGET  </td><td>SQLゲット</td><td>指定のSQL文の実行結果を、画面に出力します。(2項目以降は無視されます)。</td></tr>
2006         *   <tr><td>SETTBL  </td><td>セットテーブル  </td><td>指定のキーに、DBTableModel の選択されたカラム(横持ち)の値を登録します。</td></tr>
2007         *   <tr><td>GETTBL  </td><td>ゲットテーブル </td><td>指定のキーに、DBTableModel の選択されたカラム(横持ち)の値を画面に出力します。</td></tr>
2008         *   <tr><td>KEYTBL  </td><td>キーテーブル   </td><td>指定のキーに、DBTableModel の選択されたロウ(縦持ち)の値を登録します。</td></tr>
2009         *   <tr><td>SETMEM  </td><td>セットメモリ    </td><td>指定のキーに、value値を内部キャッシュに登録します。</td></tr>
2010         *   <tr><td>DEBUG   </td><td>デバッグ   </td><td>指定のスコープに登録されているパラメータ(アトリビュート)を返します。</td></tr>
2011         * </table>
2012         *
2013         * @og.rev 3.1.0.1 (2003/03/26) 指定のコマンド以外は、エラーとするように変更。
2014         * @og.rev 3.5.6.2 (2004/07/05) 文字列の連結にStringBuilderを使用します。
2015         * @og.rev 6.3.4.0 (2015/08/01) Arrays.toString から String.join に置き換え。
2016         * @og.rev 6.7.7.2 (2017/04/14) command に、DEBUG 追加
2017         *
2018         * @param       cmd コマンド (public static final 宣言されている文字列)
2019         * @see         <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.ValueTag.CMD_GET">コマンド定数</a>
2020         */
2021        public void setCommand( final String cmd ) {
2022                command = nval( getRequestParameter( cmd ),command ).toUpperCase(Locale.JAPAN);
2023
2024                if( !check( command, COMMAND_SET ) ) {
2025                        final String errMsg = "指定のコマンドは実行できません。コマンドエラー"       + CR
2026                                                                + "command=[" + command + "] "                                                  + CR
2027                                                                + "commandList=[" + String.join( ", " , COMMAND_SET ) + "]" ;
2028                        throw new HybsSystemException( errMsg );
2029                }
2030        }
2031
2032        /**
2033         * 【TAG】アクション(UPPER,LOWER,MESSAGE,APPEND,ALL_APPEND,MAP,ALL_MAP,MAPOBJ,ALL_MAPOBJ,LIST,ALL_LIST,SET,ALL_SET,DAY_WEEK,
2034         *        MERGE,FIRST,VIEWFIRST,ROW_APPEND,REPLACE,INDEX_OF,LASTINDEX_OF,SUBSTR,LENGTH,
2035         *        SPLIT,SPLIT_LIST,FOR,FOR_LIST,FORTM,FORTM_LIST,MAX_MIN,ALL_MAX_MIN,ADD,CASE,ESCAPE,
2036         *        URL_ENCODE,URL_ENCODE2,URL_DECODE,TRIM,HASH,TO_NUMBER,TO_DATE,HMCSV,CRYPT_ENC,CRYPT_DEC,REQUEST,FORMAT)をセットします。
2037         *
2038         * @og.tag
2039         * アクションは,HTMLから(get/post)指定されますので,ACT_xxx で設定される
2040         * フィールド定数値のいづれかを、指定できます。
2041         * 無指定の場合は、なにもしません。
2042         *
2043         * <table class="plain">
2044         *   <caption>アクション 一覧</caption>
2045         *   <tr><th>action      </th><th>名称              </th><th>機能</th></tr>
2046         *   <tr><td>UPPER       </td><td>アッパー(大文字化)   </td><td>value値を大文字に変換します。</td></tr>
2047         *   <tr><td>LOWER       </td><td>ローワー(小文字化)    </td><td>value値を小文字に変換します。</td></tr>
2048         *   <tr><td>MESSAGE     </td><td>メッセージ変換        </td><td>引数をメッセージリソースのキーとして、メッセージ変換します。</td></tr>
2049         *   <tr><td>APPEND      </td><td>データアペンド        </td><td>複数リクエストや複数選択時に値を連結します。</td></tr>
2050         *   <tr><td>ALL_APPEND  </td><td>オールアペンド         </td><td>SETTBL,GETTBL 時に、チェック行以外の全行を対象に値の連結を行います。</td></tr>
2051         *   <tr><td>MAP         </td><td>マップ              </td><td>検索結果やTableModelのkeyをキーに、valueを値に一括設定します。※③</td></tr>
2052         *   <tr><td>ALL_MAP     </td><td>オールマップ           </td><td>全行を対象に検索結果やTableModelのkeyをキーに、valueを値に一括設定します。※③</td></tr>
2053         *   <tr><td>MAPOBJ      </td><td>マップオブジェクト      </td><td>検索結果やTableModelのkeyに、キーと値のMapを設定します。6.2.4.2 (2015/05/29)</td></tr>
2054         *   <tr><td>ALL_MAPOBJ  </td><td>オールマップオブジェクト   </td><td>全行を対象に検索結果やTableModelのkeyに、キーと値のMapを設定します。6.2.4.2 (2015/05/29)</td></tr>
2055         *   <tr><td>LIST        </td><td>リスト               </td><td>複数リクエストや複数選択時に値をArrayListにセットします。4.3.7.5 (2009/07/13)</td></tr>
2056         *   <tr><td>LIST_CSV    </td><td>リストCSV            </td><td>複数リクエストや複数選択時に値をArrayListにセット後CSV化します。8.1.0.1 (2022/01/07)</td></tr>
2057         *   <tr><td>ALL_LIST    </td><td>オールリスト            </td><td>全行を対象に値をArrayListにセットします。4.3.7.5 (2009/07/13)</td></tr>
2058         *   <tr><td>ALL_LIST_CSV</td><td>オールリストCSV         </td><td>全行を対象に値をArrayListにセットセット後CSV化します。8.1.0.1 (2022/01/07)</td></tr>
2059         *   <tr><td>SET         </td><td>セット               </td><td>複数リクエストや複数選択時に値を順序を保持したユニークな集合(LinkedHashSet)にします。8.1.0.1 (2022/01/07)</td></tr>
2060         *   <tr><td>SET_CSV     </td><td>セットCSV            </td><td>複数リクエストや複数選択時に値を順序を保持したユニークな集合(LinkedHashSet)後CSV化します。8.1.0.1 (2022/01/07)</td></tr>
2061         *   <tr><td>ALL_SET     </td><td>オールセット            </td><td>全行を対象に値を順序を保持したユニークな集合(LinkedHashSet)にします。8.1.0.1 (2022/01/07)</td></tr>
2062         *   <tr><td>ALL_SET_CSV </td><td>オールセットCSV         </td><td>全行を対象に値を順序を保持したユニークな集合(LinkedHashSet)後CSV化にします。8.1.0.1 (2022/01/07)</td></tr>
2063         *   <tr><td>DAY_WEEK    </td><td>日付前方まるめ    </td><td>日付型文字列(YYYYMMDD) の値を、月曜日に変換します。</td></tr>
2064         *   <tr><td>            </td><td>                  </td><td>指定日が日曜日の場合は、次の日(月曜日)に進めます。その他は、週始めに戻します。</td></tr>
2065         *   <tr><td>MERGE       </td><td>データのマージ        </td><td>重複を除く、ユニークな値に、マージします。(カンマで分解、separatorで合成)</td></tr>
2066         *   <tr><td>FIRST       </td><td>1件目取得        </td><td>最初の1件目を強制的に選択状態にして、処理を行います。</td></tr>
2067         *   <tr><td>VIEWFIRST   </td><td>表示1件目取得    </td><td>7.3.1.1 (2021/02/25) 現在表示の1件目を強制的に選択状態にして、処理を行います。</td></tr>
2068         *   <tr><td>ROW_APPEND  </td><td>検索結果の連結    </td><td>検索結果の行方向のデータを連結します。</td></tr>
2069         *   <tr><td>REPLACE     </td><td>文字列置換        </td><td>value の値から、指定された正規表現(from)の部分文字列を、部分文字列(to)で置換します。</td></tr>
2070         *   <tr><td>INDEX_OF    </td><td>最初に出現する位置</td><td>value の値から、指定された(separator)が、fromVal以降に最初に出現する位置。※⑤</td></tr>
2071         *   <tr><td>LASTINDEX_OF</td><td>最後に出現する位置</td><td>value の値から、指定された(separator)が、toVal以前に最後に出現する位置。※⑤</td></tr>
2072         *   <tr><td>SUBSTR      </td><td>部分文字列        </td><td>value の値から、指定された(fromVal)から(toVal)の部分文字列を作成します。</td></tr>
2073         *   <tr><td>LENGTH      </td><td>文字数(char数)    </td><td>value の文字数(char数)をカウントします。</td></tr>
2074         *   <tr><td>SPLIT       </td><td>文字列分割        </td><td>value の値から、指定されたseparatorで分割した文字列を作成します。(key+0~連番)</td></tr>
2075         *   <tr><td>SPLIT_LIST  </td><td>文字列分割LIST登録</td><td>value の値から、指定されたseparatorで分割した文字列をLISTに登録します。 7.3.1.1 (2021/02/25)</td></tr>
2076         *   <tr><td>FOR         </td><td>繰返文字合成      </td><td>value の値に、fromVal,toVal,skipVal を使用した連結文字列を作成する。7.3.1.1 (2021/02/25)※⑥</td></tr>
2077         *   <tr><td>FOR_LIST    </td><td>繰返文字合成LIST登録</td><td>value の値に、fromVal,toVal,skipVal を使用した文字列をLISTに登録します。 7.3.1.1 (2021/02/25)※⑥</td></tr>
2078         *   <tr><td>FORTM       </td><td>繰返日付文字合成  </td><td>fromVal,toVal,skipVal を使用した連結日付文字列(format指定可)を作成する。8.0.1.2 (2021/11/19)※⑦</td></tr>
2079         *   <tr><td>FORTM_LIST  </td><td>繰返日付文字合成LIST登録</td><td>fromVal,toVal,skipVal を使用した日付文字列(format指定可)をLISTに登録します。 8.0.1.2 (2021/11/19)※⑦</td></tr>
2080         *   <tr><td>MAX_MIN     </td><td>最大_最小値       </td><td>選択行のkeyのカラムの最小値,最大値を、MIN.キー、MAX.キー の値にセットします。 5.6.4.3 (2013/05/24) ※①</td></tr>
2081         *   <tr><td>ALL_MAX_MIN </td><td>最大_最小値       </td><td>全行を対象にkeyのカラムの最小値,最大値を、MIN.キー、MAX.キー の値にセットします。 5.6.4.3 (2013/05/24) ※①</td></tr>
2082         *   <tr><td>EXEC 廃止   </td><td>計算結果          </td><td>【廃止】value またはBODY部の値を、JavaScriptで計算した結果をセットします。7.3.0.0 (2021/01/06)</td></tr>
2083         *   <tr><td>ADD         </td><td>計算結果          </td><td>defaultVal の 値と、(value またはBODY部の)値を、加算した結果をキー変数にセットします。7.3.0.0 (2021/01/06)</td></tr>
2084         *   <tr><td>CASE        </td><td>条件分岐          </td><td>fromVal="A:1 B:2 C:3 D:4" 形式の値を元に、value値(左辺)に一致する右辺をセットします。 5.7.7.2 (2014/06/20) ※②</td></tr>
2085         *   <tr><td>ESCAPE      </td><td>エスケープ文字        </td><td>HTML上のエスケープ文字(&amp;lt;,&amp;gt;,&amp;quot;,&amp;apos;,&amp;amp;)を変換します。</td></tr>
2086         *   <tr><td>URL_ENCODE  </td><td>URLエンコード         </td><td>UTF-8 で、URLエンコードを行います。</td></tr>
2087         *   <tr><td>URL_ENCODE2 </td><td>ASCII以外の文字のURLエンコード</td><td>UTF-8 で、ASCII以外の文字の、URLエンコードします。</td></tr>
2088         *   <tr><td>URL_DECODE  </td><td>URLデコード         </td><td>UTF-8 でURLエンコードされた文字列をデコードします。</td></tr>
2089         *   <tr><td>TRIM        </td><td>スペース削除         </td><td>両端空白文字(スペース、タブ、改行等)を削除します。6.4.1.2 (2016/01/22)</td></tr>
2090         *   <tr><td>HASH        </td><td>ハッシュ変換          </td><td>値をformatに指定されたハッシュコードで計算します。8.1.2.0 (2022/03/10) Add</td></tr>
2091         *   <tr><td>TO_NUMBER   </td><td>数値変換          </td><td>値から、数値以外の文字を削除します。例えば、日付、金額など、区切り記号等を削除します。6.7.4.0 (2017/02/10)</td></tr>
2092         *   <tr><td>TO_DATE     </td><td>日付変換          </td><td>日付文字列から、数値以外の文字を削除します。(/,-,:,' ',Tなどを削除) 8.0.1.2 (2021/11/19)※⑧</td></tr>
2093         *   <tr><td>HMCSV       </td><td>時間(分)分割CSV   </td><td>ステップ時間を分で指定します(例:1時間=60,2時間=120,45分=45など)。
2094         *   <tr><td>            </td><td>                  </td><td>valueには、初期日付(YMD形式)を設定します。6.8.4.1 (2017/12/18)※④</td></tr>
2095         *   <tr><td>CRYPT_ENC   </td><td>暗号化変換        </td><td>HybsCryptographyによる暗号化を行います。暗号化キーは、cryptKey 属性で指定します。5.10.4.0 (2018/10/05)</td></tr>
2096         *   <tr><td>CRYPT_DEC   </td><td>暗号化復号        </td><td>HybsCryptographyによる復号化を行います。復号化キーは、cryptKey 属性で指定します。5.10.4.0 (2018/10/05)</td></tr>
2097         *   <tr><td>REQUEST     </td><td>リクエスト変数変換     </td><td>SQLなどで直接取得したデータを、リクエスト変換({&#064;XXXX}変換)します。7.2.6.1 (2020/07/17)</td></tr>
2098         *   <tr><td>FORMAT      </td><td>数字フォーマット変換    </td><td>value(数字)の値から、format<del>fromVal</del>に指定された書式文字列に変換します。7.4.2.0 (2021/05/08)</td></tr>
2099         * </table>
2100//       *           MD5                  MD5変換                    値をMD5変換します。 8.1.2.0 (2022/03/10) Delete
2101         *
2102         * ※① MAX_MIN,ALL_MAX_MIN  については、DBTableModelのカラムのCLS_NAMEが、NUMBER,INTEGER,DECIMAL の場合は、数字型(double)に変換して比較します。
2103         *     数字型(double)の場合だけ、合計(SUM.キー) と 平均(AVG.キー)計算も同時に行います。
2104         *     それ以外の場合は、文字列比較を行います。(command="SETTBL" のみ)
2105         *     command="SET" の場合は、数字型(double)として、value の値を、separator で分解したうえで、最大、最小、合計、平均 を計算し、
2106         *     それぞれを、MIN.キー、MAX.キー、SUM.キー、AVG.キー 変数にセットします。
2107         *     数字に変換できなかった場合は、エラーになります。
2108         *     null は、無視され(平均を求める場合の母数としても無視)、すべてが nulll の場合は、ゼロ文字列("")になります。
2109         *     ゼロ文字列("") の場合に、defaultVal 属性が設定されていると、defaultVal が設定されます。
2110         * ※② CASE は、fromVal="A:1 B:2 C:3 D:4" 形式の値に対して、コロン(:)で分解し、value値(左辺)が、一致する右辺を返します。
2111         *     fromVal の値は、スペースで分割され、コロン(:)が存在する左辺(キー)と右辺(値)に分解し、value値とキーを比較し、
2112         *     一致すれば、右辺の値を返します。
2113         *     valueがnullの場合、defaultVal が設定されており、その値で、fromVal の値と比較します。
2114         *     一致する値がなければ、元の value が返されます。
2115         * ※③ command="SQL"のMAP,ALL_MAP で、select key,val from TABLE のように、キーと値のみのMapを作成していましたが、
2116         *     第3引数以降も、Mapを作成するようにします。 6.9.0.2 (2018/02/13)
2117         *     具体的には、select key,val,val1,val2,val3 ・・・ from TABLE とすると、key,val の関係は、従来どおりで、
2118         *     val1 は、key + '_1' , val2 は、key + '_2' ・・・ という風に登録します。
2119         * ※④ HMCSV アクションを実行すると、MIN(fromValの日付),MAX(toValの日付),HMF(日付の時:分ラベル) を追加します。
2120         *     fromVal,toVal を指定せず、valueに、CSV形式の日付データを渡した場合は、MIN,MAX,HMF のみ求めます。 6.9.1.0 (2018/02/26)
2121         * ※⑤ INDEX_OF( value.indexOf(separator,fromVal); )は、検索対象の部分文字列をseparatorに、検索開始位置のインデックスをfromVal にセットします。
2122         *     LASTINDEX_OF( value.lastIndexOf​(separator,toVal); )は、検索対象の部分文字列をseparatorに、
2123         *     検索開始位置のインデックスをtoVal にセットします。(fromValではないことを注意) 7.2.6.0 (2020/06/30)
2124         * ※⑥ FOR は、valueに指定の文字列(未指定時は空文字列)に、fromVal ~ toVal を skipVal づつの数字文字列を合成した文字列を、separator で連結します。
2125         *     fromVal に、"000" など、先頭0で始まる2桁以上の文字列を指定した場合は、先頭ゼロ埋めの文字列を生成します。
2126         *     FOR_LIST は、同じ処理の結果を、Listオブジェクトに登録します。( c:forEach で取り出すことができます) 7.3.1.1 (2021/02/25)
2127         *     format属性で、生成する文字列をフォーマット(String#formatメソッド)できます。
2128         * ※⑦ FORTM、FORTM_LIST は、FOR、FOR_LISTと同じく繰り返し文字列を生成しますが、文字列は日付フォーマットになります。
2129         *     skipValは、数字の場合は、その数だけ日付送りします。"M" 記号だけ特殊で、月送りします。 8.0.1.2 (2021/11/19)
2130         *     format属性で、生成する日付文字列をフォーマット(HybsDateUtil#getDateFormatメソッド)できます。
2131         * ※⑧ TO_DATE は、日付フォーマットから、不要な文字を削除します。(/,-,:,' ',Tなどを削除)
2132         *     日付文字列としての整合性は、保証していません。 8.0.1.2 (2021/11/19)
2133         *
2134         * @og.rev 3.1.0.1 (2003/03/26) 指定のアクション以外は、エラーとするように変更。
2135         * @og.rev 3.5.6.2 (2004/07/05) 文字列の連結にStringBuilderを使用します。
2136         * @og.rev 4.3.7.5 (2009/07/13) ACT_LIST、ACT_ALL_LIST アクションの追加(JavaDocのみ修正)
2137         * @og.rev 5.6.4.3 (2013/05/24) ACT_MAX_MIN アクションの追加(JavaDocのみ修正)
2138         * @og.rev 5.6.4.3 (2013/05/24) tmpSelectedAll 属性追加にともなう修正。action="ALL_xxx"は、tmpSelectedAll=true にします。
2139         * @og.rev 5.7.7.2 (2014/06/20) EXEC と CASE アクションを追加
2140         * @og.rev 6.2.4.2 (2015/05/29) MAPOBJ , ALL_MAPOBJ アクションの追加
2141         * @og.rev 6.3.4.0 (2015/08/01) Arrays.toString から String.join に置き換え。
2142         * @og.rev 6.4.1.2 (2016/01/22) TRIM アクションを追加。
2143         * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。
2144         * @og.rev 6.7.4.0 (2017/02/10) TO_NUMBER アクションを追加。
2145         * @og.rev 6.8.4.1 (2017/12/18) HMCSV アクションを追加
2146         * @og.rev 8.0.1.2 (2021/11/19) ACT_TO_DATE,ACT_FORTM,ACT_FORTM_LIST 追加
2147         * @og.rev 8.1.0.1 (2022/01/07) ACT_LIST_CSV、ACT_ALL_LIST_CSV,ACT_SET,ACT_ALL_SET,ACT_SET_CSV,ACT_ALL_SET_CSV アクションの追加
2148         *
2149         * @param       act アクション (public static final 宣言されている文字列)
2150         * @see         <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.ValueTag.ACT_APPEND">アクション定数</a>
2151         */
2152        public void setAction( final String act ) {
2153                action = nval( getRequestParameter( act ),action );
2154
2155                if( action != null && !check( action, ACTION_SET ) ) {
2156                        final String errMsg = "指定のアクションは実行できません。アクションエラー"       + CR
2157                                                                + "action=[" + action + "] "                                                    + CR
2158                                                                + "actionList=[" + String.join( ", " , ACTION_SET ) + "]" ;
2159                        throw new HybsSystemException( errMsg );
2160                }
2161
2162                // 5.6.4.3 (2013/05/24) tmpSelectedAll 属性追加。action="ALL_xxx"を tmpSelectedAll="true" に置き換えます。
2163                if( action != null && action.startsWith( "ALL_" ) ) {
2164                        action = action.substring( 4 );         // "ALL_" の4文字分削除
2165                        tmpSelectedAll = true;
2166                }
2167        }
2168
2169        /**
2170         * 【TAG】パラメータ に登録するキーをセットします。
2171         *
2172         * @og.tag パラメータ に登録するキーをセットします。
2173         *
2174         * @og.rev 3.0.1.3 (2003/03/11) キーを toUpperCase している箇所を削除
2175         * @og.rev 6.2.6.0 (2015/06/19) キーのnull判定は行わない。(個別のメソッド内で実施している。)
2176         *
2177         * @param       key1 登録キー
2178         */
2179        public void setKey( final String key1 ) {
2180                key = nval( getRequestParameter( key1 ),key ) ;
2181        }
2182
2183        /**
2184         * 【TAG】パラメータ に登録する値をセットします。
2185         *
2186         * @og.tag パラメータ に登録する値をセットします。
2187         *
2188         * @og.rev 3.1.7.0 (2003/05/02) isNullSet 属性が true(初期値)のときは、リクエスト情報から値を取得。
2189         * @og.rev 3.5.4.0 (2003/11/25) getRequestParameter( value ) メソッドを setValue に移動。
2190         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
2191         *
2192         * @param       val     登録値
2193         */
2194        public void setValue( final String val ) {
2195                inValue = val;          // 3.5.4.0 (2003/11/25) 入力変数も、キープしておく。
2196                value = getRequestParameter( inValue );
2197        }
2198
2199        /**
2200         * 【TAG】value属性に値がセットされていないとき使用する、初期値を指定します。
2201         *
2202         * @og.tag
2203         * value属性に値がセットされていないときに、この初期値を使用します。
2204         *
2205         * @param       val 初期値
2206         */
2207        public void setDefaultVal( final String val ) {
2208                defaultVal = getRequestParameter( val );
2209        }
2210
2211//      /**
2212//       * 【廃止】value が NULL の時に、設定するかどうか[true/false]を指定します(初期値:true)。
2213//       *
2214//       * @og.tag
2215//       * true の場合は, null のときでもセットします。
2216//       * false の場合は, null のときは、既存の値を置き換えません。
2217//       * 初期値は、null のときでもセットするです。 ("true")
2218//       *
2219//       * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
2220//       * @og.rev 6.9.5.0 (2018/04/23) 物理的に廃止
2221//       *
2222//       * @param   flag NULL時設定有無 [true:設定する/それ以外:設定しない]
2223//       * @deprecated 5.1.8.0 (2010/07/01) 廃止。
2224//       */
2225//      @Deprecated public void setNullSet( final String flag ) {
2226//              // 廃止予定
2227//      }
2228
2229        /**
2230         * 【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します。
2231         *
2232         * @og.tag Queryオブジェクトを作成する時のDB接続IDを指定します。
2233         *
2234         * @param       id データベース接続ID
2235         */
2236        public void setDbid( final String id ) {
2237                dbid = nval( getRequestParameter( id ),dbid );
2238        }
2239
2240        /**
2241         * 【TAG】キャッシュする場合のスコープ(request,session)を指定します(初期値:request)。
2242         *
2243         * @og.tag
2244         * "request","session" が指定できます。
2245         * 初期値は、 "request" です。
2246         *
2247         * @param       scp     スコープ
2248         */
2249        @Override
2250        public void setScope( final String scp ) {
2251                scope = nval( getRequestParameter( scp ),scope );
2252        }
2253
2254        /**
2255         * 【TAG】DBTableModel から取得する場合のスコープ(request,session)を指定します(初期値:session)。
2256         *
2257         * @og.tag
2258         * "request","session" が指定できます。
2259         * 初期値は、 "session" です。
2260         *
2261         * @og.rev 5.1.2.0 (2010/01/01) DBTableModel の取得先のscope
2262         *
2263         * @param       scp     スコープ
2264         */
2265        public void setTblScope( final String scp ) {
2266                tblScope = nval( getRequestParameter( scp ),tblScope );
2267        }
2268
2269        /**
2270         * 【TAG】マルチデータ(複数件検索)を使用するかどうか[true/false]を指定します(初期値:false)。
2271         *
2272         * @og.tag
2273         * command="SQL" の場合に、複数行検索した結果を、キー+行番号 というキーを作成して
2274         * 値を設定するかどうかを指定します。
2275         * false の場合は、従来どおり、検索カラム名がキーになります。
2276         * 初期値は、false です。
2277         *
2278         * @og.rev 3.2.4.0 (2003/06/12) 新規追加
2279         *
2280         * @param   flag 複数件検索 [true:使用する/false:使用しない]
2281         */
2282        public void setUseMultiRows( final String flag ) {
2283                useMultiRows = nval( getRequestParameter( flag ),useMultiRows );
2284        }
2285
2286        /**
2287         * 【TAG】各種アクションの文字列を連結/分解する項目区切り文字をセットします(初期値:",")。
2288         *
2289         * @og.tag
2290         * 各種アクションに基づく処理において、文字列の区切りを指定するのに使用します。
2291         * APPEND、ROW_APPEND 時には、文字列の連結に使用します。
2292         * MERGE の場合は、カンマで分解後、このセパレータでMERGE処理を行い、再び、連結します。
2293         * 初期値は、"," に設定されています。
2294         *
2295         * @og.rev 3.5.6.5 (2004/08/09) 新規追加
2296         *
2297         * @param   sepa 項目区切り文字 (初期値:",")
2298         */
2299        public void setSeparator( final String sepa ) {
2300                separator = nval( getRequestParameter( sepa ),separator );
2301        }
2302
2303        /**
2304         * 【TAG】パラメータの HTMLTag開始/終了文字(&gt;&lt;) 存在チェックを実施するかどうか[true/false]を設定します
2305         *              (初期値:USE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
2306         *
2307         * @og.tag
2308         * クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。
2309         * (&gt;&lt;) が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
2310         * (初期値:システム定数のUSE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
2311         *
2312         * @og.rev 5.1.7.0 (2010/06/01) 新規追加
2313         *
2314         * @param       flag    XSSチェック [true:する/false:しない]
2315         * @see         org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK
2316         */
2317        public void setXssCheck( final String flag ) {
2318                xssCheck = nval( getRequestParameter( flag ),xssCheck );
2319        }
2320
2321        /**
2322         * 【TAG】部分文字列置換の 置換え前の部分文字列(from)を指定します。
2323         *
2324         * @og.tag
2325         * value の値から、指定された正規表現(from)に一致する、この文字列の各部分文字列に対し、
2326         * 指定された文字列(to)で置換します。
2327         * value.replaceAll( from, to ) という文法で処理します。
2328         *
2329         * ※ action="CASE" 時は、fromVal="A:1 B:2 C:3 D:4" 形式で指定可能です。
2330         * ※ action="SUBSTR" 時は、fromVal は、数字 のみ設定可能です。
2331         * ※ action="REPLACE" 時は、fromVal は、CSV形式で、複数のリプレースキーを指定できます。
2332         *            例: @1,@2,@3・・
2333         * ※ action="FOR,FOR_LIST" 時は、繰り返し文字列の作成開始文字を指定します。
2334         * ※ action="FORTM,FORTM_LIST" 時は、繰り返し日付文字列の作成開始日付を指定します。
2335         * ※ action="HMCSV" 時は、時刻のCSVリストの開始日付を指定します。
2336         *
2337         * @og.rev 5.2.2.0 (2010/11/01) 新規追加
2338         *
2339         * @param       from    置換え前の部分文字列
2340         * @see         #setToVal(String)
2341         */
2342        public void setFromVal( final String from ) {
2343                fromVal = nval( getRequestParameter( from ),fromVal );
2344        }
2345
2346        /**
2347         * 【TAG】部分文字列置換の 置換え後の部分文字列(to)を指定します。
2348         *
2349         * @og.tag
2350         * value の値から、指定された正規表現(from)に一致する、この文字列の各部分文字列に対し、
2351         * 指定された文字列(to)で置換します。
2352         * value.replaceAll( from, to ) という文法で処理します。
2353         *
2354         * ※ action="SUBSTR" 時は、toVal は、数字 のみ設定可能です。
2355         * ※ action="REPLACE" 時は、toVal は、CSV形式で、複数の置換え後の文字列を指定できます。
2356         *            例: VLA1,VAL2,VAL・・
2357         * ※ action="REPLACE" 時に、toVal='""' を指定すると、ゼロ文字列としてfromValの削除になります。
2358         * ※ action="FOR,FOR_LIST" 時は、繰り返し文字列の作成終了文字を指定します。
2359         * ※ action="FORTM,FORTM_LIST" 時は、繰り返し日付文字列の作成終了日付を指定します。
2360         * ※ action="HMCSV" 時は、時刻のCSVリストの終了日付を指定します。
2361         *
2362         * @og.rev 5.2.2.0 (2010/11/01) 新規追加
2363         * @og.rev 7.3.2.2 (2021/03/31) REPLACEアクションで、toVal に、長さゼロの文字列が扱えるように変更。
2364         *
2365         * @param       to      置換え後の部分文字列
2366         * @see         #setFromVal(String)
2367         */
2368        public void setToVal( final String to ) {
2369                toVal = nval( getRequestParameter( to ),toVal );
2370
2371                if( "\"\"".equals( toVal ) ) { toVal = ""; }    // 7.3.2.2 (2021/03/31) 長さゼロの文字列対応
2372        }
2373
2374        /**
2375         * 【TAG】HMCSV,FOR,FOR_LIST,FORTM,FORTM_LISTで使用する、ステップ数を指定します。
2376         *
2377         * @og.tag
2378         * fromVal と、toVal を組み合わせて、使用します。
2379         * action="HMCSV" で、時刻のCSVリストを作成する場合は、ステップ時間を分で指定します(例:1時間=60 , 2時間=120 , 45分=45 など)
2380         * 例えば、value="20171213" fromVal="0600" toVal="1000" skipVal="45" とすると、
2381         * 201712130600,201712130645,201712130730,201712130815,201712130900,201712130945 という文字列を作成します。
2382         * デフォルトは、60分(1時間)です。
2383         *
2384         * action=FOR,FOR_LIST のステップ数の指定時は、一般的な数字です。
2385         *
2386         * action=FORTM,FORTM_LIST のステップ数の指定時は、日数になります。(HMCSVの基準と異なるので注意)
2387         * 特殊系として、"M" を指定した場合は、月毎になります。
2388         *
2389         * skipVal には、マイナスやゼロは、指定できません。
2390         *
2391         * @og.rev 6.8.4.1 (2017/12/18) skipVal 属性 追加
2392         *
2393         * @param       skip    HMCSVで使用する、ステップ時間を分で指定
2394         */
2395        public void setSkipVal( final String skip ) {
2396                skipVal = nval( getRequestParameter( skip ),skipVal );
2397                if( !StringUtil.isNull( skipVal ) ) {
2398                        final char ch = skipVal.charAt(0);
2399                        if( ch == '-' || ch == '0' ) {
2400                                final String errMsg = "skipVal属性には、マイナスやゼロは、指定できません。"
2401                                                        + " skipVal=[" + skipVal + "]" + CR ;
2402                                throw new HybsSystemException( errMsg );
2403                        }
2404                }
2405        }
2406
2407        /**
2408         * 【TAG】actionが、FORMAT,FOR,FOR_LIST,FORTM,FORTM_LIST の場合の文字列変換フォーマットを指定します。
2409         *
2410         * @og.tag
2411         * FORMAT,FOR,FOR_LIST の場合に生成する文字列のフォーマットは、String#formatメソッド を使用します。
2412         * FORTM,FORTM_LIST の場合に生成する日付文字列のフォーマットは、HybsDateUtil#getDateFormatメソッド を使用します。
2413         *
2414         * @og.rev 8.0.1.2 (2021/11/19) format 属性 追加
2415         *
2416         * @param       fmt     数値や日付に変換する場合のフォーマットを指定
2417         */
2418        public void setFormat( final String fmt ) {
2419                format = nval( getRequestParameter( fmt ),format );
2420        }
2421
2422        /**
2423         * 【TAG】暗号化、復号化に利用する暗号化キーを指定します。
2424         *
2425         * @og.tag
2426         * 暗号化キーをしています。
2427         * 未設定の場合は、エンジンで用意されているキーを利用します。
2428         * 暗号化キーは8の倍数の文字数が推奨されています。
2429         *
2430         * @og.rev 5.10.4.0 (2018/10/05) 新規追加
2431         *
2432         * @param cKey  暗号化キー
2433         */
2434        public void setCryptKey( final String cKey ) {
2435                cryptKey = nval( getRequestParameter( cKey ), cryptKey);
2436        }
2437
2438        /**
2439         * このオブジェクトの文字列表現を返します。
2440         * 基本的にデバッグ目的に使用します。
2441         *
2442         * @og.rev 4.3.4.0 (2008/12/01) PageContextのスコープをクラス変数としてアクセス
2443         * @og.rev 5.1.8.0 (2010/07/01) isNullSet 属性 廃止
2444         * @og.rev 6.7.7.2 (2017/04/14) 属性の追加と、各スコープ変数の表示廃止
2445         *
2446         * @return このクラスの文字列表現
2447         * @og.rtnNotNull
2448         */
2449        @Override
2450        public String toString() {
2451                return ToString.title( this.getClass().getName() )
2452                                .println( "VERSION"                     ,VERSION                )
2453                                .println( "tableId"                     ,tableId                )
2454                                .println( "command"                     ,command                )
2455                                .println( "action"                      ,action                 )
2456                                .println( "key"                         ,key                    )
2457                                .println( "inValue"                     ,inValue                )
2458                                .println( "value"                       ,value                  )
2459                                .println( "defaultVal"          ,defaultVal             )
2460                                .println( "dbid"                        ,dbid                   )
2461                                .println( "scope"                       ,scope                  )
2462                                .println( "tblScope"            ,tblScope               )                               // 6.7.7.2 (2017/04/14)
2463                                .println( "separator"           ,separator              )
2464                                .println( "useMultiRows"        ,useMultiRows   )
2465                                .println( "xssCheck"            ,xssCheck               )                               // 6.7.7.2 (2017/04/14)
2466                                .println( "fromVal"                     ,fromVal                )                               // 6.7.7.2 (2017/04/14)
2467                                .println( "toVal"                       ,toVal                  )                               // 6.7.7.2 (2017/04/14)
2468                                .println( "skipVal"                     ,skipVal                )                               // 6.8.4.1 (2017/12/18)
2469                                .println( "tmpSelectedAll"      ,tmpSelectedAll )                               // 6.7.7.2 (2017/04/14)
2470                                .println( "Other..."    ,getAttributes().getAttribute() )
2471                                .fixForm().toString() ;
2472        }
2473}