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.resource.GUIInfo;
021    import org.opengion.hayabusa.resource.LabelInterface;
022    import org.opengion.fukurou.util.XHTMLTag;
023    
024    import org.opengion.fukurou.util.StringUtil ;
025    import static org.opengion.fukurou.util.StringUtil.nval ;
026    
027    import java.util.Locale ;
028    
029    /**
030     * サブミãƒ?ƒˆボタンを表示するHTML拡張タグでã�?forward.jsp の commonForward タグと同時に使用しまã�?ã€?
031     *
032     * こã?タグは、value にæŒ?®šされた値??.jsp" の画面へサブミãƒ?ƒˆしますã?
033     * そã?際ã?command に設定された値ã‚?送信しますã?
034     * 従来は、value に、copy/modify/delete など、å?ç�?�™るJSPをå?別に設定してã�?�¾したのでã€?
035     * command と lbl が未設定時には、value の値を使用してã�?�¾したã€?下位互換性のため残してã�?�¾ã�?
036     * Ver5 になって、update.jsp ですべての処ç�?‚’行う方向で開発するに当たりã?
037     * command と lbl を記述するå¿?¦�がでてきましたã€?
038     * そこで、現在æœ?–°版では、action 属æ?を用意し、command を記述するã�?�‘で良くなりましたã€?
039     *
040     *    [action属æ?]  [初期設定されるパラメータ郡]
041     *      INSERT       value="update" command="INSERT" lbl="INSERT"  accesskey="I"
042     *      COPY         value="update" command="COPY"   lbl="COPY"    accesskey="C"
043     *      MODIFY       value="update" command="MODIFY" lbl="MODIFY"  accesskey="M"
044     *      DELETE       value="update" command="DELETE" lbl="DELETE"  accesskey="Z"
045     *      ENTRY        value="entry"  command="ENTRY"  lbl="ENTRY"   accesskey="E"
046     *      RESET        value="reset"  command="RESET"  lbl="ENTRY"   accesskey="R"
047     *
048     * columnWritable , noWritable の属æ?追åŠ?5.2.2.0 (2010/11/01))
049     * これは、各コマンドごとに、次ペã?ジの view のカラãƒ?±žæ?の設定に利用する属æ?ですã?
050     * Ver4 では、keys,vals のä¸?ˆ¬引数として設定してã�?�¾したがã?ここでは、専用属æ?として
051     * 用意してã�?�¾すã?
052     *
053     * @og.formSample
054     * ●形式ï¼?lt;og:submit value="…" lbl="…" />
055     * ●body?šなã�?
056     *
057     * ●Tag定義??
058     *   <og:submit
059     *       action             【TAG】アクション(INSERT,COPY,MODIFY,DELETE,ENTRY,RESET)を指定しまã�?
060     *       value              【TAG】forward したã�?¼ª?³?°ファイル名を記述しまã�?ä¾?insert,copy,modify,delete など)
061     *       command            【TAG】å?ç�?‚³マンドを登録しまã�?初期値:大æ–?­—ã? value 属æ?値[INSERT,COPY,MODIFY,DELETE など])
062     *       gamenId            【TAG】gamenId 属æ?を登録しまã�?
063     *       lbl                【TAG】ラベルリソースのラベルIDを指定しまã�?
064     *       target             【TAG】サブミãƒ?ƒˆ先ã?æ–?›¸を表示させるフレーãƒ??またã?ウィンドウの名前を指定しまã�?
065     *       keys               【TAG】ã?タン専用のリクエストキーをCSV形式でè¤?•°æŒ?®šしまã�?
066     *       vals               【TAG】ã?タン専用のリクエストå?をCSV形式でè¤?•°æŒ?®šしまã�?
067     *       roles              【TAG】ロールをセãƒ?ƒˆしまã�?
068     *       dbkeys             【TAG】commonForward の dbkeys にカラãƒ?Œ‡定を行いまã�?
069     *       optionAttributes   【TAG】JavaScript などの HTML基本タグ以外ã?属æ?をã?そã?ままタグとして使用しまã�?
070     *       columnWritable     【TAG】書き込み可能カラãƒ?��をã?カンマ区åˆ?‚Šで与えまã�?
071     *       noWritable         【TAG】書き込み不可カラãƒ?��をã?カンマ区åˆ?‚Šで与えまã�?
072     *       caseKey            【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しまã�?初期値:null)
073     *       caseVal            【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しまã�?初期値:null)
074     *       caseNN             【TAG】指定ã?値がã?null/ゼロæ–?­—å? でなã�??å�?Not Null=NN)は、このタグは使用されまã�?初期値:true)
075     *       caseNull           【TAG】指定ã?値がã?null/ゼロæ–?­—å? の場合ã?、このタグは使用されまã�?初期値:true)
076     *       id                 【HTML】要ç´?�«対して固有ã?名前(id)をつける場合に設定しまã�?
077     *       lang               【HTML】要ç´??å†?®¹と他ã?属æ?値のè¨?ª?lang,xml:lang)を指定しまã�?
078     *       dir                【HTML】文字表記ã?方å�?dir)を指定しまã�?
079     *       title              【HTML】要ç´?�«対する補足çš?ƒ…報(title)を設定しまã�?
080     *       style              【HTML】この要ç´?�«対して適用させるスタイルシーãƒ?style)を設定しまã�?
081     *       readonly           【TAG】その部品に対して変更がå?来なã�?‚ˆã�?�«(readonly)æŒ?®šしまã�?サーバã?に送信されã‚?
082     *       disabled           【TAG】その部品に対してã€?�¸択や変更がå?来なã�?‚ˆã�?�«(disabled)æŒ?®šしまã�?サーバã?に送信されなã�?
083     *       tabindex           【HTML】タブã?移動é?(tabindex)を指定しまã�?0 ??32767)
084     *       accesskey          【HTML】アクセスキー(alt+キーで直接æŒ?®?を割り当てまã�?
085     *       clazz              【HTML】要ç´?�«対して class 属æ?を設定しまã�?
086     *       language           【TAG】タグå†?ƒ¨で使用するè¨?ªžコード[ja/en/zh/…]を指定しまã�?
087     *       onClick            【HTML】JavaScriptのイベンãƒ?onClick を設定しまã�?ä¾?onClick="renew('query.jsp','QUERY');")
088     *       onBlur             【HTML】JavaScriptのイベンãƒ?onBlur を設定しまã�?ä¾?onBlur="this.value=value.toUpperCase();")
089     *       onFocus            【HTML】JavaScriptのイベンãƒ?onFocus を設定しまã�?
090     *       ondblClick         【HTML】JavaScriptのイベンãƒ?ondblClick を設定しまã�?
091     *       onMouseDown        【HTML】JavaScriptのイベンãƒ?onMouseDown を設定しまã�?
092     *       onMouseUp          【HTML】JavaScriptのイベンãƒ?onMouseUp を設定しまã�?
093     *       onMouseMove        【HTML】JavaScriptのイベンãƒ?onMouseMove を設定しまã�?
094     *       onMouseOut         【HTML】JavaScriptのイベンãƒ?onMouseOut を設定しまã�?
095     *       onMouseOver        【HTML】JavaScriptのイベンãƒ?onMouseOver を設定しまã�?
096     *       img                【TAG】画像ã?タンを作る場合ã?、画像ファイルを指定しまã�?
097     *       debug              【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
098     *   />
099     *
100     * ●使用ä¾?
101     *     Ver5 推奨ケース?š指定ã? action 属æ?に設定された値に応じたã?value , command , lbl , accesskey をå?期化しますã?
102     *                      (5.2.2.0 (2010/11/01)以é™?
103     *     <og:writeCheck>
104     *         <og:submit  action="COPY"    noWritable="FGJ,UNIQ" />
105     *         <og:submit  action="MODIFY"  noWritable="CLM,FGJ,UNIQ" />
106     *         <og:submit  action="DELETE"  columnWritable="null" />
107     *         <og:submit  gamenId="GF9110" value="index" dbkeys="SYSTEM_ID,LANG,CLM" command="NEW" lbl="GF9100" target="CONTENTS" />
108     *         <br />
109     *     </og:writeCheck>
110     *
111     *     Ver4 ä¸?ˆ¬çš?�ªケース?švalue は共通になったためã?command と lbl の設定がå¿?¦?下位互換性のための設å®?
112     *     <og:writeCheck>
113     *         <og:submit  value="update"   command="COPY"   lbl="COPY"    accesskey="C" />
114     *         <og:submit  value="update"   command="MODIFY" lbl="MODIFY"  accesskey="M" />
115     *         <og:submit  value="update"   command="DELETE" lbl="DELETE"  accesskey="Z" />
116     *         <og:submit  gamenId="GF9110" value="index" dbkeys="SYSTEM_ID,LANG,CLM" command="NEW" lbl="GF9100" target="CONTENTS" />
117     *         <br />
118     *     </og:writeCheck>
119     *
120     *     従来のケース?švalue に設定された値JSPに対してサブミãƒ?ƒˆされますã?(下位互換性のための設å®?
121     *     <og:writeCheck>
122     *         <og:submit value="copy"     lbl="MSG0035" accesskey="C"  />
123     *         <og:submit value="modify"   lbl="MSG0036" accesskey="M"  />
124     *         <og:submit value="delete"   lbl="MSG0037" accesskey="Z"  />
125     *         <og:submit  gamenId="GF9110" value="index" dbkeys="SYSTEM_ID,LANG,CLM" command="NEW" lbl="GF9100" target="CONTENTS" />
126     *         <br />
127     *     </og:writeCheck>
128     *
129     * @og.rev 3.1.1.0 (2003/03/28) 新規作æ?
130     * @og.group 画面制御
131     *
132     * @version  4.0
133     * @author   Kazuhiko Hasegawa
134     * @since    JDK5.0,
135     */
136    public class SubmitTag extends HTMLTagSupport {
137            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
138            private static final String VERSION = "5.6.0.3 (2012/01/24)" ;
139    
140            private static final long serialVersionUID = 560320120124L ;
141    
142            //  5.2.2.0 (2010/11/01) 新規追åŠ?
143            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? 新è¦?{@value} */
144            public static final String ACT_INSERT  = "INSERT" ;
145            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? è¤?? {@value} */
146            public static final String ACT_COPY    = "COPY" ;
147            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? 変更 {@value} */
148            public static final String ACT_MODIFY  = "MODIFY" ;
149            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? 削除 {@value} */
150            public static final String ACT_DELETE  = "DELETE" ;
151            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? エントリー {@value} */
152            public static final String ACT_ENTRY   = "ENTRY" ;
153            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? リセãƒ?ƒˆ {@value} */
154            public static final String ACT_RESET   = "RESET" ;
155    
156            //  5.2.2.0 (2010/11/01) 新規追åŠ?
157            private static final String[] ACTION_LIST = new String[] {
158                    ACT_INSERT , ACT_COPY , ACT_MODIFY , ACT_DELETE , ACT_ENTRY , ACT_RESET };
159    
160            //  5.2.2.0 (2010/11/01) 新規追åŠ?
161            private enum ENUM_ACTION {
162                    // action  value      command    lbl       accesskey
163                       INSERT( "update" , "INSERT" , "INSERT" , "I" ),
164                       COPY  ( "update" , "COPY"   , "COPY"   , "C" ),
165                       MODIFY( "update" , "MODIFY" , "MODIFY" , "M" ),
166                       DELETE( "update" , "DELETE" , "DELETE" , "Z" ),
167                       ENTRY ( "entry"  , "ENTRY"  , "ENTRY"  , "E" ),
168                       RESET ( "reset"  , "RESET"  , "RESET"  , "R" ) ;
169    
170                    private final String defVal ;
171                    private final String defCmd ;
172                    private final String defLbl ;
173                    private final String defKey ;
174    
175                    ENUM_ACTION( final String val , final String cmd , final String lbl , final String key ) {
176                            defVal = val;
177                            defCmd = cmd;
178                            defLbl = lbl;
179                            defKey = key;
180                    }
181    
182                    public String getDefVal() { return defVal; }
183                    public String getDefCmd() { return defCmd; }
184                    public String getDefLbl() { return defLbl; }
185                    public String getDefKey() { return defKey; }
186            }
187    
188            private static final String TYPE = "submit" ;
189            private static final String NAME = "command" ;
190            private static final String MARGIN = "<span style=\"width: 3px;\" ></span>" ;
191    
192            private static final String IMG_PRE = "background: url(";                       // 5.5.0.0 (2012/03/01)
193            private static final String IMG_SUF = ") left top no-repeat;";          // 5.5.0.0 (2012/03/01)
194    
195            private String  action          = null;         // 5.2.2.0 (2010/11/01)
196            private String  command         = null;
197            private String  value           = null;
198            private String  gamenId         = null;
199            private String  target          = null;         // 3.5.5.2 (2004/04/02)
200            private String  dbkeys          = null;         // 4.0.0 (2007/05/23)
201    
202            private String  columnWritable  = null; // 5.2.2.0 (2010/11/01)
203            private String  noWritable              = null; // 5.2.2.0 (2010/11/01)
204    
205            private String bgImg            = null;         // 5.5.0.0 (2012/03/01)
206    
207            private String[] keys           = null;         // 3.5.5.5 (2004/04/23)
208            private String[] vals           = null;         // 3.5.5.5 (2004/04/23)
209    
210            /**
211             * Taglibの開始タグが見つかったときに処ç�?�™ã‚?doStartTag() ã‚?オーバã?ライドしますã?
212             *
213             * @og.rev 5.2.2.0 (2010/11/01) 新規追åŠ?
214             *
215             * @return      後続å?ç�??æŒ?¤º( SKIP_BODY )
216             */
217            @Override
218            public int doStartTag() {
219                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
220                    if( useTag() ) {
221                            // 5.1.8.0 (2010/07/01) 同時設定不可(columnWritable,noWritable) チェãƒ?‚¯
222                            if( columnWritable != null && noWritable != null ) {
223                                    String errMsg = "columnWritable と noWritable は同時にæŒ?®šできませんã€?
224                                                                    + "columnWritable = [" + columnWritable
225                                                                    + "] , noWritable = [" + noWritable
226                                                                    + "]";
227                                    throw new HybsSystemException( errMsg );
228                            }
229    
230                            // 5.2.2.0 (2010/11/01) action 属æ?による初期値の設å®?
231                            if( action != null ) {
232                                    ENUM_ACTION eact = ENUM_ACTION.valueOf( action );
233                                    if( value               == null ) { value   = eact.getDefVal(); }
234                                    if( command             == null ) { command = eact.getDefCmd(); }
235                                    if( getMsglbl() == null )        { setLbl( eact.getDefLbl() ); }
236                                    if( get( "accesskey" ) == null ) { set( "accesskey",eact.getDefKey() ); }
237                            }
238                    }
239                    return( SKIP_BODY );
240            }
241    
242            /**
243             * タグリブオブジェクトをリリースしますã?
244             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
245             *
246             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
247             * @og.rev 3.5.5.2 (2004/04/02) target 属æ?の追åŠ?
248             * @og.rev 3.5.5.5 (2004/04/23) keys,vals 属æ?の追åŠ?
249             * @og.rev 5.2.2.0 (2010/11/01) action,columnWritable,noWritable 属æ?の追åŠ?
250             * @og.rev 5.5.0.0 (2012/03/01) bgImg追åŠ?
251             */
252            @Override
253            protected void release2() {
254                    super.release2();
255                    action          = null;         // 5.2.2.0 (2010/11/01)
256                    command         = null;
257                    value           = null;
258                    gamenId         = null;
259                    target          = null;         // 3.5.5.2 (2004/04/02)
260                    keys            = null;         // 3.5.5.5 (2004/04/23)
261                    vals            = null;         // 3.5.5.5 (2004/04/23)
262                    dbkeys          = null;         // 4.0.0 (2007/05/23)
263                    columnWritable  = null; // 5.2.2.0 (2010/11/01)
264                    noWritable              = null; // 5.2.2.0 (2010/11/01)
265                    bgImg           = null;         // 5.5.0.0 (2012/03/01)
266            }
267    
268            /**
269             * サブミãƒ?ƒˆボタンを作æ?しますã?
270             *
271             * @og.rev 3.3.1.1 (2003/07/03) ForwardManager クラスのå»?­¢。飛ã?先ã?キャãƒ?‚·ュをå»?­¢しますã?
272             * @og.rev 3.5.5.2 (2004/04/02) target 属æ?の追åŠ?
273             * @og.rev 3.5.5.9 (2004/06/07) target 属æ?をã?set ではなã�?add で追åŠ??
274             * @og.rev 3.5.5.9 (2004/06/07) target 属æ?をã?set ではなã�?add で追åŠ??
275             * @og.rev 4.0.0.0 (2005/11/30) title 属æ?が未設定時の処ç�?¿½åŠ?
276             * @og.rev 5.5.0.0 (2012/03/01) bgImg対å¿?
277             * @og.rev 5.6.0.3 (2012/01/24) accesskey に ゼロæ–?­—å?を指定したå?合ã?カãƒ?‚³()ã�?�‘が残ってしまã�??
278             *
279             * @return  サブミãƒ?ƒˆボタンタグ
280             */
281            @Override
282            protected String makeTag() {
283                    StringBuilder rtn = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
284    
285                    if( value == null ) {
286                            String errMsg = "value に null がセãƒ?ƒˆされてã�?�¾すã?";
287                            throw new HybsSystemException( errMsg );
288                    }
289    
290                    String lbl = nval( getMsglbl(), value.toUpperCase( Locale.JAPAN ) );
291                    String accesskey = get( "accesskey" );
292    //              if( accesskey != null ) {
293                    if( accesskey != null && ! accesskey.isEmpty() ) {              // 5.6.0.3 (2012/01/24)
294                            lbl = lbl + "(" + accesskey + ")" ;
295                    }
296    
297                    // キャãƒ?‚·ュエントリ
298                    command = nval( command,value.toUpperCase(Locale.JAPAN) );
299                    String valueLink = getValueLink( gamenId , value );
300                    if( valueLink == null ) { return ""; }  //      アクセス不可時ã? null
301    
302                    // 3.3.1.1 (2003/07/03) ForwardManager クラスのå»?­¢。飛ã?先ã?キャãƒ?‚·ュをå»?­¢しますã?
303                    rtn.append( getHiddenTag( command, lbl, valueLink ) );
304                    rtn.append( HybsSystem.CR );
305    
306                    set( "type",TYPE );
307                    set( "name",NAME );
308                    set( "value",lbl );
309    
310                    // 3.5.5.2 (2004/04/02) target 属æ?の追åŠ?
311                    if( target != null ) {
312                            add( "onClick","this.form.target='" + target + "'",";" );       // 3.5.5.9 (2004/06/07)
313                    }
314    
315                    // 4.0.0 (2005/11/30) title 属æ?が未設定時の処ç�?¿½åŠ?
316                    if( get( "title" ) == null ) {
317                            LabelInterface msglbl = getLabelInterface();
318                            if( msglbl != null ) {
319                                    String desc = msglbl.getDescription();
320                                    if( desc != null && desc.length() > 0 ) {
321                                            set( "title",desc );
322                                    }
323                            }
324                    }
325    
326                    // 5.5.0.0 Img対å¿?スタイル属æ?に追åŠ?�™るã?
327                    if( bgImg != null && bgImg.length() > 0 ){
328                            add("style",IMG_PRE+bgImg+IMG_SUF);
329                    }
330    
331                    rtn.append( XHTMLTag.input( getAttributes() ) );
332                    rtn.append( MARGIN );
333                    rtn.append( HybsSystem.CR );
334    
335                    return rtn.toString() ;
336            }
337    
338            /**
339             * 画面?©?¤とvalue から、指定ã??µ?²?¬を作æ?しますã?
340             * 画面へのアクセス許可が与えられてã�?�ªã�??合ã?、null を返しますã?
341             *
342             * @og.rev 3.5.5.0 (2004/03/12) URLを求めるã?に、GUIInfo#getRealAddress() を使用するã€?
343             * @og.rev 4.0.0.0 (2005/01/31) GUIInfoの実アドレスのパラメータをè?慮するã€?
344             *
345             * @param   gamenId     画面?©?¤
346             * @param   value       飛ã?しå?(XXXX.jspのXXXX部åˆ?
347             *
348             * @return      ?µ?²?¬æ–?­—å?(アクセス不可時ã? null)
349             */
350            private String getValueLink( final String gamenId,final String value ) {
351                    String link = value + ".jsp";
352    
353                    if( gamenId != null && gamenId.length() > 0 ) {
354                            GUIInfo guiInfo = getGUIInfo( gamenId );                // 4.0.0 (2005/01/31)
355                            if( guiInfo == null ) { return null; }  // 見つからなã�??合ã?、アクセス不可
356    
357                            String address = guiInfo.getRealAddress( link );
358                            link = getRequestParameter( address );
359                    }
360    
361                    return link ;
362            }
363    
364            /**
365             * 【TAG】アクション(INSERT,COPY,MODIFY,DELETE,ENTRY,RESET)を指定しますã?
366             *
367             * @og.tag
368             * Ver5 になって、update.jsp ですべての処ç�?‚’行う方向で開発するに当たりã?
369             * command と lbl を記述するå¿?¦�がでてきましたã€?
370             * そこで、現在æœ?–°版では、action 属æ?を用意し、command を記述するã�?�‘で良くなりましたã€?
371             *
372             *    [action属æ?]  [初期設定されるパラメータ郡]
373             *      INSERT       value="update" command="INSERT" lbl="INSERT"  accesskey="I"
374             *      COPY         value="update" command="COPY"   lbl="COPY"    accesskey="C"
375             *      MODIFY       value="update" command="MODIFY" lbl="MODIFY"  accesskey="M"
376             *      DELETE       value="update" command="DELETE" lbl="DELETE"  accesskey="Z"
377             *      ENTRY        value="entry"  command="ENTRY"  lbl="ENTRY"   accesskey="E"
378             *      RESET        value="reset"  command="RESET"  lbl="ENTRY"   accesskey="R"
379             *
380             * @og.rev 5.2.2.0 (2010/11/01) 新規追åŠ?
381             *
382             * @param       act アクションæ–?­—å?
383             * @see         <a href="{&#064;docRoot}/constant-values.html#org.opengion.hayabusa.taglib.SubmitTag.ACT_COPY">アクション定数</a>
384             */
385            public void setAction( final String act ) {
386                    action = getRequestParameter( act );
387    
388                    if( ! check( action, ACTION_LIST ) ) {
389    
390                            StringBuilder errMsg = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
391                            errMsg.append( "æŒ?®šã?アクションは実行できません。アクションエラー" );
392                            errMsg.append( HybsSystem.CR );
393                            errMsg.append( "action=[" ).append( action ).append( "] " );
394                            errMsg.append( HybsSystem.CR );
395    
396                            for( int i=0; i<ACTION_LIST.length; i++ ) {
397                                    errMsg.append( " | " );
398                                    errMsg.append( ACTION_LIST[i] );
399                            }
400                            errMsg.append( " | " );
401                            throw new HybsSystemException( errMsg.toString() );
402                    }
403            }
404    
405            /**
406             * 【TAG】forward したã�?¼ª?³?°ファイル名を記述しまã�?ä¾?insert,copy,modify,delete など)ã€?
407             *
408             * @og.tag
409             * ?ª?³?°ファイル名ã?、標準で、insert,copy,modify,delete などとæŒ?®šしますã?
410             * 実際には、各JSP画面(insert.jsp,copy.jsp,modify.jsp,delete.jsp )に
411             * リクエストが転送されますã?
412             * こã??ª?³?°ファイル名ã?、同ä¸?”»面?©?¤å†??フォルãƒ?�«属してã�?‚‹å¿?¦�がありますã?
413             * ここの?©?¤はã€?¼ª?³?°画面そã?もã?ですã?で、大æ–?­—小文字ã?区別されますã?
414             *
415             * @param   val ?ª?³?°ファイルå�?insert,copy,modify,delete など)
416             */
417            public void setValue( final String val ) {
418                    value = nval( getRequestParameter( val ),value );
419                    if( value == null ) {
420                            String errMsg = "value に null がセãƒ?ƒˆされてã�?�¾すã?";
421                            throw new HybsSystemException( errMsg );
422                    }
423            }
424    
425            /**
426             * 【TAG】gamenId 属æ?を登録しますã?
427             *
428             * @og.tag
429             * gamenId 属æ?は、別の画面にforward する場合に使用しますã?
430             * 実際は、forward ではなくã?sendRedirect されますã?
431             *
432             * @param   id gamenId 属æ?
433             */
434            public void setGamenId( final String id ) {
435                    gamenId = nval( getRequestParameter( id ),gamenId );
436            }
437    
438            /**
439             * éš?�—属æ?タグを取得しますã?
440             * å�??タンに設定された値をã?éš?�—フィールドに設定して受け渡ししますã?
441             *
442             * @og.rev 3.3.1.1 (2003/07/03) ForwardManager クラスのå»?­¢。飛ã?先ã?キャãƒ?‚·ュをå»?­¢しますã?
443             * @og.rev 3.5.5.5 (2004/04/23) 余計なボタン関連æƒ??を転送しなã�?‚ºに、キーを変更しますã?
444             * @og.rev 3.5.5.5 (2004/04/23) keys,vals 属æ?でæŒ?®šしたå?をã?出力しますã?
445             * @og.rev 3.5.5.5 (2004/04/23) hidden の出力に、XHTMLTag.hidden を使用しますã?
446             * @og.rev 3.8.0.8 (2005/10/03) gamenId が指定されてã�?‚‹場合ã?、BACK_GAMENID をå?力するã?
447             * @og.rev 5.2.2.0 (2010/11/01) columnWritable,noWritable 属æ?の追åŠ?
448             *
449             * @param       command         コマンãƒ?
450             * @param       lbl                     ラベルID
451             * @param       valueLink       飛ã?å…?RL
452             *
453             * @return      éš?�—属æ?タグ
454             */
455            private String getHiddenTag( final String command, final String lbl, final String valueLink ) {
456    
457                    StringBuilder strRet = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
458    
459                    String prefix = HybsSystem.NO_XFER_KEY + lbl ;
460                    strRet.append( XHTMLTag.hidden( prefix        ,valueLink ) );   // 3.5.5.5 (2004/04/23)
461                    strRet.append( XHTMLTag.hidden( prefix + "CMD",command   ) );   // 3.5.5.5 (2004/04/23)
462    
463                    // 3.5.5.5 (2004/04/23) keys,vals 属æ?でæŒ?®šしたå?をã?出力しますã?
464                    if( keys != null ) {
465                            if( keys.length != vals.length ) {
466                                    String errMsg = "SubmitTag の keys と vals の引数の個数が異なりますã?" + HybsSystem.CR
467                                                            + "keys=[" + StringUtil.array2csv( keys ) + "], vals=["
468                                                            + StringUtil.array2csv( vals ) + "]" ;
469                                    throw new HybsSystemException( errMsg );
470                            }
471                            for( int i=0; i<keys.length; i++ ) {
472                                    strRet.append( XHTMLTag.hidden( prefix + "KEY_" + keys[i],vals[i] ) );  // 3.5.5.5 (2004/04/23)
473                            }
474                    }
475    
476                    // 4.0.0 (2007/05/23) dbkeys が指定されてã�?‚‹場å�?
477                    if( dbkeys != null && dbkeys.length() > 0 ) {
478                            strRet.append( XHTMLTag.hidden( prefix + "KEY_dbkeys",dbkeys ) );       // 4.0.0 (2007/05/23)
479                    }
480    
481                    // 3.8.0.8 (2005/10/03) gamenId が指定されてã�?‚‹場合ã?、BACK_GAMENID をå?力するã?
482                    if( gamenId != null && gamenId.length() > 0 ) {
483                            String backGamenId = getGUIInfoAttri( "KEY" );
484                            strRet.append( XHTMLTag.hidden( prefix + "KEY_BACK_GAMENID",backGamenId ) );
485                    }
486    
487                    // 5.2.2.0 (2010/11/01) columnWritable,noWritable 属æ?の追åŠ?
488                    if( columnWritable != null ) {
489                            strRet.append( XHTMLTag.hidden( prefix + "KEY_columnWritable",columnWritable ) );
490                    }
491                    if( noWritable != null ) {
492                            strRet.append( XHTMLTag.hidden( prefix + "KEY_noWritable",noWritable ) );
493                    }
494    
495                    return strRet.toString();
496            }
497    
498            /**
499             * 【TAG】å?ç�?‚³マンドを登録しまã�?初期値:大æ–?­—ã? value 属æ?値[INSERT,COPY,MODIFY,DELETE など])ã€?
500             *
501             * @og.tag
502             * command 属æ?を指定しなã�??合ã?、このvalue 属æ?値がã?コマンドになりますã?
503             * value 属æ?に、insert,copy,modify,delete などとæŒ?®šされてã�?�Ÿ場合ã?ã€?
504             * それぞれ、INSERT,COPY,MODIFY,DELETE とã�?�†コマンドになりますã?
505             * コマンドã?、大æ–?­—ですã?
506             *
507             * @param       cmd コマンãƒ?
508             */
509            public void setCommand( final String cmd ) {
510                    command = nval( getRequestParameter( cmd ),command );
511                    if( command != null ) { command = command.toUpperCase(Locale.JAPAN); }
512            }
513    
514            /**
515             * 【TAG】サブミãƒ?ƒˆ先ã?æ–?›¸を表示させるフレーãƒ??またã?ウィンドウの名前を指定しますã?
516             *
517             * @og.tag サブミãƒ?ƒˆ先ã?フレーãƒ?��(ターゲãƒ?ƒˆ属æ?)を設定しますã?
518             *
519             * @og.rev 3.5.5.2 (2004/04/02) 新規追åŠ?
520             *
521             * @param       flag サブミãƒ?ƒˆ先ã?æ–?›¸のフレーãƒ?��(ターゲãƒ?ƒˆ属æ?)
522             */
523            public void setTarget( final String flag ) {
524                    target = nval( getRequestParameter( flag ),target );
525            }
526    
527            /**
528             * 【TAG】ã?タン専用のリクエストキーをCSV形式でè¤?•°æŒ?®šしますã?
529             *
530             * @og.tag
531             * こã?サブミãƒ?ƒˆボタンが押されたå?合ã?み、転送されるリクエスト情報の
532             * キーを設定できますã?カンマ区åˆ?‚Šでè¤?•°æŒ?®šできますã?
533             * vals 属æ?には、キーに対応するå?をã?設定してくださいã€?
534             * åˆ?§£方法ã?、CSV変数をå?にåˆ?§£してから、getRequestParameter で値を取得しますã?
535             * こうしなã�?�¨ãƒ??タ自身にカンマを持ってã�?‚‹場合にåˆ?§£をミスる為ですã?
536             *
537             * @og.rev 3.5.5.5 (2004/04/23) 新規追åŠ?
538             * @og.rev 3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用
539             *
540             * @param       key ボタンが押された時に転送するキー
541             */
542            public void setKeys( final String key ) {
543                    keys = getCSVParameter( key );
544            }
545    
546            /**
547             * 【TAG】ã?タン専用のリクエストå?をCSV形式でè¤?•°æŒ?®šしますã?
548             *
549             * @og.tag
550             * キーに対応したå?をã?カンマ区åˆ?‚Šæ–?­—でè¤?•°æŒ?®šå?来ますã?
551             * æŒ?®šé?序ã?、キーと同じにしておいて下さã�??
552             * åˆ?§£方法ã?、CSV変数をå?にåˆ?§£してから、getRequestParameter で値を取得しますã?
553             * こうしなã�?�¨ãƒ??タ自身にカンマを持ってã�?‚‹場合にåˆ?§£をミスる為ですã?
554             *
555             * @og.rev 3.5.5.5 (2004/04/23) 新規追åŠ?
556             * @og.rev 3.5.6.2 (2004/07/05) CommonTagSupport#getCSVParameter を使用
557             *
558             * @param       val keys属æ?に対応するå?
559             */
560            public void setVals( final String val ) {
561                    vals = getCSVParameter( val );
562            }
563    
564            /**
565             * 【TAG】commonForward の dbkeys にカラãƒ?Œ‡定を行いますã?
566             *
567             * @og.tag
568             * カラãƒ?Œ‡定ã?、CSV形å¼?カンマ区åˆ?‚Š)でæŒ?®šしてくださいã€?
569             * なおã?引数は、è?動的に受けるã?ではなくã?commonForward タグにã€?
570             * dbkeys="{&#064;dbkeys}" の記述はå¿?¦�ですã?
571             *
572             * @og.rev 4.0.0.0 (2007/05/23) 新規追åŠ?
573             *
574             * @param       keys    dbkeys のにカラãƒ?Œ‡å®?
575             */
576            public void setDbkeys( final String keys ) {
577                    dbkeys = nval( getRequestParameter( keys ),dbkeys );
578            }
579    
580            /**
581             * 【TAG】書き込み可能カラãƒ?��をã?カンマ区åˆ?‚Šで与えますã?
582             *
583             * @og.tag
584             * これは、書き込み不可カラãƒ?��のæŒ?®?noWritable)と同時にセãƒ?ƒˆする
585             * ことは出来ませんã€?
586             * なおã?カラãƒ?��の代わりにã€?null" を指定すると、なにも指定しなã�?�“と
587             * になりますã?つまりã?noWritable にすべてのカラãƒ?‚’æŒ?®šすることと
588             * 同じになりますã?(ãƒ?ƒ•ォルトなので、あまり意味はありませんã€?
589             * "*" を指定すると、すべてのカラãƒ?‚’(columnWritable)æŒ?®šしたことになりますã?
590             *
591             * @og.rev 5.2.2.0 (2010/11/01) 新規追åŠ?
592             *
593             * @param       columnName      例ï¼?OYA,KO,HJO,SU,DYSET,DYUPD"
594             * @see         #setNoWritable( String )
595             */
596            public void setColumnWritable( final String columnName ) {
597                    columnWritable = nval( getRequestParameter(columnName),null );
598            }
599    
600            /**
601             * 【TAG】書き込み不可カラãƒ?��をã?カンマ区åˆ?‚Šで与えますã?
602             *
603             * @og.tag
604             * これは、書き込み可能カラãƒ?��のæŒ?®?columnWritable)と同時にセãƒ?ƒˆする
605             * ことは出来ませんã€?
606             * なおã?カラãƒ?��の代わりにã€?null" を指定すると、なにも指定しなã�?�“と
607             * になりますã?つまりã?columnWritable にすべてのカラãƒ?‚’æŒ?®šすることと
608             * 同じになりますã?
609             * "*" を指定すると、すべてのカラãƒ?‚’(noWritable)æŒ?®šしたことになりますã?
610             *
611             * @og.rev 5.2.2.0 (2010/11/01) 新規追åŠ?
612             *
613             * @param       columnName      例ï¼?OYA,KO,HJO,SU,DYSET,DYUPD"
614             * @see         #setColumnWritable( String )
615             */
616            public void setNoWritable( final String columnName ) {
617                    noWritable = nval( getRequestParameter(columnName),null );
618            }
619    
620            /**
621             * 【TAG】画像ã?タンを作る場合ã?、画像ファイルを指定しますã?
622             *
623             * @og.tag
624             * 画像ã?タン作æ?支援の属æ?ですã?
625             * inputタグでtype=imageにした場合ã?IEではname,valueのセãƒ?ƒˆã�?
626             * 次の画面に渡されなã�?»•様になってã�?‚‹ためエンジンのsubmitでは
627             * 利用できませんã€?どのボタンが押されたかåˆ?�‹らなã�?
628             * そこで、typeはsubmitのままcssの背景画像としてここでæŒ?®šしã�?
629             * 画像を配置しますã?
630             * å†?ƒ¨çš?�«はbackground: url(imgFile) left top no-repeat;
631             * をstyleタグに書く事と同じですã?
632             * 高さ、å¹??把握できなã�?�Ÿめã?別途style属æ?でhight,widthを指定して下さã�??
633             *
634             * @og.rev 5.5.0.0 (2012/03/01) 新規追åŠ?
635             *
636             * @param       image   ボタンの背景画åƒ?
637             */
638            public void setImg( final String image ) {
639                    bgImg = nval( getRequestParameter(image),null );
640            }
641    
642            /**
643             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
644             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
645             *
646             * @return こã?クラスのæ–?­—å?表現
647             */
648            @Override
649            public String toString() {
650                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
651                                    .println( "VERSION"             ,VERSION        )
652                                    .println( "command"             ,command        )
653                                    .println( "value"               ,value          )
654                                    .println( "gamenId"             ,gamenId        )
655                                    .println( "target"              ,target         )
656                                    .println( "keys"                ,keys           )
657                                    .println( "vals"                ,vals           )
658                                    .println( "Other..."    ,getAttributes().getAttribute() )
659                                    .fixForm().toString() ;
660            }
661    }