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 378 return EVAL_PAGE ; 379 } 380 381 /** 382 * タグ文字列を作成します。 383 * 384 * ColumnEditor としては、HTMLTagSupport を継承しているため、 385 * このメソッドを定義する必要がありますが、内部的には使用していません。 386 * 各種属性は、入力する必要がある為、継承しているだけです。 387 * このクラスでは、このメソッドは、使われておりません。 388 * 389 * @og.rev 3.5.1.0 (2003/10/03) 新規追加 390 * 391 * @return タグ文字列(常に null を返す) 392 */ 393 @Override 394 protected String makeTag() { 395 return null; 396 } 397 398 /** 399 * タグリブオブジェクトをリリースします。 400 * 401 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 402 * 403 * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 404 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 405 * @og.rev 3.5.1.0 (2003/10/03) 親クラスをCommonTagSupportからHTMLTagSupportに変更。 406 * @og.rev 3.5.5.5 (2004/04/23) 入力欄の大きさを指定する viewSize 属性を追加。 407 * @og.rev 3.5.5.7 (2004/05/10) codeName 属性を追加。 408 * @og.rev 3.5.5.9 (2004/06/07) addNoValue 属性を修正。 409 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 410 * @og.rev 3.8.8.5 (2007/03/09) 全カラム が指定されたことにする allColumns 属性を追加 411 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 412 * @og.rev 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 413 * @og.rev 5.1.9.0 (2010/08/01) codeList , codeGroup 属性を追加。(Codeリソースのサブセット) 414 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属性の処理を、HTMLTagSupport に移します。 415 * @og.rev 5.6.2.3 (2013/03/22) useSLabel 属性を追加。(MENU,DBMENUでSLABELを利用するかどうか) 416 * @og.rev 5.6.2.3 (2013/03/22) 非表示文字の設定。noDisplayVal 属性を追加。 417 * @og.rev 5.7.3.0 (2014/02/07) noResource 属性を追加。ResourceManager を使用しないかどうか 418 * @og.rev 5.7.6.3 (2014/05/23) stringOutput追加 419 * @og.rev 6.0.4.0 (2014/11/28) addKeyLabel 属性を追加 420 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 421 * @og.rev 6.2.3.0 (2015/05/01) キー,ラベルで分離して出力するかどうか。writeKeyLabel 属性を追加 422 * @og.rev 6.3.1.1 (2015/07/10) codeKeyVal 属性を追加 423 * @og.rev 6.3.4.0 (2015/08/01) eventValue 追加 424 * @og.rev 6.7.6.0 (2017/03/17) strictCheck 追加。 425 */ 426 @Override 427 protected void release2() { 428 super.release2(); 429 tableId = HybsSystem.TBL_MDL_KEY; 430 columns = null; // 3.7.0.5 (2005/04/11) 431 allColumns = false; // 3.8.8.5 (2007/03/09) 432 labelData = null; // 4.0.0 (2005/01/31) 433 className = null; 434 fieldSize = null; // 6.2.0.0 (2015/02/27) 435 viewSize = null; // 6.2.0.0 (2015/02/27) 436 maxlength = null; // 3.5.5.5 (2004/04/23) 437 writable = null; 438 renderer = null; 439 editor = null; 440 dbType = null; 441 codeName = null; // 3.5.5.7 (2004/05/10) 442 codeList = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 443 codeGroup = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 444 codeKeyVal = null; // 6.3.1.1 (2015/07/10) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 445 defaultVal = null; 446 parameter = null; 447 dbid = null; 448 addNoValue = null; // 3.5.5.9 (2004/06/07) 449 addKeyLabel = null; // 6.0.4.0 (2014/11/28) キー:ラベル形式で表示するかどうか 450 writeKeyLabel = false; // 6.2.3.0 (2015/05/01) キー,ラベルで分離して出力するかどうか 451 useLabelMap = false; // 4.3.4.0 (2008/12/01) 452 useSLabel = null; // 5.6.2.3 (2013/03/22) MENU,DBMENUでSLABELを利用するかどうか 453 noDisplayVal = null; // 5.6.2.3 (2013/03/22) 非表示文字の設定 454 labelMap = null; // 4.3.4.0 (2008/12/01) 455 eventColumn = null; // 4.3.6.0 (2009/04/01) 456 eventValue = null; // 6.3.4.0 (2015/08/01) 457 rawParameter = null; // 4.3.6.0 (2009/04/01) 458 eventURL = null; // 4.3.6.0 (2009/04/01) 459 noResource = false; // 5.7.3.0 (2014/02/07) noResource 属性を追加。 460 strictCheck = true; // 6.7.6.0 (2017/03/17) 461 stringOutput = HybsSystem.sysBool( "USE_STRING_EXCEL_OUTPUT" ); // 5.7.6.3 (2014/05/23) 462 } 463 464 /** 465 * カスタマイズされた DBColumnConfig を作成します。 466 * 467 * DBColumnConfig は、DBColumn より取得します。この DBColumnConfig に、 468 * 属性で指定された値をセットすることで、カスタマイズを行います。 469 * 470 * @og.rev 3.7.0.5 (2005/04/11) 新規追加 471 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 472 * @og.rev 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 473 * @og.rev 4.3.6.0 (2009/04/01) evnetColumn対応 474 * @og.rev 5.1.8.0 (2010/07/01) メソッド名変更(setDefValue ⇒ setDefault) 475 * @og.rev 5.1.9.0 (2010/08/01) codeList ,codeGroup 属性を追加(Codeリソースのサブセット) 476 * @og.rev 5.6.2.3 (2013/03/22) useSLabel 属性を追加。(MENU,DBMENUでSLABELを利用するかどうか) 477 * @og.rev 5.6.2.3 (2013/03/22) 非表示文字の設定。noDisplayVal 属性を追加。 478 * @og.rev 5.7.3.0 (2014/02/07) noResource 属性を追加。ResourceManager を使用しないかどうか 479 * @og.rev 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合の処理 480 * @og.rev 5.7.6.3 (2014/05/23) stringOutput追加 481 * @og.rev 6.0.4.0 (2014/11/28) addKeyLabel 属性を追加 482 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 483 * @og.rev 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 484 * @og.rev 6.3.1.0 (2015/06/28) 個人リソースのUSE_ADD_KEY_LABELで初期値設定 485 * @og.rev 6.3.1.1 (2015/07/10) codeKeyVal 属性を追加 486 * @og.rev 6.3.4.0 (2015/08/01) eventValue 追加 487 * @og.rev 5.9.18.1 (2017/03/24) DATALIST_R用のIEのHTML5機能が無効の場合の処理を追加 488 * 489 * @param dbColumn カラムオブジェクト 490 * 491 * @return カスタマイズされた DBColumnConfig 492 */ 493 private DBColumnConfig getModifyConfig( final DBColumn dbColumn ) { 494 // 5.7.3.0 (2014/02/07) noResource 属性を追加 495 if( noResource ) { 496 labelData = new LabelData( dbColumn.getName() ); 497 renderer = "LABEL"; 498 } 499 500 final DBColumnConfig config = dbColumn.getConfig(); 501 502 // 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合の処理 503 final String ieHTML5 = (String)getSessionAttribute( HybsSystem.IE_HTML5_KEY ); 504 if( "FALSE".equalsIgnoreCase( ieHTML5 ) ) { 505 if( "DATALIST".equalsIgnoreCase( editor ) || 506 "DATALIST".equalsIgnoreCase( config.getEditor() ) ) { 507 editor = "INDBMENU"; 508 } 509 // 5.9.18.1 (2017/03/24) IEのHTML5機能が無効の場合の処理(DATALIST_R用) 510 if( "DATALIST_R".equalsIgnoreCase( editor ) || 511 "DATALIST_R".equalsIgnoreCase( config.getEditor() )){ 512 editor = "INMENU"; 513 } 514 } 515 516 // 6.3.1.0 (2015/06/28) 個人リソースのUSE_ADD_KEY_LABELで初期値設定 517 if( addKeyLabel == null ) { addKeyLabel = nval( sys( "USE_ADD_KEY_LABEL" ) , null ); } // 4:個人設定可 518 519 final String lang = get( "lang" ); // 4.0.0 (2005/01/31) super クラスで受けます。 520 521 if( lang != null ) { config.setLang( lang ); } 522 if( labelData != null ) { config.setLabelData( labelData ); } // 4.0.0 (2005/01/31) 523 if( className != null ) { config.setClassName( className ); } 524 if( fieldSize != null ) { config.setFieldSize( fieldSize ); } // 6.2.0.0 (2015/02/27) メソッド名変更 525 if( viewSize != null ) { config.setViewLength( viewSize ); } // 6.2.0.0 (2015/02/27) 新規追加 526 if( maxlength != null ) { config.setMaxlength( maxlength ); } // 3.5.5.5 (2004/04/23) 527 if( writable != null ) { config.setWritable( writable ); } 528 if( renderer != null ) { config.setRenderer( renderer ); } 529 if( editor != null ) { config.setEditor( editor ); } 530 if( dbType != null ) { config.setDbType( dbType ); } 531 if( defaultVal != null ) { config.setDefault( defaultVal ); } // 5.1.8.0 (2010/07/01) 532 if( parameter != null ) { config.setParameter( parameter ); } 533 if( dbid != null ) { config.setDbid( dbid ); } 534 if( eventColumn != null ) { config.setEventColumn( eventColumn ); } // 4.3.6.0 (2009/04/01) 535 if( eventValue != null ) { config.setEventValue( eventValue ); } // 6.3.4.0 (2015/08/01) 536 if( eventURL != null ) { config.setEventURL( eventURL ); } // 4.3.6.0 (2009/04/01) 537 if( rawParameter != null ){ config.setRawParameter( rawParameter ); } // 4.3.6.0 (2009/04/01) 538 if( useSLabel != null ) { config.setUseSLabel( useSLabel ); } // 5.6.2.3 (2013/03/22) 539 if( noDisplayVal != null ) { config.setNoDisplayVal( noDisplayVal ); } // 5.6.2.3 (2013/03/22) 540 if( addKeyLabel != null ) { config.setAddKeyLabel( addKeyLabel ); } // 6.0.4.0 (2014/11/28) 541 542 if( writeKeyLabel ) { config.setWriteKeyLabel( writeKeyLabel ); } // 6.2.3.0 (2015/05/01) 543 544 // 4.0.0 (2005/11/30) ロールを指定 545 final String roles = get( "roles" ); 546 if( roles != null ) { config.setRoles( roles ); } 547 548 // 4.0.0 (2005/01/31) 549 if( codeName != null ) { 550 final CodeData codeData = getResource().getCodeData( codeName ) ; 551 config.setCodeData( codeData ); 552 } 553 554 // codeName で指定のリソースでも、サブセットが作成できます。 555 // 5.1.9.0 (2010/08/01) codeList 属性を追加(Codeリソースのサブセット) 556 if( codeList != null ) { 557 final CodeData codeData = config.getCodeData() ; 558 if( codeData != null ) { 559 config.setCodeData( codeData.subsetList( codeList ) ); 560 } 561 } 562 563 // 5.1.9.0 (2010/08/01) codeGroup 属性を追加(Codeリソースのサブセット) 564 if( codeGroup != null ) { 565 final CodeData codeData = config.getCodeData() ; 566 if( codeData != null && codeData.useGroup() ) { 567 config.setCodeData( codeData.subsetGroup( codeGroup ) ); 568 } 569 } 570 571 // 6.3.1.1 (2015/07/10) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 572 if( codeKeyVal != null ) { 573 config.setParameter( codeKeyVal ); 574 config.setRenderer( "KVMENU" ); 575 config.setEditor( "KVMENU" ); 576 } 577 578 // 3.5.5.9 (2004/06/07) 579 // 注意:addNoValue は、互換性の関係で、値が指定された場合のみ、 580 // config に設定します。 581 // editor="DBMENU" が、指定された場合は、addNoValue が指定されていない場合のみ、 582 // 従来との互換性の関係より、このクラスのデフォルト(true)を、config に設定します。 583 if( addNoValue != null ) { 584 // Boolean.parseBoolean は、引数がnullの場合は、falseを返すが、値が設定されている時のみセットするので、nullチェックしている。 585 config.setAddNoValue( Boolean.parseBoolean( addNoValue ) ); // 6.1.0.0 (2014/12/26) refactoring 586 } 587 588 // 3.5.1.0 (2003/10/03) 親クラスをCommonTagSupportからHTMLTagSupportに変更。 589 config.setEditorAttributes( getAttributes() ); 590 591 // 4.3.4.0 (2008/12/01) ラベルデータの動的取得に対応します。 592 if( useLabelMap && labelMap != null ) { 593 final LabelData ldata = labelMap.get( dbColumn.getName() ); 594 if( ldata != null ) { 595 config.setLabelData( ldata ); 596 } 597 } 598 599 // 5.7.6.3 (2014/05/23) 600 config.setStringOutput( stringOutput ); 601 602 return config ; 603 } 604 605 /** 606 * 【TAG】カラム名をセットします。 607 * 608 * @og.tag 609 * カラム名をセットします。 610 * columns と同時にはセットできません。 611 * 値に"*"を指定することで、全カラムを対象とすることができます。 612 * また、"PN*,CDK*"等のように前方一致でのワイルドカード指定も可能です。 613 * 614 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 615 * @og.rev 3.8.8.5 (2007/03/09) 全カラム が指定されたことにする allColumns 属性を追加 616 * 617 * @param clm ネーム 618 */ 619 public void setColumn( final String clm ) { 620 if( columns != null ) { 621 final String errMsg = "columns との同時セットは出来ません。: " + CR 622 + "column=[" + clm + "] , " 623 + "columns=[" + StringUtil.array2csv( columns ) + "]"; 624 throw new HybsSystemException( errMsg ); 625 } 626 final String column = getRequestParameter( clm ); 627 if( column != null && column.length() > 0 ) { 628 columns = new String[] { column }; 629 allColumns = column.indexOf( '*' ) >= 0 ; // 3.8.8.5 (2007/03/09) 630 } 631 } 632 633 /** 634 * 【TAG】カラム名をCSV形式で複数セットします。 635 * 636 * @og.tag 637 * カラム名をセットします。 638 * column と同時にはセットできません。 639 * 分解方法は、通常のパラメータ取得後に、CSV分解します。 640 * 値に"*"を指定することで、全カラムを対象とすることができます。 641 * また、"PN*,CDK*"等のように前方一致でのワイルドカード指定も可能です。 642 * 643 * @og.rev 3.7.0.5 (2005/04/11) 複数カラムを同時設定できる columns 属性を追加 644 * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSV分解に戻します。 645 * @og.rev 3.8.8.5 (2007/03/09) 全カラム が指定されたことにする allColumns 属性を追加 646 * 647 * @param clms カラム名(CSV形式) 648 */ 649 public void setColumns( final String clms ) { 650 if( columns != null ) { 651 final String errMsg = "column との同時セットは出来ません。: " + CR 652 + "column=[" + StringUtil.array2csv( columns ) + "] , " 653 + "columns=[" + clms + "]" ; 654 throw new HybsSystemException( errMsg ); 655 } 656 final String column = nval( getRequestParameter( clms ),null ); 657 if( column != null ) { 658 allColumns = column.indexOf( '*' ) >= 0 ; // 3.8.8.5 (2007/03/09) 659 columns = StringUtil.csv2Array( column ); 660 if( columns.length == 0 ) { columns = null; } 661 } 662 } 663 664 /** 665 * 【TAG】ラベルリソースに定義されたラベルIDをセットします。 666 * 667 * @og.tag 668 * ラベルをセットします。 669 * 670 * @og.rev 2.3.1.2 (2003/01/28) ラベルリソースからラベル名を取得するように修正 671 * @og.rev 4.0.0.0 (2005/01/31) キーより、ラベルデータオブジェクトを取得します。 672 * 673 * @param lbl ラベル 674 */ 675 public void setLabel( final String lbl ) { 676 labelData = getResource().getLabelData( getRequestParameter( lbl ) ) ; // 4.0.0 (2005/01/31) 677 } 678 679 /** 680 * 【TAG】カラムのクラス名(VARCHAR2,NUMBER など)をセットします。 681 * 682 * @og.tag 683 * カラムのクラス名をセットします。 684 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 685 * 686 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 687 * 688 * @param cls クラス 689 */ 690 public void setClassName ( final String cls ) { 691 className = nval( getRequestParameter( cls ),className ); 692 } 693 694 /** 695 * 【HTML】最大入力文字数を指定します(入力可能文字数で、バイト数ではありません)。 696 * 697 * @og.tag 698 * カラムの入力文字制限数をセットします。 699 * 700 * @og.rev 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 701 * 702 * @param len 入力文字制限数 703 */ 704 public void setMaxlength( final String len ) { 705 maxlength = nval( getRequestParameter( len ),maxlength ); 706 707 // 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 708 if( "0".equals( maxlength ) ) { set( "NO_MAXLEN", "true" ); } 709 } 710 711 /** 712 * 【TAG】カラムの入力枠サイズ(横幅)を文字数でセットします(入力文字制限ではありません)。 713 * 714 * @og.tag 715 * カラムのサイズをセットします。 716 * 717 * @og.rev 3.5.5.5 (2004/04/23) 入力欄の大きさを指定する viewSize 属性を追加。 718 * 719 * @param siz サイズ 720 */ 721 public void setSize( final String siz ) { 722 fieldSize = nval( getRequestParameter( siz ),null ); // 6.2.0.0 (2015/02/27) 723 } 724 725 /** 726 * 【TAG】カラムの表示サイズ(横幅)を文字数でセットします。 727 * 728 * @og.tag 729 * 入力枠ではなく、表示する時の文字数制限に使われます。 730 * maxLength は、DB上の桁数(バイト数)ですが、viewSize は、文字数です。 731 * SLABEL の簡易バイト数計算(全角2Byte)でもなく、文字数計算になります。 732 * 733 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 734 * 735 * @param len 表示サイズ(横幅) 736 */ 737 public void setViewSize( final String len ) { 738 viewSize = nval( getRequestParameter( len ),null ); 739 } 740 741 /** 742 * 【TAG】カラムが書き込み可能かどうか[true:可能/false:不可]を設定します(初期値:null)。 743 * 744 * @og.tag 745 * カラムの書き込み可能を設定します。 746 * 初期値は、null:無指定 です。 747 * 748 * @param flag 書き込み許可 [true:許可/false:不可] 749 */ 750 public void setWritable ( final String flag ) { 751 writable = nval( getRequestParameter( flag ),writable ); 752 } 753 754 /** 755 * 【TAG】カラムの表示用レンデラー({@og.doc03Link renderer Renderer_****})をセットします。 756 * 757 * @og.tag 758 * これは、plugin.column 以下の Renderer_**** クラスの **** を与えます。 759 * これらは、CellRenderer インターフェースを継承したサブクラスです。 760 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellRenderer Renderer} を参照願います。 761 * {@og.doc03Link renderer Renderer_**** クラス} 762 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 763 * 764 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 765 * 766 * @param rdr 表示用レンデラー (Renderer_**** の ****) 767 * @see org.opengion.hayabusa.db.CellRenderer 768 */ 769 public void setRenderer ( final String rdr ) { 770 renderer = nval( getRequestParameter( rdr ),renderer ); 771 } 772 773 /** 774 * 【TAG】カラムの編集用エディター({@og.doc03Link editor Editor_****})をセットします。 775 * 776 * @og.tag 777 * これは、plugin.column 以下の Editor_**** クラスの **** を 778 * 与えます。これらは、CellEditor インターフェースを継承したサブクラスです。 779 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellEditor Editor} を参照願います。 780 * {@og.doc03Link editor Editor_**** クラス} 781 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 782 * 783 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 784 * 785 * @param ed 編集用エディター (Editor_**** の ****) 786 * @see org.opengion.hayabusa.db.CellEditor 787 */ 788 public void setEditor ( final String ed ) { 789 editor = nval( getRequestParameter( ed ),editor ); 790 } 791 792 /** 793 * 【TAG】DBタイプ({@og.doc03Link dbType DBType_****})をセットします。 794 * 795 * @og.tag 796 * これは、org.opengion.hayabusa.db.column 以下の DBType_**** クラスの **** を 797 * 与えます。これらは、DBType インターフェースを継承したサブクラスです。 798 * 属性クラス定義の {@link org.opengion.hayabusa.db.DBType DBType} を参照願います。 799 * {@og.doc03Link dbType DBType_**** クラス} 800 * "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 801 * 802 * @og.rev 6.4.1.1 (2016/01/16) "既存値:設定値" という指定を行えば、既存値を持っている場合のみ、設定値に置き換えます。 803 * 804 * @param dt パラメータ 805 * @see org.opengion.hayabusa.db.DBType DBType_**** の **** 806 */ 807 public void setDbType( final String dt ) { 808 dbType = nval( getRequestParameter( dt ),dbType ); 809 } 810 811 /** 812 * 【TAG】コードセレクトのユニークキー(コード名称)をセットします。 813 * 814 * @og.tag 815 * このキーを元に、CodeSelectionオブジェクトを構築します。 816 * 817 * @og.rev 3.5.5.7 (2004/05/10) 新規作成 818 * 819 * @param name メニューのユニークキー(コード名称) 820 */ 821 public void setCodeName( final String name ) { 822 codeName = nval( getRequestParameter( name ),codeName ); 823 } 824 825 /** 826 * 【TAG】コードセレクトのサブセットとなるコード(キー)をCSV形式で指定します。 827 * 828 * @og.tag 829 * この値に限定された、コードリソースを、既存の、CodeData の 830 * サブセットとして作成します。 831 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 832 * ここで指定するのは、コード(キー)だけです。 833 * 834 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 835 * 836 * @param list コードセレクトのサブセットとなるコード(キー) 837 */ 838 public void setCodeList( final String list ) { 839 codeList = nval( getRequestParameter( list ),codeList ); 840 } 841 842 /** 843 * 【TAG】コードセレクトのサブセットとなるグループを指定します。 844 * 845 * @og.tag 846 * この値に限定された、コードリソースを、既存の、CodeData の 847 * サブセットとして作成します。 848 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 849 * 850 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 851 * 852 * @param group コードセレクトのサブセットとなるグループ 853 */ 854 public void setCodeGroup( final String group ) { 855 codeGroup = nval( getRequestParameter( group ),codeGroup ); 856 } 857 858 /** 859 * 【TAG】新しいコードセレクトを作成する為の「キー:ラベル キー:ラベル」の文字列を指定します。 860 * 861 * @og.tag 862 * 既存の、CodeData には存在しない、新しいコードリソースを作成する為の、文字列を指定します。 863 * 文字列は、「キー:ラベル キー:ラベル」形式で、スペースで分解後、":" でキーとラベルに分離します。 864 * スペース分解後の文字列に、":" が含まれていない場合は、キーをラベルとして扱います。 865 * また、ラベル部分は、ラベルリソースを使用して、変換を行います。 866 * 内部的には、CodeData を作成しません。DBColumnオブジェクト内で、直接、Selection_KEYVAL を生成します。 867 * codeName 、codeList、codeGroup などが指定された場合は、そちらが優先されます。 868 * 「キー:ラベル キー:ラベル」で、ラベル にスペースを含ませる場合は、ダブルクォーテーションで囲ってください。 869 * 「"キー:ラベル" "キー:ラベル"」という感じです。 870 * 871 * ※ editor,renderer を、"KVMENU" にして、param に、「キー:ラベル キー:ラベル」 872 * の文字列を指定する方法の、簡易版です。 873 * 874 * @og.rev 6.3.1.1 (2015/07/10) codeKeyVal 属性を追加 875 * 876 * @param keyval KEY:VAL文字列 877 */ 878 public void setCodeKeyVal( final String keyval ) { 879 codeKeyVal = nval( getRequestParameter( keyval ),codeKeyVal ); 880 } 881 882 /** 883 * 【TAG】パラメータをセットします。 884 * 885 * @og.tag 886 * ここで指定したパラメータは、renderer、editor、dbType すべてのパラメータに 887 * セットされます。 888 * パラメータをセットします。 889 * 890 * @og.rev 5.6.4.3 (2013/05/24) 新規追加 891 * 892 * @param prm パラメータ 893 */ 894 public void setParam( final String prm ) { 895 parameter = nval( getRequestParameter( prm ),parameter ); 896 rawParameter = nval( prm, parameter ); 897 } 898 899 /** 900 * 【TAG】value属性に値がセットされていないとき使用する、初期値を指定します。 901 * 902 * @og.tag 903 * value属性に値がセットされていないときに、この初期値を使用します。 904 * 905 * @param dv 初期値 906 */ 907 public void setDefaultVal( final String dv ) { 908 defaultVal = nval( getRequestParameter( dv ),defaultVal ); 909 } 910 911 /** 912 * 【TAG】セレクトメニューの値なしのOptionの有無[true/false]を指定します(初期値:falseと同等)。 913 * 914 * @og.tag 915 * セレクトメニューの場合、値なしのOptionをSelectに含めるかどうかを指定します。 916 * ここでは、検索結果の登録画面に使用されるケースが多いため、なにも指定されない 917 * 場合は、なにもセットしません。(Coderesourceの指定どおり) 918 * 動作としては、初期値は、含めない("false") と同等です。 919 * 920 * <og:columnEditor column="CDBK" addNoValue="false" /> 921 * 922 * @param flag 値なしのOptionの有無 [true:含める/それ以外:含めない] 923 */ 924 public void setAddNoValue( final String flag ) { 925 addNoValue = nval( getRequestParameter( flag ),addNoValue ); 926 } 927 928 /** 929 * 【TAG】セレクトメニューの場合、キー:ラベル形式で表示するかどうか[true/false/null]を指定します(初期値:null)。 930 * 931 * @og.tag 932 * カラムがプルダウンメニュー形式の場合、キー:ラベル形式で表示するか、ラベルだけで表示するかを 933 * 選択できます。 934 * true を指定すると、「強制的に」キー:ラベル形式で表示します。 935 * false の場合は、「強制的に」ラベルのみで表示されます。 936 * 初期値の null の場合、コードリソースや、SQL文に準拠した指定通りの形式で表示します。 937 * 938 * <og:column name="CDC" addKeyLabel="true" /> 939 * 940 * @og.rev 6.0.4.0 (2014/11/28) キー:ラベル形式で表示するかどうか。新規追加 941 * 942 * @param flag キー:ラベル形式表示 [true:キー:ラベル形式/false:ラベルのみ/null:指定通り] 943 */ 944 public void setAddKeyLabel( final String flag ) { 945 addKeyLabel = nval( getRequestParameter( flag ),addKeyLabel ); 946 } 947 948 /** 949 * 【TAG】セレクトメニューの場合、キーとラベルを分けて出力するかどうか[true/false]を指定します(初期値:false)。 950 * 951 * @og.tag 952 * カラムがプルダウンメニュー形式の場合、ファイル出力時に、キーとラベルを分離して出力する事ができます。 953 * この属性と、addKeyLabel とは、微妙に関連していて、addKeyLabel="true" のみの場合は、 954 * キー:ラベル形式で、出力されますが、writeKeyLabel="true" も指定されている場合は、こちらが優先されます。 955 * なお、この指定が有効なのは、セレクトメニューのカラムのみです。 956 * 初期値は、false です。 957 * 958 * @og.rev 6.2.3.0 (2015/05/01) キー/ラベルで分離して出力するかどうか。 959 * 960 * @param flag キー/ラベル分離出力するかどうか [true:分離出力/false:通常] 961 */ 962 public void setWriteKeyLabel( final String flag ) { 963 writeKeyLabel = nval( getRequestParameter( flag ),writeKeyLabel ); 964 } 965 966 /** 967 * 【TAG】SQL文を指定してラベル情報を動的に読み込むかどうか[true/false]指定します(初期値:false)。 968 * 969 * @og.tag 970 * trueを指定すると、body部分に記述されたSQL文よりラベル情報を生成して、 971 * 動的にラベル表示を切り替えます。 972 * 973 * ワイルドカードを使用した、カラムの複数指定と組み合わせることで、外部から設定 974 * されたラベル情報で一括で変更することができます。 975 * 976 * 発行するクエリでは、第1カラムにラベルキーを、第2カラムにラベル名称を設定します。 977 * 第3カラムが存在する場合は、名称(短)として使用されます。(必須ではありません) 978 * 979 * ここで作成されたラベル情報は、カラムエディターを適用したDBTableModelのみで 980 * 有効であり、内部的にもキャッシュされません。 981 * 982 * 初期値は、false(動的読込しない)です。 983 * 984 * @og.rev 4.3.4.0 (2008/12/01) 新規作成 985 * 986 * @param flag 動的読込 [true:する/false:しない] 987 */ 988 public void setUseLabelMap( final String flag ) { 989 useLabelMap = nval( getRequestParameter( flag ),useLabelMap ); 990 } 991 992 /** 993 * 【TAG】MENU,DBMENUでSLABELを利用するかどうか[auto/true/false]を指定します(初期値:null)。 994 * 995 * @og.tag 996 * 通常はセレクトメニューは一覧とそれ以外で短縮ラベルの利用が自動で切り替わります。 997 * 強制的にSLABELを利用させたい場合にこの属性をtrue/falseにセットして下さい。 998 * auto/true/false以外を指定した場合はfalse扱いとします。 999 * ここでの初期値は、値の変更を行わないということで、null です。 1000 * 1001 * @og.rev 5.6.2.3 (2013/03/22) columnタグに実装されているので移植 1002 * 1003 * @param prm SLABEL利用 [auto:自動/true:利用する/false:利用しない] 1004 */ 1005 public void setUseSLabel( final String prm ) { 1006 useSLabel = nval( getRequestParameter( prm ),useSLabel ); 1007 if( useSLabel != null && 1008 !"auto".equalsIgnoreCase( useSLabel ) && 1009 !"true".equalsIgnoreCase( useSLabel ) && 1010 !"false".equalsIgnoreCase( useSLabel ) ) { 1011 final String errMsg = "useSLabel は、[auto:自動/true:利用する/false:利用しない] から選んでください。" 1012 + "useSLabel=[" + prm + "]" + CR ; 1013 throw new HybsSystemException( errMsg ); 1014 } 1015 } 1016 1017 /** 1018 * 【TAG】非表示文字列を指定します(初期値:null)。 1019 * 1020 * @og.tag 1021 * これは、例えば、数字型の場合は、0 がデフォルトなどの場合、 1022 * あえて表示したくないなどのケースに使います。 1023 * そのような状況が設定されていない場合は、null が返されます。 1024 * 初期値は、null です。 1025 * 1026 * @og.rev 5.6.2.3 (2013/03/22) 新規追加 1027 * 1028 * @param prm 非表示文字列 [auto:自動/true:利用する/false:利用しない] 1029 */ 1030 public void setNoDisplayVal( final String prm ) { 1031 noDisplayVal = nval( getRequestParameter( prm ),noDisplayVal ); 1032 } 1033 1034 /** 1035 * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します 1036 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。 1037 * 1038 * @og.tag 1039 * 検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に 1040 * 渡す場合に、通常は、session を利用します。その場合の登録キーです。 1041 * query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、 1042 * この tableId 属性を利用して、メモリ空間を分けます。 1043 * (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。 1044 * 1045 * @param id テーブルID (sessionに登録する時のID) 1046 */ 1047 public void setTableId( final String id ) { 1048 tableId = nval( getRequestParameter( id ),tableId ); 1049 } 1050 1051 /** 1052 * 【TAG】データベースへ接続する場合のID(初期値:null)。 1053 * 1054 * @og.tag 1055 * データベース接続を使用するエディター、レンデラーを使用する場合に使用する接続先IDを指定します。 1056 * カラムオブジェクトは、query処理ではなく、view処理時に適用されるため、データベース 1057 * 接続先を指定する必要があります。 1058 * 初期値は、null(DEFAULT 接続) です。 1059 * 1060 * @og.rev 4.0.0.0 (2006/04/02) 新規追加 1061 * 1062 * @param id 接続先ID 1063 */ 1064 public void setDbid( final String id ) { 1065 dbid = nval( getRequestParameter( id ),dbid ); 1066 } 1067 1068 /** 1069 * 【TAG】イベントカラム(親カラム)を設定します。 1070 * 1071 * @og.tag 1072 * 親子関係を持った項目の動的な入れ替えを行う場合に利用します。 1073 * このカラムを変化させるトリガとなるカラムの名前をセットします。 1074 * 1075 * ※詳細はcolumnTagのeventURL属性の説明をご覧下さい。 1076 * 1077 * なお、columnEditorで、Viewに対して、SQL文の定義(置き換え定義)をする場合でも、 1078 * 他カラムの値の参照は、columnタグの場合と同様に、{@XXXX}または$nの変数により行います。 1079 * この場合、これらの変数は、"自身と同一行のカラム"を意味します。 1080 * 1081 * @og.rev 4.3.6.0 (2009/04/01) 1082 * @og.rev 5.1.7.0 (2010/06/01) コメント大幅修正 1083 * 1084 * @param col 親カラム 1085 */ 1086 public void setEventColumn( final String col ) { 1087 eventColumn = nval( getRequestParameter( col ), eventColumn ); 1088 } 1089 1090 /** 1091 * 【TAG】eventColumn使用時の値を、SQL文から求めるためのqueryをセットします。 1092 * 1093 * @og.tag 1094 * eventColumn利用時は{@XXXX}はリクエストパラメータではなく 1095 * xxxカラムの実際の値が利用されます。 1096 * 1097 * @og.rev 6.3.4.0 (2015/08/01) eventValue 追加 1098 * @param val パラメータ 1099 */ 1100 public void setEventValue( final String val ) { 1101 eventValue = nval( getReservedParameter( val ), eventValue ); // ここでは{@XXXX}変換をしない 1102 } 1103 1104 /** 1105 * 【TAG】イベントカラム指定時に呼び出すURLを指定します。 1106 * 1107 * @og.tag 1108 * イベントカラム指定時に部品を作成するJSPを指定します。 1109 * 初期値はシステムリソースのEVENT_COLUMN_URLです。 1110 * (例:eventURL="makeColumn_custom.jsp") 1111 * 1112 * ※詳細はcolumnTagのeventURL属性の説明をご覧下さい。 1113 * 1114 * @og.rev 4.3.6.0 (2009/04/01) 1115 * 1116 * @param url JSPのURL 1117 */ 1118 public void setEventURL( final String url ) { 1119 eventURL = nval( getRequestParameter( url ), eventURL ); 1120 } 1121 1122 /** 1123 * 【TAG】eventColumn実行後のcallbak関数を指定します。 1124 * 1125 * @og.tag 1126 * eventColumnの動作終了後に実行するCallback関数の指定を行います。 1127 * 関数名のみを指定して下さい。 1128 * ex) sampleCallback()を実行する場合はeventCallback="sampleCallback" 1129 * 実行する関数の第一引数には自動的に次の要素が入った配列が渡されます 1130 * [0] 変更された子カラムのID属性値 1131 * [1] evnetColumn実行後の子カラムの値 1132 * [2] eventColumn実行前の子カラムの値 1133 * 1134 * この属性は、optionAttributesへの設定と同様の動作を行います。 1135 * 1136 * @og.rev 5.5.4.0 (2012/07/02) 新規追加 1137 * @og.rev 6.9.8.0 (2018/05/28) パラメータ引数が、未設定の場合の考慮不足 1138 * 1139 * @param callback Callback関数 1140 */ 1141 public void setEventCallback( final String callback ) { 1142 // optionAttributes扱いで登録します。 1143 final String clbk = getRequestParameter( callback ); 1144 if( StringUtil.isNotNull( clbk ) ){ 1145 add( "optionAttributes", "eventCallback='" + clbk + "'" ); 1146 } 1147 1148// // optionAttributes扱いで登録します。 1149// if( callback != null && callback.length() > 0 ){ 1150// add( "optionAttributes", "eventCallback='"+getRequestParameter( callback )+"'" ); 1151// } 1152 } 1153 1154 /** 1155 * 【HTML5】表示形式を指定します(初期値:text)。 1156 * 1157 * @og.tag 1158 * ColumnTagは、カラムリソースで作成される為、タイプは固定です。 1159 * しかし、HTML5 で追加された形式には、有用なタイプも存在する為、 1160 * それらへの書き換えをできるようにします。 1161 * よって、ここでは、従来型のタイプへの書き換えはできません。 1162 * (textだけは例外で戻せるようにします)。 1163 * 1164 * [search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1165 * が、設定できます。 1166 * 1167 * HTML5 の機能を有効にするには、ネイティブモードで動作させる必要があります。 1168 * ① USE_IE7_HEADER = "false" に設定する。 1169 * ② USE_HTML5_HEADER = "true" に設定する。 1170 * ③ IEのツール⇒互換表示設定で、互換表示に追加したWebサイトから削除する。 1171 * ④ 同上の設定で、イントラサイトを互換表示で表示するのチェックを外す。 1172 * 必要があります。 1173 * 1174 * <og:input type="text" /> テキストボックスを表示 1175 * 1176 * HTML5 で追加されたタイプ 1177 * <og:input type="search" /> 検索テキストの入力欄を作成する 1178 * <og:input type="tel" /> 電話番号の入力欄を作成する 1179 * <og:input type="url" /> URLの入力欄を作成する 1180 * <og:input type="email" /> メールアドレスの入力欄を作成する 1181 * <og:input type="datetime" /> UTC(協定世界時)による日時の入力欄を作成する 1182 * <og:input type="date" /> 日付の入力欄を作成する 1183 * <og:input type="month" /> 月の入力欄を作成する 1184 * <og:input type="week" /> 週の入力欄を作成する 1185 * <og:input type="time" /> 時間の入力欄を作成する 1186 * <og:input type="datetime-local" /> UTC(協定世界時)によらないローカル日時の入力欄を作成する 1187 * <og:input type="number" /> 数値の入力欄を作成する 1188 * <og:input type="range" /> レンジの入力欄を作成する 1189 * <og:input type="color" /> 色の入力欄を作成する 1190 * 1191 * @og.rev 5.7.1.0 (2013/12/06) HTML5 対応(新規追加) 1192 * @og.rev 6.3.4.0 (2015/08/01) Arrays.toString から String.join に置き換え。 1193 * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 1194 * 1195 * @param type HTML5用 [text/search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1196 */ 1197 public void setType( final String type ) { 1198 final String tp = getRequestParameter( type ); 1199 1200 if( check( tp , TYPE_SET ) ) { 1201 set( "type",tp ); 1202 } 1203 else { 1204 final String errMsg = "type 属性は、下記の中から選択してください。type=[" 1205 + tp + "] in [" + String.join( ", " , TYPE_SET ) + "]"; 1206 throw new HybsSystemException( errMsg ); 1207 } 1208 } 1209 1210 /** 1211 * 【TAG】ResourceManager を使用しないかどうか[true/false]を指定します(初期値:false)。 1212 * 1213 * @og.tag 1214 * trueを指定すると、使用しない設定になります。 1215 * これは、データベースから検索した値そのものが返される カラムオブジェクトを使用することになります。 1216 * 「noResource」なので、意味が反転しているのをご注意ください。 1217 * 1218 * false(初期値)は、ResourceManager を使用します。 1219 * 1220 * @og.rev 5.7.3.0 (2014/02/07) 新規作成 1221 * 1222 * @param flag ResourceManagerの不使用 [true:不使用/false:使用] 1223 */ 1224 public void setNoResource( final String flag ) { 1225 noResource = nval( getRequestParameter( flag ),noResource ); 1226 } 1227 1228 /** 1229 * 【TAG】(通常は使いません)カラムIDの存在チェックを行うかどうか[true/false]を指定します(初期値:true)。 1230 * 1231 * @og.tag 1232 * true の場合、カラムIDがDBTableModel に存在しない場合は、エラーになります。 1233 * false の場合、カラムIDがDBTableModel に存在しない場合は、無視します。 1234 * これは、検索条件によって、設定されるカラムが異なる場合でも、後続処理を 1235 * 正常に動作させたい場合に、使用します。 1236 * 初期値は true (チェックを行う) です。 1237 * 1238 * @og.rev 6.7.6.0 (2017/03/17) strictCheck 追加。 1239 * 1240 * @param check 存在チェック [true:行う/false:行わない] 1241 */ 1242 public void setStrictCheck( final String check ) { 1243 strictCheck = nval( getRequestParameter( check ),strictCheck ); 1244 } 1245 1246 /** 1247 * 【TAG】レンデラ利用時のExcel出力でセルタイプを文字固定にするか[true/false]を指定します(初期値:システム定数のUSE_STRING_EXCEL_OUTPUT)。 1248 * 1249 * @og.tag 1250 * falseを指定すると、dbTypeに従ったセルタイプとなります。 1251 * TableWriter内部でdouble変換をするためエラーに注意してください。 1252 * (初期値:システム定数のUSE_STRING_EXCEL_OUTPUT[={@og.value SystemData#USE_STRING_EXCEL_OUTPUT}])。 1253 * 1254 * @og.rev 5.7.6.3 (2014/05/23) 新規作成 1255 * 1256 * @param flag セルタイプの文字固定にするか [true:固定する/false:固定しない] 1257 */ 1258 public void setStringOutput( final String flag ) { 1259 stringOutput = nval( getRequestParameter( flag ),stringOutput ); 1260 } 1261 1262 /** 1263 * 【TAG】リアルタイムチェックを行うかどうかを指定します(初期値:true)。 1264 * 1265 * @og.tag 1266 * カラム単位でリアルタイムチェックを行うかどうかを設定をします。 1267 * タグに独自属性としてrealTimeCheck="true/false"を追記します。 1268 * falseを設定した場合にチェックが行われなくなります。 1269 * 初期値はリアルタイムチェックを行う(true)です。 1270 * 1271 * この属性は、optionAttributesへの設定と同様の動作を行います。 1272 * 引数の文字列の、true/false 判定を行っていません。そのままの文字列が設定されます。 1273 * JavaScript 側では、false 判定のみ行っているので、不正な文字列の場合は、 1274 * 初期値(true:リアルタイムチェックを行う)が適用されます。 1275 * これは、Ver5 とロジックを合わせておくための処置です。 1276 * 1277 * @og.rev 5.9.32.2 (2018/05/18) 新規追加 1278 * @og.rev 6.9.8.0 (2018/05/28) Ver5 とロジックを合わせます。 1279 * 1280 * @param flag リアルタイムチェックを行うかどうか [true:行う/false:行わない] 1281 */ 1282 public void setUseRealTimeCheck( final String flag ) { 1283 // optionAttributes扱いで登録します。 1284 final String rtcf = getRequestParameter( flag ); 1285 1286 if( StringUtil.isNotNull( rtcf ) ){ 1287 add( "optionAttributes", "realTimeChk=\"" + rtcf + "\"" ); // 連結時のスペースは、Attributes クラスで処理 1288 } 1289 1290// final boolean useRtc = nval( getRequestParameter( flag ) , true ); 1291// 1292// if( !useRtc ) { // true 以外の場合のみ、optionAttributes に属性を追加します。 1293// add( "optionAttributes", "realTimeChk=\"false\"" ); // 連結時のスペースは、Attributes クラスで処理 1294// } 1295 } 1296 1297 /** 1298 * このオブジェクトの文字列表現を返します。 1299 * 基本的にデバッグ目的に使用します。 1300 * 1301 * @return このクラスの文字列表現 1302 * @og.rtnNotNull 1303 */ 1304 @Override 1305 public String toString() { 1306 return ToString.title( this.getClass().getName() ) 1307 .println( "VERSION" ,VERSION ) 1308 .println( "tableId" ,tableId ) 1309 .println( "columns" ,columns ) 1310 .println( "allColumns" ,allColumns ) 1311 .println( "className" ,className ) 1312 .println( "size" ,fieldSize ) // 6.2.0.0 (2015/02/27) 1313 .println( "viewSize" ,viewSize ) // 6.2.0.0 (2015/02/27) 1314 .println( "maxlength" ,maxlength ) 1315 .println( "writable" ,writable ) 1316 .println( "renderer" ,renderer ) 1317 .println( "editor" ,editor ) 1318 .println( "codeName" ,codeName ) 1319 .println( "dbType" ,dbType ) 1320 .println( "defaultVal" ,defaultVal ) 1321 .println( "parameter" ,parameter ) 1322 .println( "dbid" ,dbid ) 1323 .println( "addNoValue" ,addNoValue ) 1324 .println( "Other..." ,getAttributes().getAttribute() ) 1325 .fixForm().toString() ; 1326 } 1327}