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 java.util.ArrayList;
019import java.util.List;
020import java.util.Set;                                                                                   // 6.4.3.4 (2016/03/11)
021import java.util.regex.Pattern;                                                                 // 7.0.1.8 (2019/01/28)
022
023import org.opengion.fukurou.util.ErrorMessage;
024import org.opengion.fukurou.util.ToString;                                              // 6.1.1.0 (2015/01/17)
025import org.opengion.fukurou.util.ArraySet;                                              // 6.4.3.4 (2016/03/11)
026import org.opengion.hayabusa.common.HybsSystem;
027import org.opengion.hayabusa.common.HybsSystemException;
028import org.opengion.hayabusa.db.DBTableModel;
029import org.opengion.hayabusa.db.Query;
030import org.opengion.hayabusa.resource.GUIInfo;
031
032import static org.opengion.fukurou.util.StringUtil.nval;
033import static org.opengion.fukurou.system.HybsConst.BR;                 // 6.1.0.0 (2014/12/26) refactoring
034
035/**
036 * SQL文を直接指定して、データベースに追加/更新/削除を行います(queryType="JDBCTableUpdate")。
037 *
038 * 存在チェックを行う場合は、tableExist タグと併用してください。
039 * 複雑な処理が必要な場合は、従来より使用しています、PLSQLをCALLする、
040 * plsqlUpdateタグを使用してください。
041 * また、tableUpdateParam タグを使用する事で、テーブル名とsqlTypeの指定で動的に
042 * SQL文を自動生成できます。これにより、追加、更新、削除やテーブルに関して、
043 * 単一のJSP画面ですべて対応できるようになります。
044 *
045 * 7.2.9.3 (2020/11/06)
046 *   queryType="JDBCTableMerge" と、"JDBCTableUpdate" を相互運用します。
047 *   tableUpdateParam タグのsqlType="MERGE" を指定しておくと、
048 *   UPDATE文とINSERT文を両方とも作成して、有れば更新なければ追加処理を行います。
049 *   その場合、queryTypeを、JDBCTableMerge に変更します。
050 *   sqlType が従来の"INSERT"や"UPDATE" の場合は、queryTypeを、JDBCTableUpdate
051 *   に変更します。
052 *   この変換は、"JDBCTableMerge" と、"JDBCTableUpdate" を相互運用します。
053 *
054 * ※ このタグは、Transaction タグの対象です。
055 *
056 * @og.formSample
057 * ●形式:<og:tableUpdate command="…" names="…" queryType="JDBCTableUpdate" >
058 *             {@SQL}
059 *         </og:update>
060 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します)
061 *
062 * ●Tag定義:
063 *   <og:tableUpdate
064 *       queryType          【TAG】Query を発行する為のクラスID(JDBCTableUpdate,JDBCTableMerge)を指定します({@og.doc03Link queryType 初期値:JDBCTableUpdate})
065 *       sqlType            【TAG】BODY部に書かれている Param の SQLタイプを指定します(INSERT,COPY,UPDATE,MODIFY,DELETE,MERGE,無指定)
066 *       command            【TAG】コマンド (NEW,RENEW)をセットします(PlsqlUpdateTag,UpdateTag の場合は、ENTRY)
067 *       scope              【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session)
068 *       displayMsg         【TAG】検索結果を画面上に表示するメッセージリソースIDを指定します (初期値:VIEW_DISPLAY_MSG[=])
069 *       resourceType       【特殊】クリアするリソースの種類[GEA03/GEA04/GEA08]を指定します
070 *       conditionKey       【TAG】条件判定するカラムIDを指定します(初期値:null)
071 *       conditionList      【TAG】条件判定する値のリストを、"|"で区切って登録します(初期値:無条件) 7.0.1.8 (2019/01/28) 正規表現に変更
072 *       tableId            【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
073 *       dbid               【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します
074 *       selectedAll        【TAG】データを全件選択済みとして処理するかどうか[true/false]を指定します(初期値:false)
075 *       commitTableModel   【特殊】SQL実行後に結果をDBTableModelに反映させるかどうか[true/false]を指定します(初期値:true)
076 *       followCdkh         【TAG】DBTableModelの改廃Cに従って処理を行うかを指定します
077 *       quotCheck          【TAG】リクエスト情報の シングルクォート(') 存在チェックを実施するかどうか[true/false]を設定します(初期値:false)
078 *       useTimeView        【TAG】処理時間を表示する TimeView を表示するかどうかを指定します
079 *                                                                              (初期値:VIEW_USE_TIMEBAR[={@og.value SystemData#VIEW_USE_TIMEBAR}])。
080 *       useSLabel          【TAG】7.0.7.0 (2019/12/13) エラーメッセージにSLABELを利用するかどうか[true/false]を指定します(初期値:false)
081 *       caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)
082 *       caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)
083 *       caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない)
084 *       caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない)
085 *       caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
086 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
087 *   >   ... Body ...
088 *   </og:tableUpdate>
089 *
090 * ●使用例
091 *    ・QUERYを他のJSPから渡す場合
092 *    【copy.jsp】
093 *        <og:hidden name="SQL" >
094 *          INSERT INTO GE41
095 *               (CLM,NAME_JA,LABEL_NAME,KBSAKU,SYSTEM_ID,LANG,
096 *               FGJ,DYSET,DYUPD,USRSET,USRUPD,PGUPD)
097 *          VALUES
098 *               ([CLM],[NAME_JA],[LABEL_NAME],[KBSAKU],[SYSTEM_ID],[LANG],
099 *               '1','{@USER.YMDH}','{@USER.YMDH}','{@USER.ID}','{@USER.ID}','{@GUI.KEY}')
100 *        </og:value>
101 *
102 *    【entry.jsp】
103 *        <og:tableUpdate
104 *            command   = "{@command}"
105 *            queryType = "JDBCTableUpdate"
106 *        {@SQL}
107 *        </og:tableUpdate>
108 *
109 *    ・tableUpdateParamを使用する場合
110 *    【entry.jsp】
111 *        <og:tableUpdate
112 *            command   = "{@command}"
113 *            queryType = "JDBCTableUpdate"
114 *            sqlType   = "{@sqlType}"        // tableUpdateParam の sqlType と一致
115 *        >
116 *            <og:tableUpdateParam
117 *                sqlType     = "{@sqlType}"       // INSERT,COPY,UPDATE,MODIFY,DELETE,MERGE
118 *                table       = "{@TABLE_NAME}"    // 処理対象のテーブル名
119 *                names       = "{@names}"         // 処理対象のカラム名
120 *                omitNames   = "{@omitNames}"     // 処理対象外のカラム名
121 *                where       = "{@where}"         // 処理対象を特定するキー
122 *                constKeys   = "{@constKeys}"     // 処理カラム名の中の固定情報カラム名
123 *                constVals   = "{@constVals}"     // 処理カラム名の中の固定情報設定値
124 *            />
125 *        </og:tableUpdate>
126 *
127 *    ・処理の可否を指定する場合
128 *    【entry.jsp】
129 *        <og:tableUpdate
130 *            command   = "{@command}"
131 *            queryType = "JDBCTableUpdate"
132 *            conditionKey  ="…"      : 条件判定するカラムIDを指定(初期値は columnId )
133 *            conditionList ="…"      : 条件判定する値のリストを、"|"で区切って登録(初期値は、無条件)
134 *        {@SQL}
135 *        </og:tableUpdate>
136 *
137 *    ・JDBCTableUpdate のまま、sqlType="MERGE" を指定する場合。
138 *      一つのtableUpdateParamで、両方(UPDATE,INSERT)の処理を実行します。
139 *    【entry.jsp】
140 *        <og:tableUpdate
141 *            command   = "{@command}"
142 *            queryType = "JDBCTableUpdate"
143 *            <og:tableUpdateParam
144 *                sqlType     = "MERGE"                // INSERT or UPDATE
145 *                table       = "{@TABLE_NAME}"    // 処理対象のテーブル名
146 *                names       = "{@names}"         // 処理対象のカラム名
147 *                omitNames   = "{@omitNames}"     // 処理対象外のカラム名
148 *                where       = "{@where}"         // 処理対象を特定するキー(INSERT時には使われず、UPDAET時に使われる。)
149 *                constKeys   = "{@constKeys}"     // 処理カラム名の中の固定情報カラム名
150 *                constVals   = "{@constVals}"     // 処理カラム名の中の固定情報設定値
151 *            />
152 *        </og:tableUpdate>
153 *
154 * @og.rev 3.8.8.0 (2007/12/22) 新規作成
155 * @og.group DB登録
156 *
157 * @version  4.0
158 * @author   Kazuhiko Hasegawa
159 * @since    JDK5.0,
160 */
161public class TableUpdateTag extends QueryTag {
162        /** このプログラムのVERSION文字列を設定します。   {@value} */
163        private static final String VERSION = "7.2.9.1 (2020/10/23)" ;
164        private static final long serialVersionUID = 729120201023L ;
165
166        /** command 引数に渡す事の出来る コマンド  登録{@value} */
167        public static final String CMD_ENTRY  = "ENTRY" ;
168        // 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。
169        private static final Set<String> COMMAND_SET = new ArraySet<>( CMD_ENTRY );
170
171        // 処理を行う、リソースの種類を指定します。(GEA03,GEA04,GEA08 のどれか)
172        private String  sqlType                 ;                       // INSERT,COPY,UPDATE,MODIFY,DELETE,MERGE
173        private String  resourceType    ;
174        private int             resTypeColNo    = -1;
175        private String  conditionKey    ;                       // 条件判定するカラムIDを指定(初期値は columnId )
176        private String  conditionList   ;                       // 条件判定する値のリストを、"|"で区切って登録(初期値は、無条件) 7.0.1.8 (2019/01/28) 正規表現に変更
177        private boolean selectedAll             ;
178        private boolean commitTableModel= true;         // 4.0.2.0 (2007/12/25)
179        private boolean followCdkh              ;                       // 4.3.2.0 (2008/09/09).
180        private boolean quotCheck               ;                       // 5.1.7.0 (2010/06/01) quotCheckを指定できるようにする。※但し、初期値はfalse固定。タイミングを見て修正要
181
182        /**
183         * デフォルトコンストラクター
184         *
185         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
186         */
187        public TableUpdateTag() { super(); }            // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
188
189        /**
190         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
191         *
192         * @og.rev 4.0.0.0 (2007/11/14) 0件の場合でもstartQueryTransactionを通すように変更
193         * @og.rev 5.1.7.0 (2010/06/01) quotCheckを指定できるようにする。※但し、初期値はfalse固定。
194         * @og.rev 6.3.4.0 (2015/08/01) caseKey,caseVal,caseNN,caseNull,caseIf 属性対応
195         *
196         * @return      後続処理の指示( EVAL_BODY_BUFFERED )
197         */
198        @Override
199        public int doStartTag() {
200                if( !useTag() ) { return SKIP_BODY ; }  // 6.3.4.0 (2015/08/01)
201                dyStart = System.currentTimeMillis();
202
203                table = (DBTableModel)getObject( tableId );
204                startQueryTransaction( tableId );               // 4.0.0.0 (2007/11/14) 0件の場合でもdoEndでPAGE_SKIPしないように位置変更。
205                if( table == null || table.getRowCount() == 0 ||
206                        ! check( command, COMMAND_SET ) ) { return SKIP_BODY ; }
207                super.quotCheck = quotCheck;
208
209                return EVAL_BODY_BUFFERED ;     // Body を評価する。( extends BodyTagSupport 時)
210        }
211
212        /**
213         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
214         *
215         * @og.rev 4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage ⇒ getResource().getLabel )
216         * @og.rev 6.3.4.0 (2015/08/01) caseKey,caseVal,caseNN,caseNull,caseIf 属性対応
217         * @og.rev 6.4.1.2 (2016/01/22) QueryTag.errMsgId  → QueryTag.ERR_MSG_ID  refactoring
218         * @og.rev 6.9.9.0 (2018/08/20) 「ERR0041:検索処理中に割り込みの検索要求がありました」エラーを、標準のErrorMessageに追加するようにします。
219         * @og.rev 7.0.7.0 (2019/12/13) useSLabel 属性を追加。
220         *
221         * @return      後続処理の指示
222         */
223        @Override
224        public int doEndTag() {
225                debugPrint();
226                if( !useTag() ) { return EVAL_PAGE ; }  // 6.3.4.0 (2015/08/01)
227
228                String label  = "";                             // 4.0.0 (2005/11/30) 検索しなかった場合。
229                if( check( command, COMMAND_SET ) ) {
230                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
231                        if( executeCount > 0 && displayMsg != null && displayMsg.length() > 0 ) {
232                                buf.append( executeCount )
233                                        .append( getResource().getLabel( displayMsg ) )
234                                        .append( BR );
235                        }
236
237                        // 6.9.9.0 (2018/08/20) 「ERR0041:検索処理中に割り込みの検索要求がありました」エラーを、標準のErrorMessageに追加するようにします。
238                        if( table != null && ! commitTableObject( tableId, table ) ) {
239                                if( errMessage == null ) { errMessage = new ErrorMessage( "TableUpdateTag Query Error!" ); }
240                                // ERR0041:検索処理中に割り込みの検索要求がありました。処理されません。
241                                errMessage.addMessage( 0,ErrorMessage.NG,"ERR0041" );
242                                errCode = ErrorMessage.NG;
243                        }
244
245//                      final String err = TaglibUtil.makeHTMLErrorTable( errMessage,getResource() );
246                        final String err = TaglibUtil.makeHTMLErrorTable( errMessage,getResource(),useSLabel );         // 7.0.7.0 (2019/12/13)
247                        if( err != null && err.length() > 0 ) {
248                                buf.append( err );
249                                // 6.4.1.2 (2016/01/22) QueryTag.errMsgId  → QueryTag.ERR_MSG_ID  refactoring
250                                setSessionAttribute( ERR_MSG_ID,errMessage );
251                        }
252                        else {
253                                // 6.4.1.2 (2016/01/22) QueryTag.errMsgId  → QueryTag.ERR_MSG_ID  refactoring
254                                removeSessionAttribute( ERR_MSG_ID );
255                        }
256                        label = buf.toString();
257
258//                      // 6.9.9.0 (2018/08/20) 「ERR0041:検索処理中に割り込みの検索要求がありました」エラーを、標準のErrorMessageに追加するようにします。
259//                      if( table != null && ! commitTableObject( tableId, table )  ) {
260//                              // 3.6.0.8 (2004/11/19) トランザクションチェックを行います。
261//                              jspPrint( "TableUpdateTag Query処理が割り込まれました。DBTableModel は登録しません。" );
262//                              return SKIP_PAGE ;
263//                      }
264                }
265
266                jspPrint( label );
267
268                // セキュリティチェック(データアクセス件数登録)
269                final long dyTime = System.currentTimeMillis()-dyStart;
270                final GUIInfo guiInfo = (GUIInfo)getSessionAttribute( HybsSystem.GUIINFO_KEY );
271                if( guiInfo != null ) { guiInfo.addWriteCount( executeCount,dyTime,sql ); }
272
273                if( useTimeView ) {             // 6.3.6.0 (2015/08/16)
274                        jspPrint( "<div id=\"queryTime\" value=\"" + (dyTime) + "\"></div>" );  // 3.5.6.3 (2004/07/12)
275                }
276                return errCode >= ErrorMessage.NG ? SKIP_PAGE : EVAL_PAGE ;
277        }
278
279        /**
280         * タグリブオブジェクトをリリースします。
281         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
282         *
283         * @og.rev 4.0.2.0 (2007/12/25) commitTableModel追加
284         * @og.rev 4.1.2.0 (2008/03/12) sqlType追加
285         * @og.rev 5.1.7.0 (2010/06/01) quotCheckを指定できるようにする。※但し、初期値はfalse固定。
286         * @og.rev 7.2.9.1 (2020/10/23) TableUpdateParamTag のマージ(UPDATE,INSERT)対応
287         */
288        @Override
289        protected void release2() {
290                super.release2();
291                sqlType                 = null;         // INSERT,COPY,UPDATE,MODIFY,DELETE,MERGE
292                resourceType    = null;
293                resTypeColNo    = -1;
294                conditionKey    = null;         // 条件判定するカラムIDを指定(初期値は columnId )
295                conditionList   = null;         // 条件判定する値のリストを、"|"で区切って登録(初期値は、無条件) 7.0.1.8 (2019/01/28) 正規表現に変更
296                selectedAll             = false;
297                commitTableModel= true;         // 4.0.2.0 (2007/12/25)
298                followCdkh              = false;        // 4.3.2.0 (2008/09/09)
299                quotCheck               = false;        // 5.1.7.0 (2010/06/01)
300        }
301
302        /**
303         * Query を実行します。
304         *
305         * @og.rev 4.0.2.0 (2007/12/25) commitTableModel追加
306         * @og.rev 6.3.6.1 (2015/08/28) close(),realClose() 廃止。Queryはキャッシュしません。
307         *
308         * @param   query オブジェクト
309         */
310        @Override
311        protected void execute( final Query query ) {
312                final int[] rowNo = getParameterRows();         // 4.0.0 (2005/01/31)
313                if( rowNo.length > 0 ) {
314                        query.execute( rowNo,table );
315
316                        errCode = query.getErrorCode();
317                        errMessage = query.getErrorMessage();
318
319                        // リソースクリア処理
320                        if( resourceType != null ) {
321                                resTypeColNo = table.getColumnNo( "CLM" );              // キーは、CLM
322                        }
323
324                        // 逆順にDELETEしないと、行番号がずれてしまう。
325                        int row;
326                        for( int j=rowNo.length-1; j>=0; j-- ) {
327                                row = rowNo[j];
328                                if( resTypeColNo >= 0 ) {
329                                        clearResourceData( table.getValue( row,resTypeColNo ) );                // リソースのクリア
330                                }
331
332                                if( commitTableModel ) {        // 4.0.2.0 (2007/12/25)
333                                        if( DBTableModel.DELETE_TYPE.equals( table.getModifyType( row ) ) ) {
334                                                table.removeValue( row );
335                                        }
336                                        else {
337                                                table.resetModify( row );
338                                        }
339                                }
340                        }
341                }
342        }
343
344        /**
345         * 表示データの HybsSystem.ROW_SEL_KEY を元に、選ばれた 行番号の
346         * 配列を返します。
347         * ここでは、conditionKey に値が設定されている場合は、そのカラムの値が
348         * conditionList にマッチする場合のみ対象選択行として返します。
349         * 値がセットされていない場合は、通常のCommonTagSupport#getParameterRows()
350         * が呼ばれます。
351         * なにも選ばれていない場合は、サイズ0の配列を返します。
352         *
353         * @og.rev 4.3.2.0 (2008/09/09) followCdkh属性対応
354         * @og.rev 7.0.1.8 (2019/01/28) conditionListの判定を、正規表現に変更
355         *
356         * @return       (選ばれていない場合は、サイズ0の配列を返す)
357         * @og.rtnNotNull
358         */
359        @Override
360        protected int[] getParameterRows() {
361                int[] rowNo ;
362                if( selectedAll ) {
363                        final int rowCnt = table.getRowCount();         // 3.5.5.7 (2004/05/10)
364                        rowNo = new int[ rowCnt ];
365                        for( int i=0; i<rowCnt; i++ ) {
366                                rowNo[i] = i;
367                        }
368                } else {
369                        rowNo = super.getParameterRows();               // 4.0.0 (2005/01/31)
370                }
371
372                // 7.0.1.8 (2019/01/28) conditionListの判定を、正規表現に変更
373                if( conditionKey != null && conditionList != null ) {                   // 7.0.1.8 (2019/01/28)
374                        final int col = table.getColumnNo( conditionKey );
375                        final List<Integer> list = new ArrayList<>();
376                        final Pattern ptn = Pattern.compile( conditionList );           // 7.0.1.8 (2019/01/28)
377                        for( int i=0; i<rowNo.length; i++ ) {
378                                final String val = nval( table.getValue( rowNo[i],col ) , "" );         // 7.0.1.8 (2019/01/28)
379                                if( ptn.matcher( val ).matches() ) {
380                                        list.add( Integer.valueOf( rowNo[i] ) );
381                                }
382                        }
383
384                        final int size = list.size();
385                        rowNo = new int[size];
386                        for( int i=0; i<size; i++ ) {
387                                rowNo[i] = list.get(i).intValue();
388                        }
389                }
390
391                // 4.3.2.0 (2008/09/09)
392                if( sqlType != null && sqlType.length() > 0 && followCdkh ) {
393                        final List<Integer> flist = new ArrayList<>();
394                        for( int i=0; i<rowNo.length; i++ ) {
395                                final String cdkh = table.getModifyType( rowNo[i] );
396                                // 6.9.7.0 (2018/05/14) PMD Useless parentheses.
397                                if(     ( "INSERT".equals( sqlType ) || "COPY".equals(   sqlType ) )    && DBTableModel.INSERT_TYPE.equals( cdkh )
398//                                      ||      ( "UPDATE".equals( sqlType ) || "CHANGE".equals( sqlType ) )    && DBTableModel.UPDATE_TYPE.equals( cdkh )              // 7.2.9.1 (2020/10/23) CHANGE ⇒ MODIFY
399                                        ||      ( "UPDATE".equals( sqlType ) || "MODIFY".equals( sqlType ) )    && DBTableModel.UPDATE_TYPE.equals( cdkh )
400                                        ||        "DELETE".equals( sqlType )                                                                    && DBTableModel.DELETE_TYPE.equals( cdkh ) ) {
401                                                flist.add( Integer.valueOf( rowNo[i] ) );
402                                }
403                        }
404
405                        final int size = flist.size();
406                        rowNo = new int[size];
407                        for( int i=0; i<size; i++ ) {
408                                rowNo[i] = flist.get(i).intValue();
409                        }
410                }
411
412                return rowNo;
413        }
414
415//      /**
416//       * BODY部の TableUpdateParamTag に書かれたquery文を受け取ります。
417//       *
418//       * typeには、UPDATEかINSERTが指定され、それに応じたqueryを各変数にセットします。
419//       *
420//       * @og.rev 7.2.9.1 (2020/10/23) TableUpdateParamTag のマージ(UPDATE,INSERT)対応
421//       * @og.rev 7.2.9.3 (2020/11/06) QueryTag に移動
422//       *
423//       * @param       type    Queryタイプ(UPDATE,INSERT,その他)
424//       * @param       query   SQL文
425//       */
426//      protected void setQuery( final String type , final String query ) {
427//              sql = query;                                                                                                    // とりあえず、セットしておく
428//              sqlCnt++ ;                                                                                                              // 0の場合はBODYから、1の場合はそのまま、それ以上の場合は、マージ処理。QueryTag のprotected属性
429//
430//              if( "UPDATE".equalsIgnoreCase( type ) ) {
431//                      updQuery = query;                                                                                       // 上位の QueryTag のprotected属性
432//              }
433//              else if( "INSERT".equalsIgnoreCase( type ) ) {
434//                      insQuery = query;                                                                                       // 上位の QueryTag のprotected属性
435//              }
436//      }
437
438        /**
439         * 【TAG】Query を発行する為のクラスID(JDBCTableUpdate,JDBCTableMerge)を指定します({@og.doc03Link queryType 初期値:JDBCTableUpdate})。
440         *
441         * @og.tag
442         * 引数指定のUPDATE,INSERT,DELETE文を実行する場合の、queryType 属性を使用します。
443         * このタグでは、execute( int[] ,DBTableModel )を実行します。
444         * 代表的なクラスとして、"JDBCTableUpdate" が標準で用意されています。
445         *
446         * タグにより使用できる/出来ないがありますが、これは、org.opengion.hayabusa.db
447         * 以下の Query_**** クラスの **** を与えます。
448         * これらは、Query インターフェースを継承したサブクラスです。
449         * {@og.doc03Link queryType Query_**** クラス}
450         *
451         * @param       id Queryタイプ
452         * @see         org.opengion.hayabusa.db.Query  Queryのサブクラス
453         * @see         org.opengion.hayabusa.db.Query#execute( int[] ,DBTableModel )
454         */
455        @Override
456        public void setQueryType( final String id ) {
457                super.setQueryType( nval( id,"JDBCTableUpdate" ) );
458        }
459
460        /**
461         * resourceType が設定されたときのみ使用される、キャッシュの初期化メソッドです。
462         *
463         * @param       key     初期化を行うキー
464         */
465        private void clearResourceData( final String key ) {
466                getResource().clear( key );
467        }
468
469        /**
470         * 【特殊】クリアするリソースの種類[GEA03/GEA04/GEA08]を指定します。
471         *
472         * @og.tag
473         * 注意:この属性は、リソース関連DBのメンテナンス時にのみ、内部リソースキャッシュを
474         * クリアする目的で使用します。一般の属性としては、使用することはないため、
475         * ご注意ください。
476         * リソース関連のテーブルを更新した場合、リソースキャッシュをクリアして
477         * 置かないと、データベースの値が反映されません。
478         * 昔は、リソースの更新ごとに、全件クリアしていましたが、部分クリアが
479         * できるようになったため、部分クリアを行います。
480         * こでは、(GEA03,GEA04,GEA08) のどれかを指定してください。
481         *
482         * @param       type    クリアリソースタイプ [GEA03/GEA04/GEA08]
483         */
484        public void setResourceType( final String type ) {
485                resourceType = nval( getRequestParameter(type),resourceType );
486
487                if( resourceType != null &&
488                        "|GEA03|GEA04|GEA08|".indexOf( "|" + resourceType + "|" ) < 0 ) {
489                                final String errMsg = "resourceTypeは GEA03,GEA04,GEA08 のどれかです。"
490                                                        + "resourceType=" + type ;
491                                throw new HybsSystemException( errMsg );
492                }
493        }
494
495        /**
496         * 【TAG】条件判定するカラムIDを指定します(初期値:null)。
497         *
498         * @og.tag
499         * 指定のカラムIDの値と、conditionList の値を比較して、
500         * 存在する場合は、Query 処理を実行します。
501         * 例えば、conditionKey="CDKH" として、conditionList="A" とすれば、
502         * 改廃コードが"A"のデータで、かつ選択されたデータのみを処理します。
503         * 設定しない場合は、通常の処理と同様に、選択行のみ処理されます。
504         *
505         * @param       key 条件判定カラム
506         * @see         #setConditionList( String )
507         */
508        public void setConditionKey( final String key ) {
509                conditionKey = nval( getRequestParameter( key ),null ) ;
510        }
511
512        /**
513         * 【TAG】条件判定する値のリストを、"|"で区切って登録します(初期値:無条件)。
514         *
515         * @og.tag
516         * conditionKey とペアで指定します。ここには、カラムの設定値のリストを
517         * 指定することで、複数条件(OR結合)での比較を行い、リストにカラム値が
518         * 存在する場合のみ、Query 処理を実行します。
519         * 値が設定されている場合は、その値とマッチする必要があります。なにもセット
520         * されない場合、または、null の場合は、null データとマッチする場合のみ処理
521         * されますので、ご注意ください。
522         *
523         * @og.rev 7.0.1.8 (2019/01/28) conditionListの判定を、正規表現に変更
524         *
525         * @param       list    条件判定値 ("|"区切のリスト)
526         * @see         #setConditionKey( String )
527         */
528        public void setConditionList( final String list ) {
529//              conditionList = "|" + nval( getRequestParameter( list ),"" ) + "|" ;
530                conditionList = nval( getRequestParameter( list ),"" ) ;
531        }
532
533        /**
534         * 【TAG】データを全件選択済みとして処理するかどうか[true/false]を指定します(初期値:false)。
535         *
536         * @og.tag
537         * 全てのデータを選択済みデータとして扱って処理します。
538         * 全件処理する場合に、(true/false)を指定します。
539         * 初期値は false です。
540         *
541         * @param  all データを全件選択済み [true:全件選択済み/false:通常]
542         */
543        public void setSelectedAll( final String all ) {
544                selectedAll = nval( getRequestParameter( all ),selectedAll );
545        }
546
547        /**
548         * 【特殊】SQL実行後に結果をDBTableModelに反映させるかどうか[true/false]を指定します(初期値:true)。
549         *
550         * @og.tag
551         * 注意:この属性は、リソース関連DBのメンテナンス時に、複数DBへの登録を行うための、
552         * 暫定対応として定義しています。
553         * falseにした場合は、実データとDBTableModelの整合性が取れなくなるため、使用には十分注して下さい。
554         * 初期値は true です。
555         *
556         * @og.rev 4.0.2.0 (2007/12/25) 新規作成
557         *
558         * @param  commitTblMdl 反映有無 [true:反映する/false:反映しない]
559         */
560        public void setCommitTableModel( final String commitTblMdl ) {
561                commitTableModel = nval( getRequestParameter( commitTblMdl ),commitTableModel );
562        }
563
564        /**
565         * 引数の名称配列。
566         *
567         * @return      名称配列
568         */
569        protected String[] getNames() {
570                return table.getNames() ;
571        }
572
573        /**
574         * 【TAG】BODY部に書かれている Param の SQLタイプを指定します。
575         *
576         * @og.tag
577         * TableUpdateParamTag は、上位の TableUpdateTag の sqlType 属性 と同じ
578         * sqlType 属性の場合のみ、SQL文を合成・出力します。
579         * つまり、TableUpdateTag側のsqlType 属性をパラメータに、TableUpdateParamTag
580         * の sqlType 属性を固定値にすることで、どのパラメータを使用するかを
581         * 選択できる機能を実現する事が可能です。
582         *
583         * 7.2.9.3 (2020/11/06)
584         *   複数指定できるようにします。
585         *
586         * @og.rev 4.1.2.0 (2008/03/12) 新規追加
587         *
588         * @param       type SQLタイプ
589         */
590        public void setSqlType( final String type ) {
591                sqlType = nval( getRequestParameter( type ),sqlType );
592        }
593
594        /**
595         * 【TAG】DBTableModelの改廃Cに従って処理を行うかを指定します。
596         *
597         * @og.tag
598         * この属性は、sqlTypeが指定されている場合のみ有効です。
599         * sqlTypeが指定されている場合、そのsqlTypeに対応した、改廃Cが設定されている
600         * 行のみを処理します。
601         * 対応関係は、以下の通りです。
602         *  sqlType = "INSERT" or "COPY" ⇒ 改廃C='A'のみ処理
603//       *  sqlType = "UPDATE" or "CHANGE" ⇒ 改廃C='C'のみ処理
604         *  sqlType = "UPDATE" or "MODIFY" ⇒ 改廃C='C'のみ処理
605         *  sqlType = "DELETE" ⇒ 改廃C='D'のみ処理
606         *
607         * @og.rev 4.3.2.0 (2008/09/09) 新規追加
608         *
609         * @param       flag 改廃C処理 [true:行う/false:行わない]
610         */
611        public void setFollowCdkh( final String flag ) {
612                followCdkh = nval( getRequestParameter( flag ),followCdkh );
613        }
614
615        /**
616         * 【TAG】リクエスト情報の シングルクォート(') 存在チェックを実施するかどうか[true/false]を設定します(初期値:false)。
617         *
618         * @og.tag
619         * SQLインジェクション対策の一つとして、暫定的ではありますが、SQLのパラメータに
620         * 渡す文字列にシングルクォート(') を許さない設定にすれば、ある程度は防止できます。
621         * 数字タイプの引数には、 or 5=5 などのシングルクォートを使用しないコードを埋めても、
622         * 数字チェックで検出可能です。文字タイプの場合は、必ず (')をはずして、
623         * ' or 'A' like 'A のような形式になる為、(')チェックだけでも有効です。
624         * (') が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
625         * ※(他のタグは、システムリソースのUSE_SQL_INJECTION_CHECK[={@og.value SystemData#USE_SQL_INJECTION_CHECK}])
626         * ですが、JSPの互換性を考慮し、初期値を固定でfalseにしています)
627         *
628         * @og.rev 5.1.7.0 (2010/06/01) 新規追加
629         *
630         * @param   flag クォートチェック [true:する/それ以外:しない]
631         */
632        @Override
633        public void setQuotCheck( final String flag ) {
634                quotCheck = nval( getRequestParameter( flag ),quotCheck );
635        }
636
637        /**
638         * SQLタイプを返します。
639         *
640         * @og.rev 4.1.2.0 (2008/03/12) 新規追加
641         *
642         * @return      SQLタイプ
643         */
644        protected String getSqlType() {
645                return sqlType ;
646        }
647
648        /**
649         * このオブジェクトの文字列表現を返します。
650         * 基本的にデバッグ目的に使用します。
651         *
652         * @og.rev 4.0.2.0 (2007/12/25) resourceColumn、commitTableModel追加
653         *
654         * @return このクラスの文字列表現
655         * @og.rtnNotNull
656         */
657        @Override
658        public String toString() {
659                return ToString.title( this.getClass().getName() )
660                                .println( "VERSION"                     ,VERSION                )
661                                .println( "resourceType"        ,resourceType   )
662                                .println( "resTypeColNo"        ,resTypeColNo   )
663                                .println( "conditionKey"        ,conditionKey   )
664                                .println( "conditionList"       ,conditionList  )
665                                .println( "followCdkh"          ,followCdkh             )
666                                .println( "CMD_ENTRY"           ,CMD_ENTRY              )
667                                .println( "commitTabelModel",commitTableModel )         // 4.0.2.0 (2007/12/25)
668                                .println( "sql"                         ,sql                    )               // 4.1.2.0 (2008/03/12)
669                                .println( "Other..."    ,getAttributes().getAttribute() )
670                                .fixForm().toString()
671                        + CR
672                        + super.toString() ;
673        }
674}