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 static org.opengion.fukurou.util.StringUtil.nval;
019
020import java.io.File;
021import java.util.Locale;
022import java.util.concurrent.ConcurrentMap;                                              // 6.4.3.3 (2016/03/04)
023import java.util.Arrays;
024import java.util.Map;                                                                                   // 6.9.9.0 (2018/08/20)
025
026import org.opengion.fukurou.business.ArrayTableModel;
027import org.opengion.fukurou.model.DataModel;                                    // 6.7.9.1 (2017/05/19) ArrayTableModel を、DataModel I/F に変更
028import org.opengion.fukurou.business.BizLogicHelper;
029import org.opengion.fukurou.db.Transaction;
030import org.opengion.fukurou.util.ErrMsg;
031import org.opengion.fukurou.util.ErrorMessage;
032import org.opengion.fukurou.util.HybsLoader;
033import org.opengion.fukurou.util.HybsLoaderConfig;
034import org.opengion.fukurou.util.HybsLoaderFactory;
035import org.opengion.fukurou.util.StringUtil;
036import org.opengion.fukurou.util.ToString;                                              // 6.1.1.0 (2015/01/17)
037import org.opengion.hayabusa.common.HybsSystem;
038import org.opengion.hayabusa.common.HybsSystemException;
039import org.opengion.hayabusa.db.DBTableModel;
040
041/**
042 * 業務ロジックを呼び出すためのタグです。
043 *
044 * logics属性に呼び出す業務ロジックのクラス名を記述します。
045 * このタグでは、複数の業務ロジックを1度に呼び出すことができ、
046 * DB接続のcommit,rollbackは一番最後に、1度のみ実行されます。
047 * 各業務ロジックは、記述した順番に呼び出されます。
048 *
049 * 業務ロジックは、{@link org.opengion.fukurou.business.BizLogicHelper BizLogicHelper}の
050 * 実装クラス、または、この実装クラスを継承したサブクラスである必要があります。
051 *
052 * 業務ロジッククラスについては、ホットデプロイ機能により、動的コンパイル、クラスロードが
053 * 行われます。
054 *
055 * 業務ロジックのソースディレクトリは、システムリソースの BIZLOGIC_SRC_PATH で定義されます。
056 * また、同様にクラスディレクトリは、システムリソースの BIZLOGIC_CLASS_PATH で定義されます。
057 * さらに、システムリソースの BIZLOGIC_HOTDEPLOY を false に設定することで、動的コンパイル
058 * 、クラスロードを行わなくすることもできます。
059 * この場合、予めコンパイルされたクラスを、初回呼び出し時に1回のみロードされます。
060 *
061 * SystemData の USE_SQL_INJECTION_CHECK が true か、quotCheck 属性が true の場合は、
062 * SQLインジェクション対策用のシングルクォートチェックを行います。リクエスト引数に
063 * シングルクォート(')が含まれると、エラーになります。
064 * 同様にUSE_XSS_CHECKがtrueか、xssCheck属性がtrueの場合は、
065 * クロスサイトススクリプティング(XSS)対策のためless/greater than signのチェックを行います。
066 *
067 * ※ このタグは、Transaction タグの対象です。
068 *
069 * @og.formSample
070 * ●形式:
071 *       ・<og:bizLog
072 *             logics       = "業務ロジックのクラス名"
073 *             command      = "ENTRY"
074 *             scope        = "session"
075 *             dbid         = "DEFAULT"
076 *             tableId      = "DEFAULT"
077 *             selectedAll  = "false"
078 *             modifyType   = "A"
079 *             keys         = "SYSTEM_ID"
080 *             vals         = "{@SYSTEM_ID}"
081 *             stopError    = "true"
082 *             quotCheck    = "true"
083 *             xssCheck     = "true"
084 *             debug        = "false"
085 *        />
086 * ●body:なし
087 *
088 * ●Tag定義:
089 *   <og:bizLogic
090 *       logics           ○【TAG】実行する業務ロジック名を指定します(必須)。
091 *       command            【TAG】コマンドをセットします(初期値:ENTRY)
092 *       scope              【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session)
093 *       dbid               【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します(初期値:null)
094 *       tableId            【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
095 *       selectedAll        【TAG】データを全件選択済みとして処理するかどうか[true/false]を指定します(初期値:false)
096 *       modifyType         【TAG】DB検索時の モディファイタイプを指定します[A:追加/C:更新/D:削除]
097 *       keys               【TAG】リンク先に渡すキーをCSV形式で複数指定します
098 *       vals               【TAG】リンク先に渡す値をCSV形式で複数指定します
099 *       stopError          【TAG】処理エラーの時に処理を中止するかどうか[true/false]を設定します(初期値:true)
100 *       quotCheck          【TAG】リクエスト情報の シングルクォート(') 存在チェックを実施するかどうか[true/false]を設定します (初期値:USE_SQL_INJECTION_CHECK[=true])
101 *       xssCheck           【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか[true/false]を設定します (初期値:USE_XSS_CHECK[=true])
102 *       multi              【TAG】vals属性でパラメーターを取得する際、複数件存在する場合に、値を連結するかどうかを指定します(初期値:false)
103 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
104 *   />
105 *
106 * ●使用例
107 *     <!-- 業務ロジックの呼び出しを行います -->
108 *     <og:bizLogic logics="org.opengion.logic.gf9110.BizLogic_0001" keys="SYSTEM_ID" vals="{@MEM.SYSTEM_ID}" />
109 *
110 * @og.rev 5.1.1.0 (2009/12/01) 新規作成
111 * @og.group 業務ロジック
112 *
113 * @version 5.0
114 * @author Hiroki Nakamura
115 * @since JDK1.6,
116 */
117public class BizLogicTag extends CommonTagSupport {
118        /** このプログラムのVERSION文字列を設定します。   {@value} */
119        private static final String VERSION = "6.9.9.0 (2018/08/20)" ;
120        private static final long serialVersionUID = 699020180820L ;
121
122        /** command 引数に渡す事の出来る コマンド  エントリー {@value} */
123        public static final String CMD_ENTRY            = "ENTRY" ;             // 5.1.9.0 (2010/08/01)
124        private static final String ERR_MSG_ID          = HybsSystem.ERR_MSG_KEY;
125
126        private                         String          command         = CMD_ENTRY;
127        private                         String[]        logics          ;
128        private                         String          dbid            ;
129        private transient       DBTableModel table              ;
130        private                         String          tableId         = HybsSystem.TBL_MDL_KEY;
131        private                         boolean         selectedAll     ;
132        private                         String          modifyType      ;
133        private                         String[]        keys            ;
134        private                         String[]        vals            ;
135
136        private                         boolean         stopError       = true;
137        private                         boolean         quotCheck       = HybsSystem.sysBool( "USE_SQL_INJECTION_CHECK" );      // 4.0.0 (2005/08/31)
138        private                         boolean         xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" );                        // 5.0.0.2 (2009/09/15)
139
140        private transient       ErrorMessage errMessage ;
141        private                         int             errCode                 = ErrorMessage.OK;
142        private                         int             executeCount    = -1;
143        private transient       DataModel<String>       arrTable;                                                                                               // 6.7.9.1 (2017/05/19) ArrayTableModel を、DataModel I/F に変更
144        private transient       HybsLoader              loader  ;                                                                                                       // 6.3.9.0 (2015/11/06) transient 追加
145
146        private                         String  srcDir                  = HybsSystem.sys( "REAL_PATH" ) + HybsSystem.sys( "BIZLOGIC_SRC_PATH" );
147        private                         String  classDir                = HybsSystem.sys( "REAL_PATH" ) + HybsSystem.sys( "BIZLOGIC_CLASS_PATH" );
148        private                         boolean isAutoCompile   = HybsSystem.sysBool( "BIZLOGIC_AUTO_COMPILE" );
149        private                         boolean isHotDeploy             = HybsSystem.sysBool( "BIZLOGIC_HOT_DEPLOY" );
150        private                         boolean isMulti                 ;                       // 5.1.8.0 (2010/07/01) 追加
151
152        // 5.9.26.1 (2017/11/10) 実行エラーの際に、エラーを画面に出力するかどうか。。
153        private                         boolean dispError               = true;
154
155        private static final String     CLASS_PATH;
156
157        // HotDeploy機能を使用する場合に、Javaクラスをコンパイルするためのクラスパスを設定します。
158        // 対象となるクラスパスは、WEB-INF/classes 及び WEB-INF/lib/*.jar です。
159
160        static {
161                final StringBuilder sb = new StringBuilder( BUFFER_MIDDLE )
162                        .append( '.' ).append( File.pathSeparatorChar );
163                final File lib = new File( HybsSystem.sys( "REAL_PATH" ) + "WEB-INF" + File.separator + "lib" );
164                final File[] libFiles = lib.listFiles();
165                // 6.3.9.0 (2015/11/06) null になっている可能性がある(findbugs)
166                if( libFiles != null ) {
167                        for( final File file : libFiles ) {
168                                // 5.1.1.2 (2009/12/10) File.pathSeparatorCharを使用
169                                // 5.1.8.0 (2010/07/01) libの検索パスの不具合対応
170                                sb.append( file.getAbsolutePath() ).append( File.pathSeparatorChar );
171                        }
172                }
173                sb.append( HybsSystem.sys( "REAL_PATH" ) + "WEB-INF" + File.separator + "classes" )
174                        .append( File.pathSeparatorChar )
175                        // 5.1.8.0 (2010/07/01) bizの下も検索パスに追加
176                        .append( HybsSystem.sys( "REAL_PATH" ) + HybsSystem.sys( "BIZLOGIC_CLASS_PATH" ) ).append( File.pathSeparatorChar );
177
178                CLASS_PATH = sb.toString();
179        }
180
181        /**
182         * デフォルトコンストラクター
183         *
184         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
185         */
186        public BizLogicTag() { super(); }               // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
187
188        /**
189         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
190         *
191         * @og.rev 5.3.4.0 (2011/04/01) command=ENTRY以外ではDBTableModelの処理を行わない。
192         * @og.rev 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動
193         *
194         * @return      後続処理の指示(SKIP_BODY)
195         */
196        @Override
197        public int doStartTag() {
198                useXssCheck( xssCheck );                        // 6.4.8.1 (2016/07/02)
199
200                // 5.3.4.0 (2011/04/01)
201                if( CMD_ENTRY.equals( command ) ) {
202                        startQueryTransaction( tableId );
203                }
204
205                return SKIP_BODY ;
206        }
207
208        /**
209         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
210         *
211         * @og.rev 5.1.8.0 (2010/07/01) isMulti対応
212         * @og.rev 5.3.4.0 (2011/04/01) command=ENTRY以外ではDBTableModelの処理を行わない。
213         * @og.rev 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動
214         * @og.rev 5.9.26.1 (2017/11/10) dispErrorの処理追加
215         *
216         * @return      後続処理の指示
217         */
218        @Override
219        public int doEndTag() {
220                debugPrint();
221
222                // 5.3.4.0 (2011/04/01)
223                useQuotCheck( quotCheck );
224
225                makeVals();
226                execute();
227
228                final String err = TaglibUtil.makeHTMLErrorTable( errMessage,getResource() );
229                if( err != null && err.length() > 0 ) {
230                        setSessionAttribute( ERR_MSG_ID,errMessage );
231                }
232
233                if( table != null && ! commitTableObject( tableId, table ) ) {
234                        jspPrint( "BizLoicTag 処理が割り込まれました。DBTableModel は登録しません。" );
235                        return SKIP_PAGE;
236                }
237
238                // 5.9.26.1 (2017/11/10) エラーメッセージをリクエスト変数で持つようにしておく
239                setRequestAttribute( "DB.ERR_MSG", err );
240                // 5.9.26.1 (2017/11/10) dispErrorで表示をコントロール
241                if( dispError ) {
242                        jspPrint( err );
243                }
244
245                if( errCode >= ErrorMessage.NG && stopError )  {
246                        return SKIP_PAGE;
247                }
248                else {
249                        return EVAL_PAGE;
250                }
251        }
252
253        /**
254         * タグリブオブジェクトをリリースします。
255         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
256         *
257         * @og.rev 5.1.8.0 (2010/07/01) isMultiを追加
258         * @og.rev 5.1.9.0 (2010/08/01) Transaction 対応
259         * @og.rev 5.9.26.1 (2017/11/10) dispError追加
260         */
261        @Override
262        protected void release2() {
263                super.release2();
264                command                 = CMD_ENTRY;
265                logics                  = null;
266                dbid                    = null;
267                table                   = null;
268                tableId                 = HybsSystem.TBL_MDL_KEY;
269                selectedAll             = false;
270                modifyType      = null;
271                keys                    = null;
272                vals                    = null;
273                stopError               = true;
274                quotCheck               = HybsSystem.sysBool( "USE_SQL_INJECTION_CHECK" );
275                xssCheck                = HybsSystem.sysBool( "USE_XSS_CHECK" );
276                errMessage              = null;
277                errCode                 = ErrorMessage.OK;
278                executeCount    = -1;
279                arrTable                = null;
280                loader                  = null;
281                srcDir                  = HybsSystem.sys( "REAL_PATH" ) + HybsSystem.sys( "BIZLOGIC_SRC_PATH" );
282                classDir                = HybsSystem.sys( "REAL_PATH" ) + HybsSystem.sys( "BIZLOGIC_CLASS_PATH" );
283                isAutoCompile   = HybsSystem.sysBool( "BIZLOGIC_AUTO_COMPILE" );
284                isHotDeploy             = HybsSystem.sysBool( "BIZLOGIC_HOT_DEPLOY" );
285                isMulti                 = false;        // 5.1.8.0 (2010/07/01) 追加
286                dispError               = true;         // 5.9.26.1 (2017/11/10) 追加
287        }
288
289        /**
290         * 業務ロジックを実行します。
291         *
292         * @og.rev 5.1.9.0 (2010/08/01) Transaction 対応
293         * @og.rev 5.3.4.0 (2011/04/01) command=ENTRY以外ではDBTableModelの処理を行わない。
294         * @og.rev 5.3.7.0 (2011/07/01) TransactionReal の引数変更 、Transaction対応で、close処理を入れる。
295         * @og.rev 5.6.0.3 (2012/01/24) arrTable に変更された値を、table に書き戻す処理を追加
296         * @og.rev 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
297         * @og.rev 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
298         * @og.rev 6.4.3.3 (2016/03/04) Map#forEach で対応する。
299         * @og.rev 6.7.9.1 (2017/05/19) ArrayTableModel を、DataModel I/F に変更
300         */
301        private void execute() {
302
303                // 5.3.4.0 (2011/04/01)
304                if( CMD_ENTRY.equals( command ) ) {
305                        table = (DBTableModel)getObject( tableId );
306                }
307
308                final int[] rowNos;
309                if( table != null ) {
310                        rowNos = getParameterRows();
311                        String[][] tblVals = new String[rowNos.length][table.getColumnCount()];
312                        String[] modTypes = new String[rowNos.length];
313                        for( int i=0; i<rowNos.length; i++ ) {
314                                tblVals[i]  = table.getValues( rowNos[i] );
315                                modTypes[i] = table.getModifyType( rowNos[i] );
316                        }
317                        arrTable = new ArrayTableModel( table.getNames(), tblVals, modTypes );
318                }
319                else {
320                        return;
321                }
322
323                // 5.1.9.0 (2010/08/01) Transaction 対応
324                // 5.3.7.0 (2011/07/01) Transaction対応で、close処理を入れる。
325        //              conn = ConnectionFactory.connection( dbid, null );
326                // 6.3.6.1 (2015/08/28) Transaction でAutoCloseableを使用したtry-with-resources構築に対応。
327                try( Transaction tran = getTransaction() ) {
328                        errMessage = new ErrorMessage();
329                        loader = HybsLoaderFactory.getLoader(
330                                                new HybsLoaderConfig( srcDir, classDir, isAutoCompile, isHotDeploy, CLASS_PATH )
331                                                );
332
333                        boolean rtn = false;
334                        for( int i=0; i<logics.length; i++ ) {
335        //                      BizLogic logic = (BizLogic)loader.newInstance( logics[i] );
336        //                      rtn = call( logic );
337        //                      rtn = call( logics[i] );
338                                rtn = call( logics[i] , tran );         // 5.1.9.0 (2010/08/01) Transaction 対応
339                                if( !rtn ) { break; }
340                        }
341
342                        // 5.6.0.3 (2012/01/24) arrTable に変更された値を、table に書き戻す処理
343                        // 6.9.7.0 (2018/05/14) PMD These nested if statements could be combined
344//                      if( arrTable != null ) {
345//                              // 6.4.3.3 (2016/03/04) 変更が無い場合は、nulllではなく、空のConcurrentMapを返しましす。
346//                              // 6.7.9.1 (2017/05/19) ArrayTableModel を、DataModel I/F に変更
347//                              if( arrTable instanceof ArrayTableModel ) {
348                        // 6.9.8.0 (2018/05/28) FindBugs:常に true を返す instanceof
349//                      if( arrTable != null && arrTable instanceof ArrayTableModel ) {
350                        if( arrTable != null ) {
351                                // 6.4.3.3 (2016/03/04) 変更が無い場合は、nulllではなく、空のConcurrentMapを返しましす。
352                                // 6.7.9.1 (2017/05/19) ArrayTableModel を、DataModel I/F に変更
353                                        final ConcurrentMap<Integer,String[]> valMap = ((ArrayTableModel)arrTable).getModifyVals();
354                                        valMap.forEach( (seq,vals) -> table.setValues( vals , rowNos[seq] ) );
355//                              }
356                        }
357
358                        executeCount = rowNos.length;
359                        errCode = errMessage.getKekka();
360                        setRequestAttribute( "DB.COUNT"   , String.valueOf( executeCount ) );
361                        setRequestAttribute( "DB.ERR_CODE", String.valueOf( errCode ) );
362
363                        if( errCode < ErrorMessage.NG ) {
364        //                      Closer.commit( conn );
365                                tran.commit();                          // 5.1.9.0 (2010/08/01) Transaction 対応
366
367        //                      if( table != null && rowNos.length > 0 ) {
368                                        for( int j=rowNos.length-1; j>=0; j-- ) {
369                                                final int row = rowNos[j];
370                                                if( DBTableModel.DELETE_TYPE.equals( table.getModifyType( row ) ) ) {
371                                                        table.removeValue( row );
372                                                }
373                                                else {
374                                                        table.resetModify( row );
375                                                }
376                                        }
377        //                      }
378                        }
379                        else {
380        //                      Closer.rollback( conn );
381                                tran.rollback();                                // 5.1.9.0 (2010/08/01) Transaction 対応
382                        }
383        //              ConnectionFactory.close( conn, dbid );
384                }
385
386                // エラーメッセージの行番号を元の選択行に戻します。
387                final ErrMsg[] errs = errMessage.toArray();
388                final ErrorMessage errMsgTmp = new ErrorMessage();
389                for( int i=0; i<errs.length; i++ ) {
390                        if( table != null && rowNos.length > 0 ) {
391                                errMsgTmp.addMessage( errs[i].copy( rowNos[errs[i].getNo()] + 1 ) );
392                        }
393                        else {
394                                errMsgTmp.addMessage( errs[i].copy( errs[i].getNo() + 1 ) );
395                        }
396                }
397                errMessage = errMsgTmp;
398        }
399
400        /**
401         * 業務ロジックをCallします。
402         *
403         * @og.rev 5.1.9.0 (2010/08/01) Transaction 対応
404         * @og.rev 5.1.9.0 (2010/08/01) DBIDをセット、ConnectonではなくTransactionを渡すように変更
405         * @og.rev 5.6.7.0 (2013/07/27) Exception を throw するとき、一旦、errMsg 変数にセットします。
406         * @og.rev 6.7.9.1 (2017/05/19) RETURN を返す変数が、logicName + .RETURN にします。
407         * @og.rev 6.9.9.0 (2018/08/20) 戻り値を返せるようにします。
408         *
409         * @param       logicName       業務ロジック名
410         * @param       tran            ランザクションオブジェクト
411         *
412         * @return 業務ロジックの呼び出しが成功したかどうか
413         */
414        private boolean call( final String logicName , final Transaction tran ) {
415                final BizLogicHelper logicHp = new BizLogicHelper( logicName, loader );
416
417                if( logicHp.isRequireTable() ) {
418                        if( arrTable == null ) {
419                                // 5.6.7.0 (2013/07/27) Exception を throw するとき、一旦、errMsg 変数にセットします。
420                                final String errMsg = "TableModelが存在しません。logic=[" + logicName + "]" ;
421                                throw new HybsSystemException( errMsg );
422                        }
423                        else if( arrTable.getRowCount() == 0 ) { return true; } // 0件のときは呼び出ししない
424                        else { logicHp.setTable( arrTable ); }
425                }
426                logicHp.setTransaction( tran );
427                logicHp.setDbid( dbid );                // 5.1.9.0 (2010/08/01) DBIDをセット
428                logicHp.setKeys( keys );
429                logicHp.setVals( vals );
430                logicHp.setUserId( getUser().getUserID() );
431                logicHp.setParentPgId( getGUIInfoAttri( "KEY" ) );
432                logicHp.setLoader( loader );
433                if( isDebug() ) { logicHp.setDebug(); }
434
435                boolean rtn = false;
436                try {
437                        rtn = logicHp.exec();
438                }
439                catch( final Throwable th ) {
440                        tran.rollback();                // 5.1.9.0 (2010/08/01) Transaction 対応
441                        // 5.6.7.0 (2013/07/27) Exception を throw するとき、一旦、errMsg 変数にセットします。
442                        final String errMsg = "業務ロジックの処理中にエラーが発生しました。" + th.getMessage() ;
443                        throw new HybsSystemException( errMsg,th );
444                }
445                errMessage.append( logicHp.getErrMsg() );
446
447                // 6.7.9.1 (2017/05/19) RETURN を返す変数が、logicName + .RETURN にします。
448                // 現状は、BizLogicHelper.RETURN なので、本来は、分けて使いたかったはずなので。
449                setRequestAttribute( logicName + ".RETURN"   , logicHp.getReturn() );
450                setRequestAttribute( "RETURN", logicHp.getReturn() );
451
452                // 6.9.9.0 (2018/08/20) 戻り値を返せるようにします。
453                final Map<String,String> rtnMap = logicHp.getReturnMap();
454                if( rtnMap != null ) {
455                        rtnMap.forEach( (k,v) -> setRequestAttribute( k,v ) );
456                }
457
458                if( isDebug() ) { jspPrint( logicHp.getDebugMsg() ); }
459
460                return rtn;
461        }
462
463        /**
464         * Valsの配列を生成します。
465         *
466         * @og.rev 5.1.8.0 (2010/07/01) 新規作成-
467         * @og.rev 5.6.7.0 (2013/07/27) Exception を throw するとき、一旦、errMsg 変数にセットします。
468         */
469        private void makeVals() {
470                if( keys != null && keys.length > 0 ) {
471                        final boolean isSetVal = vals != null && vals.length > 0 ;
472                        if( isSetVal ) {
473                                if( keys.length != vals.length ) {
474                                        // 5.6.7.0 (2013/07/27) Exception を throw するとき、一旦、errMsg 変数にセットします。
475                                        final String errMsg = "keysとValsの個数が異なります。"  + CR
476                                                                + "  keys=" + Arrays.toString( keys ) + CR
477                                                                + "  vals=" + Arrays.toString( vals ) ;
478                                        throw new HybsSystemException( errMsg );
479                                }
480                        }
481                        else {
482                                vals = new String[keys.length];
483                        }
484                        for( int i=0; i<keys.length; i++ ) {
485                                if( isSetVal ) {
486                                        if( isMulti )   { vals[i] = StringUtil.array2csv( getRequestParameterValues( vals[i] ) );}
487                                        else                    { vals[i] = getRequestParameter( vals[i] ); }
488                                }
489                                else {
490                                        if( isMulti )   { vals[i] = StringUtil.array2csv( getRequestValues( keys[i] ) );}
491                                        else                    { vals[i] = getRequestValue( keys[i] ); }
492                                }
493                        }
494                }
495        }
496
497        /**
498         * 【TAG】コマンドをセットします(初期値:ENTRY)。
499         *
500         * @og.tag
501         * command=ENTRY以外ではDBTableModelの処理を行いません。
502         * コマンドは,HTMLから[get/post]指定されますので,CMD_xxx で設定される
503         * フィールド定数値のいづれかを、指定できます。
504         *
505         * @param       cmd コマンド (public static final 宣言されている文字列)
506         * @see         <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.BizLogicTag.CMD_ENTRY">コマンド定数</a>
507         */
508        public void setCommand( final String cmd ) {
509                final String cmd2 = getRequestParameter( cmd );
510                if( cmd2 != null && cmd2.length() >= 0 ) { command = cmd2.toUpperCase(Locale.JAPAN); }
511        }
512
513        /**
514         * 【TAG】実行する業務ロジック名を指定します。
515         *
516         * @og.tag
517         * 実行する業務ロジック名を指定します。業務ロジック名は、クラス名を指定します。
518         * クラス名については、クラス自身の名称のみを指定することができます。
519         * (パッケージ名を含めた完全な形のクラス名を指定することもできます)
520         * また、CSV形式で、複数指定することもできます。
521         * この場合、指定した順番に処理されます。
522         *
523         * @param       lgs 業務ロジック名
524         */
525        public void setLogics( final String lgs ) {
526                logics = getCSVParameter( lgs );
527        }
528
529        /**
530         * 【TAG】(通常は使いません)Queryオブジェクトを作成する時のDB接続IDを指定します(初期値:null)。
531         *
532         * @og.tag
533         * Queryオブジェクトを作成する時のDB接続IDを指定します。
534         * これは、システムリソースで、DEFAULT_DB_URL 等で指定している データベース接続先
535         * 情報に、XX_DB_URL を定義することで、 dbid="XX" とすると、この 接続先を使用して
536         * データベースにアクセスできます。
537         *
538         * @param       id データベース接続ID
539         */
540        public void setDbid( final String id ) {
541                dbid = nval( getRequestParameter( id ),dbid );
542        }
543
544        /**
545         * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
546         *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
547         *
548         * @og.tag
549         * 検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に
550         * 渡す場合に、通常は、session を利用します。その場合の登録キーです。
551         * query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、
552         * この tableId 属性を利用して、メモリ空間を分けます。
553         * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
554         *
555         * @param       id テーブルID (sessionに登録する時のID)
556         */
557        public void setTableId( final String id ) {
558                tableId   = nval( getRequestParameter( id ),tableId );
559        }
560
561        /**
562         * 【TAG】データを全件選択済みとして処理するかどうか[true/false]を指定します(初期値:false)。
563         *
564         * @og.tag
565         * 全てのデータを選択済みデータとして扱って処理します。
566         * 全件処理する場合に、(true/false)を指定します。
567         * 初期値は false です。
568         *
569         * @param  all データを全件選択済み [true:全件選択済み/false:通常]
570         */
571        public void setSelectedAll( final String all ) {
572                selectedAll = nval( getRequestParameter( all ),selectedAll );
573        }
574
575        /**
576         * 【TAG】DB検索時の モディファイタイプを指定します[A:追加/C:更新/D:削除]。
577         *
578         * @og.tag
579         * DB検索時に、そのデータをA(追加)、C(更新)、D(削除)のモディファイタイプを
580         * つけた状態にします。
581         * その状態で、そのまま、update する事が可能になります。
582         *
583         * @param   type モディファイタイプ [A:追加/C:更新/D:削除]
584         */
585        public void setModifyType( final String type ) {
586                modifyType = nval( getRequestParameter( type ),modifyType );
587        }
588
589        /**
590         * 【TAG】リンク先に渡すキーをCSV形式で複数指定します。
591         *
592         * @og.tag リンク先に渡すキーを指定します。
593         * Keysだけを指定して、Valsを指定しない場合、Keysで指定された項目名に対応するパラメーターを取得し、
594         * Valsとして使用します。
595         *
596         * @og.rev 3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用
597         *
598         * @param       key リンク先に渡すキー(CSV形式)
599         */
600        public void setKeys( final String key ) {
601                keys = getCSVParameter( getRequestParameter( key ) );
602        }
603
604        /**
605         * 【TAG】リンク先に渡す値をCSV形式で複数指定します。
606         *
607         * @og.tag リンク先に渡す値を指定します。
608         * Keysだけを指定して、Valsを指定しない場合、Keysで指定された項目名に対応するパラメーターを取得し、
609         * Valsとして使用します。
610         * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
611         * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
612         *
613         * @og.rev 3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用
614         * @og.rev 5.1.8.0 (2010/07/01) isMuitl対応
615         *
616         * @param       val リンク先に渡す値(CSV形式)
617         */
618        public void setVals( final String val ) {
619                vals = StringUtil.csv2Array( val );
620        }
621
622        /**
623         * 【TAG】処理エラーの時に処理を中止するかどうか[true/false]を設定します(初期値:true)。
624         *
625         * @og.tag
626         * false(中止しない)に設定する場合、後続処理では、{&#064;DB.ERR_CODE}の値により、
627         * PLSQL/SQLの異常/正常終了によって分岐処理は可能となります。
628         * 初期値は、true(中止する)です。
629         *
630         * @param   flag  処理の中止 [true:中止する/false:中止しない]
631         */
632        public void setStopError( final String flag ) {
633                stopError = nval( getRequestParameter( flag ),stopError );
634        }
635
636        /**
637         * 【TAG】PLSQL/SQL処理エラーの時にエラーを画面表示するか[true/false]を設定します(初期値:true)。
638         *
639         * @og.tag
640         * false(表示しない)に設定する場合、後続処理では、{&#064;DB.ERR_MSG}の値により、
641         * 本来表示されるはずだったメッセージを取得可能です。
642         * stopErrorと併用して、JSON形式でエラーを返す場合等に利用します。
643         * 初期値は、true(表示する)です。
644         *
645         * @og.rev 5.9.26.1 (2017/11/10) 新規追加
646         *
647         * @param   flag  [true:表示する/false:表示しない]
648         */
649        public void setDispError( final String flag ) {
650                dispError = nval( getRequestParameter( flag ),dispError );
651        }
652
653        /**
654         * 【TAG】リクエスト情報の シングルクォート(') 存在チェックを実施するかどうか[true/false]を設定します
655         *              (初期値:USE_SQL_INJECTION_CHECK[={@og.value SystemData#USE_SQL_INJECTION_CHECK}])。
656         *
657         * @og.tag
658         * SQLインジェクション対策の一つとして、暫定的ではありますが、SQLのパラメータに
659         * 渡す文字列にシングルクォート(') を許さない設定にすれば、ある程度は防止できます。
660         * 数字タイプの引数には、 or 5=5 などのシングルクォートを使用しないコードを埋めても、
661         * 数字チェックで検出可能です。文字タイプの場合は、必ず (')をはずして、
662         * ' or 'A' like 'A のような形式になる為、(')チェックだけでも有効です。
663         * (') が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
664         * (初期値:システム定数のUSE_SQL_INJECTION_CHECK[={@og.value SystemData#USE_SQL_INJECTION_CHECK}])。
665         *
666         * @param   flag クォートチェック [true:する/それ以外:しない]
667         * @see         org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK
668         */
669        public void setQuotCheck( final String flag ) {
670                quotCheck = nval( getRequestParameter( flag ),quotCheck );
671        }
672
673        /**
674         * 【TAG】リクエスト情報の HTMLTag開始/終了文字(&gt;&lt;) 存在チェックを実施するかどうか[true/false]を設定します
675         *              (初期値:USE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
676         *
677         * @og.tag
678         * クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。
679         * (&gt;&lt;) が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。
680         * (初期値:システム定数のUSE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。
681         *
682         * @param       flag    XSSチェックする [true:チェックする/false:しない]
683         * @see         org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK
684         */
685        public void setXssCheck( final String flag ) {
686                xssCheck = nval( getRequestParameter( flag ),xssCheck );
687        }
688
689        /**
690         * 【TAG】vals属性でパラメーターを取得する際、複数件存在する場合に、値を連結するかどうかを指定します(初期値:false)。
691         *
692         * @og.tag
693         * この属性がtrueに指定された場合、パラメーターが複数存在する場合に、カンマで連結します。
694         * 初期値は、false(連結しない)です。
695         *
696         * @og.rev 5.1.8.0 (2010/07/01) 新規作成
697         *
698         * @param       flag    値連結 [true:する/false:しない]
699         */
700        public void setMulti( final String flag ) {
701                 isMulti = nval( getRequestParameter( flag ),isMulti );
702        }
703
704        /**
705         * 表示データの HybsSystem.ROW_SEL_KEY を元に、選ばれた 行を処理の対象とします。
706         *
707         * @return      選択行の配列
708         */
709        @Override
710        protected int[] getParameterRows() {
711                final int[] rowNo ;
712                if( selectedAll ) {
713                        final int rowCnt = table.getRowCount();
714                        rowNo = new int[ rowCnt ];
715                        for( int i=0; i<rowCnt; i++ ) {
716                                rowNo[i] = i;
717                        }
718                } else {
719                        rowNo = super.getParameterRows();
720                }
721                return rowNo ;
722        }
723
724        /**
725         * このオブジェクトの文字列表現を返します。
726         * 基本的にデバッグ目的に使用します。
727         *
728         * @return このクラスの文字列表現
729         * @og.rtnNotNull
730         */
731        @Override
732        public String toString() {
733                return ToString.title( this.getClass().getName() )
734                                .println( "VERSION"                     ,VERSION                )
735                                .println( "command"                     ,command                )
736                                .println( "logics"                      ,logics                 )
737                                .println( "dbid"                        ,dbid                   )
738                                .println( "tableId"                     ,tableId                )
739                                .println( "selectedAll"         ,selectedAll    )
740                                .println( "modifyType"          ,modifyType             )
741                                .println( "keys"                        ,keys                   )
742                                .println( "vals"                        ,vals                   )
743                                .println( "stopError"           ,stopError              )
744                                .println( "quotCheck"           ,quotCheck              )
745                                .println( "xssCheck"            ,xssCheck               )
746                                .println( "executeCount"        ,executeCount   )
747                                .println( "errCode"                     ,errCode                )
748                                .println( "Other..."            ,getAttributes().getAttribute() )
749                                .fixForm().toString() ;
750        }
751}