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 java.util.Map; 019import java.util.Set; // 6.4.3.4 (2016/03/11) 020 021import org.opengion.fukurou.util.StringUtil; 022import org.opengion.fukurou.util.ToString; // 6.1.1.0 (2015/01/17) 023import org.opengion.fukurou.util.ArraySet; // 6.4.3.4 (2016/03/11) 024import org.opengion.hayabusa.common.HybsSystem; 025import org.opengion.hayabusa.common.HybsSystemException; 026import org.opengion.hayabusa.db.DBColumn; 027import org.opengion.hayabusa.db.DBColumnConfig; 028import org.opengion.hayabusa.db.DBTableModel; 029import org.opengion.hayabusa.resource.CodeData; 030import org.opengion.hayabusa.resource.LabelData; 031import static org.opengion.fukurou.util.StringUtil.nval; 032 033/** 034 * 検索結果のカラムに対して様々な属性を付加するタグです。 035 * 036 * このタグでは、カラムリソースの属性を再設定できます。検索結果(DBTableModel) 037 * には、カラムオブジェクト(DBColumn)を持っています。このオブジェクトは、 038 * カラムリソースで設定した値を持っています。その個々の値を再設定することで、 039 * カラムオブジェクトの属性をその都度設定しなおすことができます。 040 * 最もよく使用するのは、must 属性の設定と、DBMENU エディターの設定です。 041 * must属性は、予め必須項目として指定することが出来ない為、画面毎に再設定が 042 * 必要です。ただし、ここでのmust属性は、カラムの表示色を変更するだけで、 043 * 実際のnullチェックは、columnCheck タグのnullCheck属性で指定します。 044 * DBMENU エディターは、データベースの属性から選択リストを作成する機能ですが、 045 * これも、マスタ登録時は、テキストフィールドで入力し、使用時は、選択するケース 046 * の様に、画面毎に異なる形式で使用したい場合があるためです。 047 * このタグでは、カラムオブジェクトの属性以外に、HTMLの属性を付加する事も 048 * できます。 049 * 050 * 6.7.6.0 (2017/03/17) [strictCheck属性]は、カラムIDの存在チェックを行うかどうかを指定します(初期値:true) 051 * true カラムIDがDBTableModel に存在しない場合は、エラーになる。 052 * false カラムIDがDBTableModel に存在しない場合は、無視する。 053 * 054 * @og.formSample 055 * ●形式:<og:ColumnEditor column="・・・" ・・・ > ・・・ </og:ColumnEditor > 056 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) 057 * 058 * ●Tag定義: 059 * <og:columnEditor 060 * column 【TAG】カラム名をセットします 061 * columns 【TAG】カラム名をCSV形式で複数セットします 062 * label 【TAG】ラベルリソースに定義されたラベルIDをセットします 063 * className 【TAG】カラムのクラス名(VARCHAR2,NUMBER など)をセットします。既存値:設定値対応 064 * size 【HTML】カラムの入力枠サイズをセットします(大きさだけで入力文字制限ではありません) 065 * viewSize 【TAG】カラムの表示サイズ(横幅)を文字数でセットします。 066 * maxlength 【HTML】カラムの入力文字制限数をセットします 067 * writable 【TAG】カラムが書き込み可能かどうか[true/false]をセットします(初期値:null) 068 * renderer 【TAG】カラムの表示用レンデラー({@og.doc03Link renderer Renderer_****})をセットします。既存値:設定値対応 069 * editor 【TAG】カラムの編集用エディター({@og.doc03Link editor Editor_****})をセットします。既存値:設定値対応 070 * dbType 【TAG】DBタイプ({@og.doc03Link dbType DBType_****})をセットします。既存値:設定値対応 071 * codeName 【TAG】コードセレクトのユニークキー(コード名称)をセットします 072 * codeList 【TAG】コードセレクトのサブセットとなるコードをCSV形式で指定します 073 * codeGroup 【TAG】コードセレクトのサブセットとなるグループを指定します 074 * codeKeyVal 【TAG】新しいコードセレクトを作成する為の「キー:ラベル キー:ラベル」の文字列を指定します 075 * defaultVal 【TAG】初期値をセットします 076 * param 【TAG】パラメータをセットします 077 * roles 【TAG】ロールをセットします 078 * must 【TAG】必須入力を表す色に変えるかどうか[true/false]を指定します(初期値:false) 079 * mustAny 【TAG】選択必須入力(どれかひとつ必須)を表す色[true/mustAny/その他]を指定します(初期値:無指定) 080 * optionAttributes 【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します 081 * addNoValue 【TAG】セレクトメニューの値なしのOptionの有無[true/false]を指定します(初期値:falseと同等) 082 * addKeyLabel 【TAG】セレクトメニューの場合、キー:ラベル形式で表示するかどうか[true/false/null]を指定します(初期値:null) 083 * writeKeyLabel 【TAG】セレクトメニューの場合、キーとラベルを分けて出力するかどうか[true/false]を指定します(初期値:false) 084 * useLabelMap 【TAG】SQL文を指定してラベル情報を動的に読み込むかどうか[true/false]指定します(初期値:false) 085 * useSLabel 【TAG】MENU,DBMENUでSLABELを利用するかどうか[auto/true/false]を指定します(初期値:null) 086 * noDisplayVal 【TAG】指定の値を非表示にします(レンデラーのみ有効)(初期値:null) 087 * scope 【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session) 088 * tableId 【TAG】(通常は使いません)sessionから所得する DBTableModelオブジェクトの ID(初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}]) 089 * dbid 【TAG】(通常は使いません)データベースへ接続する場合のID(初期値:null) 090 * caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 091 * caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 092 * caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) 093 * caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) 094 * caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない) 095 * lang 【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します 096 * style 【HTML】この要素に対して適用させるスタイルシート(style)を設定します 097 * clazz 【HTML】要素に対して class 属性を設定します 098 * onClick 【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');") 099 * onChange 【HTML】JavaScriptのイベント onChange を設定します(例:onChange="renew('query.jsp','QUERY');") 100 * onBlur 【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();") 101 * onFocus 【HTML】JavaScriptのイベント onFocus を設定します 102 * ondblClick 【HTML】JavaScriptのイベント ondblClick を設定します 103 * onMouseDown 【HTML】JavaScriptのイベント onMouseDown を設定します 104 * onMouseUp 【HTML】JavaScriptのイベント onMouseUp を設定します 105 * onMouseMove 【HTML】JavaScriptのイベント onMouseMove を設定します 106 * onMouseOut 【HTML】JavaScriptのイベント onMouseOut を設定します 107 * onMouseOver 【HTML】JavaScriptのイベント onMouseOver を設定します 108 * onSelect 【HTML】JavaScriptのイベント onSelect を設定します 109 * onKeydown 【HTML】JavaScriptのイベント onKeydown を設定します 110 * onKeypress 【HTML】JavaScriptのイベント onKeypress を設定します 111 * onKeyup 【HTML】JavaScriptのイベント onKeyup を設定します 112 * autocomplete 【HTML5】入力候補を提示して入力内容を自動補完する[on/off](初期値はon)。 113 * autofocus 【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます。 114 * pattern 【HTML5】正規表現で入力値のパターンを指定します。 115 * placeholder 【HTML5】入力欄に初期表示する内容を指定します。 116 * required 【HTML5】入力必須を指定します 117 * list 【HTML5】ユーザーに入力候補として提案するデータリストの要素のid属性の値を指定します。 118 * min 【HTML5】入力欄で入力できる最小値を指定します。 119 * max 【HTML5】入力欄で入力できる最大値を指定します。 120 * step 【HTML5】入力欄で刻むステップ値を指定する。 121 * type 【HTML5】HTML5追加分[text/search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 122 * eventColumn 【TAG】イベントカラム(親カラム)のセット 123 * eventValue 【TAG】イベントValueのSQL分 124 * eventURL 【TAG】eventColumn利用時に呼ばれるJSPのURL 125 * eventCallback 【TAG】eventColumn実行後のcallbak関数指定を指定します 126 * noResource 【TAG】ResourceManager を使用しないかどうか[true/false]を指定します(初期値:false) 127 * strictCheck 【TAG】(通常は使いません)カラムIDの存在チェックを行うかどうか[true/false]を指定します(初期値:true) 128 * stringOutput 【TAG】レンデラ利用のExcel出力時にセルタイプを文字列にするかどうか(初期値:true) 129 * useRealTimeCheck 【TAG】(通常は使いません)リアルタイムチェックを行うかどうか(初期値:true:行う) 5.9.32.2 (2018/05/18) 130 * debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) 131 * > ... Body ... 132 * </og:columnEditor> 133 * 134 * ●使用例: 135 * ・必須表示の場合 136 * <og:columnEditor column="NOSYN" must="true" /> 137 * 138 * ・DBからのセレクトメニューの場合 139 * <og:columnEditor column="CDBK" editor="DBMENU"> 140 * select CDBK,CDBK||':'||NMBK from DB02 order by 1 141 * </og:columnEditor> 142 * 143 * ・親子関係のプルダウンを作る場合 144 * ({@xxx.value}で同じ行のxxxカラムで選択した値を取得します) 145 * <og:columnEditor column="CDBK" editor="DBMENU" 146 * eventColumn="OYA"> 147 * select CDBK,CDBK||':'||NMBK from DB02 148 * where CLM = {@OYA.value} order by 1 149 * </og:columnEditor> 150 * 151 * 152 * @og.rev 3.5.1.0 (2003/10/03) 親クラスをCommonTagSupportからHTMLTagSupportに変更。 153 * @og.group 画面表示 154 * 155 * @version 4.0 156 * @author Kazuhiko Hasegawa 157 * @since JDK5.0, 158 */ 159public class ColumnEditorTag extends HTMLTagSupport { 160 /** このプログラムのVERSION文字列を設定します。 {@value} */ 161 private static final String VERSION = "6.9.8.0 (2018/05/28)" ; 162 private static final long serialVersionUID = 698020180528L ; 163 164 // 5.7.1.0 (2013/12/06) HTML5 で新たに追加された、type を追加 165 // 6.3.4.0 (2015/08/01) String から String配列 に置き換え 166 167 // 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 168 private static final Set<String> TYPE_SET = new ArraySet<>( "text","search","tel","url","email","datetime","date","month","week","time","datetime-local","number","range","color" ); 169 170 private static final String DEFAULT_ADD_NO_VALUE= "true"; // 3.7.0.5 (2005/04/11) 171 172 private transient LabelData labelData ; 173 174 /** 6.4.3.1 (2016/02/12) 取得元が ConcurrentHashMap で返す。 */ 175 private transient Map<String,LabelData> labelMap ; // 6.3.9.0 (2015/11/06) transient 追加 176 177 private String tableId = HybsSystem.TBL_MDL_KEY; 178 private String[] columns ; // 3.7.0.5 (2005/04/11) 179 private boolean allColumns ; // 3.8.8.5 (2007/03/09) 180 private String className ; 181 private String fieldSize ; // 6.2.0.0 (2015/02/27) 182 private String viewSize ; // 6.2.0.0 (2015/02/27) viewSize 属性の追加 183 private String maxlength ; // 3.5.5.5 (2004/04/23) 184 private String writable ; 185 private String renderer ; 186 private String editor ; 187 private String dbType ; 188 private String codeName ; // 3.5.5.7 (2004/05/10) 189 private String codeList ; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 190 private String codeGroup ; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 191 private String codeKeyVal ; // 6.3.1.1 (2015/07/10) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 192 private String defaultVal ; 193 private String parameter ; 194 private String dbid ; 195 private String addNoValue ; // 3.5.5.9 (2004/06/07) 196 private String addKeyLabel ; // 6.0.4.0 (2014/11/28) キー:ラベル形式で表示するかどうか 197 private boolean writeKeyLabel ; // 6.2.3.0 (2015/05/01) 198 199 private String eventColumn ; // 4.3.6.0 (2009/04/01) イベントカラム 200 private String eventValue ; // 6.3.4.0 (2015/08/01) eventValue 追加 201 private String rawParameter ; // 4.3.6.0 (2009/04/01) 生パラメータ 202 private String eventURL ; // 4.3.6.0 (2009/04/01) イベントURL 203 204 // 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 205 private boolean useLabelMap ; // 4.3.4.0 (2008/12/01) 206 private String useSLabel ; // 5.6.2.3 (2013/03/22) MENU,DBMENUでSLABELを利用するかどうか 207 private String noDisplayVal ; // 5.6.2.3 (2013/03/22) 非表示文字の設定 208 209 // 5.7.3.0 (2014/02/07) ResourceManager を使用しないかどうか[true/false]を指定 210 private boolean noResource ; 211 private boolean strictCheck = true; // 6.7.6.0 (2017/03/17) カラムIDの存在チェックを行うかどうかを指定します。 212 213 private boolean stringOutput = HybsSystem.sysBool( "USE_STRING_EXCEL_OUTPUT" ); // 5.7.6.3 (2014/05/23) 214 215 /** 216 * デフォルトコンストラクター 217 * 218 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor. 219 */ 220 public ColumnEditorTag() { super(); } // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。 221 222 /** 223 * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。 224 * 225 * @og.rev 3.1.0.0 (2003/03/20) DBColumnConfig#getColumnConfig() メソッド廃止 226 * @og.rev 3.1.1.0 (2003/03/28) ボディの内容を取得する処理を、CommonTagSupport で行う。 227 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。ボディが存在する場合のみボディが呼ばれる対応。 228 * @og.rev 3.5.1.0 (2003/10/03) 親クラスをCommonTagSupportからHTMLTagSupportに変更。 229 * @og.rev 3.5.5.5 (2004/04/23) 入力欄の大きさを指定する viewSize 属性を追加。 230 * @og.rev 3.5.5.7 (2004/05/10) CodeSelection を、codeName を元に構築できるように設定します。 231 * @og.rev 3.5.5.9 (2004/06/07) addNoValue が、設定された場合のみ、config に設定します 232 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 233 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 234 * 235 * @return 後続処理の指示( EVAL_BODY_BUFFERED ) 236 */ 237 @Override 238 public int doStartTag() { 239 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 240 if( useTag() ) { 241 if( "DBMENU".equalsIgnoreCase(editor) ) { 242 className = "VARCHAR2"; 243 renderer = "DBMENU"; 244 editor = "DBMENU"; 245 246 if( addNoValue == null ) { 247 addNoValue = DEFAULT_ADD_NO_VALUE ; 248 } 249 } 250 251 return EVAL_BODY_BUFFERED ; 252 } 253 return SKIP_BODY ; // Body を評価しない 254 } 255 256 /** 257 * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。 258 * 259 * @og.rev 2.3.1.3 (2003/02/08) ラベル、サイズのみでも変更できるように修正 260 * @og.rev 3.0.0.1 (2003/02/14) DBMENU作成時に、ラベルの最後のスペースを除去する。 261 * @og.rev 3.1.0.0 (2003/03/20) DBColumnConfig#getColumnConfig() メソッド廃止 262 * @og.rev 3.1.1.0 (2003/03/28) ボディの内容を取得する処理を、CommonTagSupport で行う。 263 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。ボディが存在する場合のみボディが呼ばれる対応。 264 * @og.rev 3.5.0.0 (2003/09/17) キー、ラベルともに、""(ダブルコーテーション)で囲うように変更。 265 * @og.rev 3.5.5.7 (2004/05/10) このタグでSQLを発行するのではなく、DBMENU の DBColumnを作成する。 266 * @og.rev 3.5.5.9 (2004/06/07) addNoValue が null の場合は、初期値を設定します。 267 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 268 * @og.rev 3.8.6.3 (2006/11/30) SQL 文の前後のスペースを取り除きます。 269 * @og.rev 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 270 * @og.rev 4.3.6.0 (2009/04/01) イベントカラム対応 271 * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し 272 * @og.rev 5.5.4.0 (2012/07/02) 予約語対応 273 * @og.rev 6.3.1.1 (2015/07/10) BodyString,BodyRawStringは、CommonTagSupport で、trim() します。 274 * @og.rev 6.4.0.5 (2016/01/09) useLabelMap="true" 時のSQL文の実行は、dbid を使用して行う。 275 * 276 * @return 後続処理の指示(SKIP_BODY) 277 */ 278 @Override 279 public int doAfterBody() { 280 final String sql = getBodyString(); 281 if( sql != null && sql.length() > 0 ) { 282 if( useLabelMap ) { 283 // 6.4.0.5 (2016/01/09) useLabelMap="true" 時のSQL文の実行は、dbid を使用して行う。 284 labelMap = getResource().getLabelMap( sql.trim() , dbid ); // 4.3.4.0 (2008/12/01) 285 } 286 else { 287 if( eventColumn != null && eventColumn.length() >0 ){ // 4.3.6.0 (2009/04/01) 288 rawParameter = getReservedParameter( getBodyRawString() ); // 6.3.1.1 (2015/07/10) 289 } 290 parameter = sql.trim() ; 291 } 292 } 293 294 return SKIP_BODY ; 295 } 296 297 /** 298 * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。 299 * 300 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 301 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。ボディが存在する場合のみボディが呼ばれる対応。 302 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 303 * @og.rev 3.8.8.5 (2007/03/09) 全カラム が指定されたことにする allColumns 属性を追加 304 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 305 * @og.rev 4.3.4.0 (2008/12/01) カラム指定のワイルドカード対応 306 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属性の処理を、HTMLTagSupport に移します。 307 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 308 * @og.rev 6.7.6.0 (2017/03/17) strictCheck 追加。 309 * @og.rev 6.8.1.4 (2017/08/25) must="false"で、config.setEditorAttributes で、属性を追加するようになった為の取り消しの対応。 310 * 311 * @return 後続処理の指示 312 */ 313 @Override 314 public int doEndTag() { 315 debugPrint(); // 4.0.0 (2005/02/28) 316 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 317 if( !useTag() ) { return EVAL_PAGE; } 318 319 final DBTableModel table = (DBTableModel)getObject( tableId ); 320 if( table == null ) { return EVAL_PAGE; } 321 322 if( columns != null ) { 323 // 3.8.8.5 (2007/03/09) 全カラム が指定 324 final String mustType = getMustType(); // 5.2.1.0 (2010/10/01) 325 if( allColumns ) { 326 final int len = table.getColumnCount(); 327 for( int i=0; i<len; i++ ) { 328 329 // 4.3.4.0 (2008/12/01) 330 final DBColumn dbColumn = table.getDBColumn( i ); 331 for( int j=0; j<columns.length; j++ ) { 332 final String prefix = columns[j].replace( "*", "" ); 333 if( dbColumn.getName().indexOf( prefix ) == 0 ) { // 前方一致のみ対応 334 // 6.8.1.4 (2017/08/25) must="false"で、config.setEditorAttributes で、属性を追加するようになった為の取り消しの対応。 335 final DBColumnConfig config = getModifyConfig( dbColumn ); 336 337 // 4.1.2.1 (2008/03/13) 338 if( mustType != null ) { 339 table.addMustType( i,mustType ); 340 // 6.8.1.4 (2017/08/25) must="false" で、must の取り消し 341 if( "false".equalsIgnoreCase( mustType ) ) { 342 config.removeEditorAttributes( "class" , "must" ); 343 } 344 } 345 346 table.setDBColumn( i,new DBColumn( config ) ); 347 348 break; 349 } 350 } 351 } 352 } 353 else { 354 for( int i=0; i<columns.length; i++ ) { 355 final int clmNo = table.getColumnNo( columns[i],strictCheck ); // 6.7.6.0 (2017/03/17) 356 if( clmNo < 0 ) { continue; } // 6.7.6.0 (2017/03/17) 357 358 final DBColumn dbColumn = table.getDBColumn( clmNo ); 359 360 final DBColumnConfig config = getModifyConfig( dbColumn ); 361 // 6.8.1.4 (2017/08/25) must="false"で、config.setEditorAttributes で、属性を追加するようになった為の取り消しの対応。 362 363 // 4.1.2.1 (2008/03/13) 364 if( mustType != null ) { 365 table.addMustType( clmNo,mustType ); 366 // 6.8.1.4 (2017/08/25) must="false" で、must の取り消し 367 if( "false".equalsIgnoreCase( mustType ) ) { 368 config.removeEditorAttributes( "class" , "must" ); 369 } 370 } 371 372 table.setDBColumn( clmNo,new DBColumn( config ) ); 373 } 374 } 375 } 376 377 return EVAL_PAGE ; 378 } 379 380 /** 381 * タグ文字列を作成します。 382 * 383 * ColumnEditor としては、HTMLTagSupport を継承しているため、 384 * このメソッドを定義する必要がありますが、内部的には使用していません。 385 * 各種属性は、入力する必要がある為、継承しているだけです。 386 * このクラスでは、このメソッドは、使われておりません。 387 * 388 * @og.rev 3.5.1.0 (2003/10/03) 新規追加 389 * 390 * @return タグ文字列(常に null を返す) 391 */ 392 @Override 393 protected String makeTag() { 394 return null; 395 } 396 397 /** 398 * タグリブオブジェクトをリリースします。 399 * 400 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 401 * 402 * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 403 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 404 * @og.rev 3.5.1.0 (2003/10/03) 親クラスをCommonTagSupportからHTMLTagSupportに変更。 405 * @og.rev 3.5.5.5 (2004/04/23) 入力欄の大きさを指定する viewSize 属性を追加。 406 * @og.rev 3.5.5.7 (2004/05/10) codeName 属性を追加。 407 * @og.rev 3.5.5.9 (2004/06/07) addNoValue 属性を修正。 408 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 409 * @og.rev 3.8.8.5 (2007/03/09) 全カラム が指定されたことにする allColumns 属性を追加 410 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 411 * @og.rev 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 412 * @og.rev 5.1.9.0 (2010/08/01) codeList , codeGroup 属性を追加。(Codeリソースのサブセット) 413 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属性の処理を、HTMLTagSupport に移します。 414 * @og.rev 5.6.2.3 (2013/03/22) useSLabel 属性を追加。(MENU,DBMENUでSLABELを利用するかどうか) 415 * @og.rev 5.6.2.3 (2013/03/22) 非表示文字の設定。noDisplayVal 属性を追加。 416 * @og.rev 5.7.3.0 (2014/02/07) noResource 属性を追加。ResourceManager を使用しないかどうか 417 * @og.rev 5.7.6.3 (2014/05/23) stringOutput追加 418 * @og.rev 6.0.4.0 (2014/11/28) addKeyLabel 属性を追加 419 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 420 * @og.rev 6.2.3.0 (2015/05/01) キー,ラベルで分離して出力するかどうか。writeKeyLabel 属性を追加 421 * @og.rev 6.3.1.1 (2015/07/10) codeKeyVal 属性を追加 422 * @og.rev 6.3.4.0 (2015/08/01) eventValue 追加 423 * @og.rev 6.7.6.0 (2017/03/17) strictCheck 追加。 424 */ 425 @Override 426 protected void release2() { 427 super.release2(); 428 tableId = HybsSystem.TBL_MDL_KEY; 429 columns = null; // 3.7.0.5 (2005/04/11) 430 allColumns = false; // 3.8.8.5 (2007/03/09) 431 labelData = null; // 4.0.0 (2005/01/31) 432 className = null; 433 fieldSize = null; // 6.2.0.0 (2015/02/27) 434 viewSize = null; // 6.2.0.0 (2015/02/27) 435 maxlength = null; // 3.5.5.5 (2004/04/23) 436 writable = null; 437 renderer = null; 438 editor = null; 439 dbType = null; 440 codeName = null; // 3.5.5.7 (2004/05/10) 441 codeList = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 442 codeGroup = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 443 codeKeyVal = null; // 6.3.1.1 (2015/07/10) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 444 defaultVal = null; 445 parameter = null; 446 dbid = null; 447 addNoValue = null; // 3.5.5.9 (2004/06/07) 448 addKeyLabel = null; // 6.0.4.0 (2014/11/28) キー:ラベル形式で表示するかどうか 449 writeKeyLabel = false; // 6.2.3.0 (2015/05/01) キー,ラベルで分離して出力するかどうか 450 useLabelMap = false; // 4.3.4.0 (2008/12/01) 451 useSLabel = null; // 5.6.2.3 (2013/03/22) MENU,DBMENUでSLABELを利用するかどうか 452 noDisplayVal = null; // 5.6.2.3 (2013/03/22) 非表示文字の設定 453 labelMap = null; // 4.3.4.0 (2008/12/01) 454 eventColumn = null; // 4.3.6.0 (2009/04/01) 455 eventValue = null; // 6.3.4.0 (2015/08/01) 456 rawParameter = null; // 4.3.6.0 (2009/04/01) 457 eventURL = null; // 4.3.6.0 (2009/04/01) 458 noResource = false; // 5.7.3.0 (2014/02/07) noResource 属性を追加。 459 strictCheck = true; // 6.7.6.0 (2017/03/17) 460 stringOutput = HybsSystem.sysBool( "USE_STRING_EXCEL_OUTPUT" ); // 5.7.6.3 (2014/05/23) 461 } 462 463 /** 464 * カスタマイズされた DBColumnConfig を作成します。 465 * 466 * DBColumnConfig は、DBColumn より取得します。この DBColumnConfig に、 467 * 属性で指定された値をセットすることで、カスタマイズを行います。 468 * 469 * @og.rev 3.7.0.5 (2005/04/11) 新規追加 470 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 471 * @og.rev 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 472 * @og.rev 4.3.6.0 (2009/04/01) evnetColumn対応 473 * @og.rev 5.1.8.0 (2010/07/01) メソッド名変更(setDefValue ⇒ setDefault) 474 * @og.rev 5.1.9.0 (2010/08/01) codeList ,codeGroup 属性を追加(Codeリソースのサブセット) 475 * @og.rev 5.6.2.3 (2013/03/22) useSLabel 属性を追加。(MENU,DBMENUでSLABELを利用するかどうか) 476 * @og.rev 5.6.2.3 (2013/03/22) 非表示文字の設定。noDisplayVal 属性を追加。 477 * @og.rev 5.7.3.0 (2014/02/07) noResource 属性を追加。ResourceManager を使用しないかどうか 478 * @og.rev 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合の処理 479 * @og.rev 5.7.6.3 (2014/05/23) stringOutput追加 480 * @og.rev 6.0.4.0 (2014/11/28) addKeyLabel 属性を追加 481 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 482 * @og.rev 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 483 * @og.rev 6.3.1.0 (2015/06/28) 個人リソースのUSE_ADD_KEY_LABELで初期値設定 484 * @og.rev 6.3.1.1 (2015/07/10) codeKeyVal 属性を追加 485 * @og.rev 6.3.4.0 (2015/08/01) eventValue 追加 486 * @og.rev 5.9.18.1 (2017/03/24) DATALIST_R用のIEのHTML5機能が無効の場合の処理を追加 487 * 488 * @param dbColumn カラムオブジェクト 489 * 490 * @return カスタマイズされた DBColumnConfig 491 */ 492 private DBColumnConfig getModifyConfig( final DBColumn dbColumn ) { 493 // 5.7.3.0 (2014/02/07) noResource 属性を追加 494 if( noResource ) { 495 labelData = new LabelData( dbColumn.getName() ); 496 renderer = "LABEL"; 497 } 498 499 final DBColumnConfig config = dbColumn.getConfig(); 500 501 // 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合の処理 502 final String ieHTML5 = (String)getSessionAttribute( HybsSystem.IE_HTML5_KEY ); 503 if( "FALSE".equalsIgnoreCase( ieHTML5 ) ) { 504 if( "DATALIST".equalsIgnoreCase( editor ) || 505 "DATALIST".equalsIgnoreCase( config.getEditor() ) ) { 506 editor = "INDBMENU"; 507 } 508 // 5.9.18.1 (2017/03/24) IEのHTML5機能が無効の場合の処理(DATALIST_R用) 509 if( "DATALIST_R".equalsIgnoreCase( editor ) || 510 "DATALIST_R".equalsIgnoreCase( config.getEditor() )){ 511 editor = "INMENU"; 512 } 513 } 514 515 // 6.3.1.0 (2015/06/28) 個人リソースのUSE_ADD_KEY_LABELで初期値設定 516 if( addKeyLabel == null ) { addKeyLabel = nval( sys( "USE_ADD_KEY_LABEL" ) , null ); } // 4:個人設定可 517 518 final String lang = get( "lang" ); // 4.0.0 (2005/01/31) super クラスで受けます。 519 520 if( lang != null ) { config.setLang( lang ); } 521 if( labelData != null ) { config.setLabelData( labelData ); } // 4.0.0 (2005/01/31) 522 if( className != null ) { config.setClassName( className ); } 523 if( fieldSize != null ) { config.setFieldSize( fieldSize ); } // 6.2.0.0 (2015/02/27) メソッド名変更 524 if( viewSize != null ) { config.setViewLength( viewSize ); } // 6.2.0.0 (2015/02/27) 新規追加 525 if( maxlength != null ) { config.setMaxlength( maxlength ); } // 3.5.5.5 (2004/04/23) 526 if( writable != null ) { config.setWritable( writable ); } 527 if( renderer != null ) { config.setRenderer( renderer ); } 528 if( editor != null ) { config.setEditor( editor ); } 529 if( dbType != null ) { config.setDbType( dbType ); } 530 if( defaultVal != null ) { config.setDefault( defaultVal ); } // 5.1.8.0 (2010/07/01) 531 if( parameter != null ) { config.setParameter( parameter ); } 532 if( dbid != null ) { config.setDbid( dbid ); } 533 if( eventColumn != null ) { config.setEventColumn( eventColumn ); } // 4.3.6.0 (2009/04/01) 534 if( eventValue != null ) { config.setEventValue( eventValue ); } // 6.3.4.0 (2015/08/01) 535 if( eventURL != null ) { config.setEventURL( eventURL ); } // 4.3.6.0 (2009/04/01) 536 if( rawParameter != null ){ config.setRawParameter( rawParameter ); } // 4.3.6.0 (2009/04/01) 537 if( useSLabel != null ) { config.setUseSLabel( useSLabel ); } // 5.6.2.3 (2013/03/22) 538 if( noDisplayVal != null ) { config.setNoDisplayVal( noDisplayVal ); } // 5.6.2.3 (2013/03/22) 539 if( addKeyLabel != null ) { config.setAddKeyLabel( addKeyLabel ); } // 6.0.4.0 (2014/11/28) 540 541 if( writeKeyLabel ) { config.setWriteKeyLabel( writeKeyLabel ); } // 6.2.3.0 (2015/05/01) 542 543 // 4.0.0 (2005/11/30) ロールを指定 544 final String roles = get( "roles" ); 545 if( roles != null ) { config.setRoles( roles ); } 546 547 // 4.0.0 (2005/01/31) 548 if( codeName != null ) { 549 final CodeData codeData = getResource().getCodeData( codeName ) ; 550 config.setCodeData( codeData ); 551 } 552 553 // codeName で指定のリソースでも、サブセットが作成できます。 554 // 5.1.9.0 (2010/08/01) codeList 属性を追加(Codeリソースのサブセット) 555 if( codeList != null ) { 556 final CodeData codeData = config.getCodeData() ; 557 if( codeData != null ) { 558 config.setCodeData( codeData.subsetList( codeList ) ); 559 } 560 } 561 562 // 5.1.9.0 (2010/08/01) codeGroup 属性を追加(Codeリソースのサブセット) 563 if( codeGroup != null ) { 564 final CodeData codeData = config.getCodeData() ; 565 if( codeData != null && codeData.useGroup() ) { 566 config.setCodeData( codeData.subsetGroup( codeGroup ) ); 567 } 568 } 569 570 // 6.3.1.1 (2015/07/10) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 571 if( codeKeyVal != null ) { 572 config.setParameter( codeKeyVal ); 573 config.setRenderer( "KVMENU" ); 574 config.setEditor( "KVMENU" ); 575 } 576 577 // 3.5.5.9 (2004/06/07) 578 // 注意:addNoValue は、互換性の関係で、値が指定された場合のみ、 579 // config に設定します。 580 // editor="DBMENU" が、指定された場合は、addNoValue が指定されていない場合のみ、 581 // 従来との互換性の関係より、このクラスのデフォルト(true)を、config に設定します。 582 if( addNoValue != null ) { 583 // Boolean.parseBoolean は、引数がnullの場合は、falseを返すが、値が設定されている時のみセットするので、nullチェックしている。 584 config.setAddNoValue( Boolean.parseBoolean( addNoValue ) ); // 6.1.0.0 (2014/12/26) refactoring 585 } 586 587 // 3.5.1.0 (2003/10/03) 親クラスをCommonTagSupportからHTMLTagSupportに変更。 588 config.setEditorAttributes( getAttributes() ); 589 590 // 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 591 if( useLabelMap && labelMap != null ) { 592 final LabelData ldata = labelMap.get( dbColumn.getName() ); 593 if( ldata != null ) { 594 config.setLabelData( ldata ); 595 } 596 } 597 598 // 5.7.6.3 (2014/05/23) 599 config.setStringOutput( stringOutput ); 600 601 return config ; 602 } 603 604 /** 605 * 【TAG】カラム名をセットします。 606 * 607 * @og.tag 608 * カラム名をセットします。 609 * columns と同時にはセットできません。 610 * 値に"*"を指定することで、全カラムを対象とすることができます。 611 * また、"PN*,CDK*"等のように前方一致でのワイルドカード指定も可能です。 612 * 613 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 614 * @og.rev 3.8.8.5 (2007/03/09) 全カラム が指定されたことにする allColumns 属性を追加 615 * 616 * @param clm ネーム 617 */ 618 public void setColumn( final String clm ) { 619 if( columns != null ) { 620 final String errMsg = "columns との同時セットは出来ません。: " + CR 621 + "column=[" + clm + "] , " 622 + "columns=[" + StringUtil.array2csv( columns ) + "]"; 623 throw new HybsSystemException( errMsg ); 624 } 625 final String column = getRequestParameter( clm ); 626 if( column != null && column.length() > 0 ) { 627 columns = new String[] { column }; 628 allColumns = column.indexOf( '*' ) >= 0 ; // 3.8.8.5 (2007/03/09) 629 } 630 } 631 632 /** 633 * 【TAG】カラム名をCSV形式で複数セットします。 634 * 635 * @og.tag 636 * カラム名をセットします。 637 * column と同時にはセットできません。 638 * 分解方法は、通常のパラメータ取得後に、CSV分解します。 639 * 値に"*"を指定することで、全カラムを対象とすることができます。 640 * また、"PN*,CDK*"等のように前方一致でのワイルドカード指定も可能です。 641 * 642 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 643 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 644 * @og.rev 3.8.8.5 (2007/03/09) 全カラム が指定されたことにする allColumns 属性を追加 645 * 646 * @param clms カラム名(CSV形式) 647 */ 648 public void setColumns( final String clms ) { 649 if( columns != null ) { 650 final String errMsg = "column との同時セットは出来ません。: " + CR 651 + "column=[" + StringUtil.array2csv( columns ) + "] , " 652 + "columns=[" + clms + "]" ; 653 throw new HybsSystemException( errMsg ); 654 } 655 final String column = nval( getRequestParameter( clms ),null ); 656 if( column != null ) { 657 allColumns = column.indexOf( '*' ) >= 0 ; // 3.8.8.5 (2007/03/09) 658 columns = StringUtil.csv2Array( column ); 659 if( columns.length == 0 ) { columns = null; } 660 } 661 } 662 663 /** 664 * 【TAG】ラベルリソースに定義されたラベルIDをセットします。 665 * 666 * @og.tag 667 * ラベルをセットします。 668 * 669 * @og.rev 2.3.1.2 (2003/01/28) ラベルリソースからラベル名を取得するように修正 670 * @og.rev 4.0.0.0 (2005/01/31) キーより、ラベルデータオブジェクトを取得します。 671 * 672 * @param lbl ラベル 673 */ 674 public void setLabel( final String lbl ) { 675 labelData = getResource().getLabelData( getRequestParameter( lbl ) ) ; // 4.0.0 (2005/01/31) 676 } 677 678 /** 679 * 【TAG】カラムのクラス名(VARCHAR2,NUMBER など)をセットします。 680 * 681 * @og.tag 682 * カラムのクラス名をセットします。 683 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 684 * 685 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 686 * 687 * @param cls クラス 688 */ 689 public void setClassName ( final String cls ) { 690 className = nval( getRequestParameter( cls ),className ); 691 } 692 693 /** 694 * 【HTML】最大入力文字数を指定します(入力可能文字数で、バイト数ではありません)。 695 * 696 * @og.tag 697 * カラムの入力文字制限数をセットします。 698 * 699 * @og.rev 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 700 * 701 * @param len 入力文字制限数 702 */ 703 public void setMaxlength( final String len ) { 704 maxlength = nval( getRequestParameter( len ),maxlength ); 705 706 // 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 707 if( "0".equals( maxlength ) ) { set( "NO_MAXLEN", "true" ); } 708 } 709 710 /** 711 * 【TAG】カラムの入力枠サイズ(横幅)を文字数でセットします(入力文字制限ではありません)。 712 * 713 * @og.tag 714 * カラムのサイズをセットします。 715 * 716 * @og.rev 3.5.5.5 (2004/04/23) 入力欄の大きさを指定する viewSize 属性を追加。 717 * 718 * @param siz サイズ 719 */ 720 public void setSize( final String siz ) { 721 fieldSize = nval( getRequestParameter( siz ),null ); // 6.2.0.0 (2015/02/27) 722 } 723 724 /** 725 * 【TAG】カラムの表示サイズ(横幅)を文字数でセットします。 726 * 727 * @og.tag 728 * 入力枠ではなく、表示する時の文字数制限に使われます。 729 * maxLength は、DB上の桁数(バイト数)ですが、viewSize は、文字数です。 730 * SLABEL の簡易バイト数計算(全角2Byte)でもなく、文字数計算になります。 731 * 732 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 733 * 734 * @param len 表示サイズ(横幅) 735 */ 736 public void setViewSize( final String len ) { 737 viewSize = nval( getRequestParameter( len ),null ); 738 } 739 740 /** 741 * 【TAG】カラムが書き込み可能かどうか[true:可能/false:不可]を設定します(初期値:null)。 742 * 743 * @og.tag 744 * カラムの書き込み可能を設定します。 745 * 初期値は、null:無指定 です。 746 * 747 * @param flag 書き込み許可 [true:許可/false:不可] 748 */ 749 public void setWritable ( final String flag ) { 750 writable = nval( getRequestParameter( flag ),writable ); 751 } 752 753 /** 754 * 【TAG】カラムの表示用レンデラー({@og.doc03Link renderer Renderer_****})をセットします。 755 * 756 * @og.tag 757 * これは、plugin.column 以下の Renderer_**** クラスの **** を与えます。 758 * これらは、CellRenderer インターフェースを継承したサブクラスです。 759 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellRenderer Renderer} を参照願います。 760 * {@og.doc03Link renderer Renderer_**** クラス} 761 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 762 * 763 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 764 * 765 * @param rdr 表示用レンデラー (Renderer_**** の ****) 766 * @see org.opengion.hayabusa.db.CellRenderer 767 */ 768 public void setRenderer ( final String rdr ) { 769 renderer = nval( getRequestParameter( rdr ),renderer ); 770 } 771 772 /** 773 * 【TAG】カラムの編集用エディター({@og.doc03Link editor Editor_****})をセットします。 774 * 775 * @og.tag 776 * これは、plugin.column 以下の Editor_**** クラスの **** を 777 * 与えます。これらは、CellEditor インターフェースを継承したサブクラスです。 778 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellEditor Editor} を参照願います。 779 * {@og.doc03Link editor Editor_**** クラス} 780 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 781 * 782 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 783 * 784 * @param ed 編集用エディター (Editor_**** の ****) 785 * @see org.opengion.hayabusa.db.CellEditor 786 */ 787 public void setEditor ( final String ed ) { 788 editor = nval( getRequestParameter( ed ),editor ); 789 } 790 791 /** 792 * 【TAG】DBタイプ({@og.doc03Link dbType DBType_****})をセットします。 793 * 794 * @og.tag 795 * これは、org.opengion.hayabusa.db.column 以下の DBType_**** クラスの **** を 796 * 与えます。これらは、DBType インターフェースを継承したサブクラスです。 797 * 属性クラス定義の {@link org.opengion.hayabusa.db.DBType DBType} を参照願います。 798 * {@og.doc03Link dbType DBType_**** クラス} 799 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 800 * 801 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 802 * 803 * @param dt パラメータ 804 * @see org.opengion.hayabusa.db.DBType DBType_**** の **** 805 */ 806 public void setDbType( final String dt ) { 807 dbType = nval( getRequestParameter( dt ),dbType ); 808 } 809 810 /** 811 * 【TAG】コードセレクトのユニークキー(コード名称)をセットします。 812 * 813 * @og.tag 814 * このキーを元に、CodeSelectionオブジェクトを構築します。 815 * 816 * @og.rev 3.5.5.7 (2004/05/10) 新規作成 817 * 818 * @param name メニューのユニークキー(コード名称) 819 */ 820 public void setCodeName( final String name ) { 821 codeName = nval( getRequestParameter( name ),codeName ); 822 } 823 824 /** 825 * 【TAG】コードセレクトのサブセットとなるコード(キー)をCSV形式で指定します。 826 * 827 * @og.tag 828 * この値に限定された、コードリソースを、既存の、CodeData の 829 * サブセットとして作成します。 830 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 831 * ここで指定するのは、コード(キー)だけです。 832 * 833 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 834 * 835 * @param list コードセレクトのサブセットとなるコード(キー) 836 */ 837 public void setCodeList( final String list ) { 838 codeList = nval( getRequestParameter( list ),codeList ); 839 } 840 841 /** 842 * 【TAG】コードセレクトのサブセットとなるグループを指定します。 843 * 844 * @og.tag 845 * この値に限定された、コードリソースを、既存の、CodeData の 846 * サブセットとして作成します。 847 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 848 * 849 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 850 * 851 * @param group コードセレクトのサブセットとなるグループ 852 */ 853 public void setCodeGroup( final String group ) { 854 codeGroup = nval( getRequestParameter( group ),codeGroup ); 855 } 856 857 /** 858 * 【TAG】新しいコードセレクトを作成する為の「キー:ラベル キー:ラベル」の文字列を指定します。 859 * 860 * @og.tag 861 * 既存の、CodeData には存在しない、新しいコードリソースを作成する為の、文字列を指定します。 862 * 文字列は、「キー:ラベル キー:ラベル」形式で、スペースで分解後、":" でキーとラベルに分離します。 863 * スペース分解後の文字列に、":" が含まれていない場合は、キーをラベルとして扱います。 864 * また、ラベル部分は、ラベルリソースを使用して、変換を行います。 865 * 内部的には、CodeData を作成しません。DBColumnオブジェクト内で、直接、Selection_KEYVAL を生成します。 866 * codeName 、codeList、codeGroup などが指定された場合は、そちらが優先されます。 867 * 「キー:ラベル キー:ラベル」で、ラベル にスペースを含ませる場合は、ダブルクォーテーションで囲ってください。 868 * 「"キー:ラベル" "キー:ラベル"」という感じです。 869 * 870 * ※ editor,renderer を、"KVMENU" にして、param に、「キー:ラベル キー:ラベル」 871 * の文字列を指定する方法の、簡易版です。 872 * 873 * @og.rev 6.3.1.1 (2015/07/10) codeKeyVal 属性を追加 874 * 875 * @param keyval KEY:VAL文字列 876 */ 877 public void setCodeKeyVal( final String keyval ) { 878 codeKeyVal = nval( getRequestParameter( keyval ),codeKeyVal ); 879 } 880 881 /** 882 * 【TAG】パラメータをセットします。 883 * 884 * @og.tag 885 * ここで指定したパラメータは、renderer、editor、dbType すべてのパラメータに 886 * セットされます。 887 * パラメータをセットします。 888 * 889 * @og.rev 5.6.4.3 (2013/05/24) 新規追加 890 * 891 * @param prm パラメータ 892 */ 893 public void setParam( final String prm ) { 894 parameter = nval( getRequestParameter( prm ),parameter ); 895 rawParameter = nval( prm, parameter ); 896 } 897 898 /** 899 * 【TAG】value属性に値がセットされていないとき使用する、初期値を指定します。 900 * 901 * @og.tag 902 * value属性に値がセットされていないときに、この初期値を使用します。 903 * 904 * @param dv 初期値 905 */ 906 public void setDefaultVal( final String dv ) { 907 defaultVal = nval( getRequestParameter( dv ),defaultVal ); 908 } 909 910 /** 911 * 【TAG】セレクトメニューの値なしのOptionの有無[true/false]を指定します(初期値:falseと同等)。 912 * 913 * @og.tag 914 * セレクトメニューの場合、値なしのOptionをSelectに含めるかどうかを指定します。 915 * ここでは、検索結果の登録画面に使用されるケースが多いため、なにも指定されない 916 * 場合は、なにもセットしません。(Coderesourceの指定どおり) 917 * 動作としては、初期値は、含めない("false") と同等です。 918 * 919 * <og:columnEditor column="CDBK" addNoValue="false" /> 920 * 921 * @param flag 値なしのOptionの有無 [true:含める/それ以外:含めない] 922 */ 923 public void setAddNoValue( final String flag ) { 924 addNoValue = nval( getRequestParameter( flag ),addNoValue ); 925 } 926 927 /** 928 * 【TAG】セレクトメニューの場合、キー:ラベル形式で表示するかどうか[true/false/null]を指定します(初期値:null)。 929 * 930 * @og.tag 931 * カラムがプルダウンメニュー形式の場合、キー:ラベル形式で表示するか、ラベルだけで表示するかを 932 * 選択できます。 933 * true を指定すると、「強制的に」キー:ラベル形式で表示します。 934 * false の場合は、「強制的に」ラベルのみで表示されます。 935 * 初期値の null の場合、コードリソースや、SQL文に準拠した指定通りの形式で表示します。 936 * 937 * <og:column name="CDC" addKeyLabel="true" /> 938 * 939 * @og.rev 6.0.4.0 (2014/11/28) キー:ラベル形式で表示するかどうか。新規追加 940 * 941 * @param flag キー:ラベル形式表示 [true:キー:ラベル形式/false:ラベルのみ/null:指定通り] 942 */ 943 public void setAddKeyLabel( final String flag ) { 944 addKeyLabel = nval( getRequestParameter( flag ),addKeyLabel ); 945 } 946 947 /** 948 * 【TAG】セレクトメニューの場合、キーとラベルを分けて出力するかどうか[true/false]を指定します(初期値:false)。 949 * 950 * @og.tag 951 * カラムがプルダウンメニュー形式の場合、ファイル出力時に、キーとラベルを分離して出力する事ができます。 952 * この属性と、addKeyLabel とは、微妙に関連していて、addKeyLabel="true" のみの場合は、 953 * キー:ラベル形式で、出力されますが、writeKeyLabel="true" も指定されている場合は、こちらが優先されます。 954 * なお、この指定が有効なのは、セレクトメニューのカラムのみです。 955 * 初期値は、false です。 956 * 957 * @og.rev 6.2.3.0 (2015/05/01) キー/ラベルで分離して出力するかどうか。 958 * 959 * @param flag キー/ラベル分離出力するかどうか [true:分離出力/false:通常] 960 */ 961 public void setWriteKeyLabel( final String flag ) { 962 writeKeyLabel = nval( getRequestParameter( flag ),writeKeyLabel ); 963 } 964 965 /** 966 * 【TAG】SQL文を指定してラベル情報を動的に読み込むかどうか[true/false]指定します(初期値:false)。 967 * 968 * @og.tag 969 * trueを指定すると、body部分に記述されたSQL文よりラベル情報を生成して、 970 * 動的にラベル表示を切り替えます。 971 * 972 * ワイルドカードを使用した、カラムの複数指定と組み合わせることで、外部から設定 973 * されたラベル情報で一括で変更することができます。 974 * 975 * 発行するクエリでは、第1カラムにラベルキーを、第2カラムにラベル名称を設定します。 976 * 第3カラムが存在する場合は、名称(短)として使用されます。(必須ではありません) 977 * 978 * ここで作成されたラベル情報は、カラムエディターを適用したDBTableModelのみで 979 * 有効であり、内部的にもキャッシュされません。 980 * 981 * 初期値は、false(動的読込しない)です。 982 * 983 * @og.rev 4.3.4.0 (2008/12/01) 新規作成 984 * 985 * @param flag 動的読込 [true:する/false:しない] 986 */ 987 public void setUseLabelMap( final String flag ) { 988 useLabelMap = nval( getRequestParameter( flag ),useLabelMap ); 989 } 990 991 /** 992 * 【TAG】MENU,DBMENUでSLABELを利用するかどうか[auto/true/false]を指定します(初期値:null)。 993 * 994 * @og.tag 995 * 通常はセレクトメニューは一覧とそれ以外で短縮ラベルの利用が自動で切り替わります。 996 * 強制的にSLABELを利用させたい場合にこの属性をtrueにセットして下さい。 997 * auto/true/false以外を指定した場合はfalse扱いとします。 998 * ここでの初期値は、値の変更を行わないということで、null です。 999 * 1000 * @og.rev 5.6.2.3 (2013/03/22) columnタグに実装されているので移植 1001 * 1002 * @param prm SLABEL利用 [auto:自動/true:利用する/false:利用しない] 1003 */ 1004 public void setUseSLabel( final String prm ) { 1005 useSLabel = nval( getRequestParameter( prm ),useSLabel ); 1006 if( useSLabel != null && 1007 !"auto".equalsIgnoreCase( useSLabel ) && 1008 !"true".equalsIgnoreCase( useSLabel ) && 1009 !"false".equalsIgnoreCase( useSLabel ) ) { 1010 final String errMsg = "useSLabel は、[auto:自動/true:利用する/false:利用しない] から選んでください。" 1011 + "useSLabel=[" + prm + "]" + CR ; 1012 throw new HybsSystemException( errMsg ); 1013 } 1014 } 1015 1016 /** 1017 * 【TAG】非表示文字列を指定します(初期値:null)。 1018 * 1019 * @og.tag 1020 * これは、例えば、数字型の場合は、0 がデフォルトなどの場合、 1021 * あえて表示したくないなどのケースに使います。 1022 * そのような状況が設定されていない場合は、null が返されます。 1023 * 初期値は、null です。 1024 * 1025 * @og.rev 5.6.2.3 (2013/03/22) 新規追加 1026 * 1027 * @param prm 非表示文字列 [auto:自動/true:利用する/false:利用しない] 1028 */ 1029 public void setNoDisplayVal( final String prm ) { 1030 noDisplayVal = nval( getRequestParameter( prm ),noDisplayVal ); 1031 } 1032 1033 /** 1034 * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します 1035 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。 1036 * 1037 * @og.tag 1038 * 検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に 1039 * 渡す場合に、通常は、session を利用します。その場合の登録キーです。 1040 * query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、 1041 * この tableId 属性を利用して、メモリ空間を分けます。 1042 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。 1043 * 1044 * @param id テーブルID (sessionに登録する時のID) 1045 */ 1046 public void setTableId( final String id ) { 1047 tableId = nval( getRequestParameter( id ),tableId ); 1048 } 1049 1050 /** 1051 * 【TAG】データベースへ接続する場合のID(初期値:null)。 1052 * 1053 * @og.tag 1054 * データベース接続を使用するエディター、レンデラーを使用する場合に使用する接続先IDを指定します。 1055 * カラムオブジェクトは、query処理ではなく、view処理時に適用されるため、データベース 1056 * 接続先を指定する必要があります。 1057 * 初期値は、null(DEFAULT 接続) です。 1058 * 1059 * @og.rev 4.0.0.0 (2006/04/02) 新規追加 1060 * 1061 * @param id 接続先ID 1062 */ 1063 public void setDbid( final String id ) { 1064 dbid = nval( getRequestParameter( id ),dbid ); 1065 } 1066 1067 /** 1068 * 【TAG】イベントカラム(親カラム)を設定します。 1069 * 1070 * @og.tag 1071 * 親子関係を持った項目の動的な入れ替えを行う場合に利用します。 1072 * このカラムを変化させるトリガとなるカラムの名前をセットします。 1073 * 1074 * ※詳細はcolumnTagのeventURL属性の説明をご覧下さい。 1075 * 1076 * なお、columnEditorで、Viewに対して、SQL文の定義(置き換え定義)をする場合でも、 1077 * 他カラムの値の参照は、columnタグの場合と同様に、{@XXXX}または$nの変数により行います。 1078 * この場合、これらの変数は、"自身と同一行のカラム"を意味します。 1079 * 1080 * @og.rev 4.3.6.0 (2009/04/01) 1081 * @og.rev 5.1.7.0 (2010/06/01) コメント大幅修正 1082 * 1083 * @param col 親カラム 1084 */ 1085 public void setEventColumn( final String col ) { 1086 eventColumn = nval( getRequestParameter( col ), eventColumn ); 1087 } 1088 1089 /** 1090 * 【TAG】eventColumn使用時の値を、SQL文から求めるためのqueryをセットします。 1091 * 1092 * @og.tag 1093 * eventColumn利用時は{@XXXX}はリクエストパラメータではなく 1094 * xxxカラムの実際の値が利用されます。 1095 * 1096 * @og.rev 6.3.4.0 (2015/08/01) eventValue 追加 1097 * @param val パラメータ 1098 */ 1099 public void setEventValue( final String val ) { 1100 eventValue = nval( getReservedParameter( val ), eventValue ); // ここでは{@XXXX}変換をしない 1101 } 1102 1103 /** 1104 * 【TAG】イベントカラム指定時に呼び出すURLを指定します。 1105 * 1106 * @og.tag 1107 * イベントカラム指定時に部品を作成するJSPを指定します。 1108 * 初期値はシステムリソースのEVENT_COLUMN_URLです。 1109 * (例:eventURL="makeColumn_custom.jsp") 1110 * 1111 * ※詳細はcolumnTagのeventURL属性の説明をご覧下さい。 1112 * 1113 * @og.rev 4.3.6.0 (2009/04/01) 1114 * 1115 * @param url JSPのURL 1116 */ 1117 public void setEventURL( final String url ) { 1118 eventURL = nval( getRequestParameter( url ), eventURL ); 1119 } 1120 1121 /** 1122 * 【TAG】eventColumn実行後のcallbak関数を指定します。 1123 * 1124 * @og.tag 1125 * eventColumnの動作終了後に実行するCallback関数の指定を行います。 1126 * 関数名のみを指定して下さい。 1127 * ex) sampleCallback()を実行する場合はeventCallback="sampleCallback" 1128 * 実行する関数の第一引数には自動的に次の要素が入った配列が渡されます 1129 * [0] 変更された子カラムのID属性値 1130 * [1] evnetColumn実行後の子カラムの値 1131 * [2] eventColumn実行前の子カラムの値 1132 * 1133 * この属性は、optionAttributesへの設定と同様の動作を行います。 1134 * 1135 * @og.rev 5.5.4.0 (2012/07/02) 新規追加 1136 * @og.rev 6.9.8.0 (2018/05/28) パラメータ引数が、未設定の場合の考慮不足 1137 * 1138 * @param callback Callback関数 1139 */ 1140 public void setEventCallback( final String callback ) { 1141 // optionAttributes扱いで登録します。 1142 final String clbk = getRequestParameter( callback ); 1143 if( StringUtil.isNotNull( clbk ) ){ 1144 add( "optionAttributes", "eventCallback='" + clbk + "'" ); 1145 } 1146 1147// // optionAttributes扱いで登録します。 1148// if( callback != null && callback.length() > 0 ){ 1149// add( "optionAttributes", "eventCallback='"+getRequestParameter( callback )+"'" ); 1150// } 1151 } 1152 1153 /** 1154 * 【HTML5】表示形式を指定します(初期値:text)。 1155 * 1156 * @og.tag 1157 * ColumnTagは、カラムリソースで作成される為、タイプは固定です。 1158 * しかし、HTML5 で追加された形式には、有用なタイプも存在する為、 1159 * それらへの書き換えをできるようにします。 1160 * よって、ここでは、従来型のタイプへの書き換えはできません。 1161 * (textだけは例外で戻せるようにします)。 1162 * 1163 * [search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1164 * が、設定できます。 1165 * 1166 * HTML5 の機能を有効にするには、ネイティブモードで動作させる必要があります。 1167 * ① USE_IE7_HEADER = "false" に設定する。 1168 * ② USE_HTML5_HEADER = "true" に設定する。 1169 * ③ IEのツール⇒互換表示設定で、互換表示に追加したWebサイトから削除する。 1170 * ④ 同上の設定で、イントラサイトを互換表示で表示するのチェックを外す。 1171 * 必要があります。 1172 * 1173 * <og:input type="text" /> テキストボックスを表示 1174 * 1175 * HTML5 で追加されたタイプ 1176 * <og:input type="search" /> 検索テキストの入力欄を作成する 1177 * <og:input type="tel" /> 電話番号の入力欄を作成する 1178 * <og:input type="url" /> URLの入力欄を作成する 1179 * <og:input type="email" /> メールアドレスの入力欄を作成する 1180 * <og:input type="datetime" /> UTC(協定世界時)による日時の入力欄を作成する 1181 * <og:input type="date" /> 日付の入力欄を作成する 1182 * <og:input type="month" /> 月の入力欄を作成する 1183 * <og:input type="week" /> 週の入力欄を作成する 1184 * <og:input type="time" /> 時間の入力欄を作成する 1185 * <og:input type="datetime-local" /> UTC(協定世界時)によらないローカル日時の入力欄を作成する 1186 * <og:input type="number" /> 数値の入力欄を作成する 1187 * <og:input type="range" /> レンジの入力欄を作成する 1188 * <og:input type="color" /> 色の入力欄を作成する 1189 * 1190 * @og.rev 5.7.1.0 (2013/12/06) HTML5 対応(新規追加) 1191 * @og.rev 6.3.4.0 (2015/08/01) Arrays.toString から String.join に置き換え。 1192 * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 1193 * 1194 * @param type HTML5用 [text/search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1195 */ 1196 public void setType( final String type ) { 1197 final String tp = getRequestParameter( type ); 1198 1199 if( check( tp , TYPE_SET ) ) { 1200 set( "type",tp ); 1201 } 1202 else { 1203 final String errMsg = "type 属性は、下記の中から選択してください。type=[" 1204 + tp + "] in [" + String.join( ", " , TYPE_SET ) + "]"; 1205 throw new HybsSystemException( errMsg ); 1206 } 1207 } 1208 1209 /** 1210 * 【TAG】ResourceManager を使用しないかどうか[true/false]を指定します(初期値:false)。 1211 * 1212 * @og.tag 1213 * trueを指定すると、使用しない設定になります。 1214 * これは、データベースから検索した値そのものが返される カラムオブジェクトを使用することになります。 1215 * 「noResource」なので、意味が反転しているのをご注意ください。 1216 * 1217 * false(初期値)は、ResourceManager を使用します。 1218 * 1219 * @og.rev 5.7.3.0 (2014/02/07) 新規作成 1220 * 1221 * @param flag ResourceManagerの不使用 [true:不使用/false:使用] 1222 */ 1223 public void setNoResource( final String flag ) { 1224 noResource = nval( getRequestParameter( flag ),noResource ); 1225 } 1226 1227 /** 1228 * 【TAG】(通常は使いません)カラムIDの存在チェックを行うかどうか[true/false]を指定します(初期値:true)。 1229 * 1230 * @og.tag 1231 * true の場合、カラムIDがDBTableModel に存在しない場合は、エラーになります。 1232 * false の場合、カラムIDがDBTableModel に存在しない場合は、無視します。 1233 * これは、検索条件によって、設定されるカラムが異なる場合でも、後続処理を 1234 * 正常に動作させたい場合に、使用します。 1235 * 初期値は true (チェックを行う) です。 1236 * 1237 * @og.rev 6.7.6.0 (2017/03/17) strictCheck 追加。 1238 * 1239 * @param check 存在チェック [true:行う/false:行わない] 1240 */ 1241 public void setStrictCheck( final String check ) { 1242 strictCheck = nval( getRequestParameter( check ),strictCheck ); 1243 } 1244 1245 /** 1246 * 【TAG】レンデラ利用時のExcel出力でセルタイプを文字固定にするか[true/false]を指定します(初期値:システム定数のUSE_STRING_EXCEL_OUTPUT)。 1247 * 1248 * @og.tag 1249 * falseを指定すると、dbTypeに従ったセルタイプとなります。 1250 * TableWriter内部でdouble変換をするためエラーに注意してください。 1251 * (初期値:システム定数のUSE_STRING_EXCEL_OUTPUT[={@og.value SystemData#USE_STRING_EXCEL_OUTPUT}])。 1252 * 1253 * @og.rev 5.7.6.3 (2014/05/23) 新規作成 1254 * 1255 * @param flag セルタイプの文字固定にするか [true:固定する/false:固定しない] 1256 */ 1257 public void setStringOutput( final String flag ) { 1258 stringOutput = nval( getRequestParameter( flag ),stringOutput ); 1259 } 1260 1261 /** 1262 * 【TAG】リアルタイムチェックを行うかどうかを指定します(初期値:true)。 1263 * 1264 * @og.tag 1265 * カラム単位でリアルタイムチェックを行うかどうかを設定をします。 1266 * タグに独自属性としてrealTimeCheck="true/false"を追記します。 1267 * falseを設定した場合にチェックが行われなくなります。 1268 * 初期値はリアルタイムチェックを行う(true)です。 1269 * 1270 * この属性は、optionAttributesへの設定と同様の動作を行います。 1271 * 引数の文字列の、true/false 判定を行っていません。そのままの文字列が設定されます。 1272 * JavaScript 側では、false 判定のみ行っているので、不正な文字列の場合は、 1273 * 初期値(true:リアルタイムチェックを行う)が適用されます。 1274 * これは、Ver5 とロジックを合わせておくための処置です。 1275 * 1276 * @og.rev 5.9.32.2 (2018/05/18) 新規追加 1277 * @og.rev 6.9.8.0 (2018/05/28) Ver5 とロジックを合わせます。 1278 * 1279 * @param flag リアルタイムチェックを行うかどうか [true:行う/false:行わない] 1280 */ 1281 public void setUseRealTimeCheck( final String flag ) { 1282 // optionAttributes扱いで登録します。 1283 final String rtcf = getRequestParameter( flag ); 1284 1285 if( StringUtil.isNotNull( rtcf ) ){ 1286 add( "optionAttributes", "realTimeChk=\"" + rtcf + "\"" ); // 連結時のスペースは、Attributes クラスで処理 1287 } 1288 1289// final boolean useRtc = nval( getRequestParameter( flag ) , true ); 1290// 1291// if( !useRtc ) { // true 以外の場合のみ、optionAttributes に属性を追加します。 1292// add( "optionAttributes", "realTimeChk=\"false\"" ); // 連結時のスペースは、Attributes クラスで処理 1293// } 1294 } 1295 1296 /** 1297 * このオブジェクトの文字列表現を返します。 1298 * 基本的にデバッグ目的に使用します。 1299 * 1300 * @return このクラスの文字列表現 1301 * @og.rtnNotNull 1302 */ 1303 @Override 1304 public String toString() { 1305 return ToString.title( this.getClass().getName() ) 1306 .println( "VERSION" ,VERSION ) 1307 .println( "tableId" ,tableId ) 1308 .println( "columns" ,columns ) 1309 .println( "allColumns" ,allColumns ) 1310 .println( "className" ,className ) 1311 .println( "size" ,fieldSize ) // 6.2.0.0 (2015/02/27) 1312 .println( "viewSize" ,viewSize ) // 6.2.0.0 (2015/02/27) 1313 .println( "maxlength" ,maxlength ) 1314 .println( "writable" ,writable ) 1315 .println( "renderer" ,renderer ) 1316 .println( "editor" ,editor ) 1317 .println( "codeName" ,codeName ) 1318 .println( "dbType" ,dbType ) 1319 .println( "defaultVal" ,defaultVal ) 1320 .println( "parameter" ,parameter ) 1321 .println( "dbid" ,dbid ) 1322 .println( "addNoValue" ,addNoValue ) 1323 .println( "Other..." ,getAttributes().getAttribute() ) 1324 .fixForm().toString() ; 1325 } 1326}