001/* 002 * Copyright (c) 2009 The openGion Project. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 013 * either express or implied. See the License for the specific language 014 * governing permissions and limitations under the License. 015 */ 016package org.opengion.hayabusa.taglib; 017 018import org.opengion.hayabusa.common.HybsSystem; 019import org.opengion.hayabusa.common.HybsSystemException; 020import org.opengion.hayabusa.db.DBColumn; 021import org.opengion.hayabusa.db.DBColumnConfig; 022import org.opengion.hayabusa.resource.CodeData ; 023import org.opengion.hayabusa.resource.RoleMode ; 024import org.opengion.fukurou.util.Attributes; 025import org.opengion.fukurou.util.XHTMLTag; 026import org.opengion.fukurou.util.StringUtil; 027import static org.opengion.fukurou.util.StringUtil.nval ; 028 029/** 030 * カラムリソースに基づいた、入力フィールドなどを作成するHTML拡張タグです。 031 * 032 * name 属性に カラムリソースのキーを与えることにより、指定した表示形式にて画面に表示します。 033 * column タグは、リソースの設定が反映されるため、アプリケーションを修正せずに、 034 * 機能拡張することが可能です。たとえば、テキストフィールド入力に設定していたカラムを、 035 * プルダウンメニューに即座に変更可能です。 036 * カラム定義でロールが指定されている場合、ログインユーザーでアクセス許可がない場合は 037 * カラムは表示されません。 038 * カラムリソースに存在しない場合や特殊用途に使用する場合は、inputタグを使用してください。 039 * 040 * @og.formSample 041 * ●形式:<og:column name=… value=… /> 042 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) 043 * 044 * ●Tag定義: 045 * <og:column 046 * name ○【TAG】カラムの名前を指定します(必須)。 047 * value 【TAG】設定値を指定します 048 * defaultVal 【TAG】value属性に値がセットされていないときに、初期値をセットします 049 * td 【TAG】テーブル形式の <td> タグを使用するかどうか[yes/no/false]を指定します(初期値:yes) 050 * addNoValue 【TAG】コンボボックスの場合、値なしのOptionを含めるかどうか[true/false]を指定します(初期値:true) 051 * lbl 【TAG】ラベルリソースのラベルIDを指定します 052 * must 【TAG】必須入力を表す色に変えるかどうか[true/false]を指定します(初期値:false) 053 * mustAny 【TAG】選択必須入力(どれかひとつ必須)を表す色[true/mustAny/その他]を指定します(初期値:無指定) 054 * aimai 【TAG】曖昧検索可能フィールドとして、曖昧検索方法を指定します(初期値:null) 055 * writable 【TAG】書き込みタイプかどうか[true/false]を指定します(初期値:true) 056 * colspan 【TAG】フィールド部分の colspan を指定します 057 * id 【HTML】要素に対して固有の名前(id)をつける場合に設定します 058 * maxlength 【TAG】最大入力文字数を指定します(入力可能文字数で、バイト数ではありません) 059 * size 【TAG】カラムの表示サイズ(横幅)を文字数でセットします(入力文字制限ではありません) 060 * renderer 【TAG】カラムの表示用レンデラー({@og.doc03Link renderer Renderer_****})をセットします 061 * editor 【TAG】カラムの編集用エディター({@og.doc03Link editor Editor_****})をセットします 062 * dbType 【TAG】DBタイプ({@og.doc03Link dbType DBType_****})をセットします 063 * optionAttributes 【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します 064 * useDefaultPropertieVal 【TAG】リソースファイルの初期値を使うかどうか[true/false]を指定します(初期値:false) 065 * nextForm 【TAG】入力カーソルを、指定されたname属性のフィールドへ自動的に移動させます 066 * useRequestValue 【TAG】value が null の場合に、name 属性から Request情報 を適用するかどうかを指定します(初期値:true) 067 * codeName 【TAG】コードセレクトのユニークキー(コード名称)をセットします 068 * codeList 【TAG】コードセレクトのサブセットとなるコードをCSV形式で指定します 069 * codeGroup 【TAG】コードセレクトのサブセットとなるグループを指定します 070 * codeKeyVal 【TAG】新しいコードセレクトを作成する為の「キー:ラベル キー:ラベル」の文字列を指定します 071 * clazz 【HTML】要素に対して class 属性を設定します 072 * caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 073 * caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 074 * caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:true) 075 * caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:true) 076 * lang 【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します 077 * dir 【HTML】文字表記の方向(dir)を指定します 078 * title 【HTML】要素に対する補足的情報(title)を設定します 079 * style 【HTML】この要素に対して適用させるスタイルシート(style)を設定します 080 * readonly 【TAG】その部品に対して変更が出来ないように(readonly)指定します(サーバーに送信される) 081 * disabled 【TAG】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない) 082 * tabindex 【HTML】タブの移動順(tabindex)を指定します(0 〜 32767) 083 * accesskey 【HTML】アクセスキー(alt+キーで直接指定)を割り当てます 084 * language 【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します 085 * onClick 【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');") 086 * onChange 【HTML】JavaScriptのイベント onChange を設定します(例:onChange="renew('query.jsp','QUERY');") 087 * onBlur 【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();") 088 * onFocus 【HTML】JavaScriptのイベント onFocus を設定します 089 * ondblClick 【HTML】JavaScriptのイベント ondblClick を設定します 090 * onMouseDown 【HTML】JavaScriptのイベント onMouseDown を設定します 091 * onMouseUp 【HTML】JavaScriptのイベント onMouseUp を設定します 092 * onMouseMove 【HTML】JavaScriptのイベント onMouseMove を設定します 093 * onMouseOut 【HTML】JavaScriptのイベント onMouseOut を設定します 094 * onMouseOver 【HTML】JavaScriptのイベント onMouseOver を設定します 095 * onSelect 【HTML】JavaScriptのイベント onSelect を設定します 096 * onKeydown 【HTML】JavaScriptのイベント onKeydown を設定します 097 * onKeypress 【HTML】JavaScriptのイベント onKeypress を設定します 098 * onKeyup 【HTML】JavaScriptのイベント onKeyup を設定します 099 * autocomplete 【HTML5】入力候補を提示して入力内容を自動補完する[on/off](初期値はon)。 100 * autofocus 【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます。 101 * pattern 【HTML5】正規表現で入力値のパターンを指定します。 102 * placeholder 【HTML5】入力欄に初期表示する内容を指定します。 103 * required 【HTML5】入力必須を指定します 104 * list 【HTML5】ユーザーに入力候補として提案するデータリストの要素のid属性の値を指定します。 105 * min 【HTML5】入力欄で入力できる最小値を指定します。 106 * max 【HTML5】入力欄で入力できる最大値を指定します。 107 * step 【HTML5】入力欄で刻むステップ値を指定する。 108 * type 【HTML5】HTML5追加分[text/search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 109 * roles 【TAG】ロールをセットします 110 * eventColumn 【TAG】イベントカラム(親カラム)セット 111 * param 【TAG】パラメータをセットします 112 * dbid 【TAG】(通常使いません)データベースへ接続する場合のID 113 * eventURL 【TAG】イベントURLのセット 114 * xssCheck 【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか[true/false]を設定します (初期値:USE_XSS_CHECK[=true]) 115 * useSLabel 【TAG】MENU,DBMENUでSLABELを利用するかどうか[auto/true/false]を指定します(初期値:auto) 116 * eventCallback 【TAG】eventColumn実行後のcallbak関数指定 117 * debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) 118 * > ... Body ... 119 * </og:column> 120 * 121 * ●使用例 122 * <og:column name="PN" /> 編集種別がTextの場合は、テキストフィールドが表示されます。 123 * 通常はNAME属性を指定するだけです。 124 * <og:column name="CDC" /> 編集種別がMenuの場合は、メニューが表示されます。 125 * <og:column name="PN" value="syokichi" /> 初期値をセットするときはvalue属性を使います。 126 * <og:column name="PN" lbl="PNL" /> ラベルを変更するときはlbl属性を使います。 127 * <og:column name="CDC" /> リソースファイルからコンボボックスも自動作成されます。 128 * <og:column name="CDC" addNoValue="false" /> NULL値を消すときはaddNoValue属性を使います。 129 * <og:column name="CDC" addNoValue="false" must="true" /> 属性は、複数組み合わせて使えます。 130 * <og:column name="PN" must="true" /> 色を変更するときはmust属性を使います。 131 * <og:column name="PN" td="false" /> 自動作成されるtdタグやラベルを外すときはtd属性を使います。 132 * <og:column name="PN" td="no" /> 自動作成されるtdタグを外し、ラベルとフィールドは残します。 133 * <og:column name="PN" writable="false" /> 非入力にするときはwritable属性を使います。 134 * <og:column name="PN" size="20" /> 強制的にSIZEの変更をするときはsize属性を使います。 135 * <og:column name="A" nextForm="B" /> 最大桁数入力後、フォーム B にフォーカスが移動します。 136 * <og:column name="B" /> 137 * 138 * BODY 部分に記述した値は、カラムフィールドの直後にセットされます。 139 * <og:column name="PN" > 140 * <button type="button" onclick="popup(・・・);return false;"> 141 * <og:message lbl="POPUP" comment="▼" /> 142 * </button> 143 * </og:column> 144 * 145 * eventColumnを利用すると、親カラムの変更に従って子カラムの内容を変える事が可能です。 146 * ・親子関係のプルダウンを作成する場合 147 * <og:column name="OYA" /> 148 * <og:column name="KO" eventColumn="OYA" param="SELECT ... WHERE COL = '{@OYA}'" /> 149 * 150 * ・親子関係の入力欄(親のデータで子をDBから検索)を作成する場合 151 * <og:column name="OYA" /> 152 * <og:column name="KO" eventColumn="OYA" param="SELECT A AS VALUE WHERE COL = {@OYA}" /> 153 * 154 * ・親子関係の要素をカスタム化されたJSPを利用して作成する場合 155 * 変更するカラムはJSPで記述されており、指定する事が可能です。 156 * <og:column name="OYA" /> 157 * <og:column name="KO" eventColumn="OYA" param="{@OYA}" eventURL="custom_makeColumn.jsp" /> 158 * 159 * @og.group 画面部品 160 * 161 * @version 4.0 162 * @author Kazuhiko Hasegawa 163 * @since JDK5.0, 164 */ 165public class ColumnTag extends HTMLTagSupport { 166 //* このプログラムのVERSION文字列を設定します。 {@value} */ 167 private static final String VERSION = "5.7.7.1 (2014/06/13)" ; 168 169 private static final long serialVersionUID = 577120140613L ; 170 171 // 5.7.1.0 (2013/12/06) HTML5 で新たに追加された、type を追加。ただし、text だけは戻せるようにしておきます。 172 private static final String CHECK_TYPE = "|text|search|tel|url|email|datetime|date|month|week|time|datetime-local|number|range|color|" ; 173 174 // 4.0.0 (2005/01/31) HTML_LABEL_SEPARATOR を boolean 変数として取得します。 175 private final String CLM = HybsSystem.sysBool( "HTML_LABEL_SEPARATOR" ) ? ":" : "" ; 176 177 private String td_flag = "yes"; // yes:<td> タグを使用 / false:フィールドのみ / no:ラベルとフィールド 178 private boolean addNoValue = true; // 値なしのOptionをSelectに含めるかどうか 179 private String name = null; 180 private String value = null; 181 private boolean writable = true; // 書き込み/ラベルを指定する。(true で書き込み) 182 private String defaultVal = ""; // value がセットされていないときの初期値 183 // 2.1.0.0 (2002/10/11) useDefaultPropertieVal 属性を追加。 184 // 5.2.3.0 (2010/12/01) useDefaultPropertieVal 属性の初期値をシステムリソースで定義 185 // properties ファイルの初期値を 使う:true / 使わない:false 186 private boolean useDefVal = HybsSystem.sysBool( "USE_DEFAULT_PROPERTIE_VALUE" ); 187 188 // 3.0.0.0 (2002/12/25) colspan 属性を追加。 189 private String colspan = ""; 190 // 3.5.4.2 (2003/12/15) nextForm 属性を追加。 191 private String nextForm = null; 192 193 // 3.5.4.9 (2004/02/25) value が null の場合に、リクエスト情報を設定します。 194 private boolean useRequestValue = true; // 初期値:true 195 196 // 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 197 private String vewSize = null; 198 private String maxlength = null; 199 200 // 3.8.0.4 (2005/08/08) BODY 部分に記述した値は、カラムフィールドの直後にセットされます。 201 private String body = null; 202 private String codeName = null; // 3.8.0.6 (2005/09/12) 203 private String codeList = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 204 private String codeGroup = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセットとなるグループ) 205 private String codeKeyVal = null; // 5.6.6.0 (2013/07/05) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 206 207 // 4.0.0 (2007/05/30) カラム状態を動的に変更します。 208 private String renderer = null; 209 private String editor = null; 210 private String dbType = null; 211 212 private String eventColumn = null; // 4.3.6.0 (2009/04/01) 親カラムの指定 213 private String eventURL = null; // 4.3.6.0 (2009/04/01) eventColumnで飛ばすURL 214 private String param = null; // 4.3.6.0 (2009/04/01) パラメータを変更可能にする 215 private String dbid = null; // 5.7.6.2 (2014/05/16) 216 217 private boolean xssCheck = HybsSystem.sysBool( "USE_XSS_CHECK" ); // 5.1.7.0 (2010/06/01) XSS対策 218 219 private String useSLabel = "auto"; // 5.5.1.0 (2012/04/03) 220 221 /** 222 * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。 223 * 224 * @og.rev 3.8.0.4 (2005/08/08) 新規追加(BODY部の評価) 225 * @og.rev 5.1.7.0 (2010/06/01) command=RENEWの場合はdefaultValを無視する。 226 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 227 * 228 * @return 後続処理の指示( EVAL_BODY_BUFFERED ) 229 */ 230 @Override 231 public int doStartTag() { 232 // 5.9.10.0 (2016/07/01) doAfterBodyから移動 233 useXssCheck( xssCheck ); 234 235 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 236 if( useTag() ) { 237 // makeTag() より移動 238 if( value == null && useRequestValue ) { // 3.5.4.9 (2004/02/25) 239 // 5.1.7.0 (2010/06/01) command=RENEWの場合はdefaultValを無視する。 240 String cmd = pageContext.getRequest().getParameter( "command" ); 241 if( "RENEW".equals( cmd ) ) { 242 value = getRequestValue( name ); 243 } 244 else { 245 value = nval( getRequestValue( name ),defaultVal ); 246 } 247 } 248 249 return EVAL_BODY_BUFFERED ; // Body を評価する。( extends BodyTagSupport 時) 250 } 251 return SKIP_BODY ; // Body を評価しない 252 } 253 254 /** 255 * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。 256 * 257 * @og.rev 3.8.0.4 (2005/08/08) 新規追加(BODY部の評価) 258 * @og.rev 5.1.7.0 (2010/06/01) XSS解除対応 259 * 260 * @return 後続処理の指示(SKIP_BODY) 261 */ 262 @Override 263 public int doAfterBody() { 264 // 5.1.7.0 (2010/06/01) XSS対策 265 // 5.9.10.0 (2016/07/01) doStartTagに移動 266 // useXssCheck( xssCheck ); 267 268 body = getBodyString(); 269 return SKIP_BODY ; 270 } 271 272 /** 273 * タグリブオブジェクトをリリースします。 274 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 275 * 276 * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 277 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false で指定するように変更 278 * @og.rev 3.0.0.0 (2002/12/25) colspan 属性を追加。 279 * @og.rev 3.0.1.4 (2003/03/17) colspan 属性の制御方法を変更 280 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 281 * @og.rev 3.5.4.2 (2003/12/15) nextForm 属性を追加。 282 * @og.rev 3.5.4.9 (2004/02/25) useRequestValue 属性を追加。 283 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 284 * @og.rev 3.8.0.4 (2005/08/08) body , useBody 属性を追加。 285 * @og.rev 3.8.0.6 (2005/09/12) codeName 属性を追加。 286 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 287 * @og.rev 5.1.7.0 (2010/06/01) XSS解除対応 288 * @og.rev 5.1.9.0 (2010/08/01) codeList , codeGroup属性を追加。(Codeリソースのサブセットとなるグループ) 289 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属性の処理を、HTMLTagSupport に移します。 290 * @og.rev 5.2.3.0 (2010/12/01) useDefaultPropertieVal 属性の初期値をシステムリソースで定義 291 * @og.rev 5.6.6.0 (2013/07/05) codeKeyVal 属性を追加 292 * @og.rev 5.7.6.2 (2014/05/16) dbid 属性を追加 293 */ 294 @Override 295 protected void release2() { 296 super.release2(); 297 td_flag = "yes"; // table形式の <td> タグを使用するかどうか 298 addNoValue = true; // 値なしのOptionをSelectに含めるかどうか 299 name = null; 300 value = null; 301 writable = true; // 書き込み/ラベルを指定する。(true で書き込み) 302 defaultVal = ""; // value がセットされていないときの初期値 303 useDefVal = HybsSystem.sysBool( "USE_DEFAULT_PROPERTIE_VALUE" ); // 5.2.3.0 (2010/12/01) 304 colspan = ""; 305 nextForm = null; // 3.5.4.2 (2003/12/15) 306 useRequestValue = true; // 3.5.4.9 (2004/02/25) 307 vewSize = null; // 3.5.6.0 (2004/06/18) 308 maxlength = null; // 3.5.6.0 (2004/06/18) 309 body = null; // 3.8.0.4 (2005/08/08) 310 codeName = null; // 3.8.0.6 (2005/09/12) 311 codeList = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 312 codeGroup = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセットとなるグループ) 313 codeKeyVal = null; // 5.6.6.0 (2013/07/05) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 314 renderer = null; 315 editor = null; 316 dbType = null; 317 eventColumn = null; // 4.3.6.0 (2009/04/01) 318 eventURL = null; // 4.3.6.0 (2009/04/01) 319 param = null; // 4.3.6.0 (2009/04/01) 320 dbid = null; // 5.7.6.2 (2014/05/16) 321 xssCheck = HybsSystem.sysBool( "USE_XSS_CHECK" ); // 5.1.7.0 (2010/06/01) XSS解除対応 322 } 323 324 /** 325 * 検索条件の入力用のテキストフィールドを作成します。 326 * 327 * テーブルタグによりフィールドは分割されます。 328 * 使用時は、テーブルタグを前後に使用して下さい。 329 * 330 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false で指定するように変更 331 * @og.rev 2.0.1.0 (2002/10/10) ラベルとフィールドのセパレーターとして、コロン(:)を使用するかどうかを指定できる 332 * @og.rev 3.0.0.0 (2002/12/25) colspan 属性を追加。 333 * @og.rev 3.0.1.4 (2003/03/17) colspan 属性の制御方法を変更 334 * @og.rev 3.5.4.9 (2004/02/25) value が null の時の 値の設定方法 335 * @og.rev 3.5.4.9 (2004/02/25) value が null の時の 値の設定方法 336 * @og.rev 3.8.0.4 (2005/08/08) body 属性を追加。 337 * @og.rev 3.8.7.0 (2006/12/15) カラムリソースで指定したカラムラベルを反映させる。 338 * @og.rev 4.0.0.0 (2005/11/30) カラムロールを考慮 339 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 340 * @og.rev 4.3.7.1 (2009/06/08) id=labelのclass化 341 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属性の処理を、HTMLTagSupport に移します。 342 * @og.rev 5.6.2.2 (2013/03/15) 自動must処理の出力位置を変更 343 * @og.rev 5.8.4.1 (2015/02/15) aimai追加 6.2.0.0逆移植 344 * 345 * @return 入力用のテキストフィールドタグ 346 */ 347 @Override 348 protected String makeTag() { 349 // 3.8.7.0 (2006/12/15) カラムリソースで指定したカラムラベルを反映させる。 350 DBColumn dbColumn = getDBColumn( name ); 351 String label = getLongLabel() ; 352 if( label == null ) { label = dbColumn.getLongLabel() ; } 353 354 String tag = getInsertTag( dbColumn,value ); 355 356 // 4.0.0 (2005/11/30) カラムロールを考慮 357 if( tag == null ) { return ""; } // アクセス不可の場合は、ゼロ文字列を返す。 358 359 // 3.8.0.4 (2005/08/08) BODY を使用する場合は、カラムフィールドの直後に挿入する。 360 if( body != null ) { tag = tag + body; } 361 362 StringBuilder rtn = new StringBuilder( HybsSystem.BUFFER_MIDDLE ); 363 if( "yes".equals( td_flag ) ) { 364 // 4.3.7.1 (2009/06/08) id=labelのclass化 365 // rtn.append( "<td id=\"label\">" ); 366 rtn.append( "<td class=\"label\">" ); 367 rtn.append( label ); 368 rtn.append( CLM ); 369 rtn.append( "</td>" ); 370 rtn.append( "<td" ); 371 rtn.append( colspan ); 372 rtn.append( ">" ); 373 rtn.append( tag ); 374 rtn.append( makeAimaiPicker( name ) ); // 5.8.4.2(2015/02/20) 375 if( getMustType() != null ) { rtn.append( makeMustHidden( name ) ); } // 5.6.2.1 (2013/03/15) 376 rtn.append( "</td>" ); 377 } 378 else if( "no".equals( td_flag ) ) { 379 // 4.3.7.1 (2009/06/08) id=labelのclass化 380 //rtn.append( "<span id=\"label\">" ); 381 rtn.append( "<span class=\"label\">" ); 382 rtn.append( label ); 383 rtn.append( CLM ); 384 rtn.append( "</span>" ); 385 rtn.append( tag ); 386 rtn.append( makeAimaiPicker( name ) ); // 5.8.4.2(2015/02/20) 387 if( getMustType() != null ) { rtn.append( makeMustHidden( name ) ); } // 5.6.2.1 (2013/03/15) 388 } 389 else { 390 rtn.append( tag ); 391 rtn.append( makeAimaiPicker( name ) ); // 5.8.4.2(2015/02/20) 392 if( getMustType() != null ) { rtn.append( makeMustHidden( name ) ); } // 5.6.2.1 (2013/03/15) 393 } 394 395 return rtn.toString() ; 396 } 397 398 /** 399 * カラムがselectタグの場合に、値なしのオプション文字列を挿入します。 400 * 401 * addNoValue 値が True の場合のみ、挿入します。 402 * 403 * @og.rev 2.1.0.0 (2002/10/11) useDefaultPropertieVal 属性を追加。 404 * @og.rev 3.5.4.2 (2003/12/15) 入力カーソルを自動的に次のフィールドへ移動する機能を追加する。 405 * @og.rev 3.5.5.5 (2004/04/23) DBColumn の size と maxlength の 意味を変更 406 * @og.rev 3.5.5.7 (2004/05/10) DBColumn.getOption( String ) 廃止 407 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 408 * @og.rev 3.8.0.6 (2005/09/12) codeName 属性を追加。 409 * @og.rev 3.8.7.0 (2006/12/15) カラムリソースで指定したカラムラベルを反映させる。 410 * @og.rev 4.0.0.0 (2005/01/31) getFieldSize メソッドを XHTMLTag から DBColumn へ移動 411 * @og.rev 4.0.0.0 (2005/11/30) カラムロールを考慮。アクセス不可の場合は、null を返す。 412 * @og.rev 4.3.0.0 (2008/07/04) ロールモードマルチ対応 413 * @og.rev 4.3.7.2 (2009/06/15) 不要なIDが出力されるバグを修正 414 * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し 415 * @og.rev 5.1.7.0 (2010/06/01) DBColumnの{@XXXX}変数対応 416 * @og.rev 5.1.9.0 (2010/08/01) codeList ,codeGroup 属性を追加(Codeリソースのサブセットとなるグループ) 417 * @og.rev 5.5.4.0 (2012/07/02) eventColumnの{@USER.XXXX}対応 418 * @og.rev 5.6.6.0 (2013/07/05) codeKeyVal 属性を追加 419 * @og.rev 5.7.6.2 (2014/05/16) dbid 属性を追加、IEのHTML5機能が無効の場合の処理 420 * @og.rev 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合、list 属性は削除します。 421 * @og.rev 5.7.7.1 (2014/06/13) codeName 設定時に、renderer,editor が null の場合のみ、MENUに設定 422 * 423 * @param clm DBColumnカラムオブジェクト 424 * @param value 設定値 425 * 426 * @return 入力用のカラムタグ 427 */ 428 private String getInsertTag( final DBColumn clm, final String value ) { 429 String val = value; 430 431 // 4.3.0.0 (2008/07/04) ロールモードマルチ対応 432 RoleMode roleMode = null; 433 String roles = get( "roles" ); 434 if( roles != null ) { 435 roleMode = RoleMode.newInstance( roles ); 436 } 437 else { 438 roleMode = clm.getRoleMode(); 439 } 440 441 byte byteMode = getUser().getAccessBitMode( roleMode ) ; 442 443 if( !RoleMode.isAccess( byteMode ) ) { return null; } // アクセス不可(rw不可) 444 445 // 書き込み権限のチェック 446 // writable = writable && RoleMode.isWrite( byteMode ); 447 448 // 3.5.4.2 (2003/12/15) 入力カーソルを自動的に次のフィールドへ移動する機能 449 if( nextForm != null ) { 450 if( maxlength == null ) { maxlength = String.valueOf( clm.getTotalSize() ); } // 4.0.0 (2005/01/31) メソッド名変更 451 452 String onKeyup = "nextForm(this,'" + nextForm + "'," + maxlength + ");" ; 453 set( "onKeyup",onKeyup ); 454 } 455 456 // 3.5.6.0 (2004/06/18) 直接 DBColumnConfig に設定します。 457 if( vewSize == null && maxlength != null ) { 458 // 4.0.0 (2005/01/31) getFieldSize メソッドを XHTMLTag から DBColumn へ移動 459 int fsize = clm.getFieldSize( Integer.parseInt( maxlength ) ); 460 vewSize = String.valueOf( fsize ); 461 } 462 463 DBColumnConfig config = clm.getConfig(); 464 465 // 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合の処理 466 String ieHTML5 = (String)getSessionAttribute( HybsSystem.IE_HTML5_KEY ); 467 if( "FALSE".equalsIgnoreCase( ieHTML5 ) ) { 468 if( "DATALIST".equalsIgnoreCase( editor ) || 469 "DATALIST".equalsIgnoreCase( config.getEditor() ) ) { 470 editor = "INDBMENU"; 471 set( "list",null ); // 5.7.6.2 (2014/05/16) list 属性は削除します。 472 } 473 } 474 475 if( maxlength != null ) { config.setMaxlength( maxlength ); } 476 if( vewSize != null ) { config.setViewLength( vewSize ); } // 4.0.0 (2005/01/31) 477 if( renderer != null ) { config.setRenderer( renderer ); } 478 if( editor != null ) { config.setEditor( editor ); } 479 if( dbType != null ) { config.setDbType( dbType ); } 480 if( eventColumn != null ) { config.setEventColumn( eventColumn ); } // 4.3.6.0 (2009/04/01) 481 if( param != null ) { // 4.3.6.0 (2009/04/01) 482 config.setParameter( getRequestParameter( param ) ); // ここで{@XXXX}変換 483 config.setRawParameter( getReservedParameter(param) ); // 5.5.4.0 (2012/07/02) 予約語対応 484 } 485 // 5.1.7.0 (2010/06/01) DBColumnの{@XXXX}変数対応 486 else if ( clm.isNeedsParamParse() ){ 487 config.setRendererParam( getRequestParameter( config.getRendererParam() ) ); 488 config.setEditorParam( getRequestParameter( config.getEditorParam() ) ); 489 } 490 if( dbid != null ) { config.setDbid( dbid ); } // 5.7.6.2 (2014/05/16) 491 if( eventURL != null ) { config.setEventURL( eventURL ); } // 4.3.6.0 (2009/04/01) 492 if( useSLabel != null ) { config.setUseSLabel( useSLabel ); } // 5.5.1.0 (2012/04/03) 493 494 // 4.0.0 (2005/01/31) 495 if( codeName != null ) { 496 CodeData codeData = getResource().getCodeData( codeName ) ; 497 config.setCodeData( codeData ); 498 // 5.7.7.1 (2014/06/13) codeName 設定時に、renderer,editor が null の場合のみ、MENUに設定。 499// config.setRenderer( "MENU" ); 500// config.setEditor( "MENU" ); 501 if( renderer == null ) { config.setRenderer( "MENU" ); } 502 if( editor == null ) { config.setEditor( "MENU" ); } 503 } 504 505 // 5.6.6.0 (2013/07/05) CodeData オブジェクトの取得を表に移動 506 // codeName で指定のリソースでも、サブセットが作成できます。 507 CodeData codeData = config.getCodeData() ; 508 if( codeData != null ) { 509 // 5.1.9.0 (2010/08/01) codeList 属性を追加(Codeリソースのサブセット) 510 if( codeList != null ) { 511 config.setCodeData( codeData.subsetList( codeList ) ); 512 } 513 514 // 5.1.9.0 (2010/08/01) codeGroup 属性を追加(Codeリソースのサブセットとなるグループ) 515 if( codeGroup != null ) { 516 config.setCodeData( codeData.subsetGroup( codeGroup ) ); 517 } 518 519 // 5.1.9.0 (2010/08/01) RoleMode 制御を追加(Codeリソースのサブセット) 520 if( codeData.useRoleMode() ) { 521 config.setCodeData( codeData.subsetRole( getUser().getRoleMode() ) ); 522 } 523 } 524 525 // 5.6.6.0 (2013/07/05) codeKeyVal 新しいコードセレクトを作成する。 526 if( codeKeyVal != null ) { 527 config.setCodeKeyVal( codeKeyVal ); 528 config.setRenderer( "MENU" ); 529 config.setEditor( "MENU" ); 530 } 531 532 Attributes attri = getAttributes(); 533 config.setEditorAttributes( attri ); 534 DBColumn column = new DBColumn( config ); 535 536 if( useDefVal && ( val == null || val.length() == 0 ) ) { 537 val = column.getDefault(); 538 } 539 540 String rtn = null; 541 if( writable ) { 542 String editTag = column.getEditorValue( val ); 543 StringBuilder tag = new StringBuilder( editTag ); 544 if( addNoValue && editTag.startsWith( "<select" ) ) { 545 int offset = editTag.indexOf( '>' ); 546 tag.insert( offset+1,"<option value=\"\" ></option>" ); 547 } 548 rtn = tag.toString(); 549 } 550 else { 551 if( attri == null || attri.size() == 0 ) { 552 rtn = column.getRendererValue( val ); 553 } 554 else { 555 attri.set( "body" , column.getRendererValue( val ) ); 556 rtn = XHTMLTag.span( attri ); 557 } 558 } 559 560 // 4.3.6.0 (2009/04/01) eventColumn対応 生SQL文のセッション保存 561 // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し 562 String evCol = column.getEventColumn(); 563 if( evCol != null && evCol.length() > 0 ){ 564 addEventColumn( column ); 565 rtn = column.getEventColumnTag( rtn, val, writable ); 566 } 567 568 return rtn; 569 } 570 571 /** 572 * 【TAG】カラムの名前を返します。 573 * 574 * @og.tag 575 * <og:column name="PN" /> 576 * 577 * @og.rev 4.2.4.0 (2008/07/01) 578 * 579 * @return カラムの名前 580 */ 581 protected String getName() { 582 return name; 583 } 584 585 /** 586 * 【TAG】カラムの名前を指定します。 587 * 588 * @og.tag 589 * <og:column name="PN" /> 590 * 591 * @og.rev 3.8.0.9 (2005/10/17) RequestParameter変数({@XXXX})が使用できるように修正 592 * 593 * @param name 名前 594 */ 595 public void setName( final String name ) { 596 this.name = nval( getRequestParameter( name ),this.name ); 597 } 598 599 /** 600 * 【TAG】設定値を指定します。 601 * 602 * @og.tag 603 * <og:column name="PN" value="syokichi" /> 604 * 605 * @param val 設定値 606 */ 607 public void setValue( final String val ) { 608 value = nval( getRequestParameter( val ),value ); 609 } 610 611 /** 612 * 【TAG】value属性に値がセットされていないときに、初期値をセットします。 613 * 614 * @og.tag 615 * value属性に値がセットされていないときに、初期値をセットします。 616 * 617 * なお、commandがRENEWの場合は、このdefaultValは適用されません。 618 * これは、defaultValの値が埋め込まれた項目が存在する画面に戻った際に、 619 * defaultValの項目の値がnullとなっていた場合に、defaultValの値が復元されると、 620 * 検索結果との不一致が発生するためです。 621 * 622 * @param dv 初期値 623 */ 624 public void setDefaultVal( final String dv ) { 625 defaultVal = nval( getRequestParameter( dv ),defaultVal ); 626 } 627 628 /** 629 * 【TAG】リソースファイルの初期値を使うかどうか[true/false]を指定します(初期値:false)。 630 * 631 * @og.tag 632 * 初期値がセットされていないときに指定します。 633 * 使う場合はtrue、 使わない場合は falseをセットします。 634 * この初期値を、システムリソースの USE_DEFAULT_PROPERTIE_VALUE で設定可能とします。 635 * 636 * @og.rev 2.1.0.0 (2002/10/11) useDefaultPropertieVal 属性を追加。 637 * @og.rev 5.2.3.0 (2010/12/01) 初期値をシステムリソースで定義(USE_DEFAULT_PROPERTIE_VALUE) 638 * 639 * @param dv ファイルの初期値を指定 [true:使う/false:使わない] 640 */ 641 public void setUseDefaultPropertieVal( final String dv ) { 642 useDefVal = nval( getRequestParameter( dv ),useDefVal ); 643 } 644 645 /** 646 * 【TAG】テーブル形式の <td> タグを使用するかどうか[yes/no/false]を指定します(初期値:yes)。 647 * 648 * @og.tag 649 * yes(初期値) とすると、ラベルとフィールドをテーブルのtdタグでそれぞれ記述します。 650 * no とすると、tdタグを使用せず、ラベルとフィールドを表示します。 651 * false は、ラベルを出さずに、フィールドのみを表示します。 652 * 653 * <td><og:column name="PN" td="no" /> </td> 654 * 655 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false で指定するように変更 656 * @og.rev 2.1.2.3 (2002/12/02) errMsg の文字列の修正漏れを訂正 657 * 658 * @param flag [yes:タグを使用/no:ラベルとフィールド/false:フィールドのみ] 659 */ 660 public void setTd( final String flag ) { 661 String td = nval( getRequestParameter( flag ),td_flag ); 662 663 if( check( "|" + td + "|" , "|yes|no|false|" ) ) { 664 td_flag = td; 665 } 666 else { 667 String errMsg = "td 属性は、下記の範囲より選定してください。 td=[" 668 + td + " in [|yes|no|false|]"; 669 throw new HybsSystemException( errMsg ); 670 } 671 } 672 673 /** 674 * 【TAG】コンボボックスの場合、値なしのOptionを含めるかどうか[true/false]を指定します(初期値:true)。 675 * 676 * @og.tag 677 * カラムがプルダウンメニュー形式の場合、選択肢には通常データベース登録できる候補が 678 * 並びます。しかし、検索時には、候補を絞りたくない(指定しない)場合があり、 679 * その様な場合には、値なしのOptionを含める(true)ことで、対応可能です。 680 * 初期値:true(値なしのOptionを含める)なので、検索画面に利用する場合は、そのまま使用できます。 681 * 682 * <og:column name="CDC" addNoValue="false" /> 683 * 684 * @param flag [true:含める/それ以外:含めない] 685 */ 686 public void setAddNoValue( final String flag ) { 687 addNoValue = nval( getRequestParameter( flag ),addNoValue ); 688 } 689 690 /** 691 * 【TAG】書き込みタイプかどうか[true/false]を指定します(初期値:true)。 692 * 693 * @og.tag 694 * 初期値は、書き込みタイプ("true") です。 695 * <og:column name="PN" writable="false" /> 696 * 697 * @param flag [true:書き込みタイプ/それ以外:ラベルタイプ] 698 */ 699 public void setWritable( final String flag ) { 700 writable = nval( getRequestParameter( flag ),writable ); 701 } 702 703 /** 704 * 【TAG】最大入力文字数を指定します(入力可能文字数で、バイト数ではありません)。 705 * 706 * @og.tag 707 * <og:column name="PN" maxlength="20" /> 708 * 709 * @og.rev 3.5.4.2 (2003/12/15) 最大入力制限数に応じたサイズ自動生成を入れます。 710 * @og.rev 3.5.4.5 (2004/01/23) CSSで処理する場合のクラス属性は、maxlength が 5 以下の場合とする。 711 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 712 * 713 * @param maxlen 最大入力文字数 714 */ 715 public void setMaxlength( final String maxlen ) { 716 maxlength = nval( getRequestParameter( maxlen ),null ); 717 718 // 3.5.4.5 (2004/01/23) 追加 719 if( maxlength != null && maxlength.length() == 1 ) { 720 char ch = maxlength.charAt(0); 721 if( ch >= '1' && ch <= '5' ) { 722 add( "class", "S0" + ch ); // 3.5.5.9 (2004/06/07) セパレータ引数付きのメソッドに変更 723 } 724 } 725 } 726 727 /** 728 * 【TAG】カラムの表示サイズ(横幅)を文字数でセットします(入力文字制限ではありません)。 729 * 730 * @og.tag 731 * <og:column name="PN" size="20" /> 732 * 733 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 734 * 735 * @param size 表示サイズ(横幅) 736 */ 737 public void setSize( final String size ) { 738 vewSize = nval( getRequestParameter( size ),null ); 739 } 740 741 /** 742 * 【TAG】フィールド部分の colspan を指定します。 743 * 744 * @og.tag 745 * 通常の出力では、ラベルとフィールドのtdが2つ使用されます。この colspan は、 746 * フィールドに追加されます。 747 * たとえば、3 を指定した場合、フィールドが、次のテーブルの、ラベル、フィールド部分まで 748 * 伸びるため、レイアウト的にすっきりと、長いフィールドを適用する事が可能です。 749 * 750 * <og:column name="PN" colspan="3" /> 751 * 752 * @og.rev 3.0.0.0 (2002/12/25) colspan 属性を追加。 753 * @og.rev 3.0.1.4 (2003/03/17) colspan 属性の制御方法を変更 754 * 755 * @param sp フィールド部分のcolspan 756 */ 757 public void setColspan( final String sp ) { 758 colspan = nval( getRequestParameter( sp ),colspan ); 759 if( colspan.length() > 0 ) { 760 colspan = " colspan=\"" + colspan + "\" "; 761 } 762 } 763 764 /** 765 * 【TAG】入力カーソルを、指定されたname属性のフィールドへ自動的に移動させます。 766 * 767 * @og.tag 768 * JavaScript の onKeyup イベントを利用して、最大桁数まで入力すると、 769 * 次のフィールドに、自動的にカーソルが飛ぶように設定します。 770 * 引数は、次に飛ばすフィールドの name 属性です。 771 * 実行するには、JavaScript の nextForm 関数が必要です。(default.js で指定) 772 * 773 * @og.rev 3.5.4.2 (2003/12/15) 新規追加 774 * 775 * @param name 次にフォーカスを移すタグのname属性 776 */ 777 public void setNextForm( final String name ) { 778 nextForm = nval( getRequestParameter( name ),nextForm ); 779 } 780 781 /** 782 * 【TAG】value が null の場合に、name 属性から Request情報 を適用するかどうかを指定します(初期値:true)。 783 * 784 * @og.tag 785 * name 属性に一致するリクエスト情報がある場合、value が null の場合や、 786 * 引数を設定していない場合は、この設定値に応じて、リクエスト情報の値を 787 * 設定します(初期値:true なので、通常はこの動きです) 788 * ごくまれに、ENTRY 系の削除を行う場合、リクエスト情報が残り、削除されずに 789 * 再表示(DB的には削除済み)されるケースでは、使用しない(false)設定が可能です。 790 * 791 * useRequestValue | true(初期値) | false 792 * ------------------+------------------------+------------ 793 * value |A A A A _ _ _ _ |_ _ _ _ 794 * name(Request情報)|B B _ _ B B _ _ |B B _ _ 795 * defaultVal |C _ C _ C _ C _ |C _ C _ 796 * ==================+========================+============ 797 * 設定値 |A A A A B B C _ |C _ C _ 798 * 799 * @og.rev 3.5.4.9 (2004/02/25) 新規追加 800 * 801 * @param flag value が null の時の 値の設定方法 802 */ 803 public void setUseRequestValue( final String flag ) { 804 useRequestValue = nval( getRequestParameter( flag ),useRequestValue ); 805 } 806 807 /** 808 * 【TAG】コードセレクトのユニークキー(コード名称)をセットします。 809 * 810 * @og.tag 811 * このキーを元に、CodeData オブジェクトを構築します。 812 * 813 * @og.rev 3.8.0.6 (2005/09/12) 新規作成 814 * 815 * @param name メニューのユニークキー 816 */ 817 public void setCodeName( final String name ) { 818 codeName = nval( getRequestParameter( name ),codeName ); 819 } 820 821 /** 822 * 【TAG】コードセレクトのサブセットとなるコード(キー)をCSV形式で指定します。 823 * 824 * @og.tag 825 * この値に限定された、コードリソースを、既存の、CodeData の 826 * サブセットとして作成します。 827 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 828 * ここで指定するのは、コード(キー)だけです。 829 * 830 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 831 * 832 * @param list コードセレクトのサブセットとなるコード(キー) 833 */ 834 public void setCodeList( final String list ) { 835 codeList = nval( getRequestParameter( list ),codeList ); 836 } 837 838 /** 839 * 【TAG】コードセレクトのサブセットとなるグループを指定します。 840 * 841 * @og.tag 842 * この値に限定された、コードリソースを、既存の、CodeData の 843 * サブセットとして作成します。 844 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 845 * グループとは、optiongroup の事ではなく、コードリソースに関連付けられた 846 * グループを指定する事で、簡易的にサブセットを作成します。 847 * 848 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 849 * 850 * @param group コードセレクトのサブセットとなるグループ 851 */ 852 public void setCodeGroup( final String group ) { 853 codeGroup = nval( getRequestParameter( group ),codeGroup ); 854 } 855 856 /** 857 * 【TAG】新しいコードセレクトを作成する為の「キー:ラベル キー:ラベル」の文字列を指定します。 858 * 859 * @og.tag 860 * 既存の、CodeData には存在しない、新しいコードリソースを作成する為の、文字列を指定します。 861 * 文字列は、「キー:ラベル キー:ラベル」形式で、スペースで分解後、":" でキーとラベルに分離します。 862 * スペース分解後の文字列に、":" が含まれていない場合は、無視されます。 863 * 内部的には、CodeData を作成しません。DBColumnオブジェクト内で、直接、Selection_KEYVAL を生成します。 864 * codeName 、codeList、codeGroup などが指定された場合は、そちらが優先されます。 865 * 「キー:ラベル キー:ラベル」で、ラベル にスペースを含ませる場合は、ダブルクォーテーションで囲ってください。 866 * 867 * @og.rev 5.6.6.0 (2013/07/05) 新規作成 868 * 869 * @param keyval 新しいコードセレクトを作成する為の KEY:VAL 文字列 870 */ 871 public void setCodeKeyVal( final String keyval ) { 872 codeKeyVal = nval( getRequestParameter( keyval ),codeKeyVal ); 873 } 874 875 /** 876 * 【TAG】カラムの表示用レンデラー({@og.doc03Link renderer Renderer_****})をセットします。 877 * 878 * @og.tag 879 * これは、plugin.column 以下の Renderer_**** クラスの **** を 880 * 与えます。これらは、CellRenderer インターフェースを継承したサブクラスです。 881 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellRenderer Renderer} を参照願います。 882 * {@og.doc03Link renderer Renderer_**** クラス} 883 * 884 * @param rdr カラムの表示用レンデラー(Renderer_**** の ****) 885 * @see org.opengion.hayabusa.db.CellRenderer 886 */ 887 public void setRenderer ( final String rdr ) { 888 renderer = nval( getRequestParameter( rdr ),renderer ); 889 } 890 891 /** 892 * 【TAG】カラムの編集用エディター({@og.doc03Link editor Editor_****})をセットします。 893 * 894 * @og.tag 895 * これは、plugin.column 以下の Editor_**** クラスの **** を 896 * 与えます。これらは、CellEditor インターフェースを継承したサブクラスです。 897 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellEditor Editor} を参照願います。 898 * {@og.doc03Link editor Editor_**** クラス} 899 * 900 * @param ed カラムの編集用エディター(Editor_**** の ****) 901 * @see org.opengion.hayabusa.db.CellEditor 902 */ 903 public void setEditor ( final String ed ) { 904 editor = nval( getRequestParameter( ed ),editor ); 905 } 906 907 /** 908 * 【TAG】DBタイプ({@og.doc03Link dbType DBType_****})をセットします。 909 * 910 * @og.tag 911 * これは、org.opengion.hayabusa.db.column 以下の DBType_**** クラスの **** を 912 * 与えます。これらは、DBType インターフェースを継承したサブクラスです。 913 * 属性クラス定義の {@link org.opengion.hayabusa.db.DBType DBType} を参照願います。 914 * {@og.doc03Link dbType DBType_**** クラス} 915 * 916 * @param dt パラメータ 917 * @see org.opengion.hayabusa.db.DBType DBType_**** の **** 918 */ 919 public void setDbType( final String dt ) { 920 dbType = nval( getRequestParameter( dt ),dbType ); 921 } 922 923 /** 924 * 【TAG】イベントカラム(親カラム)セット。 925 * 926 * @og.tag 927 * 親子関係を持った項目の動的な入れ替えを行う場合に利用します。 928 * このカラムを変化させるトリガとなるカラムの名前をセットします。 929 * 930 * この属性がセットされた場合、親カラムが変更都度子カラム(自身のカラム)が 931 * 再表示されます。 932 * 標準で再表示時に受け継がれる属性は以下の通りです。 933 * (1)editor・renderer 934 * (2)writable 935 * (3)addNoValue 936 * (4)class(must・mustAnyや、DBTypeを含みます) 937 * (5)style(optionAttributes等でセットしたもの) 938 * (6)size 939 * (7)maxlength 940 * これら以外に特殊な設定を行ったカラムに関しては、eventURL属性でカスタムの 941 * 置き換え用JSPを作成し、個別に対応して下さい。 942 * 943 * また、置き換えの定義は、param属性で定義します。 944 * param属性に定義されたSQL文の結果により、各種エディター、レンデラーによって、以下の 945 * ように置き換えが行われます。 946 * 947 * (1)DBMENUの場合 948 * paramに指定されたSQL文により動的にプルダウンを置き変えます。 949 * SQL文の{@XXXX}の記述により、その時点での親カラムの値を参照することができます。 950 * 951 * 例) SELECT A.CODE,B.LNAME FROM GEA04 A,GEA08 B 952 * WHERE A.CLM||'.'||A.CODE = B.CLM 953 * AND A.SYSTEM_ID = B.SYSTEM_ID 954 * AND A.CLM like 'KBSAKU%' 955 * AND B.LANG like '{@LANG}' ← name=LANGを持つ項目のその時点での値に変換される 956 * AND B.SYSTEM_ID = '**' 957 * 958 * (2)DBMENU以外の場合 959 * paramに指定されたSQL文により値(value値)を置き換えたカラムを作成し、置き換えます。 960 * DBMENUの場合と同様、SQL文の{@XXXX}の記述により、その時点での親カラムの値を参照することができます。 961 * 962 * 例) SELECT LABEL_NAME FROM GF41 963 * WHERE SYSTEM_ID='{@SYS.SYSTEM_ID}' AND CLM='{@CLM}' AND LANG='{@LANG}' 964 * 965 * なお、いずれの場合も、{@XXXX}の部分については、$1,$2...の形式でも記述することができます。 966 * この場合、$1は1番目のeventColumnのカラム、$2は2番目のeventColumnのカラムと指します。 967 * 968 * (注意点1)イベントカラムによるイベントは、画面表示時に1度実行されます。 969 * 但し、eventColumn属性で、カラム名の先頭に'_'をつけた場合、 970 * または親カラムの値がNULLの場合は実行されません。 971 * 972 * (注意点2)SQL文などのパラメーター中に記述された{@XXXX}の値の変換はJavaScriptにより行われるため、 973 * 値が取得できる項目は、"画面に書き込み可能状態で表示されているカラム"に限ります。 974 * テーブルモデル内の変数や表示のみの値については、ここでは利用することはできません。 975 * {@USER.XXXX}等の予約語に関しては、5.5.4.0以降では処理されます。 976 * 977 * (注意点3)現時点では、INMENU,INDBMENUについては、入れ替え後のJavaScriptが正常に動作しないため、 978 * イベントカラムが正常に動作しません。 979 * 980 * @og.rev 4.3.6.0 (2009/04/01) 981 * @og.rev 5.1.7.0 (2010/06/01) コメント大幅修正 982 * @param col 親カラム 983 */ 984 public void setEventColumn( final String col ) { 985 eventColumn = nval( getRequestParameter( col ), eventColumn ); 986 } 987 988 /** 989 * 【TAG】イベントURLのセット。 990 * 991 * @og.tag 992 * 初期値はシステムリソースのEVENT_COLUMN_URLです。 993 * イベントカラム指定時に部品を作成するJSPを指定します。 994 * (設定例:eventURL="makeColumn_custom.jsp") 995 * 996 * 置き換え対象のカラムに特殊な設定がされており、標準のカラム置き換えでは対応できない場合に、 997 * このURLを指定することで、個別に置き換え方法を定義する必要があります。 998 * 999 * なお、個別に置き換え方法を定義したJSPを作成する場合は、標準(jsp/common/eventColumnMaker.jsp)を 1000 * 参考にして作成して下さい。 1001 * 1002 * eventColumnから利用するJSPで利用可能なリクエスト変数 1003 * {@EC_CNAME} 子カラム名(一覧表示の場合でも行番号__nは付加されません) 1004 * {@EC_RENDERER} 子カラムのレンデラー 1005 * {@EC_EDITOR} 子カラムのエディター 1006 * {@EC_SQL} 子カラムのプルダウン、または値を出力するためのSQL文({@XXXX}をカラムのvalue値で置き換えたもの) 1007 * {@EC_WRITABLE} 子カラムが編集可能などうか 1008 * {@EC_CVALUE} 子カラムの現在の値 1009 * {@EC_NOVALUE} 子カラムの最上部Option値が空ならtrue。その他false(addNoValue属性値と同じです) 1010 * {@EC_CLASS} 子カラムのCLASS属性 1011 * {@EC_SIZE} 子カラムのSIZE属性 1012 * {@EC_MAXLENGTH} 子カラムのMAXLENGTH属性 1013 * {@EC_OPTATTRS} 子カラムのその他OPTION属性 1014 * {@EC_PNAMEE} 親カラム名(一覧表示の場合でも行番号__nは付加されません) 1015 * {@EC_PVALUE} 親カラムの現在の値 1016 * 1017 * @og.rev 4.3.6.0 (2009/04/01) 1018 * @og.rev 5.1.7.0 (2010/06/01) コメント大幅修正 1019 * @param url イベントURL 1020 */ 1021 public void setEventURL( final String url ) { 1022 eventURL = nval( getRequestParameter( url ), eventURL ); 1023 } 1024 1025 /** 1026 * 【TAG】パラメータをセットします。 1027 * 1028 * @og.tag 1029 * EditorParam等のパラメータを一括でセットします。 1030 * eventColumn利用時は{@XXXX}はリクエストパラメータではなく 1031 * xxxカラムの実際の値が利用されます。 1032 * 1033 * @og.rev 4.3.6.0 (2009/04/01) 1034 * @param prm パラメータ 1035 */ 1036 public void setParam( final String prm ) { 1037 param = nval( prm, param ); // ここでは{@XXXX}変換をしない 1038 } 1039 1040 /** 1041 * 【TAG】データベースへ接続する場合のID。 1042 * 1043 * @og.tag 1044 * データベース接続を使用するエディター、レンデラーを使用する場合に使用する接続先IDを指定します。 1045 * カラムオブジェクトは、query処理ではなく、view処理時に適用されるため、データベース 1046 * 接続先を指定する必要があります。 1047 * 初期値は、null(DEFAULT 接続) です。 1048 * 1049 * @og.rev 5.7.6.2 (2014/05/16) 新規追加 1050 * 1051 * @param id 接続先ID 1052 */ 1053 public void setDbid( final String id ) { 1054 dbid = nval( getRequestParameter( id ),dbid ); 1055 } 1056 1057 /** 1058 * 【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか[true/false]を設定します 1059 * (初期値:USE_XSS_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK}])。 1060 * 1061 * @og.tag 1062 * クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。 1063 * (><) が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。 1064 * (初期値:システム定数のUSE_XSS_CHECK[={@og.value org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK}])。 1065 * 1066 * @og.rev 5.1.7.0 (2010/06/01) 新規追加 1067 * 1068 * @param flag XSSチェック [true:する/false:しない] 1069 * @see org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK 1070 */ 1071 public void setXssCheck( final String flag ) { 1072 xssCheck = nval( getRequestParameter( flag ),xssCheck ); 1073 } 1074 1075 /** 1076 * 【TAG】MENU,DBMENUでSLABELを利用するかどうか[auto/true/false]を指定します(初期値:auto)。 1077 * 1078 * @og.tag 1079 * 通常はセレクトメニューは一覧とそれ以外で短縮ラベルの利用が自動で切り替わります。 1080 * 強制的にSLABELを利用させたい場合にこの属性をtrue/falseにセットして下さい。 1081 * 標準はauto(自動)です。 1082 * auto/true/false以外を指定した場合はfalse扱いとします。 1083 * 1084 * @og.rev 5.5.1.0 (2012/04/03) 1085 * @param prm [auto:自動/true:利用する/false:利用しない] 1086 */ 1087 public void setUseSLabel( final String prm ) { 1088 useSLabel = nval( getRequestParameter( prm ),useSLabel ); 1089 } 1090 1091 /** 1092 * 【TAG】eventColumn実行後のcallbak関数指定。 1093 * 1094 * @og.tag 1095 * eventColumnの動作終了後に実行するCallback関数の指定を行います。 1096 * 関数名のみを指定して下さい。 1097 * ex) sampleCallback()を実行する場合はeventCallback="sampleCallback" 1098 * 実行する関数の第一引数には自動的に次の要素が入った配列が渡されます 1099 * [0] 変更された子カラムのID属性値 1100 * [1] evnetColumn実行後の子カラムの値 1101 * [2] eventColumn実行前の子カラムの値 1102 * 1103 * この属性は、optionAttributesへの設定と同様の動作を行います。 1104 * 1105 * @og.rev 5.5.4.0 (2012/07/02) 新規追加 1106 * 1107 * @param callback callbak関数 1108 */ 1109 public void setEventCallback( final String callback ) { 1110 // optionAttributes扱いで登録します。 1111 if( callback != null && callback.length() > 0 ){ 1112 add( "optionAttributes", "eventCallback='"+getRequestParameter( callback )+"'" ); 1113 } 1114 } 1115 1116 /** 1117 * 【HTML5】表示形式を指定します(初期値:text)。 1118 * 1119 * @og.tag 1120 * ColumnTagは、カラムリソースで作成される為、タイプは固定です。 1121 * しかし、HTML5 で追加された形式には、有用なタイプも存在する為、 1122 * それらへの書き換えをできるようにします。 1123 * よって、ここでは、従来型のタイプへの書き換えはできません。 1124 * (textだけは例外で戻せるようにします)。 1125 * 1126 * [search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1127 * が、設定できます。 1128 * 1129 * HTML5 の機能を有効にするには、ネイティブモードで動作させる必要があります。 1130 * @ USE_IE7_HEADER = "false" に設定する。 1131 * A USE_HTML5_HEADER = "true" に設定する。 1132 * B IEのツール⇒互換表示設定で、互換表示に追加したWebサイトから削除する。 1133 * C 同上の設定で、イントラサイトを互換表示で表示するのチェックを外す。 1134 * 必要があります。 1135 * 1136 * <og:input type="text" /> テキストボックスを表示 1137 * 1138 * HTML5 で追加されたタイプ 1139 * <og:input type="search" /> 検索テキストの入力欄を作成する 1140 * <og:input type="tel" /> 電話番号の入力欄を作成する 1141 * <og:input type="url" /> URLの入力欄を作成する 1142 * <og:input type="email" /> メールアドレスの入力欄を作成する 1143 * <og:input type="datetime" /> UTC(協定世界時)による日時の入力欄を作成する 1144 * <og:input type="date" /> 日付の入力欄を作成する 1145 * <og:input type="month" /> 月の入力欄を作成する 1146 * <og:input type="week" /> 週の入力欄を作成する 1147 * <og:input type="time" /> 時間の入力欄を作成する 1148 * <og:input type="datetime-local" /> UTC(協定世界時)によらないローカル日時の入力欄を作成する 1149 * <og:input type="number" /> 数値の入力欄を作成する 1150 * <og:input type="range" /> レンジの入力欄を作成する 1151 * <og:input type="color" /> 色の入力欄を作成する 1152 * 1153 * @og.rev 5.7.1.0 (2013/12/06) HTML5 対応(新規追加) 1154 * 1155 * @param type HTML5用 [text/search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1156 */ 1157 public void setType( final String type ) { 1158 String tp = getRequestParameter( type ); 1159 1160 if( check( "|" + tp + "|" , CHECK_TYPE ) ) { 1161 set( "type",tp ); 1162 } 1163 else { 1164 String errMsg = "type 属性は、下記の中から選択してください。type=[" 1165 + tp + " in [" + CHECK_TYPE + "]"; 1166 throw new HybsSystemException( errMsg ); 1167 } 1168 } 1169 1170 /** 1171 * このオブジェクトの文字列表現を返します。 1172 * 基本的にデバッグ目的に使用します。 1173 * 1174 * @return このクラスの文字列表現 1175 */ 1176 @Override 1177 public String toString() { 1178 return org.opengion.fukurou.util.ToString.title( this.getClass().getName() ) 1179 .println( "VERSION" ,VERSION ) 1180 .println( "td_flag" ,td_flag ) 1181 .println( "addNoValue" ,addNoValue ) 1182 .println( "name" ,name ) 1183 .println( "value" ,value ) 1184 .println( "writable" ,writable ) 1185 .println( "defaultVal" ,defaultVal ) 1186 .println( "useDefVal" ,useDefVal ) 1187 .println( "colspan" ,colspan ) 1188 .println( "nextForm" ,nextForm ) 1189 .println( "useRequestValue" ,useRequestValue) 1190 .println( "vewSize" ,vewSize ) 1191 .println( "maxlength" ,maxlength ) 1192 .println( "codeName" ,codeName ) 1193 .println( "body" ,StringUtil.htmlFilter( body ) ) 1194 .println( "Other..." ,getAttributes().getAttribute() ) 1195 .fixForm().toString() ; 1196 } 1197}