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