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 static org.opengion.fukurou.util.StringUtil.nval;
019
020 import java.io.IOException;
021 import java.io.ObjectInputStream;
022 import java.io.ObjectOutputStream;
023
024 import org.opengion.fukurou.util.Options;
025 import org.opengion.fukurou.util.StringUtil;
026 import org.opengion.fukurou.util.TagBuffer;
027 import org.opengion.fukurou.util.XHTMLTag;
028 import org.opengion.hayabusa.common.HybsSystem;
029 import org.opengion.hayabusa.common.HybsSystemException;
030
031 /**
032 * プルãƒ?‚¦ンメニューを作æ?するHTML拡張タグですã?
033 *
034 * プルãƒ?‚¦ンメニューå†??選択肢は、selectタグのå†?®¹であるoptionタグã€?
035 * またã?queryOptionタグによってæŒ?®šしますã?
036 * optionタグがセãƒ?ƒˆされなã�??合ã?、name属æ?の、コードリソース からoptionæ–?—å?よりã€?
037 * プルãƒ?‚¦ンメニューの選択肢を作æ?しますã?
038 * name 属æ?に ラベルリソース のキーを与えることでã€?ロケールにあわせたリソースを使用してã€?
039 * 画面に表示しますã?ロケールは、ユーザーæƒ??の lang 属æ?をå?期å?で使用しã?
040 * セãƒ?ƒˆされてã�?�ªã�??合ã?、リクエスト情報のロケールから取得しますã?
041 * language 属æ?で定義されてã�?‚‹場合ã?、そちらを優先しますã?
042 *
043 * @og.formSample
044 * ●形式ï¼?lt;og:select name="…" />
045 * ●body?šあã‚?EVAL_BODY_INCLUDE:BODYをインクルードし、{@XXXX} は解析しません)
046 *
047 * ●Tag定義??
048 * <og:select
049 * name ○ã?TAG】メニューの名称を指定しますã?(å¿??)
050 * value 【TAG】å?を指定しまã�?
051 * defaultVal 【TAG】value属æ?に値がセãƒ?ƒˆされてã�?�ªã�?�¨き使用する、å?期å?を指定しまã�?
052 * lbl 【TAG】ラベルリソースのラベルIDを指定しまã�?
053 * must 【TAG】å¿??入力を表す色に変えるかどã�?�‹[true/false]を指定しまã�?初期値:false)
054 * mustAny 【TAG】選択å¿??入åŠ?どれかひとつå¿??)を表す色[true/mustAny/そã?他]を指定しまã�?初期値:無æŒ?®?
055 * addNoValue 【TAG】å?なしã?Optionを含めるかどã�?�‹[true/false]を指定しまã�?初期値:false)
056 * td 【TAG】テーブル形式ã? <td> タグを使用するかどã�?�‹[yes/no/false]を指定しまã�?初期値:yes)
057 * colspan 【TAG】フィールド部åˆ?? colspan を指定しまã�?
058 * optionAttributes 【TAG】JavaScript などの HTML基本タグ以外ã?属æ?をã?そã?ままタグとして使用しまã�?
059 * size 【TAG】リストã?ãƒ?‚¯スとして表示する場合ã?表示行数を指定しまã�?
060 * multiple 【TAG】è¤?•°選択を可能(multiple)にしまã�?初期値:未設å®?
061 * id 【HTML】要ç´?�«対して固有ã?名前(id)をつける場合に設定しまã�?
062 * caseKey 【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しまã�?初期値:null)
063 * caseVal 【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しまã�?初期値:null)
064 * caseNN 【TAG】指定ã?値がã?null/ゼロæ–?—å? でなã�??å�?Not Null=NN)は、このタグは使用されまã�?初期値:true)
065 * caseNull 【TAG】指定ã?値がã?null/ゼロæ–?—å? の場合ã?、このタグは使用されまã�?初期値:true)
066 * lang 【HTML】要ç´??å†?®¹と他ã?属æ?値のè¨?ª?lang,xml:lang)を指定しまã�?
067 * dir 【HTML】文字表記ã?方å�?dir)を指定しまã�?
068 * title 【HTML】要ç´?�«対する補足çš?ƒ…報(title)を設定しまã�?
069 * style 【HTML】この要ç´?�«対して適用させるスタイルシーãƒ?style)を設定しまã�?
070 * disabled 【TAG】その部品に対してã€?�¸択や変更がå?来なã�?‚ˆã�?�«(disabled)æŒ?®šしまã�?サーバã?に送信されなã�?
071 * tabindex 【HTML】タブã?移動é?(tabindex)を指定しまã�?0 ??32767)
072 * clazz 【HTML】要ç´?�«対して class 属æ?を設定しまã�?
073 * language 【TAG】タグå†?ƒ¨で使用するè¨?ªžコード[ja/en/zh/…]を指定しまã�?
074 * onClick 【HTML】JavaScriptのイベンãƒ?onClick を設定しまã�?ä¾?onClick="renew('query.jsp','QUERY');")
075 * onChange 【HTML】JavaScriptのイベンãƒ?onChange を設定しまã�?ä¾?onChange="renew('query.jsp','QUERY');")
076 * onBlur 【HTML】JavaScriptのイベンãƒ?onBlur を設定しまã�?ä¾?onBlur="this.value=value.toUpperCase();")
077 * onFocus 【HTML】JavaScriptのイベンãƒ?onFocus を設定しまã�?
078 * ondblClick 【HTML】JavaScriptのイベンãƒ?ondblClick を設定しまã�?
079 * onMouseDown 【HTML】JavaScriptのイベンãƒ?onMouseDown を設定しまã�?
080 * onMouseUp 【HTML】JavaScriptのイベンãƒ?onMouseUp を設定しまã�?
081 * onMouseMove 【HTML】JavaScriptのイベンãƒ?onMouseMove を設定しまã�?
082 * onMouseOut 【HTML】JavaScriptのイベンãƒ?onMouseOut を設定しまã�?
083 * onMouseOver 【HTML】JavaScriptのイベンãƒ?onMouseOver を設定しまã�?
084 * onSelect 【HTML】JavaScriptのイベンãƒ?onSelect を設定しまã�?
085 * onKeydown 【HTML】JavaScriptのイベンãƒ?onKeydown を設定しまã�?
086 * onKeypress 【HTML】JavaScriptのイベンãƒ?onKeypress を設定しまã�?
087 * onKeyup 【HTML】JavaScriptのイベンãƒ?onKeyup を設定しまã�?
088 * roles 【TAG】ロールをセãƒ?ƒˆしまã�?
089 * eventColumn 【TAG】イベントカラãƒ?親カラãƒ?を指定しまã�?
090 * eventURL 【TAG】イベントカラãƒ?Œ‡定時に呼び出すURL
091 * eventCallback 【TAG】eventColumn実行後ã?callbak関数æŒ?®?
092 * debug 【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
093 * > ... Body ...
094 * </og:select>
095 *
096 * ●使用ä¾?
097 * <og:select name="CDC"> CodeResource プロパティの値を使用したã�?�¨きã?code属æ?を使ã�?�¾すã?
098 * <og:option code="CDC" />
099 * </og:select>
100 *
101 * <og:select name="CDC"> 選択é?目のä¸?•ª上にé ?›®を付け足すことも可能ですã?
102 * <og:option msg="MSG0001" /> MessageResource プロパティの値を使用したã�?�¨ききはmsg属æ?を使ã�?�¾すã?
103 * <og:option code="CDC" />
104 * </og:select>
105 *
106 * <og:select name="CDC"> 選択é?目のä¸?•ª上にé ?›®を付け足すことも可能ですã?
107 * <og:option lbl="CDC1" /> LabelResource プロパティの値を使用したã�?�¨ききはlbl属æ?を使ã�?�¾すã?
108 * <og:option code="CDC" />
109 * </og:select>
110 *
111 * <og:select name="CDC" multiple="multiple"> 選択肢の中からè¤?•°選択できるようにするときã?multiple属æ?を使ã�?�¾すã?
112 * <og:option code="CDC" />
113 * </og:select>
114 *
115 * <og:select name="CDC" disabled="disabled"> 選択不可にするときã?disabled属æ?を使ã�?�¾すã?
116 * <og:option code="CDC" />
117 * </og:select>
118 *
119 * <og:select name="CDC"> 選択肢をSELECTæ–??結果から作æ?したã�?�¨きã?queryOptionタグとçµ?�¿合わせて使ã�?�¾すã?
120 * <og:queryOption>
121 * select NOSYN,NOSYN,':',NMSYN from DB01 ORDER BY 1
122 * </og:queryOption>
123 * </og:select>
124 *
125 * <og:select name="CDC" eventColumn="OYA" > 親子関係ã?プルãƒ?‚¦ンを作る場å�?
126 * <og:queryOption>
127 * select NOSYN,NOSYN,':',NMSYN from DB01
128 * where CLM = "{@OYA}" ORDER BY 1
129 * </og:queryOption>
130 * </og:select>
131 *
132 * @og.group 選択データ制御
133 *
134 * @version 4.0
135 * @author Kazuhiko Hasegawa
136 * @since JDK5.0,
137 */
138 public class SelectTag extends HTMLTagSupport {
139 //* こã?プログラãƒ??VERSIONæ–?—å?を設定しますã? {@value} */
140 private static final String VERSION = "5.6.2.2 (2013/03/15)" ;
141
142 private static final long serialVersionUID = 562220130315L ;
143
144 // 4.0.0 (2005/01/31) HTML_LABEL_SEPARATOR ã‚?boolean 変数として取得しますã?
145 private final String CLM = ( HybsSystem.sysBool( "HTML_LABEL_SEPARATOR" ) ) ? ":" : "" ;
146
147 // 4.0.0 (2005/01/31) USE_MULTI_KEY_SELECT を定義しておきますã?
148 private final boolean USE_MULTI_KEY_SELECT = HybsSystem.sysBool( "USE_MULTI_KEY_SELECT" ) ;
149
150 // 4.3.6.0 (2009/04/01) JSPの位置を取っておく
151 // private static final String JSP = HybsSystem.sys( "JSP" );
152
153 private transient Options option = new Options();
154 private String td_flag = "yes"; // yes:<td> タグを使用 / false:フィールドã?み / no:ラベルとフィールãƒ?
155
156 // 3.0.1.3 (2003/03/11) colspan 属æ?を追åŠ??
157 private String colspan = null;
158
159 // 3.5.4.0 (2003/11/25) value ,defaultVal 属æ?を追åŠ??
160 private String value = null;
161 private String defaultVal = null; // value がセãƒ?ƒˆされてã�?�ªã�?�¨きã?初期値
162 private boolean multipleAll = false; // 3.8.0.9 (2005/10/17) è¤?•°選択可能時に全選択を設定するã?
163 private String eventColumn = null; // 4.3.6.0 (2009/04/01) イベントカラãƒ?
164 // private String eventURL = JSP + "/" + HybsSystem.sys( "EVENT_COLUMN_URL" ); // 4.3.6.0 (2009/04/01) 処ç�?SPの設å®?
165 private String eventURL = null; // 5.1.9.0 (2010/08/01) 動的プルãƒ?‚¦ン不å?合対å¿?
166
167 // 4.1.2.1 (2008/03/13) must , mustAny 属æ?をè?動化しますã?
168 // 5.2.1.0 (2010/10/01) must , mustAny 属æ?の処ç�?‚’、HTMLTagSupport に移しますã?
169 // private String mustType = null; // 4.1.2.1 (2008/03/13)
170
171 private String rawParam = null; // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
172
173 // 5.1.9.0 (2010/08/01) 値なしã?OptionをSelectに含めるかどã�?�‹ 新規追åŠ?
174 private boolean addNoValue = false; // 互換性のため、å?期å?は、false になりますã?
175
176 /**
177 * Taglibの開始タグが見つかったときに処ç�?�™ã‚?doStartTag() ã‚?オーバã?ライドしますã?
178 *
179 * @og.rev 5.0.2.0 (2009/11/01) è¤?•°パラメーターの選択に対å¿?
180 * @og.rev 5.1.7.0 (2010/06/01) command=RENEWの場合ã?defaultValを無視するã?
181 * @og.rev 5.1.9.0 (2010/08/01) addNoValue 対å¿?
182 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
183 * @og.rev 5.3.7.0 (2011/07/01) 5.1.7.0 (2010/06/01)の対応で判定条件がé?転してã�?‚‹バグを修正
184 *
185 * @return 後続å?ç�??æŒ?¤º( EVAL_BODY_INCLUDE )
186 */
187 @Override
188 public int doStartTag() {
189 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
190 if( useTag() ) {
191 if( value == null ) {
192 // value = nval( getRequestValue( get( "name" ) ),defaultVal );
193 // 5.1.7.0 (2010/06/01) command=RENEWの場合ã?defaultValを無視するã?
194 String cmd = pageContext.getRequest().getParameter( "command" );
195 if( "RENEW".equals( cmd ) ) {
196 value = StringUtil.array2line( getRequestValues( get( "name" ) ), "|" );
197 }
198 else {
199 value = nval( StringUtil.array2line( getRequestValues( get( "name" ) ), "|" ),defaultVal );
200 }
201 }
202
203 // 5.1.9.0 (2010/08/01) addNoValue 対å¿?option を最初にセãƒ?ƒˆするã€?
204 if( addNoValue ) {
205 option.add( "<option value=\"\" ></option>" );
206 }
207
208 return( EVAL_BODY_INCLUDE ); // Body インクルーãƒ? extends TagSupport æ™?
209 }
210 return ( SKIP_BODY ); // Body を評価しなã�?
211 }
212
213 /**
214 * タグリブオブジェクトをリリースしますã?
215 * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
216 *
217 * @og.rev 2.0.0.4 (2002/09/27) カスタãƒ?‚¿グの release() メソãƒ?ƒ‰をã?追åŠ?
218 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false でæŒ?®šするよã�?�«変更
219 * @og.rev 3.0.1.3 (2003/03/11) colspan 属æ?を追åŠ??
220 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
221 * @og.rev 3.5.4.0 (2003/11/25) value ,defaultVal 属æ?を追åŠ??
222 * @og.rev 3.8.0.9 (2005/10/17) è¤?•°選択可能時に全選択を設定するã?
223 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属æ?をè?動化しますã?
224 * @og.rev 4.3.6.0 (2009/04/01) eventColumn,eventURL追åŠ?
225 * @og.rev 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
226 * @og.rev 5.1.9.0 (2010/08/01) columnタグで動的プルãƒ?‚¦ンが動作しなã�?¸�å?合に対å¿?
227 * @og.rev 5.1.9.0 (2010/08/01) addNoValue 属æ?を追åŠ??
228 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属æ?の処ç�?‚’、HTMLTagSupport に移しますã?
229 *
230 */
231 @Override
232 protected void release2() {
233 super.release2();
234 option = new Options();
235 td_flag = "yes"; // table形式ã? <td> タグを使用するかどã�?�‹
236 colspan = null;
237 value = null;
238 defaultVal = null; // value がセãƒ?ƒˆされてã�?�ªã�?�¨きã?初期値
239 multipleAll = false; // 3.8.0.9 (2005/10/17) è¤?•°選択可能時に全選択を設定するã?
240 // mustType = null; // 4.1.2.1 (2008/03/13) // HTMLTagSupport に移しますã?
241 eventColumn = null; // 4.3.6.0 (2009/04/01)
242 // eventURL = JSP + "/" + HybsSystem.sys( "EVENT_COLUMN_URL" ); // 4.3.6.0 (2009/04/01)
243 eventURL = null; // 5.1.9.0 (2010/08/01) columnタグで動的プルãƒ?‚¦ンが動作しなã�?¸�å?合に対å¿?
244 rawParam = null; // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
245 addNoValue = false; // 5.1.9.0 (2010/08/01) 互換性のため、å?期å?は、false になりますã?
246 }
247
248 /**
249 * 入力用のプルãƒ?‚¦ンメニューを作æ?しますã?
250 *
251 * 表示é ??é ?›®名タグは、あらかじめ作æ?済みの値をここでは受け取りますã?
252 * hasSelect 属æ?の値に応じて?Œタグの作æ?方法ã?変わりますã?
253 *
254 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false でæŒ?®šするよã�?�«変更
255 * @og.rev 2.0.1.0 (2002/10/10) ラベルとフィールドã?セパレーターとして、コロン(??を使用するかどã�?�‹を指定できる
256 * @og.rev 3.0.1.3 (2003/03/11) colspan 属æ?を追åŠ??
257 * @og.rev 3.5.4.0 (2003/11/25) value ,defaultVal 属æ?を追åŠ??
258 * @og.rev 4.0.0.0 (2005/01/31) マルチセレクションのON/OFFをここでæŒ?®šã?
259 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属æ?をè?動化しますã?
260 * @og.rev 4.3.6.0 (2009/04/01) eventColumn対å¿?
261 * @og.rev 4.3.7.1 (2009/06/08) id=labelのclassåŒ?
262 * @og.rev 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
263 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属æ?の処ç�?‚’、HTMLTagSupport に移しますã?
264 * @og.rev 5.5.3.0 (2012/06/01) idのセãƒ?ƒˆ見直ã�?
265 * @og.rev 5.6.2.2 (2013/03/15) 自動must処ç�??出力位置を変更
266 *
267 * @return 表示é ?�¸択用のプルãƒ?‚¦ンメニュータグ
268 */
269 @Override
270 protected String makeTag() {
271
272 String name = get( "name" );
273 if( getMsglbl() == null ) { setLbl( name ); }
274
275 if( colspan != null ) {
276 colspan = " colspan=\"" + colspan + "\" ";
277 }
278 else {
279 colspan = "";
280 }
281
282 // 4.0.0 (2005/01/31) XHTMLTag.java より移å‹?
283 if( USE_MULTI_KEY_SELECT ) {
284 set( "onkeydown", "setKeySelect(this);" );
285 }
286
287 StringBuilder rtn = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
288
289 // 5.5.3.0 既にIDが指定されてã�?‚‹場合ã?nameをセãƒ?ƒˆしなã�?
290 if( get("id")==null || get("id").length() == 0 ){
291 set( "id", name );
292 }
293
294 // 4.3.6.0 (2009/04/01) eventColumnの対å¿?
295 // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
296 // if( eventColumn != null && eventColumn.length() > 0 ) {
297 // String[] evntCols = StringUtil.csv2Array( eventColumn );
298 // for( int i = 0; i < evntCols.length; i++ ) {
299 // // SelectTagは"DBMENU"をmakeColumnに渡すã?
300 // String javaScript =
301 // "<script type=\"text/javascript\">" +
302 // "$(function(){$('#" + evntCols[i] + "').change(function(){" +
303 // "makeColumn('" + name + "','" + name + "',EC_" + name + ",'DBMENU','" + eventURL + "');}).change();});"+
304 // "</script>"
305 // ;
306 // rtn.append( javaScript );
307 // }
308 // }
309
310 String selTag = XHTMLTag.select( getAttributes(), option );
311
312 // 5.1.7.0 (2010/06/01) 動的プルãƒ?‚¦ン実è£?¦‹直ã�?
313 if( eventColumn != null && eventColumn.length() > 0 ) {
314 String editor = null;
315 if( rawParam != null && rawParam.length() > 0 ) {
316 editor = "DBMENU";
317 }
318 else {
319 editor = "MENU";
320 }
321 addEventColumn( name, eventColumn, eventURL, "", editor, "", rawParam );
322 TagBuffer span = new TagBuffer( "span" );
323 span.add( "class", HybsSystem.EVENT_COLUMN_CLASS );
324 span.add( HybsSystem.EVENT_COLUMN_ID, name );
325 span.add( HybsSystem.EVENT_COLUMN_INITVAL, value );
326 span.add( HybsSystem.EVENT_COLUMN_WRITABLE, "true" );
327 span.setBody( selTag );
328 selTag = span.makeTag();
329 }
330
331 if( "yes".equals( td_flag ) ) {
332 // 4.3.7.1 (2009/06/08) id=labelのclassåŒ?
333 // rtn.append( "<td id=\"label\">" );
334 rtn.append( "<td class=\"label\">" );
335 rtn.append( getLongLabel() ); // 4.0.0 (2005/01/31)
336 rtn.append( CLM );
337 rtn.append( "</td>" );
338 rtn.append( "<td" );
339 rtn.append( colspan );
340 rtn.append( ">" );
341 // rtn.append( XHTMLTag.select( getAttributes(), option ) );
342 rtn.append( selTag );
343 if( getMustType() != null ) { rtn.append( makeMustHidden( name ) ); } // 5.6.2.2 (2013/03/15)
344 rtn.append( "</td>" );
345 }
346 else if( "no".equals( td_flag ) ) {
347 // 4.3.7.1 (2009/06/08) id=labelのclassåŒ?
348 // rtn.append( "<span id=\"label\">" );
349 rtn.append( "<span class=\"label\">" );
350 rtn.append( getLongLabel() ); // 4.0.0 (2005/01/31)
351 rtn.append( CLM );
352 rtn.append( "</span>" );
353 // rtn.append( XHTMLTag.select( getAttributes(), option ) );
354 rtn.append( selTag );
355 if( getMustType() != null ) { rtn.append( makeMustHidden( name ) ); } // 5.6.2.2 (2013/03/15)
356 }
357 else {
358 // rtn.append( XHTMLTag.select( getAttributes(), option ) );
359 rtn.append( selTag );
360 if( getMustType() != null ) { rtn.append( makeMustHidden( name ) ); } // 5.6.2.2 (2013/03/15)
361 }
362
363 // 4.1.2.1 (2008/03/13) must , mustAny 属æ?をè?動化しますã?
364 // if( mustType != null ) {
365 // rtn.append( XHTMLTag.hidden( HybsSystem.MUST_KEY + mustType, name ) );
366 // }
367 // 5.2.1.0 (2010/10/01) must , mustAny 属æ?をè?動化しますã?
368 // 5.6.2.2 (2013/03/15) tdの外に出力される不正形を正しまã�?
369 // if( getMustType() != null ) { rtn.append( makeMustHidden( name ) ); }
370
371 return rtn.toString() ;
372 }
373
374 /**
375 * メニューé ?›®の選択é?目を追åŠ?�—ますã?
376 *
377 * select タグのBODY要ç´?? OptionTag よりアクセスされますã?
378 *
379 * @og.rev 3.1.2.0 (2003/04/07) taglib パッケージå†?ƒ¨で使用してã�?‚‹ç®?‰€ã‚?protected 化するã?
380 * @param opt オプションタグæ–?—å?
381 */
382 protected void addOption( final String opt ) {
383 option.add( opt );
384 }
385
386 /**
387 * 【TAG】メニューの名称を指定しますã?
388 *
389 * @og.tag メニューの名称を指定しますã?
390 *
391 * @param name 名称
392 */
393 public void setName( final String name ) {
394 set( "name", getRequestParameter( name ) );
395 }
396
397 /**
398 * 【TAG】リストã?ãƒ?‚¯スとして表示する場合ã?表示行数を指定しますã?
399 *
400 * @og.tag 表示行数を指定しますã?
401 *
402 * @param size 表示行数
403 */
404 public void setSize( final String size ) {
405 set( "size",getRequestParameter( size ) );
406 }
407
408 /**
409 * 【TAG】è¤?•°選択を可能(multiple)にしまã�?初期値:未設å®?ã€?
410 *
411 * @og.tag
412 * multiple 値ã�?"multiple" またã? "true" の場合ã?è¤?•°選択状態になりますã?
413 * またã?"ALL" を設定するå?合ã?、OptionTag上で、すべてのOption が選択状態に
414 * 初期設定されますã?
415 * 大æ–?—ã?小文字ã?種別はなくしますが、指定以外ã?æ–?—が設定された場合ã?、エラーになりますã?
416 *
417 * @og.rev 3.8.0.9 (2005/10/17) è¤?•°選択可能時に全選択を設定するã?
418 *
419 * @param multi è¤?•°選æŠ?"multiple" またã? "true") ,初期値全選æŠ? "ALL" )
420 */
421 public void setMultiple( final String multi ) {
422 String multiple = nval( getRequestParameter( multi ),null );
423 if( "multiple".equalsIgnoreCase( multiple ) || "true".equalsIgnoreCase( multiple ) ) {
424 set( "multiple","multiple" );
425 }
426 else if( "ALL".equalsIgnoreCase( multiple ) ) {
427 set( "multiple","multiple" );
428 multipleAll = true;
429 }
430 else if( ! ( "false".equalsIgnoreCase( multiple ) || multiple == null ) ) {
431 String errMsg = "multiple 属æ?には、[multiple,true,ALL] 以外ã?設定できませんã€?
432 + "multiple=" + multi ;
433 throw new HybsSystemException( errMsg );
434 }
435 }
436
437 /**
438 * 【TAG】å¿??入力を表す色に変えるかどã�?�‹[true/false]æŒ?®šしまã�?初期値:false)ã€?
439 *
440 * @og.tag
441 * 初期値は、å¿??でなã�?"false") ですã?
442 *
443 * @og.rev 4.0.0.0 (2005/02/28) must属æ?の登録をã?id属æ?から、class 属æ?に変更しますã?
444 * @og.rev 4.1.2.1 (2008/03/13) must属æ?をè?動化しますã?
445 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属æ?の処ç�?‚’、HTMLTagSupport に移しますã?
446 *
447 * @param flag å¿??入åŠ?("true")?�å¿??でなã�?(それ以å¤?
448 */
449 // public void setMust( final String flag ) {
450 //// boolean must = nval( getRequestParameter( flag ),false );
451 // mustType = nval( getRequestParameter( flag ),null );
452 // if( "true".equalsIgnoreCase( mustType ) ) {
453 // mustType = "must";
454 // add( "class","must" );
455 // }
456 // }
457
458 /**
459 * 【TAG】選択å¿??入åŠ?どれかひとつå¿??)を表す色(true|mustAny|そã?ä»?を指定しまã�?初期値:無æŒ?®?ã€?
460 *
461 * @og.tag
462 * è¤?•°のカラãƒ??ã�?�¡、どれかひとつをå¿??とする選択å¿??入力を示す色を指定しますã?
463 * true またã?、mustAny を設定すると、class属æ?に、mustAny がセãƒ?ƒˆされますã?
464 * mustAny は、CSSファイルに初期設定されてã�?�¾すã?true またã?、mustAny 以外ã?値をセãƒ?ƒˆ
465 * すると、その値がそのまま、class属æ?にセãƒ?ƒˆされますã?でã€?�¸択å¿??のグループ化ã�?
466 * 可能ですã?
467 * なおã?実際の選択å¿??入力チェãƒ?‚¯は、ここではなくã?columnCheck タグでæŒ?®šがå¿?¦�ですã?
468 * 自動å?ç�??、mustAny="true" æŒ?®šã?場合ã?み有効ですã?
469 * 初期値は、無æŒ?®šですã?
470 *
471 * @og.rev 3.8.0.9 (2005/10/17) 新規追åŠ?
472 * @og.rev 4.1.2.1 (2008/03/13) mustAny属æ?をè?動化しますã?
473 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属æ?の処ç�?‚’、HTMLTagSupport に移しますã?
474 *
475 * @param flag 選択å¿??入åŠ?どれかひとつå¿??)を表す色を指å®?true|mustAny|そã?ä»?
476 */
477 // public void setMustAny( final String flag ) {
478 // if( mustType == null ) { // must 属æ?と同時設定時には、must 属æ?を優先しますã?
479 // mustType = nval( getRequestParameter( flag ),null );
480 // if( "true".equalsIgnoreCase( mustType ) ) {
481 // mustType = "mustAny";
482 // }
483 // add( "class",mustType ); // mustType == null の場合ã?、add されませんã€?
484 // }
485 //
486 //// String str = nval( getRequestParameter( flag ),null );
487 //// if( str != null ) {
488 //// if( str.equalsIgnoreCase( "true" ) ) {
489 //// add( "class","mustAny" );
490 //// }
491 //// else {
492 //// add( "class",str );
493 //// }
494 //// }
495 // }
496
497 /**
498 * 【TAG】テーブル形式ã? <td> タグを使用するかどã�?�‹[yes/no/false]を指定しまã�?初期値:yes)ã€?
499 *
500 * @og.tag
501 * 初期値は、使用する("yes") ですã?
502 *
503 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false でæŒ?®šするよã�?�«変更
504 * @og.rev 5.5.1.0 (2012/04/03) エラーメãƒ?‚»ージ変更
505 *
506 * @param flag [yes:tdタグを使用/no:ラベルとフィールãƒ?false:フィールドã?み]
507 */
508 public void setTd( final String flag ) {
509 String td = nval( getRequestParameter( flag ),td_flag );
510
511 if( check( "|" + td + "|" , "|yes|no|false|" ) ) {
512 td_flag = td;
513 }
514 else {
515 String errMsg = "Error in SelectTag [td]: " + td;
516 //errMsg = errMsg + " in [|true|false|label|] only used";
517 errMsg = errMsg + " in [|yes|no|false|] only used"; // 5.5.1.0 (2012/04/03)
518 throw new HybsSystemException( errMsg );
519 }
520 }
521
522 /**
523 * 【TAG】フィールド部åˆ?? colspan を指定しますã?
524 *
525 * @og.tag
526 * 通常はã€? を指定して、フィールドã?ラベル、フィールドã?
527 * çµ?�¿合わせ部åˆ?�«ã€?•·ã�?ƒ•ィールドが適用されるよã�?�«使用しますã?
528 *
529 * <og:select name="CDK" colspan="3" />
530 *
531 * @og.rev 3.0.1.3 (2003/03/11) colspan 属æ?を追åŠ??
532 *
533 * @param sp フィールド部åˆ?? colspan
534 */
535 public void setColspan( final String sp ) {
536 colspan = nval( getRequestParameter( sp ),colspan );
537 }
538
539 /**
540 * 【TAG】å?を指定しますã?
541 *
542 * @og.tag
543 * ここでæŒ?®šされた値がã?optionタグの値と同じであればã€?�¸択状態になりますã?
544 *
545 * <og:select name="CDC" value="{@ABC}" defaultVal="XYZ" >
546 * <og:option value="ABC" lbl="CDC1" />
547 * <og:option value="XYZ" lbl="CDC2" />
548 * </og:select>
549 *
550 * @og.rev 3.5.4.0 (2003/11/25) 新規作æ?
551 * @og.rev 5.0.2.0 (2009/11/01) è¤?•°パラメーターの選択に対å¿?
552 *
553 * @param val 値
554 */
555 public void setValue( final String val ) {
556 // value = nval( getRequestParameter( val ),value );
557 value = nval( StringUtil.array2line( getRequestParameterValues( val ), "|" ),value );
558 }
559
560 /**
561 * 値を外部から取り出しますã?
562 *
563 * OptionTag で、value を取りå?して、å?部の値と同じ場合ã?ã€?�¸択状態にしますã?
564 *
565 * @og.rev 3.5.4.0 (2003/11/25) 新規作æ?
566 *
567 * @return å†?ƒ¨に設定された値
568 */
569 protected String getValue() {
570 return value;
571 }
572
573 // /**
574 // * 親のカラãƒ?‚’取å¾?
575 // *
576 // * QueryOptiontagで、eventColumnを取りå?して生SQLæ–??
577 // * セãƒ?‚·ョンへの登録判断をしまã�?
578 // *
579 // * @og.rev 4.3.6.0 (2009/04/01)
580 // *
581 // * @return イベントカラãƒ?
582 // */
583 // protected String getEventColumn() {
584 // return eventColumn;
585 // }
586
587 /**
588 * 【TAG】イベントカラãƒ?親カラãƒ?を指定しますã?
589 *
590 * @og.tag
591 * 親子関係ã?カラãƒ?‚’作æ?する場合に利用しますã?
592 * queryOptionタグとセãƒ?ƒˆで利用して下さã�??
593 *
594 * ※詳細はcolumnTagのeventColumn属æ?の説明をご覧下さã�??
595 *
596 * @og.rev 4.3.6.0 (2009/04/01)
597 *
598 * @param col 親カラãƒ?��
599 */
600 public void setEventColumn( final String col ) {
601 eventColumn = nval( getRequestParameter( col ), eventColumn );
602 }
603
604 /**
605 * 【TAG】イベントカラãƒ?Œ‡定時に呼び出すURLã€?
606 *
607 * @og.tag
608 * イベントカラãƒ?Œ‡定時に部品を作æ?するJSPを指定しますã?
609 * 初期値はシスãƒ?ƒ リソースのEVENT_COLUMN_URLですã?
610 * (例:eventURL="makeColumn_custom.jsp")
611 *
612 * ※詳細はcolumnTagのeventURL属æ?の説明をご覧下さã�??
613 *
614 * @og.rev 4.3.6.0 (2009/04/01)
615 *
616 * @param url 呼び出すURL
617 */
618 public void setEventURL( final String url ) {
619 eventURL = nval( getRequestParameter( url ), eventURL );
620 }
621
622 /**
623 * è¤?•°選択可能時に全選択を設定するかどã�?�‹を返しますã?
624 *
625 * これは、上位å?れ子ã?タグの OptionTag で、multipleAll を取りå?してã€?
626 * true であれば、å?選択に設定しますã?
627 *
628 * @og.rev 3.8.0.9 (2005/10/17) 新規作æ?
629 *
630 * @return 全選æŠ?true / 通常:false
631 */
632 protected boolean isMultipleAll() {
633 return multipleAll;
634 }
635
636 /**
637 * 【TAG】value属æ?に値がセãƒ?ƒˆされてã�?�ªã�?�¨き使用する、å?期å?を指定しますã?
638 *
639 * @og.tag
640 * value属æ?に値がセãƒ?ƒˆされてã�?�ªã�?�¨きに、å?期å?をセãƒ?ƒˆしますã?
641 *
642 * なおã?commandがRENEWの場合ã?、このdefaultValは適用されませんã€?
643 * これは、defaultValの値が埋め込まれたé ?›®が存在する画面に戻った際にã€?
644 * defaultValのé ?›®の値がnullとなってã�?�Ÿ場合に、defaultValの値が復å…?�•れるとã€?
645 * 検索結果との不ä¸??が発生するためですã?
646 *
647 * @og.rev 3.5.4.0 (2003/11/25) 新規作æ?
648 * @og.rev 5.0.2.0 (2009/11/01) è¤?•°パラメーターの選択に対å¿?
649 *
650 * @param dv 初期値
651 */
652 public void setDefaultVal( final String dv ) {
653 // defaultVal = nval( getRequestParameter( dv ),defaultVal );
654 defaultVal = nval( StringUtil.array2line( getRequestParameterValues( dv ), "|" ),defaultVal );
655 }
656
657 /**
658 * 【TAG】å?なしã?Optionを含めるかどã�?�‹[true/false]を指定しまã�?初期値:false)ã€?
659 *
660 * @og.tag
661 * カラãƒ?�Œプルãƒ?‚¦ンメニュー形式ã?場合ã?選択肢には通常ãƒ??タベã?ス登録できる候補が
662 * 並びますã?しかしã?検索時には、å?補を絞りたくなã�?æŒ?®šしなã�?場合がありã€?
663 * そã?様な場合には、å?なしã?Optionを含める(true)ことで、対応可能ですã?
664 * 初期値:false(値なしã?Optionを含めなã�?はã€?�Ž去の互換性を重視してã�?‚‹ため、column タグと異なりますã?
665 *
666 * @og.rev 5.1.9.0 (2010/08/01) 新規追åŠ?
667 *
668 * @param flag [true:含める/それ以å¤?含めない]
669 */
670 public void setAddNoValue( final String flag ) {
671 addNoValue = nval( getRequestParameter( flag ),addNoValue );
672 }
673
674 /**
675 * パラメーター変換({@XXXX}の置き換えをしなã�?ж態ã?パラメーターをセãƒ?ƒˆしますã?
676 *
677 * @og.rev 5.1.7.0 (2010/06/01) 新規作æ?(動的プルãƒ?‚¦ン実è£?¦‹直ã�?
678 * @og.rev 5.5.4.0 (2012/07/02) 予ç´?ªž対å¿?
679 *
680 * @param param パラメーター
681 */
682 protected void setRawParam( final String param ) {
683 // rawParam = nval( param, rawParam );
684 rawParam = nval( getReservedParameter(param), rawParam ); // 5.5.4.0 (2012/07/02)
685 }
686
687 /**
688 * 【TAG】eventColumn実行後ã?callbak関数æŒ?®šã?
689 *
690 * @og.tag
691 * eventColumnの動作終äº?¾Œに実行するCallback関数のæŒ?®šを行いますã?
692 * 関数名ã?みを指定して下さã�??
693 * ã€?x) sampleCallback()を実行するå?合ã?eventCallback="sampleCallback"
694 * 実行する関数の第ä¸?¼•数には自動的に次の要ç´?�Œ入ったé?列が渡されまã�?
695 * ã€?0] 変更された子カラãƒ??ID属æ?値
696 * ã€?1] evnetColumn実行後ã?子カラãƒ??値
697 * ã€?2] eventColumn実行前の子カラãƒ??値
698 *
699 * こã?属æ?は、optionAttributesへの設定と同様ã?動作を行いますã?
700 *
701 * @og.rev 5.5.4.0 (2012/07/02) 新規追åŠ?
702 *
703 * @param callback callbak関数
704 */
705 public void setEventCallback( final String callback ) {
706 // optionAttributes扱ã�?�§登録しますã?
707 if( callback != null && callback.length() > 0 ){
708 add( "optionAttributes", "eventCallback='"+getRequestParameter( callback )+"'" );
709 }
710 }
711
712 /**
713 * シリアライズ用のカスタãƒ?‚·リアライズ書き込みメソãƒ?ƒ‰
714 *
715 * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
716 * @serialData
717 *
718 * @param strm ObjectOutputStreamオブジェクãƒ?
719 */
720 private void writeObject( final ObjectOutputStream strm ) throws IOException {
721 strm.defaultWriteObject();
722 }
723
724 /**
725 * シリアライズ用のカスタãƒ?‚·リアライズ読み込みメソãƒ?ƒ‰
726 *
727 * ここでは、transient 宣è¨?�•れたå†?ƒ¨変数のå†??初期化がå¿?¦�なフィールドã?み設定しますã?
728 *
729 * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
730 * @serialData
731 *
732 * @param strm ObjectInputStreamオブジェクãƒ?
733 * @see #release2()
734 */
735 private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
736 strm.defaultReadObject();
737 option = new Options();
738 }
739
740 /**
741 * こã?オブジェクトã?æ–?—å?表現を返しますã?
742 * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
743 *
744 * @return こã?クラスのæ–?—å?表現
745 */
746 @Override
747 public String toString() {
748 return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
749 .println( "VERSION" ,VERSION )
750 .println( "td_flag" ,td_flag )
751 .println( "colspan" ,colspan )
752 .println( "value" ,value )
753 .println( "defaultVal" ,defaultVal )
754 .println( "multipleAll" ,multipleAll )
755 .println( "Other..." ,getAttributes().getAttribute() )
756 .fixForm().toString() ;
757 }
758 }