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    import org.opengion.hayabusa.db.DBTableModel;
021    import org.opengion.hayabusa.db.DBColumn;
022    import org.opengion.hayabusa.db.Query;
023    import org.opengion.hayabusa.db.QueryFactory;
024    import org.opengion.fukurou.util.XHTMLTag;
025    import org.opengion.fukurou.util.Attributes;
026    import org.opengion.fukurou.db.Transaction;
027    import org.opengion.fukurou.db.TransactionReal;
028    
029    import static org.opengion.fukurou.util.StringUtil.nval ;
030    
031    import java.io.ObjectOutputStream;
032    import java.io.ObjectInputStream;
033    import java.io.IOException;
034    
035    /**
036     * プルãƒ?‚¦ンメニューの選択é?目をSELECTæ–??結果から作æ?するタグですã?
037     *
038     * 基本çš?�«はã€?½‘ueryタグと同じ使ã�?–¹をしますã?
039     * こã?オブジェクトにã€?queryId を与えることにより、queryId に対応しã�?Queryオブジェクãƒ?
040     * (のサブクラスのオブジェクãƒ?が作æ?されますã?
041     * ここでæŒ?®šするSELECTæ–??、ã?SELECT KEY、LABEL1、LABEL2ã€?½¥?¥?¥ FROM TABLE ?¥?¥?¥』形å¼?ã‚?
042     * してã�?‚‹å¿?¦�がありますã?特別なケースとして、ã?SELECT KEY FROM TABLE ?¥?¥?¥』形式ã?場合ã?ã€?
043     * LABEL に KEY ã�?使用されますã?
044     * SystemData の USE_SQL_INJECTION_CHECK ã�?true かã?quotCheck 属æ?ã�?true の場合ã?ã€?
045     * ?³?±?¬インジェクション対策用のクォーãƒ?‚£ションチェãƒ?‚¯を行いますã?リクエスト引数に
046     * クォーãƒ?‚£ション(')が含まれると、エラーになりますã?
047     * 同様にUSE_XSS_CHECKがtrueかã?xssCheck属æ?がtrueの場合ã?ã€?
048     * クロスサイトススクリプティング(XSS)対策ã?ためless/greater than signのチェãƒ?‚¯を行いますã?
049     *
050     * ※ こã?タグは、Transaction タグの対象ですã?
051     *
052     * @og.formSample
053     * ●形式ï¼?
054     *     <og:queryOption >
055     *          SELECTæ–?
056     *     </og:queryOption >
057     * ●body?šあã‚?EVAL_BODY_BUFFERED:BODYを評価しã?{@XXXX} を解析しまã�?
058     *
059     * ●Tag定義??
060     *   <og:queryOption
061     *       value              【TAG】Optionの初期値で選ばれる値を指定しまã�?
062     *       separator          【TAG】è¤?•°のラベルを合成するときに使用するé ?›®区åˆ?‚Šæ–?­—をセãƒ?ƒˆしまã�?初期値:スペã?ス)
063     *       defaultVal         【TAG】value値がNULLの場合に使用されるå?期å?を設定しまã�?
064     *       language           【TAG】タグå†?ƒ¨で使用するè¨?ªžコード[ja/en/zh/…]を指定しまã�?
065     *       quotCheck          【TAG】リクエスト情報の クォーãƒ?‚£ション(') 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?(初期値:USE_SQL_INJECTION_CHECK[=true])
066     *       dbid               【TAGã€?通常は使ã�?�¾せん)Queryオブジェクトを作æ?する時ã?DB接続IDを指定しまã�?
067     *       addKey             【TAG】é?目がä¸?�¤ã�?�‘の場合ã??—ベルリソ?°?½に、キーæƒ??を追åŠ?�™るかどã�?�‹を指定しまã�?初期値:false)
068     *       classUseNo         【TAG】オプションに追åŠ?�™ã‚?class 属æ?の カラãƒ?•ª号を指定しまã�?
069     *       groupUseNo         【TAG】オプションのグループ化を行うカラãƒ?•ª号を指定しまã�?
070     *       titleUseNo         【TAG】オプションに追åŠ?�™ã‚?title 属æ?の カラãƒ?•ª号を指定しまã�?
071     *       xssCheck           【TAG】リクエスト情報の HTMLTag開å§?終äº?–‡å­?><) 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?(初期値:USE_XSS_CHECK[=true])
072     *       caseKey            【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しまã�?初期値:null)
073     *       caseVal            【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しまã�?初期値:null)
074     *       caseNN             【TAG】指定ã?値がã?null/ゼロæ–?­—å? でなã�??å�?Not Null=NN)は、このタグは使用されまã�?初期値:true)
075     *       caseNull           【TAG】指定ã?値がã?null/ゼロæ–?­—å? の場合ã?、このタグは使用されまã�?初期値:true)
076     *       debug              【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
077     *   >   ... Body ...
078     *   </og:queryOption>
079     *
080     * ●使用ä¾?
081     *     <og:select name="CDC" >
082     *         <og:queryOption>
083     *                 select NOSYN,NOSYN,NMSYN from DB01 ORDER BY 1
084     *         </og:queryOption>
085     *     </og:select>
086     *
087     *     <og:select name="CDC" >                選択é?目のä¸?•ª上に空白をセãƒ?ƒˆしたã�?�¨きoptionタグをçµ?�ˆせることも可能ですã?
088     *         <og:option msg="" />               初期値を設定したいときã?value属æ?を使ã�?�¾すã?
089     *         <og:queryOption value="61200" separator=":" >
090     *                 select CDBK,CDBK,NMBK from DB02 ORDER BY 1
091     *         </og:queryOption>
092     *     </og:select>
093     *
094     * @og.group 選択データ制御
095     *
096     * @version  4.0
097     * @author   Kazuhiko Hasegawa
098     * @since    JDK5.0,
099     */
100    public class QueryOptionTag extends CommonTagSupport {
101            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
102            private static final String VERSION = "5.3.8.0 (2011/08/01)" ;
103    
104            private static final long serialVersionUID = 538020110801L ;
105    
106            private transient DBTableModel  table           = null;
107            private String  selValue        = null;
108            private String  defaultVal      = null;
109            // 4.0.0.0 (2007/10/10) dbid の初期値をã?"DEFAULT" から null に変更
110    //      private String  dbid            = "DEFAULT";
111            private String  dbid            = null;
112            private String  sql                     = null;
113            private String  separator       = " ";          // é ?›®区åˆ?‚Šæ–?­?
114            private boolean quotCheck       = HybsSystem.sysBool( "USE_SQL_INJECTION_CHECK" );      // 4.0.0 (2005/08/31)
115            private int             classUseNo      = -1;   // 3.8.5.2 (2006/06/09) オプションに追åŠ?�™るクラス属æ?
116            private int             groupUseNo      = -1;   // 3.8.5.2 (2006/06/09) キーブレイク時に追åŠ?�™るグループ文å­?
117            private boolean addKey          = false;                // 4.0.0 (2006/11/15) é ?›®ä¸?�¤のときに?—ベルリソ?°?½表示時にキーも付加するã€?
118            private int             titleUseNo              = -1;   // 4.3.8.0 (2009/08/01) オプションのtitle属æ?
119            private boolean xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" );        // 5.0.0.2 (2009/09/15)
120            private String  rawSql          = null; // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
121    
122            /**
123             * Taglibの開始タグが見つかったときに処ç�?�™ã‚?doStartTag() ã‚?オーバã?ライドしますã?
124             *
125             * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
126             *
127             * @return      後続å?ç�??æŒ?¤º( EVAL_BODY_BUFFERED )
128             */
129            @Override
130            public int doStartTag() {
131                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
132                    if( useTag() ) {
133                            return( EVAL_BODY_BUFFERED );   // Body を評価するã€? extends BodyTagSupport æ™?
134                    }
135                    return ( SKIP_BODY );                           // Body を評価しなã�?
136            }
137    
138            /**
139             * Taglibのタグ本体を処ç�?�™ã‚?doAfterBody() ã‚?オーバã?ライドしますã?
140             *
141             * @og.rev 3.1.1.0 (2003/03/28) ボディのå†?®¹を取得するå?ç�?‚’、CommonTagSupport で行うã€?
142             * @og.rev 3.6.0.8 (2004/11/19) エラー発生時に確実にリリースされるよã�?�« try finally 追åŠ?
143             * @og.rev 3.7.1.0 (2005/04/26) DBTableModel がすでにセãƒ?ƒˆされてã�?‚‹場合ã?、SQL処ç�?¸�要ã?
144             * @og.rev 4.0.0.0 (2005/01/31) lang â‡?ResourceManager へ変更
145             * @og.rev 4.0.0.0 (2005/08/31) useQuotCheck() による?³?±?¬インジェクション対ç­?
146             * @og.rev 3.8.6.3 (2006/11/30) SQL æ–??前後ã?スペã?スを取り除きますã?
147             * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得ã?為,ApplicationInfoオブジェクトを設å®?
148             * @og.rev 4.3.6.0 (2009/04/01) EventColumn対å¿?
149             * @og.rev 5.0.0.5 (2009/08/28) XSS対ç­?
150             * @og.rev 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
151             * @og.rev 5.1.9.0 (2010/08/01) TransactionTag 対応ã?上位に TransactionTag があれã?、そこからConnection をもらうã€?
152             * @og.rev 5.3.7.0 (2011/07/01) TransactionReal の引数変更
153             * @og.rev 5.3.8.0 (2011/08/01) Transaction発生ç®?‰€でclose()
154             *
155             * @return      後続å?ç�??æŒ?¤º(SKIP_BODY)
156             */
157            @Override
158            public int doAfterBody() {
159                    // 3.7.1.0 (2005/04/26) DBTableModel がすでにセãƒ?ƒˆされてã�?‚‹場合ã?、SQL処ç�?¸�要ã?
160                    if( table != null ) { return(SKIP_BODY); }
161    
162                    // 4.0.0 (2005/08/31) useQuotCheck() による?³?±?¬インジェクション対ç­?
163                    useQuotCheck( quotCheck );
164                    // 5.0.0.2 (2009/09/15) XSS対ç­?
165                    useXssCheck( xssCheck );
166    
167                    sql = getBodyString().trim();
168    //              String rawsql = getBodyRawString().trim(); // 4.3.6.0 生ã?SQLを保持
169                    rawSql = getBodyRawString().trim();
170    
171                    // 4.3.6.0 (2009/04/01) セãƒ?‚·ョンへのSQLæ–?™»録
172                    // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
173    //              String[] selectVals = getEventColumn(); // 親タグからイベントカラãƒ?¨­定を取る
174    //              if( selectVals[0] != null && selectVals[0].length() > 0 ){
175    //                      addEventColumnSQL( selectVals[1], rawsql );
176    //              }
177    
178                    Query query = QueryFactory.newInstance();               // 4.0.0 (2005/01/31)
179                    Transaction tran = null;
180                    try {
181                            // 5.1.9.0 (2010/08/01) TransactionTag 対å¿?
182    //                      final Transaction tran ;
183                            TransactionTag tranTag = (TransactionTag)findAncestorWithClass( this,TransactionTag.class );
184                            if( tranTag == null ) {
185    //                              tran = new TransactionReal( dbid,getApplicationInfo() );
186                                    tran = new TransactionReal( getApplicationInfo() );             // 5.3.7.0 (2011/07/01) 引数変更
187                            }
188                            else {
189                                    tran = tranTag.getTransaction();
190                            }
191                            query.setTransaction( dbid,tran );      // 5.1.9.0 (2010/08/01) TransactionTag 対å¿?
192    
193    //                      query.setConnectionID( dbid );
194                            query.setResourceManager( getResource() );      // 4.0.0 (2005/01/31)
195    
196                            query.setStatement( sql );
197    //                      query.setApplicationInfo( getApplicationInfo() );       // 3.8.7.0 (2006/12/15)
198                            query.execute();
199    
200                            table = query.getDBTableModel();
201    
202                            // 4.0.0 (2005/11/30) 検索結果の件数をã?"DB.COUNT" キーでリクエストにセãƒ?ƒˆするã€?
203                    }
204                    finally {
205    //                      if( query != null ) { query.close(); }
206                            QueryFactory.close( query );
207                            if( tran != null ) { tran.close(); }            // 5.3.8.0 (2011/08/01) Transaction発生ç®?‰€でclose()
208                    }
209                    return(SKIP_BODY);
210            }
211    
212            /**
213             * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
214             *
215             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
216             * @og.rev 3.3.2.0 (2003/07/07) defaultVal 属æ?の追åŠ??
217             * @og.rev 3.5.4.0 (2003/11/25) selVal 属æ?を追åŠ??
218             * @og.rev 5.0.2.0 (2009/11/01) è¤?•°パラメーターの選択に対å¿?
219             * @og.rev 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
220             * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
221             *
222             * @return      後続å?ç�??æŒ?¤º
223             */
224            @Override
225            public int doEndTag() {
226                    debugPrint();           // 4.0.0 (2005/02/28)
227                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
228                    if( useTag() ) {
229                            SelectTag select = (SelectTag)findAncestorWithClass( this,SelectTag.class );
230                            if( select == null ) {
231                                    String errMsg = "こã?タグは、SelectTag のBODY に記述するå¿?¦�がありますã?";
232                                    throw new HybsSystemException( errMsg );
233                            }
234                            String selVal = nval( select.getValue(),defaultVal );   // 3.5.4.0 (2003/11/25)
235            //              selValue = nval( selValue,selVal );                                             // 3.5.4.0 (2003/11/25)
236                            selValue = "|" + nval( selValue,selVal ) + "|";                 // 5.0.2.0 (2009/11/01)
237                            makeLabel( select );
238    
239                            // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
240                            select.setRawParam( rawSql );
241                    }
242                    return(EVAL_PAGE);
243            }
244    
245            /**
246             * タグリブオブジェクトをリリースしますã?
247             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
248             *
249             * @og.rev 2.0.0.4 (2002/09/27) カスタãƒ?‚¿グの release() メソãƒ?ƒ‰をã?追åŠ?
250             * @og.rev 3.0.1.0 (2003/03/03) セパレーターを指定できる様に変更ã€?
251             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
252             * @og.rev 3.3.2.0 (2003/07/07) defaultVal 属æ?の追åŠ??
253             * @og.rev 3.8.5.2 (2006/06/09) classUseNo , groupUseNo 属æ?の追åŠ??
254             * @og.rev 4.0.0.0 (2005/08/31) quotCheck , addKey 属æ?の追åŠ?
255             * @og.rev 4.0.0.0 (2007/10/10) dbid の初期値をã?"DEFAULT" から null に変更
256             * @og.rev 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
257             *
258             */
259            @Override
260            protected void release2() {
261                    super.release2();
262                    table           = null;
263                    selValue        = null;
264                    defaultVal      = null;
265    //              dbid            = "DEFAULT";
266                    dbid            = null;
267                    sql                     = null;
268                    separator       = " ";
269                    classUseNo      = -1;   // 3.8.5.2 (2006/06/09) オプションに追åŠ?�™るクラス属æ?
270                    groupUseNo      = -1;   // 3.8.5.2 (2006/06/09) キーブレイク時に追åŠ?�™るグループ文å­?
271                    quotCheck       = HybsSystem.sysBool( "USE_SQL_INJECTION_CHECK" );      // 4.0.0 (2005/08/31)
272                    addKey          = false;                // 4.0.0 (2006/11/15) é ?›®ä¸?�¤のときに?—ベルリソ?°?½表示時にキーも付加するã€?
273                    titleUseNo              = -1;
274                    xssCheck        = HybsSystem.sysBool( "USE_XSS_CHECK" );        // 5.0.0.2 (2009/09/15)
275                    rawSql          = null; // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
276            }
277    
278            /**
279             * DBTableModelをセãƒ?ƒˆしますã?
280             *
281             * サブクラスより、DBTableModelをセãƒ?ƒˆするのに使ã�?�¾すã?
282             *
283             * @og.rev 3.7.1.0 (2005/04/26) 新規追åŠ?
284             *
285             * @param       table   DBTableModelオブジェクãƒ?
286             */
287            protected void setTableModel( final DBTableModel table ) {
288                    this.table = table ;
289            }
290    
291            /**
292             * オプションを作æ?しますã?
293             *
294             * DBTableModel の?‘番目の値ã‚?"value" に、それ以降をæ–?­—å?をé?結させて
295             * BODY属æ? に登録するOptionを作æ?しますã?
296             *
297             * @og.rev 3.0.1.0 (2003/03/03) 『SELECT KEY FROM TABLE ?¥?¥?¥』形式ã?場合ã?、LABEL に KEY を使用ã€?
298             * @og.rev 3.8.0.9 (2005/10/17) è¤?•°選択可能時に全選択を設定するã?
299             * @og.rev 3.8.5.2 (2006/06/09) classUseNo 属æ?と groupUseNo 属æ?を追åŠ?
300             * @og.rev 3.8.9.2 (2007/07/28) グループと、クラスの設定方法ã?バグ修正
301             * @og.rev 4.3.8.0 (2009/08/01) titleUseNo属æ?追åŠ?
302             * @og.rev 5.0.2.0 (2009/11/01) è¤?•°パラメーターの選択に対å¿?
303             *
304             * @param   select SelectTagオブジェクãƒ?
305             */
306            private void makeLabel( final SelectTag select ) {
307                    boolean multipleAll = select.isMultipleAll();   // 3.8.0.9 (2005/10/17)
308                    int rowCnt = table.getRowCount();               // 3.5.5.7 (2004/05/10)
309    
310                    String bkGroupKey = "";
311                    String grpLabel ;
312                    for( int row=0; row<rowCnt; row++ ) {
313                            // 3.8.5.2 (2006/06/09) groupUseNo 属æ?
314                            if( groupUseNo >= 0 ) {
315                                    String groupKey = table.getValue( row,groupUseNo );
316                                    grpLabel = getRendererValue( row,groupUseNo );
317                                    if( !bkGroupKey.equals( groupKey ) ) {          // キーブレイク
318                                            // 3.8.9.2 (2007/07/28) グループと、クラスの設定方法ã?バグ修正
319    //                                      bkGroupKey = groupKey;
320    //                                      if( row != 0 ) { select.addOption( "</optgroup>" ); }
321    //                                      select.addOption( "<optgroup label=\"" + grpLabel + "\">" );
322    
323                                            if( ! "".equals( bkGroupKey ) ) {
324                                                    select.addOption( "</optgroup>" );
325                                            }
326                                            if( ! "".equals( groupKey ) ) {
327                                                    select.addOption( "<optgroup label=\"" + grpLabel + "\">" );
328                                            }
329                                            bkGroupKey = groupKey;
330                                    }
331                            }
332    
333                            Attributes attri = new Attributes();
334                            String value = table.getValue( row,0 );
335                            attri.set( "value", value );
336    
337                            // 5.0.2.0 (2009/11/01)
338    //                      if( ( selValue != null && selValue.equals( value ) ) || multipleAll ) {
339                            if( ( selValue != null && selValue.length() > 0 && selValue.indexOf( "|" + value + "|" ) >= 0 ) || multipleAll ) {
340                                    attri.set( "selected", "selected" );
341                            }
342    
343                            // 3.8.5.2 (2006/06/09) classUseNo 属æ?
344                            if( classUseNo >= 0 ) {
345                                    attri.add( "class", table.getValue( row,classUseNo ) );
346                            }
347    
348                            StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
349                            boolean titleFlg = false; // 4.3.8.0 (2009/08/01) title属æ?を付けるかどã�?�‹
350                            if( table.getColumnCount() == 1 ) {
351                                    // é ?›®がä¸?�¤の queryOption では、ラベルリソースが使用されますã?
352                                    if( addKey ) { buf.append( value ).append( ":" ); }
353                                    buf.append( getResource().getLabel( value ) );
354    
355                                    // 4.3.8.0 (2009/08/01) titleUseNo 属æ? セãƒ?ƒˆされてã�?‚‹場合かつラベルと異なるå?合ã?title属æ?に追åŠ?
356                                    if( titleUseNo >= 0 && !getResource().getLabel( value ).equals( table.getValue( row,titleUseNo ) )) {
357                                            titleFlg = true;
358                                    }
359                            }
360                            else {
361            //                      if( groupUseNo >= 0 ) {
362            //                              buf.append( grpLabel );
363            //                              buf.append( separator );
364            //                      }
365                                    String label = getRendererValue( row,1 );
366                                    buf.append( label );
367            //                      attri.set( "label", label );
368                                    for( int clm=2; clm<table.getColumnCount(); clm++ ) {
369                                            // 4.3.8.0 (2009/08/01) titleUseNo追åŠ?
370                                            // if( clm == groupUseNo || clm == classUseNo ) { continue; }
371                                            if( clm == groupUseNo || clm == classUseNo || clm==titleUseNo) { continue; }
372                                            buf.append( separator );
373                                            buf.append( getRendererValue( row,clm ) );
374                                    }
375    
376                                    // 4.3.8.0 (2009/08/01) titleUseNo 属æ? セãƒ?ƒˆされてã�?‚‹場合かつラベルと異なるå?合ã?title属æ?に追åŠ?
377                                    if( titleUseNo >= 0 && !label.equals( table.getValue( row,titleUseNo ) )) {
378                                            titleFlg = true;
379                                    }
380                            }
381    
382                            // 4.3.7.2 (2009/06/22) タイトル属æ?セãƒ?ƒˆ
383                            if( titleFlg ){
384                                    attri.add( "title", table.getValue( row,titleUseNo ) );
385                            }
386    
387                            attri.set( "body", buf.toString() );
388                            select.addOption( XHTMLTag.option( attri ) );
389                    }
390    //              if( groupUseNo >= 0 && "".equals( bkGroupKey ) ) {
391                    if( groupUseNo >= 0 && ! "".equals( bkGroupKey ) ) { // 3.8.9.2 (2007/07/28)
392                            select.addOption( "</optgroup>" );
393                    }
394            }
395    
396            /**
397             * 【TAG】Optionの初期値で選ばれる値を指定しますã?
398             *
399             * @og.tag Optionの初期値で選ばれる値を指定しますã?
400             *
401             * @param   val Optionの初期値で選ばれる値
402             */
403            public void setValue( final String val ) {
404                    selValue = getRequestParameter( val );
405            }
406    
407            /**
408             * 【TAG】value値がNULLの場合に使用されるå?期å?を設定しますã?
409             *
410             * @og.tag
411             * value値がNULLの場合に、この初期値をセãƒ?ƒˆしますã?
412             *
413             * @og.rev 3.3.2.0 (2003/07/07) defaultVal 属æ?の追åŠ??(新規作æ?)
414             *
415             * @param       val 初期値
416             */
417            public void setDefaultVal( final String val ) {
418                    defaultVal = getRequestParameter( val );
419            }
420    
421            /**
422             * 【TAG】è¤?•°のラベルを合成するときに使用するé ?›®区åˆ?‚Šæ–?­—をセãƒ?ƒˆしまã�?初期値:スペã?ス)ã€?
423             *
424             * @og.tag
425             * 初期値は、スペã?スですã?
426             *
427             * @og.rev 3.0.1.0 (2003/03/03) セパレーターを指定できる様に変更ã€?
428             *
429             * @param   sep é ?›®区åˆ?‚Šæ–?­?
430             */
431            public void setSeparator( final String sep ) {
432                    separator = nval( getRequestParameter( sep ),separator );
433            }
434    
435            /**
436             * 【TAG】オプションに追åŠ?�™ã‚?class 属æ?の カラãƒ?•ª号を指定しますã?
437             *
438             * @og.tag
439             * オプションは、データベã?スを検索して作æ?されますが、そのSQLæ–??カラãƒ?ƒ…報ã‚?
440             * 使用して オプションに class 属æ?を追åŠ?�—ますã?
441             * å�?‚ªプションに色をつける場合ã?、この class 属æ?に対応すã‚?CSS ファイルを用意しますã?
442             * ここでは、class 属æ?に使用する SQLæ–?? カラãƒ?•ª号( 先é?ã�?0 ) を指定しますã?
443             * 通常、カラãƒ?•ª号=0 は キーæƒ??ã€?1 はラベルæƒ?? ですã?2 ã�?3 を指定しますã?
444             * 初期値は、使用しなã�?-1)ですã?
445             *
446             * @og.rev 3.8.5.2 (2006/06/09) 新規追åŠ?
447             *
448             * @param   no オプションに追åŠ?�™るクラス属æ?
449             */
450            public void setClassUseNo( final String no ) {
451                    classUseNo = nval( getRequestParameter( no ),classUseNo );
452                    if( classUseNo == 0 || classUseNo == 1 ) {
453                            String errMsg = "通常、カラãƒ?•ª号=0 は キーæƒ??ã€?1 はラベルæƒ?? ですã?2 ã�?3 を指定して下さã�??";
454                            throw new HybsSystemException( errMsg );
455                    }
456            }
457    
458            /**
459             * 【TAG】オプションのグループ化を行うカラãƒ?•ª号を指定しますã?
460             *
461             * @og.tag
462             * オプションは、データベã?スを検索して作æ?されますが、そのSQLæ–??カラãƒ?ƒ…報ã‚?
463             * 使用して オプションをグループ化しますã?グループ化は optgroup要ç´?‚’ブレイク時に
464             * 出力する事で対応しますã?
465             * ここでは、グループ化に使用する SQLæ–?? カラãƒ?•ª号( 先é?ã�?0 ) を指定しますã?
466             * 通常、カラãƒ?•ª号=0 は キーæƒ??ã€?1 はラベルæƒ?? ですã?2 ã�?3 を指定しますã?
467             * 初期値は、使用しなã�?-1)ですã?
468             *
469             * @og.rev 3.8.5.2 (2006/06/09) 新規追åŠ?
470             *
471             * @param   no キーブレイク時に追åŠ?�™るグループ文å­?
472             */
473            public void setGroupUseNo( final String no ) {
474                    groupUseNo = nval( getRequestParameter( no ),groupUseNo );
475                    if( groupUseNo == 0 || groupUseNo == 1 ) {
476                            String errMsg = "通常、カラãƒ?•ª号=0 は キーæƒ??ã€?1 はラベルæƒ?? ですã?2 ã�?3 を指定して下さã�??";
477                            throw new HybsSystemException( errMsg );
478                    }
479            }
480    
481            /**
482             * 【TAG】リクエスト情報の クォーãƒ?‚£ション(') 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?
483             *              (初期値:USE_SQL_INJECTION_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK}])ã€?
484             *
485             * @og.tag
486             * ?³?±?¬インジェクション対策ã?ä¸?�¤として、暫定的ではありますが、SQLのパラメータに
487             * 渡す文字å?にクォーãƒ?‚£ション(') を許さなã�?¨­定にすれば、ある程度は防止できますã?
488             * 数字タイプã?引数にはã€?or 5=5 などのクォーãƒ?‚£ションを使用しなã�?‚³ードを埋めてもã?
489             * 数字チェãƒ?‚¯で検å?可能ですã?æ–?­—タイプã?場合ã?、å¿?�š (')をã?ずしてã€?
490             * ' or 'A' like 'A のような形式になる為ã€?')チェãƒ?‚¯ã�?�‘でも有効ですã?
491             * (') が含まれてã�?�Ÿエラーにする(true)?�かノã?チェãƒ?‚¯ã�?false)を指定しますã?
492             * (初期値:シスãƒ?ƒ 定数のUSE_SQL_INJECTION_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK}])ã€?
493             *
494             * @og.rev 4.0.0.0 (2005/08/31) 新規追åŠ?
495             *
496             * @param   flag クォーãƒ?‚£ションチェãƒ?‚¯ [true:する/それ以å¤?しない]
497             * @see         org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK
498             */
499            public void setQuotCheck( final String flag ) {
500                    quotCheck = nval( getRequestParameter( flag ),quotCheck );
501            }
502    
503            /**
504             * 【TAGã€?通常は使ã�?�¾せん)Queryオブジェクトを作æ?する時ã?DB接続IDを指定しますã?
505             *
506             * @og.tag
507             * Queryオブジェクトを作æ?する時ã?DB接続IDを指定しますã?
508             * これは、シスãƒ?ƒ リソースで、DEFAULT_DB_URL 等でæŒ?®šしてã�?‚‹ ãƒ??タベã?ス接続å?
509             * æƒ??に、XX_DB_URL を定義することでã€?dbid="XX" とすると、この 接続å?を使用して
510             * ãƒ??タベã?スにアクセスできますã?
511             *
512             * @param       id ãƒ??タベã?ス接続ID
513             */
514            public void setDbid( final String id ) {
515                    dbid = nval( getRequestParameter( id ),dbid );
516            }
517    
518            /**
519             * 【TAG】é?目がä¸?�¤ã�?�‘の場合ã??—ベルリソ?°?½に、キーæƒ??を追åŠ?�™るかどã�?�‹を指定しまã�?初期値:false)ã€?
520             *
521             * @og.tag
522             * Queryオブジェクトã?é ?›®がä¸?�¤の場合ã??—ベル部にはã€?¾—ベルリソ?°?½を使用しますã?
523             * こã?時ã??—ベル無しã?場合ã?、キーが表示されますがã€?¾—ベルありã?場合ã?、キーは表示されã�?
524             * ?—ベルã?み表示されますã?
525             * 都合によっては、キーも表示したã�??合がありますã?で、その様なケースではã€?
526             * addKey = "true を設定する事で、キー:?—ベï¾?のセãƒ?ƒˆをラベルとして扱ã�?�¾すã?
527             * 初期値はfalse(キーは付加しなã�?ですã?
528             *
529             * @param       id ãƒ??タベã?ス接続ID
530             */
531            public void setAddKey( final String id ) {
532                    addKey = nval( getRequestParameter( id ),addKey );
533            }
534    
535            /**
536             * 【TAG】リクエスト情報の HTMLTag開å§?終äº?–‡å­?&gt;&lt;) 存在チェãƒ?‚¯を実施するかどã�?�‹[true/false]を設定しまã�?
537             *              (初期値:USE_XSS_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK}])ã€?
538             *
539             * @og.tag
540             * クロスサイトスクリプティング(XSS)対策ã?ä¸?’°としてless/greater than signにつã�?�¦のチェãƒ?‚¯を行いますã?
541             * (&gt;&lt;) が含まれてã�?�Ÿエラーにする(true)?�かノã?チェãƒ?‚¯ã�?false)を指定しますã?
542             * (初期値:シスãƒ?ƒ 定数のUSE_XSS_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK}])ã€?
543             *
544             * @og.rev 5.0.0.2 (2009/09/15) 新規追åŠ?
545             *
546             * @param       flag    XSSチェãƒ?‚¯ [true:する/false:しない]
547             * @see         org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK
548             */
549            public void setXssCheck( final String flag ) {
550                    xssCheck = nval( getRequestParameter( flag ),xssCheck );
551            }
552    
553            /**
554             * row行,columåˆ?のãƒ??タの値を返しますã?
555             *
556             * これは、データの値そã?もã?ではなくã?そã?値のラベルæ–?­—を返しますã?
557             *
558             * @param   row         行番号
559             * @param   column      カラãƒ?•ª号
560             *
561             * @return  row行,columåˆ?のãƒ??タの値
562             */
563            private String getRendererValue( final int row,final int column ) {
564                    String val = table.getValue( row,column );
565                    DBColumn clm = table.getDBColumn( column );
566                    return clm.getRendererValue( val );
567            }
568    
569            /**
570             * 【TAG】オプションに追åŠ?�™ã‚?title 属æ?の カラãƒ?•ª号を指定しますã?
571             *
572             * @og.tag
573             * オプションは、データベã?スを検索して作æ?されますが、そのSQLæ–??カラãƒ?ƒ…報ã‚?
574             * 使用して オプションに title 属æ?を追åŠ?�—ますã?
575             * title属æ?はマウスオーバã?時にãƒ??ルチップとして表示されるためã?
576             * プルãƒ?‚¦ンの横å¹?‚’短くしたい場合に有効ですã?
577             * 通常、カラãƒ?•ª号=0 は キーæƒ??ã€?1 はラベルæƒ?? ですã?2 ã�?3 を指定しますã?
578             * 初期値は、使用しなã�?-1)ですã?
579             *
580             * @og.rev 4.3.8.0 (2009/08/01) 新規追åŠ?
581             *
582             * @param   no オプションに追åŠ?�™るtitle属æ?
583             */
584            public void setTitleUseNo( final String no ) {
585                    titleUseNo = nval( getRequestParameter( no ),titleUseNo );
586                    if( titleUseNo == 0 || titleUseNo == 1 ) {
587                            String errMsg = "通常、カラãƒ?•ª号=0 は キーæƒ??ã€?1 はラベルæƒ?? ですã?2 ã�?3 を指定して下さã�??";
588                            throw new HybsSystemException( errMsg );
589                    }
590            }
591    
592            /**
593             * シリアライズ用のカスタãƒ?‚·リアライズ書き込みメソãƒ?ƒ‰
594             *
595             * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
596             * @serialData
597             *
598             * @param       strm    ObjectOutputStreamオブジェクãƒ?
599             */
600            private void writeObject( final ObjectOutputStream strm ) throws IOException {
601                    strm.defaultWriteObject();
602            }
603    
604            /**
605             * シリアライズ用のカスタãƒ?‚·リアライズ読み込みメソãƒ?ƒ‰
606             *
607             * ここでは、transient 宣è¨?�•れたå†?ƒ¨変数のå†??初期化がå¿?¦�なフィールドã?み設定しますã?
608             *
609             * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
610             * @serialData
611             *
612             * @param       strm    ObjectInputStreamオブジェクãƒ?
613             * @see #release2()
614             */
615            private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
616                    strm.defaultReadObject();
617            }
618    
619    //      /**
620    //       * 親のog:selectタグのnameとeventColumn設定を返しますã?
621    //       *
622    //       * @og.rev 4.3.6.0 (2009/04/01)
623    //       *
624    //       */
625    //      private String[] getEventColumn(){
626    //              SelectTag seltag = (SelectTag)findAncestorWithClass(this,SelectTag.class);
627    //              String[] selectVal = new String[2];
628    //              selectVal[0] = seltag.getEventColumn();
629    //              selectVal[1] = seltag.get("name");
630    //              return selectVal;
631    //      }
632    
633            /**
634             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
635             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
636             *
637             * @return こã?クラスのæ–?­—å?表現
638             */
639            @Override
640            public String toString() {
641                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
642                                    .println( "VERSION"             ,VERSION        )
643                                    .println( "selValue"    ,selValue       )
644                                    .println( "defaultVal"  ,defaultVal     )
645                                    .println( "dbid"                ,dbid           )
646                                    .println( "sql"                 ,sql            )
647                                    .println( "separator"   ,separator      )
648                                    .println( "quotCheck"   ,quotCheck      )
649                                    .println( "Other..."    ,getAttributes().getAttribute() )
650                                    .fixForm().toString() ;
651            }
652    }