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     */
016    package org.opengion.hayabusa.taglib;
017    
018    import org.opengion.hayabusa.common.HybsSystem;
019    import org.opengion.hayabusa.common.HybsSystemException;
020    
021    import org.opengion.fukurou.util.StringUtil;
022    import static org.opengion.fukurou.util.StringUtil.nval ;
023    
024    /**
025     * Where句を作æ?するための条件を指定しますã?
026     *
027     * こã?タグのvalue 値に、{@XXXX} 変数が含まれてã�?‚‹場合ã?そã?リクエストå?ã�?
028     * なã�??合ã?、このタグそã?もã?がなにもå?力しませんã€?つまり条件から消えますã?)
029     * startKeyは、value をé?結するå?合ã?頭に置かれる文字å?で、where句のæœ??には表示されずã?
030     * それ以降につã�?�¦、表示されますã?(つまりã?where VALUE1 and VALUE2 and VALUE3 … ですã?)
031     * startKey の初期値はã€?and" ですã?
032     * multi は、{@XXXX} 変数に、å?がè¤?•°含まれてã�?‚‹場合ã?処ç�?‚’規定しますã?
033     * è¤?•°の値とは、同ä¸?ameでチェãƒ?‚¯ボックスæŒ?®šや、メニューでのè¤?•°æŒ?®šしたå?合ã?
034     * リクエストが配å?で送られますã?multi="true" とするとã€?xx1','xx2','xx3', ?¥?¥?¥ とã�?�†
035     * 形式に変換されますã?
036     * 具体的にはã€?where PN in ( {@PN} )" とã�?�†æ–?­—å?に対してã€?
037     * "where PN in ( 'xx1','xx2','xx3' )" を作æ?することができますã?
038     * multi の初期値はã€?false" ですã?
039     * SystemData の USE_SQL_INJECTION_CHECK ã�?true かã?quotCheck 属æ?ã�?true の場合ã?ã€?
040     * ?³?±?¬インジェクション対策用のクォーãƒ?‚£ションチェãƒ?‚¯を行いますã?リクエスト引数に
041     * クォーãƒ?‚£ション(')が含まれると、エラーになりますã?
042     * 同様にUSE_XSS_CHECKがtrueかã?xssCheck属æ?がtrueの場合ã?ã€?
043     * クロスサイトススクリプティング(XSS)対策ã?ためless/greater than signのチェãƒ?‚¯を行いますã?
044     *
045     * å�?±žæ?は、{@XXXX} 変数が使用できますã?
046     * これは、ServletRequest から、XXXX をキーに値を取りå?ã�?こã?変数に割り当てますã?
047     * つまりã?こã?XXXXをキーにリクエストすれã?、この変数に値をセãƒ?ƒˆすることができますã?
048     *
049     * @og.formSample
050     * ●形式ï¼?lt;og:and startKey="[and|or|…]" value="…" multi="[false|true]" />
051     * ●body?šあã‚?EVAL_BODY_BUFFERED:BODYを評価しã?{@XXXX} を解析しまã�?
052     *
053     * ●Tag定義??
054     *   <og:and
055     *       startKey           【TAG】SQL条件句のæœ??の演算子をæŒ?®šしまã�?初期値:and)
056     *       value              【TAG】条件の値ã‚?セãƒ?ƒˆしまã�?
057     *       multi              【TAG】è¤?•°の引数に対して処ç�?�™るかどã�?�‹[true/false]を設定しまã�?初期値:false)
058     *       separator          【TAG】multi アクション時ã?æ–?­—å?をå?割するé ?›®区åˆ?‚Šæ–?­—をセãƒ?ƒˆしまã�?
059     *       quotCheck          【TAG】リクエスト情報の クォーãƒ?‚£ション(') 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?(初期値:USE_SQL_INJECTION_CHECK[=true])
060     *       instrVals          【TAG】スペã?スで区åˆ?‚‰れたè¤?•°の値すべてを含ã‚?�¡件を作æ?しまã�?
061     *       instrType          【TAG】instrValsでè¤?•°の値を条件にする際ã?方法をæŒ?®šしまã�?初期値:and)
062     *       xssCheck           【TAG】リクエスト情報の HTMLTag開å§?終äº?–‡å­?><) 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?(初期値:USE_XSS_CHECK[=true])
063     *       caseKey            【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しまã�?初期値:null)
064     *       caseVal            【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しまã�?初期値:null)
065     *       caseNN             【TAG】指定ã?値がã?null/ゼロæ–?­—å? でなã�??å�?Not Null=NN)は、このタグは使用されまã�?初期値:true)
066     *       caseNull           【TAG】指定ã?値がã?null/ゼロæ–?­—å? の場合ã?、このタグは使用されまã�?初期値:true)
067     *       debug              【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
068     *   >   ... Body ...
069     *   </og:and>
070     *
071     * ●使用ä¾?
072     *     <og:query command="NEW">
073     *             select PN,YOBI,NMEN,HINM from XX01
074     *         <og:where>
075     *             <og:and value="PN   =    '{@PN}'"    />
076     *             <og:and value="YOBI like '{@YOBI}%'" />
077     *         </og:where>
078     *             order by PN
079     *     </og:query>
080     *
081     *          ・検索条件がå?力されたæ™?PN=AAA , YOBI=BBB)
082     *            作æ?されるSQLæ–?�çselect PN,YOBI,NMEN,HINM from XX01 where PN = 'AAA' and YOBI like 'BBB%' order by PN
083     *
084     *          ・検索条件が片方入力されなかった時(PNがNULLのとã�? YOBI=BBB)
085     *            作æ?されるSQLæ–?�çselect PN,YOBI,NMEN,HINM from XX01 where YOBI like 'BBB%' order by PN
086     *
087     *          ・検索条件がå?力されなかった時(PNがNULL, YOBIがNULL) WHERE句がなくなるã?
088     *            作æ?されるSQLæ–?�çselect PN,YOBI,NMEN,HINM from XX01 order by PN
089     *
090     *        注æ„?WhereTagを使わなã�??合に、検索条件がå?力されなかったå?合ã?、下記ã?ようになりますã?
091     *            select PN,YOBI,NMEN,HINM from XX01 where PN = '' and YOBI like '%' order by PN
092     *
093     *    --------------------------------------------------------------------------------------------------------------
094     *
095     *     <og:query command="NEW">
096     *             select PN,YOBI,NMEN,HINM from XX01 where PN="11111"
097     *         <og:where startKey="and">
098     *             <og:and value="YOBI in   ({@YOBI})" multi="true" />
099     *             <og:and value="HINM like '{@HINM}%'"             />
100     *         </og:where>
101     *             order by PN
102     *     </og:query>
103     *
104     *          ・YOBI をè¤?•°選択し、in で検索するæ™?YOBI=AA,BB,CC を選æŠ?
105     *            作æ?されるSQLæ–?�çselect PN,YOBI,NMEN,HINM from XX01 where PN = '11111'
106     *                             and YOBI in ( 'AA','BB','CC' ) and HINM like 'BBB%' order by PN
107     *
108     * @og.group 画面部å“?
109     *
110     * @version  4.0
111     * @author       Kazuhiko Hasegawa
112     * @since    JDK5.0,
113     */
114    public class SqlAndTag extends CommonTagSupport {
115            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
116            private static final String VERSION = "5.5.1.1 (2012/04/06)" ;
117    
118            private static final long serialVersionUID = 551120120406L ;
119    
120            private String  startKey        = "and";
121            private String  value           = "";
122            private String  instrVals       = null;         // 3.8.8.1 (2007/01/06)
123            private String  instrType       = "and";        // 5.4.1.0 (2011/11/01)
124            private boolean multi           = false;
125            private boolean quotCheck       = HybsSystem.sysBool( "USE_SQL_INJECTION_CHECK" );      // 4.0.0 (2005/08/31)
126            private boolean xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" );        // 5.0.0.2 (2009/09/15)
127    
128            private boolean allNull         = false;        // 5.0.0.2 (2009/09/15)
129    
130    //      private String  matchKey        = null;         // 5.1.9.0 (2010/08/01) â‡?5.2.2.0 (2010/11/01) å»?­¢(caseKey,caseVal属æ?を使用してくださいã€?
131    
132    //      private String  matchVal        = null;         // 5.1.9.0 (2010/08/01) â‡?5.2.2.0 (2010/11/01) å»?­¢(caseKey,caseVal属æ?を使用してくださいã€?
133    
134            private String  separator       = null;         // 5.2.2.0 (2010/11/01) é ?›®区åˆ?‚Šæ–?­?
135    
136            /**
137             * Taglibの開始タグが見つかったときに処ç�?�™ã‚?doStartTag() ã‚?オーバã?ライドしますã?
138             *
139             * @og.rev 4.0.0.0 (2006/12/05) BODY 部の値ã‚?value に使用する機è?追åŠ?
140             * @og.rev 4.0.0.0 (2005/08/31) useQuotCheck() による?³?±?¬インジェクション対ç­?
141             * @og.rev 5.0.0.2 (2009/09/15) XSS対ç­?
142             * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
143             *
144             * @return      後続å?ç�??æŒ?¤º
145             */
146            @Override
147            public int doStartTag() {
148                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
149                    if( useTag() ) {
150                            useQuotCheck( quotCheck );
151                            // 5.0.0.2 (2009/09/15) XSS対ç­?
152                            useXssCheck( xssCheck );
153    
154                            value = getRequestParameter( value );
155    
156                            if( value == null || value.isEmpty() ) {
157                                    return( EVAL_BODY_BUFFERED );   // Body を評価するã€? extends BodyTagSupport æ™?
158                            }
159    
160            //              if( value != null && value.length() > 0 ) {
161            //                      return( SKIP_BODY );                    // Body を評価しなã�?
162            //              }
163            //              else {
164            //                      return( EVAL_BODY_BUFFERED );   // Body を評価するã€? extends BodyTagSupport æ™?
165            //              }
166                    }
167                    return( SKIP_BODY );                    // Body を評価しなã�?
168            }
169    
170            /**
171             * Taglibのタグ本体を処ç�?�™ã‚?doAfterBody() ã‚?オーバã?ライドしますã?
172             *
173             * @og.rev 4.0.0.0 (2006/12/05) BODY 部の値ã‚?value に使用する機è?追åŠ?
174             *
175             * @return      後続å?ç�??æŒ?¤º(SKIP_BODY)
176             */
177            @Override
178            public int doAfterBody() {
179                    value = getBodyString();
180                    return(SKIP_BODY);
181            }
182    
183            /**
184             * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
185             *
186             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
187             * @og.rev 3.8.8.1 (2007/01/06) makeInstrVals を加味するã€?
188             * @og.rev 5.0.0.2 (2009/09/15) multi時ã?allNull対å¿?
189             * @og.rev 5.1.9.0 (2010/08/01) matchKey 、matchVal 対å¿?â‡?5.2.2.0 (2010/11/01) å»?­¢
190             * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
191             *
192             * @return      後続å?ç�??æŒ?¤º
193             */
194            @Override
195            public int doEndTag() {
196                    debugPrint();           // 4.0.0 (2005/02/28)
197                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
198                    if( useTag() ) {
199                            SqlWhereTag where = (SqlWhereTag)findAncestorWithClass( this,SqlWhereTag.class );
200                            if( where == null ) {
201                                    String errMsg = "<b>こã?タグは、where タグのå†?ƒ¨におくå¿?¦�がありますã?</b>";
202                                    throw new HybsSystemException( errMsg );
203                            }
204    
205                            // 5.1.9.0 (2010/08/01) matchKey 、matchVal 対å¿?â‡?5.2.2.0 (2010/11/01) å»?­¢
206            //              boolean flag = (matchKey == null) || (matchVal == null) || matchKey.matches( matchVal ) ;
207    
208                            // if( ! isNull() ) {
209            //              if( ! isNull() && ! allNull ) {                 // 5.0.0.2 (2009/09/15)
210            //              if( ! isNull() && ! allNull && flag ) { // 5.1.9.0 (2010/08/01)
211                            if( ! isNull() && ! allNull ) {                 // 5.2.2.0 (2010/11/01)
212    //                              value = makeInstrVals( instrVals,value );       // 3.8.8.1 (2007/01/06)
213                                    value = makeInstrVals( instrVals,instrType,value );     // 5.4.1.0 (2011/11/01)
214                                    if( value != null ) {
215                                            set( "keyWord", startKey );
216                                            set( "value"  , value );
217                                            where.setAttributes( getAttributes() );
218                                    }
219                            }
220                    }
221                    return(EVAL_PAGE);
222            }
223    
224            /**
225             * タグリブオブジェクトをリリースしますã?
226             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
227             *
228             * @og.rev 2.0.0.4 (2002/09/27) カスタãƒ?‚¿グの release() メソãƒ?ƒ‰をã?追åŠ?
229             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
230             * @og.rev 3.8.8.1 (2007/01/06) instrVals 属æ?追åŠ?
231             * @og.rev 4.0.0.0 (2005/08/31) quotCheck 属æ?の追åŠ?
232             * @og.rev 5.0.0.2 (2009/09/15) XSS対å¿?
233             * @og.rev 5.0.0.2 (2009/09/15) multi時ã?allNull対å¿?
234             * @og.rev 5.1.9.0 (2010/08/01) matchKey、matchVal 属æ?の追åŠ?
235             * @og.rev 5.2.2.0 (2010/11/01) separator , isMatch 属æ?の追åŠ?
236             * @og.rev 5.2.2.0 (2010/11/01) matchKey、matchVal 属æ?å»?­¢(caseKey,caseVal属æ?を使用してくださいã€?
237             * @og.rev 5.4.1.0 (2011/11/01) instrType属æ?追åŠ?
238             */
239            @Override
240            protected void release2() {
241                    super.release2();
242                    startKey        = "and";
243                    value           = "";
244                    instrVals       = null;         // 3.8.8.1 (2007/01/06)
245                    instrType       = "and";        // 5.4.1.0 (2011/11/01)
246                    multi           = false;
247                    quotCheck       = HybsSystem.sysBool( "USE_SQL_INJECTION_CHECK" );      // 4.0.0 (2005/08/31)
248                    xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" );        // 5.0.0.2 (2009/09/15)
249                    allNull         = false;        // 5.0.0.2 (2009/09/15)
250    //              matchKey        = null;         // 5.1.9.0 (2010/08/01) 新規追åŠ?
251    //              matchVal        = null;         // 5.1.9.0 (2010/08/01) 新規追åŠ?
252                    separator       = null;         // 5.2.2.0 (2010/11/01) é ?›®区åˆ?‚Šæ–?­?
253            }
254    
255            /**
256             * リクエスト情報のæ–?­—å?を取得しますã?
257             *
258             * これはã€??常のgetRequestParameter 処ç�??中で呼ばれる getRequestValue ã‚?
259             * オーバã?ライトしてã�?�¾すã?
260             *
261             * @og.rev 5.0.0.2 (2009/09/15) valuesの全NULL/空æ–?­—をisNull扱ã�?�«する
262             * @og.rev 5.3.8.0 (2011/08/01) Attribute等からも値が取得できるようにする。ã?対応時の特殊å?ç�?
263             *
264             * @param    key キー
265             *
266             * @return   リクエスト情報のæ–?­—å?
267             */
268            @Override
269            protected String getRequestValue( final String key ) {
270                    String rtn = "";
271    
272                    if( multi ) {
273                            // 5.3.8.0 (2011/08/01) getRequestValues の中で、getRequestValue を呼び出すためこのままでは
274                            // 再帰呼び出しが永é�?�«続くのでã€?¼’回目以降ã?、å?帰しなã�?‚ˆã�?�«、強制çš?�« multi の値を書き換えますã?
275                            multi = false;  // 5.3.8.0 (2011/08/01) 再帰しなã�?‚ˆã�?�«、強制çš?�«値を書き換ã�?
276                            String[] array = getRequestValues( key );
277                            allNull = true; // 5.0.0.2 (2009/09/15) arrayのå†?®¹がå?てnull/空æ–?­—か
278                            if( ! isNull() ) {
279                                    // 5.0.0.2 (2009/09/15) 全てnull/空æ–?­—ã?場合ã?nullと扱ã�?
280                                    for( int i = 0; i < array.length; i++ ) {
281                                            if( array[i] != null && array[i].length() > 0 ) {
282                                                    allNull = false;
283                                                    break;
284                                            }
285                                    }
286                                    if( ! allNull ){
287                                            rtn = makeCSVvalue( array );
288                                    }
289                            }
290                            multi = true;   // 5.3.8.0 (2011/08/01) 強制çš?�«書き換えた値をå?に戻すã?
291                    }
292                    else {
293                            rtn = super.getRequestValue( key );
294                    }
295                    return rtn ;
296            }
297    
298            /**
299             * è¤?•°の値ã‚?'xx1','xx2','xx3', ?¥?¥?¥ とã�?�†形式に変換しますã?
300             *
301             * こã?処ç�??、in などで使用するためのリクエストを配å?で受け取って処ç�?
302             * する場合ã?æ–?­—å?を加工しますã?
303             *
304             * @og.rev 5.2.2.0 (2010/11/01) separator 対å¿?
305             *
306             * @param       array   å…??配å?æ–?­—å?
307             *
308             * @return  連結後ã?æ–?­—å?
309             */
310            private String makeCSVvalue( final String[] array ) {
311                    if( array == null || array.length == 0 ) {
312                            String errMsg = "array 引数に、null ã‚??サイズゼロの配å?は使用できませんã€?;
313                            throw new HybsSystemException( errMsg );
314                    }
315    
316                    StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
317    
318                    if( separator != null ) {
319                            for(int i=0; i < array.length; i++) {
320                                    String[] ary = array[i].split( separator );
321                                    for( int j=0; j<ary.length; j++ ) {
322                                            buf.append( "'" );
323                                            buf.append( ary[j] );
324                                            buf.append( "'," );
325                                    }
326                            }
327                            buf.deleteCharAt( buf.length()-1 );             // æœ?¾Œã? ピリオドを削除するã€?
328                    }
329                    else {
330                            for(int i=0; i < array.length; i++) {
331                                    buf.append( "'" );
332                                    buf.append( array[i] );
333                                    buf.append( "'," );
334                            }
335                            buf.deleteCharAt( buf.length()-1 );             // æœ?¾Œã? ピリオドを削除するã€?
336                    }
337    //              buf.append( "'" );
338    //              buf.append( array[0] );
339    //              buf.append( "'" );
340    //              for(int i=1; i < array.length; i++) {
341    //                      buf.append( ",'" );
342    //                      buf.append( array[i] );
343    //                      buf.append( "'" );
344    //              }
345                    return buf.toString();
346            }
347    
348            /**
349             * スペã?スで区åˆ?‚‰れたè¤?•°の値ã‚?and 接続で連結しますã?
350             *
351             * value="CLM" instrVals="ABC DEF GHI" とæŒ?®šするとã€?
352             * value="CLM LIKE '%ABC%' AND CLM LIKE '%DEF%'  AND CLM LIKE '%GHI%' "
353             * とã�?�†æ–?­—å?を作æ?しますã?
354             * 個別にLIKE検索é ?›®ã‚?AND 連結する為、現れる場æ‰?�«依存しませんã€?
355             * é€?�«、現れるé ?º�をæŒ?®šするå?合ã?、ABC%DEF の様にæŒ?®š可能ですã?
356             * ただしã?columnMarker の instrVals で、è¤?•°æ–?­—ã?マã?カーを行う場合ã?
357             * ABC%DEF とã�?�†æ–?­—å?は、オリジナルでなã�??で、ã?ークアãƒ??されませんã€?
358             *
359             * @og.rev 5.4.1.0 (2011/11/01) instrType属æ?対å¿?
360             * @og.rev 5.5.1.1 (2012/04/06) notin対å¿?
361             *
362             * @param       instrVals       繰返し処ç�?‚’行う 値
363             * @param       instrType       連結方æ³?
364             * @param       value           繰返し処ç�?‚’行う value
365             *
366             * @return  連結後ã?æ–?­—å?
367             * @see         #setInstrVals( String )
368             * @see         ColumnMarkerTag#setInstrVals( String )
369             */
370            private String makeInstrVals( final String instrVals, final String instrType , final String value ) {
371                    if( instrVals == null || instrVals.length() == 0 ) { return value; }
372    
373                    String reqVals = nval( getRequestParameter( instrVals ),null );
374                    if( reqVals == null || reqVals.length() == 0 ) { return null; }
375    
376                    final String[] vals ;
377                    if( multi ) {
378                            // multi のときã?、makeCSVvalue でåŠ?·¥されたå?になってã�?‚‹ã€?
379                            vals = StringUtil.csv2Array( reqVals,',' );
380                            // 前後ã? ' はずし
381                            for( int i=0; i<vals.length; i++ ) {
382                                    vals[i] = vals[i].substring( 1,vals[i].length()-1 );
383                            }
384                    }
385                    else {
386                            vals = StringUtil.csv2Array( reqVals,' ' );
387                    }
388    
389                    if( vals == null || vals.length == 0 ) { return null; }
390    
391                    StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_SMALL );
392    
393    //              buf.append( value );
394    //              buf.append( " LIKE '%" );
395    //              buf.append( vals[0] );
396    //              buf.append( "%'" );
397    
398                    buf.append( " (" );
399                    // 条件:and â‡?å�??をandのlike条件で結合(%あり)
400                    if( instrType.startsWith( "a" ) ) {
401                            for(int i=0; i < vals.length; i++) {
402                                    if( i > 0 ) { buf.append( " and " ); }
403                                    buf.append( value );
404                                    buf.append( " LIKE '%" ).append( vals[i] ).append( "%'" );
405                            }
406                    }
407                    // 条件:or â‡?å�??をorのlike条件で結合(%あり)
408                    else if( instrType.startsWith( "o" ) ) {
409                            for(int i=0; i < vals.length; i++) {
410                                    if( i > 0 ) { buf.append( " or " ); }
411                                    buf.append( value );
412                                    buf.append( " LIKE '%" ).append( vals[i] ).append( "%'" );
413                            }
414                    }
415                    // 条件:in â‡?å�??をorのlike条件で結合(%なã�?
416                    else if( instrType.startsWith( "i" ) ) {
417                            for(int i=0; i < vals.length; i++) {
418                                    if( i > 0 ) { buf.append( " or " ); }
419                                    buf.append( value );
420                                    buf.append( " LIKE '" ).append( vals[i] ).append( "'" );
421                            }
422                    }
423                    // 条件:notin â‡?å�??をandのnot like条件で結合(%なã�? 5.5.1.1(2012/04/05)
424                    else if( instrType.startsWith( "n" ) ) {
425                            for(int i=0; i < vals.length; i++) {
426                                    if( i > 0 ) { buf.append( " and " ); }
427                                    buf.append( value );
428                                    buf.append( " NOT LIKE '" ).append( vals[i] ).append( "'" );
429                            }
430                    }
431                    else {
432                            String errMsg = "instrTypeにはã€?and','or','in','notin'のã�?�šれかを指定して下さã�??instrType=[" + instrType + "]";
433                            throw new HybsSystemException( errMsg );
434                    }
435                    buf.append( ") " );
436    
437                    return buf.toString();
438            }
439    
440            /**
441             * 【TAG】SQL条件句のæœ??の演算子をæŒ?®šしまã�?初期値:and)ã€?
442             *
443             * @og.tag
444             * value をé?結するå?合ã?頭に置かれる文字å?で、where句のæœ??には表示されずã?
445             * それ以降につã�?�¦、表示されますã?
446             * (つまりã?where VALUE1 and VALUE2 and VALUE3 … ですã?)
447             * startKey の初期値はã€?and" ですã?
448             *
449             * @param       skey 条件句のæœ??の演算å­?
450             */
451            public void setStartKey( final String skey ) {
452                    if( skey != null && skey.length() > 0 ) { startKey = skey; }
453            }
454    
455            /**
456             * 【TAG】条件の値ã‚?セãƒ?ƒˆしますã?
457             *
458             * @og.tag
459             * 条件値に、{&#064;XXXX} 変数が含まれてã�?‚‹場合ã?そã?リクエストå?がなã�??合ã?ã€?
460             * こã?タグそã?もã?がなにもå?力しませんã€?つまり条件から消えますã?)
461             * BODY 部に記述することが可能ですã?そã?場合ã?、条件属æ?になにも設定できませんã€?
462             *
463             * @param       val 条件値
464             */
465            public void setValue( final String val ) {
466                    value = val;
467            }
468    
469            /**
470             * 【TAG】スペã?スで区åˆ?‚‰れたè¤?•°の値すべてを含ã‚?�¡件を作æ?しますã?
471             *
472             * @og.tag
473             * 通常、value="CLM LIKE 'ABC%'" とã�?�†æ–?­—å?を指定しますがã€?
474             * value="CLM" instrVals="ABC DEF GHI" とæŒ?®šするとã€?
475             * value="CLM LIKE '%ABC%' AND CLM LIKE '%DEF%'  AND CLM LIKE '%GHI%' "
476             * とã�?�†æ–?­—å?を作æ?しますã?
477             * これは、instrVals にæŒ?®šした引数に対して、スペã?ス区åˆ?‚Šでåˆ?‰²しã?
478             * 前方の value にè¤?•°のAND検索を同時に実現できるようにæŒ?®šしまã�?
479             * 個別にLIKE検索é ?›®ã‚?AND 連結する為、現れる場æ‰?�«依存しませんã€?
480             * é€?�«、現れるé ?º�をæŒ?®šするå?合ã?、ABC%DEF の様にæŒ?®š可能ですã?
481             * ただしã?columnMarker の instrVals で、è¤?•°æ–?­—ã?マã?カーを行う場合ã?
482             * ABC%DEF とã�?�†æ–?­—å?は、オリジナルでなã�??で、ã?ークアãƒ??されませんã€?
483             * ※instrType属æ?のæŒ?®šにより条件の生æ?方法を変更することができますã?
484             *   詳細につã�?�¦は、instrType属æ?のドキュメントを参ç?下さã�??
485             *
486             * @param       val è¤?�ˆ条件作æ?のための設定å?
487             * @see         #setInstrType
488             * @see         ColumnMarkerTag#setInstrVals( String )
489             */
490            public void setInstrVals( final String val ) {
491                    instrVals = val;
492            }
493    
494            /**
495             * 【TAG】instrValsでè¤?•°の値を条件にする際ã?方法をæŒ?®šしまã�?初期値:and)ã€?
496             *
497             * @og.tag
498             * 通常、instrValsにæŒ?®šされた値は、スペã?ス区åˆ?‚Šでåˆ?‰²したå�??をLIKE条件としてand結合しますã?
499             * しかしã?instrType属æ?を変更することで、この条件式ã?生æ?方法を変更
500             * することができますã?
501             * 具体的には、以下ã?通りですã?
502             * â‘?nstrTypeに"and"が指定されてã�?‚‹場å�?初期値)
503             *   タグの記述 : value="CLM" instrVals="ABC DEF GHI"
504             *   生æ?æ–?­—å? :       "( CLM LIKE '%ABC%' AND CLM LIKE '%DEF%' AND CLM LIKE '%GHI%' )"
505             * ②instrTypeに"or"が指定されてã�?‚‹場å�?
506             *   タグの記述 : value="CLM" instrVals="ABC DEF GHI"
507             *   生æ?æ–?­—å? :       "( CLM LIKE '%ABC%' OR CLM LIKE '%DEF%' OR CLM LIKE '%GHI%' )"
508             * ③instrTypeに"in"が指定されてã�?‚‹場å�?
509             *   タグの記述 : value="CLM" instrVals="ABC DEF GHI"
510             *   生æ?æ–?­—å? :       "( CLM LIKE 'ABC' OR CLM LIKE 'DEF5' OR CLM LIKE 'GHI' )"
511             * ④instrTypeに"notin"が指定されてã�?‚‹場å�?
512             *       タグの記述 : value="CLM" instrVals="ABC DEF GHI"
513             *   生æ?æ–?­—å? :       "( CLM NOT LIKE 'ABC' AND CLM NOT LIKE 'DEF5' AND CLM NOT LIKE 'GHI' )"
514             * ※こã?属æ?を指定しなã�??合ã?、①のLIKE条件でのand結合となりますã?
515             * ※③④につã�?�¦、LIKE条件で%をè?動付加しなã�?�“とにより、画面からの入力å?に応じてã€?
516             *   前方ä¸??、後方ä¸??、前後方ä¸??の制御を行うことができますã?
517             *
518             * @og.rev 5.5.1.1 (2012/04/06) notin対å¿?コメント修正)
519             *
520             * @param       tp 条件方法[and/or/in/notin]
521             * @see         #setInstrVals( String )
522             */
523            public void setInstrType( final String tp ) {
524                    instrType = nval( getRequestParameter( tp ),tp );
525            }
526    
527            /**
528             * 【TAG】è¤?•°の引数に対して処ç�?�™るかどã�?�‹[true/false]を設定しまã�?初期値:false)ã€?
529             *
530             * @og.tag
531             * {&#064;XXXX} 変数に、å?がè¤?•°含まれてã�?‚‹場合ã?処ç�?‚’規定しますã?
532             * multi="true" に設定すると、è¤?•°の引数はã€?xx1','xx2','xx3', ?¥?¥?¥ とã�?�†
533             * 形式に変換しますã?
534             * where 条件でè¨?�†とã€?"where PN in ( {&#064;PN} )" とã�?�†æ–?­—å?に対してã€?
535             * "where PN in ( 'xx1','xx2','xx3' )" を作æ?することになりますã?
536             * 初期値はã€?false (マルチ変換しなã�? ですã?
537             *
538             * @param   flag マルチ変換 [true:する/それ以å¤?しなã�?
539             * @see         #setSeparator( String )
540             */
541            public void setMulti( final String flag ) {
542                    multi = nval( flag,multi );
543            }
544    
545            /**
546             * 【TAG】multi アクション時ã?æ–?­—å?をå?割するé ?›®区åˆ?‚Šæ–?­—をセãƒ?ƒˆしますã?
547             *
548             * @og.tag
549             * multi="true" の場合ã?è¤?•°のリクエストを連結してã€?in 句で問合せを行うæ–?­—å?ã‚?
550             * 作æ?しますが、separator を指定すると、さらに、separator でæ–?­—å?をå?割してã€?
551             * in 句の引数を構築しますã?
552             * 具体的には、å?割後ã?æ–?­—å?がã?è¤?•°の個ã?のリクエスト変数と同じ形式にåŠ?·¥されますã?
553             * こã?機è?は、multi="true" を指定したå?合ã?み有効になりますã?
554             * 初期値は、null ですã?つまりã?åˆ?‰²処ç�??行いませんã€?
555             *
556             * @og.rev 5.2.2.0 (2010/11/01) 新規追åŠ?
557             *
558             * @param   sepa é ?›®区åˆ?‚Šæ–?­?
559             * @see         #setMulti( String )
560             */
561            public void setSeparator( final String sepa ) {
562                    separator = nval( getRequestParameter( sepa ),separator );
563            }
564    
565            /**
566             * 【TAG】リクエスト情報の クォーãƒ?‚£ション(') 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?
567             *              (初期値:USE_SQL_INJECTION_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK}])ã€?
568             *
569             * @og.tag
570             * ?³?±?¬インジェクション対策ã?ä¸?�¤として、暫定的ではありますが、SQLのパラメータに
571             * 渡す文字å?にクォーãƒ?‚£ション(') を許さなã�?¨­定にすれば、ある程度は防止できますã?
572             * 数字タイプã?引数にはã€?or 5=5 などのクォーãƒ?‚£ションを使用しなã�?‚³ードを埋めてもã?
573             * 数字チェãƒ?‚¯で検å?可能ですã?æ–?­—タイプã?場合ã?、å¿?�š (')をã?ずしてã€?
574             * ' or 'A' like 'A のような形式になる為ã€?')チェãƒ?‚¯ã�?�‘でも有効ですã?
575             * (') が含まれてã�?�Ÿエラーにする(true)?�かノã?チェãƒ?‚¯ã�?false)を指定しますã?
576             * (初期値:シスãƒ?ƒ 定数のUSE_SQL_INJECTION_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK}])ã€?
577             *
578             * @og.rev 4.0.0.0 (2005/08/31) 新規追åŠ?
579             *
580             * @param   flag クォーãƒ?‚£ションチェãƒ?‚¯ [true:する/それ以å¤?しない]
581             * @see         org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK
582             */
583            public void setQuotCheck( final String flag ) {
584                    quotCheck = nval( getRequestParameter( flag ),quotCheck );
585            }
586    
587            /**
588             * 【TAG】リクエスト情報の HTMLTag開å§?終äº?–‡å­?&gt;&lt;) 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?
589             *              (初期値:USE_XSS_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK}])ã€?
590             *
591             * @og.tag
592             * クロスサイトスクリプティング(XSS)対策ã?ä¸?’°としてless/greater than signにつã�?�¦のチェãƒ?‚¯を行いますã?
593             * (&gt;&lt;) が含まれてã�?�Ÿエラーにする(true)?�かノã?チェãƒ?‚¯ã�?false)を指定しますã?
594             * (初期値:シスãƒ?ƒ 定数のUSE_XSS_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK}])ã€?
595             *
596             * @og.rev 5.0.0.2 (2009/09/15) 新規追åŠ?
597             *
598             * @param       flag    XSSチェãƒ?‚¯ [true:する/false:しない]
599             * @see         org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK
600             */
601            public void setXssCheck( final String flag ) {
602                    xssCheck = nval( getRequestParameter( flag ),xssCheck );
603            }
604    
605            /**
606             * 【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しますã?
607             *
608             * @og.tag
609             * matchKey.matches( matchVal ) の値がã?true の場合ã?、このタグは使用されますã?
610             * false の場合ã?、このタグは使用されませんã€?
611             * value 値に、{&#064;XXXX} 変数が含まれてã�?‚‹場合と同じ効果を得られますã?
612             * 何もæŒ?®šしなã�??合ã?またã?、引数ã�?null の場合ã?、true と同じで使用されますã?
613             *
614             * @og.rev 5.1.9.0 (2010/08/01) 新規追åŠ?
615             * @og.rev 5.2.2.0 (2010/11/01) å»?­¢(caseKey,caseVal属æ?を使用してくださいã€?
616             *
617             * @param       mkey String
618             */
619    //      public void setMatchKey( final String mkey ) {
620    //              matchKey = nval( getRequestParameter( mkey ),matchKey );
621    //      }
622    
623            /**
624             * 【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しますã?
625             *
626             * @og.tag
627             * matchKey.matches( matchVal ) の値がã?true の場合ã?、このタグは使用されますã?
628             * false の場合ã?、このタグは使用されませんã€?
629             * value 値に、{&#064;XXXX} 変数が含まれてã�?‚‹場合と同じ効果を得られますã?
630             * 何もæŒ?®šしなã�??合ã?またã?、引数ã�?null の場合ã?、true と同じで使用されますã?
631             *
632             * @og.rev 5.1.9.0 (2010/08/01) 新規追åŠ?
633             * @og.rev 5.2.2.0 (2010/11/01) å»?­¢(caseKey,caseVal属æ?を使用してくださいã€?
634             *
635             * @param       mval String
636             */
637    //      public void setMatchVal( final String mval ) {
638    //              matchVal = nval( getRequestParameter( mval ),matchVal );
639    //      }
640    
641            /**
642             * タグの名称をã?返しますã?
643             * 自åˆ??身のクラス名よりã?自動的に取り出せなã�?�Ÿめã?こã?メソãƒ?ƒ‰をオーバã?ライドしますã?
644             *
645             * @og.rev 4.0.0.0 (2005/01/31) 新規追åŠ?
646             *
647             * @return  タグの名称
648             */
649            @Override
650            protected String getTagName() {
651                    return "and" ;
652            }
653    
654            /**
655             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
656             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
657             *
658             * @return こã?クラスのæ–?­—å?表現
659             */
660            @Override
661            public String toString() {
662                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
663                                    .println( "VERSION"                     ,VERSION        )
664                                    .println( "startKey"            ,startKey       )
665                                    .println( "value"                       ,value          )
666                                    .println( "instrVals"           ,instrVals      )
667                                    .println( "multi"                       ,multi          )
668                                    .println( "quotCheck"           ,quotCheck      )
669                                    .println( "Other..."    ,getAttributes().getAttribute() )
670                                    .fixForm().toString() ;
671            }
672    }