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.html;
017
018import java.util.Arrays;
019import java.util.Iterator;
020import java.util.List;
021import java.util.Map;
022import java.util.concurrent.ConcurrentMap;                                              // 6.4.3.3 (2016/03/04)
023import java.util.stream.Collectors;                                                             // 6.4.3.4 (2016/03/11)
024import java.io.Writer;
025import java.io.IOException;
026
027import org.opengion.fukurou.system.HybsConst ;                                  // 6.1.0.0 (2014/12/26)
028import org.opengion.fukurou.util.StringUtil;
029import org.opengion.fukurou.util.Attributes;
030
031import org.opengion.hayabusa.common.HybsSystem;
032import org.opengion.hayabusa.common.HybsSystemException;
033import org.opengion.hayabusa.db.DBColumn;
034import org.opengion.hayabusa.db.DBTableModel;
035import org.opengion.hayabusa.db.DBColumnConfig;
036import org.opengion.hayabusa.resource.ResourceManager;
037
038/**
039 * ViewForm インターフェース の実装Abstractクラスです。
040 * これを,共通のスーパークラスとして 各種表示フォーム(例:HTML表示等)に使います。
041 *
042 * このクラス は、setter/getterメソッドのデフォルト実装を提供しています。
043 * 各種表示フォームに対応したサブクラス上で, create() をオーバーライドして下さい。
044 *
045 * @og.group 画面表示
046 *
047 * @version  4.0
048 * @author       Kazuhiko Hasegawa
049 * @since    JDK5.0,
050 */
051public abstract class AbstractViewForm implements ViewForm {
052        // 5.2.1.0 (2010/10/01)
053        // 6.1.1.0 (2015/01/17) BulkSet用の表示サイズは、一覧側のサイズになります。
054
055        /** システムの改行コードを設定します。*/
056        protected static final String CR                 = HybsConst.CR;                        // 6.1.0.0 (2014/12/26) refactoring
057        /** StringBilderなどの初期値を設定します。   {@value} */
058        protected static final int BUFFER_MIDDLE = HybsConst.BUFFER_MIDDLE;     // 6.1.0.0 (2014/12/26) refactoring
059        /** StringBilderなどの初期値を設定します。   {@value} */
060        protected static final int BUFFER_LARGE  = HybsConst.BUFFER_LARGE;      // 6.1.0.0 (2014/12/26) refactoring
061
062        // 3.8.0.3 (2005/07/15) 新しいヘッダー固定用のDIV要素を分ける。
063        private static final String LAYER_ST0 = "" ;
064        private static final String LAYER_END0 = "" ;
065        private static final String LAYER_END2 = "<a href=\"#top\" name=\"h_end\" id=\"h_end\" ></a></div></div></div></div>" ;
066
067        // 5.1.8.0 (2010/07/01) groupClass のタイプを定義します。
068        /** カラムのグループ化指定の enum 定数です。 */
069        private static enum CLM_GRP { KIGO , CHAR };
070
071        private String                  name                    = "";           // メニューの名前
072        private DBTableModel    table                   ;
073        private DBColumn[]              dbColumn                ;
074        private boolean[]               clmWritable     ;
075        private boolean[]               writeCtrl               ;                       // 3.8.0.9 (2005/10/17)
076        private boolean[]               clmDisplay              ;
077        private boolean[]               clmGroup                ;                       // 3.8.5.0 (2006/03/20)
078        private String                  groupClass              = "";           // 5.1.8.0 (2010/07/01)
079        private boolean                 useGroupDir             ;                       // 6.7.3.0 (2017/01/27)
080        private CLM_GRP                 groupType               ;                       // 5.1.8.0 (2010/07/01)
081        private boolean[]               sortKeys                ;                       // 3.6.0.0 (2004/09/17)
082        private boolean[]               useEventCols    ;                       // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
083        private boolean                 useSorterKeys   ;                       // 3.6.0.0 (2004/09/17) 内部変数
084        private String                  sorterQuery             = "";           // 3.6.0.0 (2004/09/17) 内部変数
085        private String                  viewFormID              ;
086        private int                     startNo                 ;
087        private int                     pageSize                = HybsSystem.sysInt( "HTML_PAGESIZE" ) ;
088        private boolean                 rowWritableFlag ;                               // 1カラム目が writable か?
089        private ViewMarker              viewLink                ;
090        private ViewMarker              viewMarker              ;
091        private ViewMarker              editMarker              ;                               // 3.8.6.1 (2006/10/20)
092        private String                  selectedType    = "checkbox";
093        private String                  numberType              = "sequence" ;  // 3.5.1.0 (2003/10/03) 新規作成
094        private int                             numberTypeClm   = -1;                   // 3.5.1.0 (2003/10/03) 新規作成
095        private String[]                numberTypeData  ;                               // 3.5.1.0 (2003/10/03) 新規作成
096        private String                  optTypeAttri    ;
097        private boolean                 noMessage               ;
098        private int                     backLinkCount   ;
099        private int                             headerSkipCount ;                               // 0:通常ヘッダ、n:n回ごとに現れる
100        private boolean                 skip                    = ViewForm.DEFAULT_SKIP;        // 3.5.3.1 (2003/10/31)
101        private int                             useCheckControl ;                               // 3.7.0.1 (2005/01/31)
102        private boolean                 useTableSorter  = HybsSystem.sysBool( "VIEW_USE_TABLE_SORTER" ) ;       // 3.5.4.7 (2004/02/06)
103        private boolean                 numberDisplay   = true ;                // 3.5.5.0 (2004/03/12)
104        private int                             scrollRowNo             = -1;                   // 3.7.0.3 (2005/03/01)
105
106        // 3.5.4.6 (2004/01/30) ヘッダー文字列を定義しておきます。
107        private static final String NO_HEADER = "No" ;
108
109        // 3.5.4.8 (2004/02/23) ViewParamTag のパラメータを受け取ります。
110        /** 6.4.3.1 (2016/02/12) 作成元のMapを、HashMap から ConcurrentHashMap に置き換え。  */
111        private ConcurrentMap<String,String> viewParam  ;               // 6.4.3.3 (2016/03/04)
112
113        //5.5.8.3 (2012/11/17) Stringでなく、Objectタイプをもてるようにする(積上げガント対応)
114        private List<String[]> viewArrayList    ; // 5.5.9.0 (2012/12/03) ObjectではなくArrayList
115
116        private int columnCount ;       // 3.5.5.7 (2004/05/10)
117        private int rowCount    ;       // 4.0.0 (2006/01/06)
118
119        // 3.5.6.2 (2004/07/05) ゼブラ模様の指定を、ViewForm としてサポート
120        // 0(ゼブラなし)、-1(ワーニング)、-2以下(エラー)、1(ゼブラ)、2以上(行数まとめ)
121        private int bgColorCycle   = 1 ;
122        // 行ごとに色を変更する時の、デフォルトクラス属性
123        private static final String BG_COLOR_ROW0 = " class=\"row_0\"";
124        // 行ごとに色を変更する時の、切り替え後クラス属性
125        private static final String BG_COLOR_ROW1 = " class=\"row_1\"";
126
127        // 行ごとに色を変更する時の、切り替え後クラス属性
128        private static final String BG_COLOR_ROWSEL = " class=\"row_sel\"";             // 3.7.0.3 (2005/03/01)
129
130        // 警告時の行ごとに色を変更する時の、デフォルトクラス属性
131        private static final String BG_WARNING_COLOR_ROW0 = " class=\"row_0 row_warning\"";
132        // 警告時の行ごとに色を変更する時の、切り替え後クラス属性
133        private static final String BG_WARNING_COLOR_ROW1 = " class=\"row_1 row_warning\"";
134
135        // エラー時の行ごとに色を変更する時の、デフォルトクラス属性
136        private static final String BG_ERROR_COLOR_ROW0 = " class=\"row_0 row_error\"";
137        // エラー時の行ごとに色を変更する時の、切り替え後クラス属性
138        private static final String BG_ERROR_COLOR_ROW1 = " class=\"row_1 row_error\"";
139
140        private String colorRow0 = BG_COLOR_ROW0 ;
141        private String colorRow1 = BG_COLOR_ROW1 ;
142
143        // 5.1.8.0 (2010/07/01) 行に対して、動的にクラス属性を付与するカラム名を指定します。
144        private int bgColorClsClmNo  = -1;
145
146        // 3.5.6.4 (2004/07/16)
147        private boolean useScrollBar = HybsSystem.sysBool( "VIEW_USE_SCROLLBAR" ) ;
148
149        // 3.6.0.0 (2004/09/17)
150        private boolean firstChecked    ;
151
152        // 3.7.1.1 (2005/05/31) SEL_ROW機能使用時に、BG_COLOR_ROWSEL の使用 有/無を指定します。
153        private boolean useSelRowColor  ;
154
155        // 4.0.0 (2007/04/16) tableタグを出力するときに付与します。
156        private String  clazz                   = "viewTable";
157
158        // 4.0.0.0 (2007/11/27) ResourceManagerを設定します。(クロス集計で使用)
159        private ResourceManager resourceManager ;
160
161        // 4.2.0.0 (2008/03/03) ビューの幅と高さを指定できるようにします。
162        private String  height          ;
163        private String  width           ;
164
165        // 4.3.1.0 (2008/09/08)
166        private boolean skipNoEdit      ;
167
168        // 4.3.3.0 (2008/10/01) 画面遷移なしモード時に各行に出力する行番号及び改廃Cのキーを定義します。
169        private static final String HIDDEN_ROW_KEY =    "rid";          // 6.4.1.1 (2016/01/16) hiddenRowKey  → HIDDEN_ROW_KEY refactoring
170        private static final String HIDDEN_CDKH_KEY =   "kh";           // 6.4.1.1 (2016/01/16) hiddenCdkhKey → HIDDEN_CDKH_KEY refactoring
171
172        private boolean noTransition    ;
173
174        // 5.1.7.0 (2010/06/01) ViewFormのキャッシュ復元を画面ID単位に行う
175        private String gamenId                  ;
176
177        // 5.2.1.0 (2010/10/01) 一括入力カラムのアシスト機能を利用するカラムを指定します。
178        private boolean[]       clmBulkSet      ;
179
180        // 5.5.4.2 (2012/07/13) mustとmustAnyを保持する
181        private String[]        nullCheck       ;
182        private String[]        mustAnyCheck;           // 3.8.0.9 (2005/10/17)
183
184        // 5.9.5.3 (2016/02/26)
185        // 6.4.6.1 (2016/06/03) tableId 廃止(利用目的を明確にするため、パラメータ名をviewClassに変更)
186
187        // 6.4.6.1 (2016/06/03) tableId 廃止(利用目的を明確にするため、パラメータ名をviewClassに変更)
188        private String viewClass = "VIEW_" + HybsSystem.TBL_MDL_KEY;    // 初期値
189
190        /**
191         * デフォルトコンストラクター
192         *
193         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
194         */
195        protected AbstractViewForm() { super(); }               // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
196
197        /**
198         * 初期化します。
199         * ここでは、内部で使用されているキャッシュをクリアし、
200         * 新しいモデル(DBTableModel)と言語(lang) を元に内部データを再構築します。
201         * なお、テーブルモデルに対してViewFormで変更を加える場合は、変更処理を行った後に
202         * このメソッドを実行するようにして下さい。
203         *
204         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
205         * @og.rev 3.5.6.1 (2004/06/25) lang 言語コード 属性を削除します。
206         * @og.rev 3.5.6.3 (2004/07/12) 呼ばれたら、必ず初期化するように修正(元に戻す)
207         * @og.rev 3.6.0.0 (2004/09/17) sortKeys 追加
208         * @og.rev 3.8.0.9 (2005/10/17) writeCtrl 追加
209         * @og.rev 3.8.5.0 (2006/03/20) clmGroup 追加
210         * @og.rev 4.0.0.0 (2006/01/06) rowCount 追加
211         * @og.rev 4.0.1.0 (2007/12/13) コメントの追加
212         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
213         * @og.rev 5.2.0.0 (2010/09/01) 2回連続登録時に選択行にスクロールしないバグを修正。
214         * @og.rev 5.2.1.0 (2010/10/01) 一括入力カラムのアシスト機能を利用するカラム(clmBulkSet) 追加
215         * @og.rev 5.5.4.2 (2012/07/13) mustとmustany保持
216         *
217         * @param       table   DBTableModelオブジェクト
218         */
219        public void init( final DBTableModel table ) {
220                this.table = table;
221                if( table != null ) {
222                        rowCount        = table.getRowCount();                  // 4.0.0 (2006/01/06)
223                        columnCount = table.getColumnCount();
224                        clmWritable = new boolean[columnCount];
225                        writeCtrl       = new boolean[columnCount];     // 3.8.0.9 (2005/10/17)
226                        clmDisplay      = new boolean[columnCount];
227                        clmGroup        = new boolean[columnCount];     // 3.8.5.0 (2006/03/20)
228                        sortKeys        = new boolean[columnCount];     // 3.6.0.0 (2004/09/17)
229                        dbColumn        = new DBColumn[columnCount];
230                        useEventCols= new boolean[columnCount]; // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
231                        clmBulkSet  = new boolean[columnCount]; // 5.2.1.0 (2010/10/01)
232                        Arrays.fill( clmWritable,DEFAULT_CLM_WRITABLE );        // カラムの書込み許可
233                        Arrays.fill( writeCtrl,false );                                         // 書き込み制御の許可
234                        Arrays.fill( clmDisplay ,true );                                        // カラムの表示許可
235                        Arrays.fill( clmGroup ,false );                                         // 3.8.5.0 (2006/03/20) カラムのグループ化
236                        Arrays.fill( sortKeys ,false );                                         // すべてリンクしないに設定する。
237                        Arrays.fill( useEventCols, false );                                     // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
238                        Arrays.fill( clmBulkSet, false );                                       // 5.2.1.0 (2010/10/01)
239                        for( int i=0; i<columnCount; i++ ) {
240                                dbColumn[i] = table.getDBColumn( i );
241                        }
242
243                        // 1カラム目(最初のカラム=配列0番目)が writable か?
244                        rowWritableFlag = "WRITABLE".equalsIgnoreCase( getColumnName(0) );
245
246                        // 5.2.0.0 (2010/09/01) 2回連続登録時に選択行にスクロールしないバグを修正。
247                        scrollRowNo = -1;
248                        firstChecked = false;
249
250                        // 5.5.4.2 (2102/07/13)
251                        nullCheck        = table.getMustArray();
252                        mustAnyCheck = table.getMustAnyArray();
253                }
254        }
255
256        /**
257         * 内部の DBTableModel を返します。
258         *
259         * @return      DBTableModelオブジェクト
260         */
261        public DBTableModel getDBTableModel() {
262                return table;
263        }
264
265        /**
266         * ViewForm の識別IDをセットします。
267         * これは、ViewFormFactory でプールする場合の識別キーになります。
268         * プールに戻すときに自分自身に この識別IDを使用します。
269         *
270         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
271         * @og.rev 3.5.6.2 (2004/07/05) メソッド名がまぎらわしい為、変更します。
272         *
273         * @param       viewFormID 識別ID
274         */
275        public void setId( final String viewFormID ) {
276                this.viewFormID = viewFormID;
277        }
278
279        /**
280         * ViewForm の識別IDを返します。
281         * これは、ViewFormFactory でプールする場合の識別キーになります。
282         * プールに戻すときに自分自身に この識別IDを使用します。
283         *
284         * @og.rev 3.5.6.2 (2004/07/05) メソッド名がまぎらわしい為、変更します。
285         *
286         * @return      識別ID
287         */
288        public String getId() {
289                return viewFormID;
290        }
291
292        /**
293         * DBTableModel から HTML文字列を作成して返します。
294         *
295         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
296         *
297         * @return      DBTableModelから作成された HTML文字列
298         */
299        public String create() {
300                return create( 0, rowCount );
301        }
302
303        /**
304         * DBTableModel から View文字列を作成して、Writer にセットします。
305         * 処理内容は、create( int , int ) と同じですが、中間の文字列(StringBuilder)
306         * を作成せずに、直接、Writer に書き出します。
307         * よって、データ作成途中でエラーが発生しても、すでにいくつかのデータは
308         * クライアントに返されています。
309         *
310         * @og.rev 5.0.0.1 (2009/08/15) 直接出力用の Writer 引数追加
311         *
312         * @param  startNo        表示開始位置
313         * @param  pageSize   表示件数
314         * @param  wrt            直接登録用の Writer
315         */
316        public void create( final int startNo, final int pageSize, final Writer wrt ) throws IOException {
317                final String errMsg = "このメソッドは、直接登録用の Writer のビューでのみ使用できます。";
318                throw new UnsupportedOperationException( errMsg );
319        }
320
321        /**
322         * 内容をクリア(初期化)します。
323         *
324         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
325         * @og.rev 3.5.1.0 (2003/10/03) displayNumber 廃止。numberType 新規追加。
326         * @og.rev 3.5.2.0 (2003/10/20) headerSkipCount属性を追加
327         * @og.rev 3.5.3.1 (2003/10/31) skip属性を追加
328         * @og.rev 3.5.4.3 (2004/01/05) useCheckControl属性を追加
329         * @og.rev 3.5.4.3 (2004/01/05) viewFormID属性を削除(初期化しない)
330         * @og.rev 3.5.4.7 (2004/02/06) useTableSorter属性を追加
331         * @og.rev 3.5.4.7 (2004/02/06) columnMaxSize は使用されていないので削除します。
332         * @og.rev 3.5.4.8 (2004/02/23) ViewParamTag のパラメータを追加します。
333         * @og.rev 3.5.5.0 (2004/03/12) numberType 属性の "delete" 値追加に伴なう、numberDisplay 変数の追加。
334         * @og.rev 3.5.6.2 (2004/07/05) bgColorCycle 変数の追加。
335         * @og.rev 3.5.6.4 (2004/07/16) useScrollBar 変数の追加。
336         * @og.rev 3.6.0.0 (2004/09/17) sortKeys , firstChecked , useSorterKeys , sorterQuery 変数の追加。
337         * @og.rev 3.7.0.1 (2005/01/31) 全件チェックコントロール変更( boolean ⇒ int )
338         * @og.rev 3.7.1.1 (2005/05/31) useSelRowColor 変数の追加。
339         * @og.rev 3.8.0.3 (2005/07/15) scrollBarType 変数の追加
340         * @og.rev 3.8.0.9 (2005/10/17) writeCtrl 変数の追加
341         * @og.rev 3.8.5.0 (2006/03/20) clmGroup 変数の追加
342         * @og.rev 3.8.6.1 (2006/10/20) editMarker 変数の追加
343         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
344         * @og.rev 5.1.8.0 (2010/07/01) groupClass , groupType 変数の追加
345         * @og.rev 5.1.8.0 (2010/07/01) bgColorClsClmNo 属性を追加します。
346         * @og.rev 5.2.1.0 (2010/10/01) 一括入力カラムのアシスト機能を利用するカラム(clmBulkSet) 追加
347         * @og.rev 5.5.4.2 (2012/07/13) mustとmustany追加
348         * @og.rev 5.5.9.0 (2012/12/03) viewArrayList追加(viewObjectは削除)
349         * @og.rev 6.7.3.0 (2017/01/27) useGroupDir追加
350         */
351        public void clear() {
352                name                    = "";                           // メニューの名前
353                table                   = null;
354                dbColumn                = null;
355                clmWritable     = null;
356                writeCtrl               = null;                 // 3.8.0.9 (2005/10/17)
357                clmDisplay              = null;
358                clmGroup                = null;                 // 3.8.5.0 (2006/03/20)
359                groupClass              = "";                   // 5.1.8.0 (2010/07/01)
360                useGroupDir             = false;                // 6.7.3.0 (2017/01/27)
361                groupType               = null;                 // 5.1.8.0 (2010/07/01)
362                sortKeys                = null;                 // 3.6.0.0 (2004/09/17)
363                useSorterKeys   = false;                // 3.6.0.0 (2004/09/17)
364                sorterQuery             = "";                   // 3.6.0.0 (2004/09/17)
365                startNo                 = 0 ;
366                pageSize                = HybsSystem.sysInt( "HTML_PAGESIZE" ) ;
367                rowWritableFlag = false;        // 1カラム目が writable か?
368                viewLink                = null;
369                viewMarker              = null;
370                editMarker              = null;         // 3.8.6.1 (2006/10/20)
371                backLinkCount   = 0;
372                selectedType    = "checkbox";
373                numberType              = "sequence";
374                numberTypeClm   = -1;
375                numberTypeData  = null;
376                headerSkipCount = 0;    // 0:通常ヘッダ、n:n回ごとに現れる
377                skip                    = ViewForm.DEFAULT_SKIP;        // 3.5.3.1 (2003/10/31)
378                useCheckControl = 0 ;           // 3.7.0.1 (2005/01/31)
379                viewParam               = null;         // 3.5.4.8 (2004/02/23)
380                viewArrayList   = null;         // 5.5.8.3 (2012/12/03) 
381                numberDisplay   = true ;        // 3.5.5.0 (2004/03/12)
382                columnCount             = 0;            // 3.5.5.7 (2004/05/10)
383                bgColorCycle    = 1;            // 3.5.6.2 (2004/07/05)
384                bgColorClsClmNo = -1;           // 5.1.8.0 (2010/07/01)
385                colorRow0               = BG_COLOR_ROW0 ;               // 3.5.6.2 (2004/07/05)
386                colorRow1               = BG_COLOR_ROW1 ;               // 3.5.6.2 (2004/07/05)
387                useScrollBar    = HybsSystem.sysBool( "VIEW_USE_SCROLLBAR" ) ;  // 3.5.6.4 (2004/07/16)
388                firstChecked    = false;
389                useSelRowColor  = false;        // 3.7.1.1 (2005/05/31)
390                height                  = null;         // 4.2.0.0 (2008/03/18)
391                width                   = null;         // 4.2.0.0 (2008/03/18)
392                skipNoEdit              = false;        // 4.3.2.0 (2008/09/10)
393                useEventCols    = null;         // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
394                clmBulkSet              = null;         // 5.2.1.0 (2010/10/01) 一括入力カラムのアシスト機能を利用するカラム(clmBulkSet) 追加
395                nullCheck               = null;         // 5.5.4.2 (2012/07/13)
396                mustAnyCheck    = null;         // 5.5.4.2 (2012/07/13)
397        }
398
399        /**
400         * テーブルのヘッダーの前に、そのデータの表示範囲を示す文字列を作成します。
401         * [開始No - 終了No]/[件数] です。
402         *
403         * @og.rev 2.0.0.2 (2002/09/24) [1 - 4]/[4] 等のメッセージ出力後の &lt;br&gt; 出力を中止。
404         * @og.rev 4.3.6.0 (2008/04/01) [1 - 4]/[4]のメッセージをJavaScriptで入れ替えるように変更
405         * @og.rev 4.3.8.0 (2009/08/01) 同メッセージ複数対応及びheadでコントロール可能にする
406         *
407         * @param  stNo    表示開始位置
408         * @param  pgSize  表示件数
409         *
410         * @return      テーブルのヘッダータグ文字列
411         * @og.rtnNotNull
412         */
413        protected String getCountForm( final int stNo, final int pgSize ) {
414                if( noMessage ) { return ""; }
415
416                final int lstNo = stNo+pgSize > rowCount ? rowCount : stNo+pgSize ;
417
418                // 6.0.2.5 (2014/10/31) char を append する。
419                final StringBuilder out = new StringBuilder( BUFFER_MIDDLE )
420                        .append( "<div class=\"orgRowCntMsg\">" )
421                        .append( '[' ).append( stNo+1 ).append( " - " ).append( lstNo )
422                        .append( "]/[" ).append( rowCount )
423                        .append( "]</div>" );
424
425                return out.toString() ;
426        }
427
428        /**
429         * カラムのラベル名を返します。
430         * カラムの項目名に対して,見える形の文字列を返します。
431         * 一般には,リソースバンドルと組合せて,各国ロケール毎にラベルを
432         * 切替えます。
433         *
434         * @param       column カラム番号
435         *
436         * @return      カラムのラベル名
437         */
438        protected String getColumnLabel( final int column ) {
439                return dbColumn[column].getLabel();
440        }
441
442        /**
443         * カラム名を返します。
444         * データベースで検索したときのカラムの項目名を返します。
445         *
446         * @param       column カラム番号
447         *
448         * @return      カラム名
449         */
450        protected String getColumnName( final int column ) {
451                return dbColumn[column].getName();
452        }
453
454        /**
455         * row行,colum列 のデータの値を返します。
456         *
457         * @param       row     行番号
458         * @param       column カラム番号
459         *
460         * @return      row行,colum列 のデータの値
461         */
462        protected String getValue( final int row,final int column ) {
463                return table.getValue( row,column ) ;
464        }
465
466        /**
467         * row行,colum列 のデータの値を返します。
468         * これは、データの値そのものではなく、その値のラベル文字を返します。
469         *
470         * @og.rev 3.8.0.9 (2005/10/17) 互換性確保のメソッド
471         *
472         * @param       row     行番号
473         * @param       column カラム番号
474         *
475         * @return      row行,colum列 のデータの値
476         * @og.rtnNotNull
477         */
478        protected String getRendererValue( final int row,final int column) {
479                return getRendererValue( row,column,getValue( row,column ) );
480        }
481
482        /**
483         * row行,colum列 のデータの値を返します。
484         * これは、データの値そのものではなく、その値のラベル文字を返します。
485         *
486         * @og.rev 3.8.0.9 (2005/10/17) writableControl 追加による引数変更
487         * @og.rev 3.8.5.0 (2006/03/20) clmGroup 追加によるグループ化処理
488         * @og.rev 4.0.0.0 (2005/11/30) 行番号に対応した値を返すように変更します。
489         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
490         * @og.rev 5.1.8.0 (2010/07/01) カラムグループの groupClass 対応
491         * @og.rev 6.7.3.0 (2017/01/27) useGroupDir 追加
492         *
493         * @param       row             行番号
494         * @param       column  カラム番号
495         * @param       inVal   データの値
496         *
497         * @return      row行,colum列 のデータの値
498         */
499        protected String getRendererValue( final int row,final int column , final String inVal ) {
500                String val = dbColumn[column].getRendererValue( row,inVal );
501
502                // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
503                if( useEventCols[column] && isWritable( row ) ) {
504                        val = dbColumn[column].getEventColumnTag( val, getValue( row,column ), row, false );
505                }
506                if( viewLink != null ) {
507                        val = viewLink.getMarkerString( row,column,val );
508                }
509                if( viewMarker != null ) {
510                        val = viewMarker.getMarkerString( row,column,val );
511                }
512
513                // 5.1.8.0 (2010/07/01) groupClass 対応:空文字の場合を考慮し、最後に処理を行う。
514                // 出力する値が、空文字列なら、前行と同じでも、空文字にしておきます。
515
516                // 6.7.3.0 (2017/01/27) useGroupDir 追加
517                if( groupType != null && clmGroup[column] && inVal != null && val != null && val.length() > 0 ) {
518                        if( useGroupDir && column > 0 && inVal.equals( getValue( row,column-1 ) ) ||
519                                !useGroupDir && row > 0 && row != startNo && inVal.equals( getValue( row-1,column ) ) ) {
520
521                                val = groupType == CLM_GRP.KIGO ? groupClass
522                                                                                                : "<span class=\"" + groupClass + "\">" + val + "</span>";
523                        }
524                }
525
526                return val;
527        }
528
529        /**
530         * row行,colum列 のデータの値をHTML文字列に変換して返します。
531         * リソースバンドルが登録されている場合は,リソースに応じた
532         * HTML文字列を作成します。
533         *
534         * @og.rev 3.8.0.9 (2005/10/17) writableControl 追加による引数変更
535         * @og.rev 3.8.6.1 (2006/10/20) editMarker 追加
536         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
537         *
538         * @param       row             行番号
539         * @param       column  カラム番号
540         * @param       inVal   データの値
541         *
542         * @return      row行,colum列 のデータの値
543         */
544        protected String getEditorValue( final int row, final int column, final String inVal ) {
545                String val = dbColumn[column].getEditorValue( row,inVal );
546                // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
547                if( useEventCols[column] ) {
548                        val = dbColumn[column].getEventColumnTag( val, getValue( row,column ), row, true );
549                }
550                if( editMarker != null ) {
551                        val = editMarker.getMarkerString( row,column,val );
552                }
553
554                return val;
555        }
556
557        /**
558         * row行,colum列 のデータの値をHTML文字列に変換して返します。
559         * リソースバンドルが登録されている場合は,リソースに応じた
560         * HTML文字列を作成します。
561         * リソースバンドルが登録されていない場合は,getValue( int row,int column )を
562         * 返します。
563         * 新規機能として、writableControl によるエディター・レンデラー指定が出来ます。
564         * その場合、表示/編集ともに、先頭のアンダーバーは削除されます。
565         *
566         * @og.rev 3.8.0.9 (2005/10/17) writableControl によるエディター・レンデラー指定
567         *
568         * @param       row     行番号
569         * @param       column カラム番号
570         *
571         * @return      row行,colum列 のデータの値
572         * @og.rtnNotNull
573         */
574        protected String getValueLabel( final int row, final int column ) {
575                String val = getValue( row,column ) ;
576                boolean isEdit = isColumnWritable( column ) && isWritable( row ) ;
577                if( writeCtrl[column] && val != null && val.length() > 0 && val.charAt(0) == '_' ) {
578                        isEdit = false;
579                        val = val.substring(1);         // 先頭の '_' を削除
580                }
581
582                // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
583                return isEdit ? getEditorValue( row,column,val ) : getRendererValue( row,column,val );
584        }
585
586        /**
587         * カラムのクラスを文字列にした名称を返します。
588         * これは,HTML上の各種タグに,データベース定義に応じたクラスを
589         * セットし,CSS(Cascading Style Sheet)の class="xxxxx" とする事により
590         * 各種スタイルを表現するのに使用します。
591         *
592         * ここでは, カラムリソースの DBTYPE 属性で指定の文字列(X,S9,KXなど)を返します。
593         *
594         * ※ 従来は、class属性に使用する値を取得していましたが、
595         *    org.opengion.plugin.view.ViewForm_HTMLTable#makeNthChild( StringBuilder , int , String )
596         *    の引数に渡すことをメインに使用します。
597         *
598         * @og.rev 4.0.0.0 (2005/01/31) 新規作成(getColumnClassName ⇒ getColumnDbType)
599         * @og.rev 5.2.2.0 (2010/11/01) className が VARCHAR2,NUMBER以外の場合は、合わせて出力します。
600         * @og.rev 6.4.4.2 (2016/04/01) contains 判定を行う新しいメソッドを使用します。
601         * @og.rev 6.4.5.0 (2016/04/08) protected化と、純粋なDBTYPE 属性を返すように変更。
602         *
603         * @param   column カラム番号
604         *
605         * @return  カラムの DBTYPE 属性
606         */
607        protected String getColumnDbType( final int column ) {
608                return dbColumn[column].getDbType();
609
610        }
611
612        /**
613         * カラムのクラスを文字列にした名称を返します。
614         * 内容的には、カラムの className の値と、dbTypeの値をマージした値になります。
615         * さらに、editorAttributesの "class"キーワードの値もマージします。
616         * ただし、この値には、must属性も設定されているため、それだけは除外します。
617         * 各種スタイルを表現するのに使用します。
618         *
619         * @og.rev 6.4.5.0 (2016/04/08) 新規追加
620         *
621         * @param   column カラム番号
622         *
623         * @return  カラムの DBTYPE 属性
624         */
625        protected String getClassName( final int column ) {
626                return dbColumn[column].getClassName();
627        }
628
629        /**
630         * カラムが書き込み可能かどうかを返します。
631         *
632         * @param       column カラム番号
633         *
634         * @return      書込み可能(true)/不可能(false)
635         */
636        protected boolean isColumnWritable( final int column ) {
637                return clmWritable[column];
638        }
639
640        /**
641         * カラムが書き込み可能かどうかをセットします。
642         *
643         * @param       column カラム番号
644         * @param       rw 書込み可能(true)/不可能(false)
645         */
646        public void setColumnWritable( final int column,final boolean rw ) {
647                clmWritable[column] = rw;
648        }
649
650        /**
651         * 書き込み可能カラム名を、CSV形式で与えます。
652         * 例:"OYA,KO,HJO,SU,DYSET,DYUPD"
653         * setColumnWritable( int column,boolean rw ) の簡易版です。
654         * null を与えた場合は,なにもしません。
655         * また、全カラムについて、有効にする場合は、columnName="*" を設定します。
656         *
657         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
658         * @og.rev 5.1.8.0 (2010/07/01) 内部ロジック変更(setBooleanArray)
659         *
660         * @param       columnName      カラム名
661         */
662        public void setColumnWritable( final String columnName ) {
663                if( columnName != null ) {
664                        setBooleanArray( columnName,true,clmWritable );
665
666                        // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
667                        setUseEventCols();
668                }
669        }
670
671        /**
672         * 書き込み不可カラム名を、CSV形式で与えます。
673         * 例:"OYA,KO,HJO,SU,DYSET,DYUPD"
674         * null を与えた場合は,なにもしません。
675         * また、全カラムについて、有効にする場合は、columnName="*" を設定します。
676         *
677         * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
678         * @og.rev 5.1.8.0 (2010/07/01) 内部ロジック変更(setBooleanArray)
679         *
680         * @param       columnName      カラム名
681         */
682        public void setNoWritable( final String columnName ) {
683                if( columnName != null ) {
684                        setBooleanArray( columnName,false,clmWritable );
685                        // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し
686                        setUseEventCols();
687                }
688        }
689
690        /**
691         * 各項目がイベントカラムをするかどうかをセットします。
692         *
693         * @og.rev 5.1.7.0 (2010/06/01) 新規作成(動的プルダウン実装見直し)
694         */
695        private void setUseEventCols() {
696                for( int column=0; column<dbColumn.length; column++ ) {
697                        final String evCols = dbColumn[column].getEventColumn();
698                        if( evCols != null && evCols.length() > 0 ) {
699                                final String[] evColsArr = StringUtil.csv2Array( evCols );
700                                for( int i=0; i<evColsArr.length; i++ ) {
701                                        String evCol = evColsArr[i];
702                                        if( evCol.charAt(0) == '_' ) { evCol = evCol.substring( 1 ); }
703                                        if( isColumnWritable( table.getColumnNo( evCol ) ) ) {
704                                                useEventCols[column] = true;
705                                                break;
706                                        }
707                                }
708                        }
709                }
710        }
711
712        /**
713         * 行指定の書込み許可を返します。
714         *
715         * @og.rev 3.5.4.2 (2003/12/15) writable カラムが "2" のときも、書き込み許可とする
716         * @og.rev 3.5.5.7 (2004/05/10) 判定ロジックを若干見直します。
717         *
718         * @param       row     行番号
719         *
720         * @return      書込み可能(true)/不可能(false)
721         */
722        protected boolean isWritable( final int row ) {
723                boolean rtn = table.isRowWritable( row );
724                if( rtn && rowWritableFlag ) {
725                        final String val = table.getValue( row,0 );
726                        rtn = "TRUE".equalsIgnoreCase( val )
727                                                || "1".equalsIgnoreCase( val )
728                                                || "2".equalsIgnoreCase( val ) ;
729
730                        if( ! rtn &&
731                                ! "FALSE".equalsIgnoreCase( val ) &&
732                                ! "0".equalsIgnoreCase( val ) &&
733                                ! "".equalsIgnoreCase( val ) ) {
734                                        final String errMsg = "writable は、TRUE,FALSE,0,1,2,null 以外指定できません。" +
735                                                                        "  row=[" + (row+1) + "]  val=[" + val + "]";
736                                        throw new HybsSystemException( errMsg );
737                        }
738                }
739                return rtn;
740        }
741
742        /**
743         * 書き込み可能な行(rowWritable == true)のチェックボックスに対して
744         * 初期値を 選択済みにするか、非選択済みにするかを指定します。
745         *
746         * @og.rev 3.5.4.2 (2003/12/15) writable カラムが "2" のとき、チェックを付ける。
747         *
748         * @param       row 行の指定
749         *
750         * @return      チェックON(true)/チェックOFF(false)
751         */
752        protected boolean isChecked( final int row ) {
753                boolean rtn = table.isRowChecked( row );
754                if( rowWritableFlag ) {
755                        final String val = table.getValue( row,0 );
756                        rtn = rtn || "2".equalsIgnoreCase( val ) ;
757                }
758                return rtn;
759        }
760
761        /**
762         * チェック済みの行の先頭に、フォーカスを当てる処理で、チェックの一つ前の
763         * 行番号欄にダミーのリンクを作成する為の判定を行います。
764         * つまり、指定の行番号の次の値が、チェックされているかどうかを判断します。
765         * さらに、これは、一番上位にチェックされている番号の時のみ
766         * 返します。(表示テーブル中、最高一回のみ、true が返る。)
767         *
768         * @og.rev 3.6.0.0 (2004/09/17) 新規作成
769         * @og.rev 3.7.0.3 (2005/03/01) setScrollRowNo の対応
770         * @og.rev 3.8.8.3 (2007/02/09) 最初の選択行 より指定行番号へのフォーカスを優先
771         * @og.rev 4.2.3.1 (2008/06/11) 1件目がチェックされている場合は、対象外とする。
772         * @og.rev 4.2.4.0 (2008/06/25) 1件目対象外の判定で、指定行番号へのフォーカスを優先する。
773         * @og.rev 5.1.1.1 (2009/12/02) 選択行アンカーは、自身の行に出す(default.js#focus2()も合わせて変更)
774         *
775         * @param       row     行の指定
776         *
777         * @return      チェックON(true)/チェックOFF(false)
778         */
779        protected boolean isFirstChecked( final int row ) {
780
781                // 最初の1回のみ、true を返す。よって、元がtrue なら、false を返す。
782                if( firstChecked ) { return false; }
783
784                // 指定の次の行を見るため、範囲オーバーしていないか確認
785                if( row >= rowCount ) { return false; } // 5.1.1.1 (2009/12/02)
786
787                final boolean rtn;
788                // 3.8.8.3 (2007/02/09) 最初の選択行 より指定行番号へのフォーカスを優先
789                if( scrollRowNo >= 0 ) {
790                        rtn = row == scrollRowNo ; // 5.1.1.1 (2009/12/02)
791                }
792                else {
793                        // 1件目がチェックされている場合は、対象外とする。4.2.3.1 (2008/06/11)
794                        if( row == 0 && table.isRowChecked( row ) ) {
795                                firstChecked = true;
796                                return false;
797                        }
798
799                        rtn = table.isRowChecked( row ); // 5.1.1.1 (2009/12/02)
800                }
801
802                // 最初の1回のみ、true を返す。よって、元がtrue なら、false を返す。
803                if( rtn ) { firstChecked = true; }
804                return rtn;
805        }
806
807        /**
808         * その行が、処理対象かどうかをチェックします。
809         * 処理対象かどうかは、書き込み可能な行(rowWritable == true)
810         * で且つ チェックされた行(rowChecked == true) とします。
811         * 例えば,NEXT/PREVでスキップ等の処理を行う場合は、 処理対象以外を
812         * スキップすることで実現できます。
813         *
814         * @param       row     行番号
815         *
816         * @return       処理対象(true)/処理対象でない(false)
817         */
818        public boolean isMarked( final int row ) {
819                return isWritable( row ) && isChecked( row ) ;
820        }
821
822        /**
823         * カラムが表示可能かどうかを返します。
824         * もし,表示不可の場合は,このカラムの全データが,表示対象から外されます。
825         *
826         * @param       column カラム番号
827         *
828         * @return      表示可能(true)/不可能(false)
829         */
830        protected boolean isColumnDisplay( final int column ) {
831                // 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
832                // 条件変更注意
833                return !( rowWritableFlag && column == 0 ) && clmDisplay[column];
834
835        }
836
837        /**
838         * 表示可能なカラムの数を返します。
839         *
840         * @return      表示可能なカラム数
841         */
842        protected int getColumnDisplayCount() {
843                int rtn = 0;
844                for( int i=0; i<columnCount; i++ ) {
845                        if( isColumnDisplay(i) ) { rtn++ ; }
846                }
847
848                return rtn;
849        }
850
851        /**
852         * カラムが表示可能かどうかをセットします。
853         * DBColumnのROLE属性による表示可否は、ViewFormTag で設定されます。
854         *
855         * @param       column カラム番号
856         * @param       rw 表示可能(true)/不可能(false)
857         */
858        public void setColumnDisplay( final int column,final boolean rw ) {
859                clmDisplay[column] = rw;
860        }
861
862        /**
863         * 表示可能カラム名を、CSV形式で与えます。
864         * 例:"OYA,KO,HJO,SU,DYSET,DYUPD"
865         * setColumnDisplay( int column,boolean rw ) の簡易版です。
866         * null を与えた場合は,なにもしません。
867         * また、全カラムについて、有効にする場合は、columnName="*" を設定します。
868         *
869         * @og.rev 5.1.8.0 (2010/07/01) 内部ロジック変更(setBooleanArray)
870         *
871         * @param       columnName      カラム名
872         */
873        public void setColumnDisplay( final String columnName ) {
874                setBooleanArray( columnName,true,clmDisplay );
875        }
876
877        /**
878         * 表示不可カラム名を、CSV形式で与えます。
879         * 例:"OYA,KO,HJO,SU,DYSET,DYUPD"
880         * null を与えた場合は,なにもしません。
881         * また、全カラムについて、有効にする場合は、columnName="*" を設定します。
882         *
883         * @og.rev 5.1.8.0 (2010/07/01) 内部ロジック変更(setBooleanArray)
884         *
885         * @param       columnName      カラム名
886         */
887        public void setNoDisplay( final String columnName ) {
888                setBooleanArray( columnName,false,clmDisplay );
889        }
890
891        /**
892         * 同一表示データをまとめる(表示しない)カラム名を、CSV形式で与えます。
893         *
894         * これは、カラムのグループ化指定を行います。
895         * 同じカラム番号で一つ上の行番号と同じ内容の場合に、表示しないというものです。
896         * 対応は、表示(Renderer)時のみとします。
897         * カラム単位なので、新しいゼブラによる色分けは行いません。(任意のカラムに適用できる為)
898         * また、ファイル出力などのデータ自身は変更されていませんので、そのままデータが落ちます。
899         * また、全カラムについて、有効にする場合は、group="*" を設定します。
900         *
901         * @og.rev 3.8.5.0 (2006/03/20) 新規追加
902         * @og.rev 5.1.8.0 (2010/07/01) 内部ロジック変更(setBooleanArray)
903         *
904         * @param       group まとめるカラム名(CSV形式)
905         */
906        public void setColumnGroup( final String group ) {
907                if( group != null ) {
908                        if( groupType == null ) { groupType = CLM_GRP.KIGO ; }
909                        setBooleanArray( group,true,clmGroup );
910                }
911        }
912
913        /**
914         * 同一表示データをまとめないカラム名を、CSV形式で与えます。
915         *
916         * これは、カラムのグループ化指定で、同一でもまとめないカラムを指定するほうが簡単な場合に
917         * 使用します。例えば、キー情報以外は、グループ化指定したい場合などに便利です。
918         * 動作は、columnGroup の動きと同じです。(まとめないカラムを指定するだけです。)
919         *
920         * これは、同一表示データをまとめるカラム名の指定(columnGroup)と同時にセットする
921         * ことは出来ません。
922         * また、全カラムについて、有効にする場合は、group="*" を設定します。
923         *
924         * @og.rev 5.1.8.0 (2010/07/01) 新規追加
925         *
926         * @param       group まとめるカラム名(CSV形式)
927         */
928        public void setNoGroup( final String group ) {
929                if( group != null ) {
930                        if( groupType == null ) { groupType = CLM_GRP.KIGO ; }
931                        setBooleanArray( group,false,clmGroup );
932                }
933        }
934
935        /**
936         * 同一表示データをまとめる場合の、表示方法を指定します。
937         *
938         * これは、カラムのグループ化指定(columnGroup)を行う場合の、まとめ表示の方法を指定します。
939         * なにも指定しない場合は、まとめカラムは、表示しない(ゼロ文字列)になります。
940         * その場合、先の行と同じ場合も、変更されたカラムが、NULL(ゼロ文字列)であった場合も、
941         * 同じ用に表示されるため、区別が付きません。
942         * そこで、前の行と同じデータの場合に、特殊な処理を行うことで、区別できるようにします。
943         * 指定方法が特殊なので、注意が必要です。
944         *   記号の場合:
945         *       記号(-- , → , ↓ , * など)が指定された場合は、そのままの文字に置き換えられます。
946         *   アルファベットの場合:
947         *       アルファベット(a-z,A-Z)の場合は、&lt;span class="アルファベット"&gt;元の文字&lt;/span&gt;
948         * 例えば、バックカラーに色を付ける、文字を薄い灰色にする、などできます。
949         * ただし、データ量が圧倒的に増えるため、大量のデータ等で使用するのは避けたほうが良いと思います。
950         *
951         * @og.rev 3.8.5.0 (2006/03/20) 新規追加
952         * @og.rev 6.3.9.0 (2015/11/06) 判定条件の記述が間違っていた。
953         *
954         * @param       grpCls まとめ表示の方法
955         */
956        public void setGroupClass( final String grpCls ) {
957                if( grpCls != null ) {
958                        groupClass = grpCls ;
959                        if( groupClass.isEmpty() ) {    // ゼロ文字列の場合
960                                groupType = CLM_GRP.KIGO ;
961                        }
962                        else {
963                                final char ch = groupClass.charAt(0);
964                                if( ch >= 'a' && ch <= 'z' || ch >= 'A' && ch <= 'Z' ) {        // 6.3.9.0 (2015/11/06)         6.9.7.0 (2018/05/14) PMD Useless parentheses.
965                                        groupType = CLM_GRP.CHAR ;
966                                }
967                                else {
968                                        groupType = CLM_GRP.KIGO ;
969                                }
970                        }
971                }
972        }
973
974        /**
975         * 同一表示データをまとめる場合に、行(row)か列(column)を指定します(初期値:false:ROW)
976         *
977         * これは、カラムのグループ化指定(columnGroup)を行う場合の、まとめ表示の方向を指定します。
978         * ROW(初期値:false)を指定すると、指定のカラムで、行単位に同一データかどうかを判定します。
979         * COLUMN(true)を指定すると、columnGroup で指定した順番に、列方向に同一データかどうかを判定します。
980         * DBTableModelの登録順で、ひとつ前のカラムと比較します。
981         *
982         * @og.rev 6.7.3.0 (2017/01/27) 新規追加
983         *
984         * @param       dir まとめ表示の方向(false:ROW/true:COLUMN)
985         * @see         #setColumnGroup( String )
986         */
987        public void setGroupDir( final boolean dir ) {
988                useGroupDir = dir;
989        }
990
991        /**
992         * カラム名リンクソートを表示するカラム名を、CSV形式で与えます。
993         *
994         * ヘッダーにソート用リンクを作成する useTableSorter 属性 に対して、
995         * カラム個別に作成する場合のカラム名をCSV形式で指定します。
996         * この tableSorterKeys 属性は、useTableSorter 属性 と無関係に、指定した
997         * カラムのみ、リンクを表示します。
998         * また、全カラムについて、有効にする場合は、columnName="*" を設定します。
999         * 例:"OYA,KO,HJO,SU,DYSET,DYUPD"
1000         *
1001         * @og.rev 3.6.0.0 (2004/09/17) 新規作成
1002         * @og.rev 5.1.8.0 (2010/07/01) 内部ロジック変更(setBooleanArray)
1003         *
1004         * @param       columnName      カラム名
1005         */
1006        public void setTableSorterKeys( final String columnName ) {
1007                if( columnName != null ) {
1008                        setBooleanArray( columnName,true,sortKeys );
1009
1010                        useSorterKeys = true;                           // 使用したことを記憶
1011                }
1012        }
1013
1014        /**
1015         * 各カラムのフィールドのデータ長を返します。
1016         *
1017         * @og.rev 3.5.5.5 (2004/04/23) DBColumn の size と maxlength の 意味を変更
1018         *
1019         * @param       column カラム番号
1020         *
1021         * @return      カラム数
1022         */
1023        protected int getColumnSize( final int column ) {
1024                return dbColumn[column].getTotalSize(); // 4.0.0 (2005/01/31) メソッド名変更
1025        }
1026
1027        /**
1028         * カラム数を返します。
1029         *
1030         * @return      カラム数
1031         */
1032        protected int getColumnCount() {
1033                return columnCount ;
1034        }
1035
1036        /**
1037         * 行数を返します。
1038         *
1039         * @return      行数
1040         */
1041        protected int getRowCount() {
1042                return rowCount;
1043        }
1044
1045        /**
1046         * リストボックスを作成する場合の name をセットします。
1047         *
1048         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
1049         *
1050         * @param  name 属性
1051         */
1052        protected void setName( final String name ) {
1053                this.name = name;
1054        }
1055
1056        /**
1057         * リストボックスを作成する場合の name を返します。
1058         *
1059         * @return      name属性
1060         */
1061        protected String getName() {
1062                return name;
1063        }
1064
1065        /**
1066         * カラム名をもとに、そのカラム番号を返します。
1067         * カラム名が存在しない場合は、 HybsSystemException を throw します。
1068         *
1069         * @param       columnName       カラム名
1070         *
1071         * @return      カラム番号
1072         */
1073        protected int getColumnNo( final String columnName ) {
1074                return table.getColumnNo( columnName );
1075        }
1076
1077        /**
1078         * 表示開始位置を返します。
1079         *
1080         * @return      表示開始位置
1081         */
1082        public int getStartNo() {
1083                return startNo;
1084        }
1085
1086        /**
1087         * 表示開始位置をセットします。
1088         *
1089         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
1090         *
1091         * @param  no    表示開始位置
1092         */
1093        public void setStartNo( final int no ) {
1094                if( no >= 0 ) { startNo = no; }
1095        }
1096
1097        /**
1098         * 先頭へ戻るリンク間隔を返します。
1099         *
1100         * @return      backLinkCount    リンク間隔
1101         */
1102        public int getBackLinkCount() {
1103                return backLinkCount;
1104        }
1105
1106        /**
1107         * 先頭へ戻るリンク間隔をセットします。
1108         *
1109         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
1110         *
1111         * @param  no   リンク間隔
1112         */
1113        public void setBackLinkCount( final int no ) {
1114                if( no >= 0 ) { backLinkCount = no; }
1115        }
1116
1117        /**
1118         * ヘッダーを出力する間隔を取得します。
1119         *
1120         * @og.rev 3.5.2.0 (2003/10/20) 新規作成
1121         *
1122         * @return      ヘッダーの表示間隔 ( 0:通常ヘッダ、n:n回ごとに現れる )
1123         */
1124        public int getHeaderSkipCount() {
1125                return headerSkipCount;
1126        }
1127
1128        /**
1129         * ヘッダーを出力する間隔をセットします。
1130         *
1131         * 0を指定すると、繰り返しません(つまり、ヘッダーを最初に表示するだけです。)
1132         * 数字を指定すると、その回数毎に、ヘッダーをデータの行に挿入します。
1133         *
1134         * @og.rev 3.5.2.0 (2003/10/20) 新規作成
1135         *
1136         * @param       hsc ヘッダーの表示間隔 ( 0:通常ヘッダ、n:n回ごとに現れる )
1137         */
1138        public void setHeaderSkipCount( final int hsc ) {
1139                headerSkipCount = hsc;
1140        }
1141
1142        /**
1143         * 表示件数を取得します。
1144         *
1145         * @return      表示件数
1146         */
1147        public int getPageSize() {
1148                return pageSize;
1149        }
1150
1151        /**
1152         * 表示件数をセットします。
1153         *
1154         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
1155         *
1156         * @param       psize 表示件数
1157         */
1158        public void setPageSize( final int psize ) {
1159                if( psize > 0 ) { pageSize = psize; }
1160        }
1161
1162        /**
1163         * フォーマットを設定します。
1164         * ※ このクラスでは実装されていません。
1165         *
1166         * @og.rev 3.5.4.0 (2003/11/25) 新規作成
1167         * @param list TableFormatterのリスト
1168         */
1169        public void setFormatterList( final List<TableFormatter> list ) {               // 4.3.3.6 (2008/11/15) Generics警告対応
1170                final String errMsg = "このメソッドは、フォーマット関係のビューでのみ使用できます。";
1171                throw new UnsupportedOperationException( errMsg );
1172        }
1173
1174        /**
1175         * TableFormatterのタイプ値に対応した値を返します。
1176         *
1177         * タイプ値は、(#,$,!) が指定可能です。
1178         * rowが、-1 の場合は、getSortedColumnLabel(col) を返します。
1179         *
1180         * TableFormatterのタイプ別に値を返します。
1181         *   '#'      : getColumnLabel(loc)
1182         *   '$'      : getRendererValue(row,loc)
1183         *   '!'      : getValue(row,loc)
1184         *   それ以外 : getValueLabel(row,loc)/getSortedColumnLabel(loc)
1185         *
1186         * @og.rev 6.4.4.2 (2016/04/01) TableFormatterのタイプ別値取得
1187         *
1188         * @param type  TableFormatterのタイプ
1189         * @param row    データを取得する行番号
1190         * @param col    データを取得する列番号
1191         * @return タイプ別の値
1192         */
1193        protected String getTypeCaseValue( final char type , final int row , final int col ) {
1194                final String rtn ;
1195
1196                if( row < 0 ) {
1197                        switch( type ) {
1198                                case '#' : rtn = getColumnLabel(col);           break;
1199                                case '$' : rtn = getRendererValue(0,col);       break;
1200                                case '!' : rtn = getValue(0,col);                       break;
1201                                default  : rtn = getSortedColumnLabel(col);     break;          // row が負の場合
1202                        }
1203                }
1204                else {
1205                        switch( type ) {
1206                                case '#' : rtn = getColumnLabel(col);           break;
1207                                case '$' : rtn = getRendererValue(row,col);     break;
1208                                case '!' : rtn = getValue(row,col);                     break;
1209                                default  : rtn = getValueLabel(row,col);        break;          //
1210                        }
1211                }
1212
1213                return rtn;
1214        }
1215
1216        /**
1217         * 表示時の選択用オブジェクトのタイプを指定します。
1218         * ・複数選択可能時は "checkbox" を指定します。
1219         * ・一つだけ選ばせる場合は, "radio" を指定します。
1220         * ・隠しフィールドで全件を選ぶ場合は、"hidden" を指定します。
1221         * ・行番号に関する情報を出さない場合は、"none" を指定します(行番号は表示します)。
1222         * 初期値は、"checkbox" です。
1223         *
1224         * @og.rev 2.2.0.0 (2002/12/17) 選択用オブジェクトのタイプとして"hidden" を追加
1225         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
1226         * @og.rev 3.5.1.0 (2003/10/03) displayNumber 廃止。numberType 新規追加。
1227         *
1228         * @param       type 選択用オブジェクトのタイプ( "checkbox"/"radio"/"hidden"/"null" )
1229         */
1230        public void setSelectedType( final String type ) {
1231                if( type != null ) {
1232                        if( "checkbox".equalsIgnoreCase( type  ) ||
1233                                "radio".equalsIgnoreCase( type  ) ||
1234                                "hidden".equalsIgnoreCase( type ) ) {
1235                                        selectedType = type;
1236                        }
1237                        else {
1238                                selectedType = null;
1239                        }
1240                }
1241        }
1242
1243        /**
1244         * 表示時の行番号の表示方法を指定します。
1245         * ・sequenceは、1から始まる連番です。
1246         * ・none を指定すると、番号は表示されません。
1247         * ・delete を指定すると、行番号表示そのもののタグを取り除きます。(3.5.5.0 追加)
1248         * ・skip=カラム名を指定すると、そのカラムの値が NULL の場合は、番号をスキップします。
1249         * ・view=カラム名を指定すると、そのカラムの値が、使用されます。(ラベルは付きません)
1250         * skip=XX と、view=XX は、=の前後にスペースを入れないで下さい。
1251         * 初期値は、"sequence" です。
1252         *
1253         * @og.rev 3.5.1.0 (2003/10/03) 新規作成
1254         * @og.rev 3.5.5.0 (2004/03/12) numberType 属性の "delete" 値追加に伴なう、numberDisplay 変数の追加。
1255         * @og.rev 5.3.0.0 (2010/12/01) 左右分割スクロール(SplitViewTag)対応。numberType 再設定時のnumberDisplay初期化
1256         *
1257         * @param       type 行番号の表示方法のタイプ( /sequence/none/delete/skip=カラム名/view=カラム名/ )
1258         */
1259        public void setNumberType( final String type ) {
1260
1261                numberType = type ;
1262                numberDisplay = true;   // 5.3.0.0 (2010/12/01) numberType 再設定時のnumberDisplay初期化
1263                if( type != null && !type.startsWith( "seq" ) && !type.startsWith( "none" ) ) {
1264                        if( type.startsWith( "skip=" ) ) {
1265                                numberTypeClm = table.getColumnNo( type.substring( 5 ) );
1266                                numberTypeData = new String[rowCount];
1267                                int cnt = 1;
1268                                for( int i=0; i<rowCount; i++ ) {
1269                                        final String tmp = table.getValue( i,numberTypeClm );
1270                                        if( tmp != null && tmp.length() > 0 ) {
1271                                                numberTypeData[i] = String.valueOf( cnt );
1272                                                cnt++ ;
1273                                        }
1274                                        else {
1275                                                numberTypeData[i] = "" ;
1276                                        }
1277                                }
1278                        }
1279                        else if( type.startsWith( "view=" ) ) {
1280                                numberTypeClm = getColumnNo( type.substring( 5 ) );
1281                        }
1282                        // 3.5.5.0 (2004/03/12)
1283                        else if( type.startsWith( "delete" ) ) {
1284                                numberDisplay = false;
1285                        }
1286                        else {
1287                                // 3.5.5.0 (2004/03/12) 不正な値をエラーチェック
1288                                final String errMsg = "numberType属性の値が不正です。numberType=[" + numberType + "]" +
1289                                                CR +
1290                                                "設定できるのは、sequence/none/delete/skip=カラム名/view=カラム名/ です。";
1291                                throw new HybsSystemException( errMsg );
1292                        }
1293                }
1294        }
1295
1296        /**
1297         * 表示時の選択用オブジェクトのタイプを返します。
1298         * 複数選択可能時は "checkbox"  一つだけ選ばせる場合は, "radio" を指定します。
1299         * 初期値は、"checkbox" です。
1300         * "checkbox"/"radio"/"hidden" 以外の文字列の場合は, null を返します。
1301         *
1302         * @return       選択用オブジェクトのタイプ( "checkbox"/"radio"/"hidden"/"null" )
1303         */
1304        protected String getSelectedType() {
1305                return selectedType ;
1306        }
1307
1308        /**
1309         * No カラムの文字列を取得します。
1310         * setNumberType で指定した、(sequence / none / skip=カラム名 / view=カラム名)に
1311         * 応じた値(レンデラーの値)を返します。
1312         *
1313         * @og.rev 3.5.1.0 (2003/10/03) 新規作成
1314         *
1315         * @param   row 行番号
1316         *
1317         * @return      Noカラムの文字列
1318         */
1319        protected String getNumberData( final int row ) {
1320                String rtn = null;
1321
1322                if( numberType == null || numberType.startsWith( "se" ) ) {     // sequence
1323                        rtn = String.valueOf( row + 1 );
1324                }
1325                else {
1326                        if( numberType.startsWith( "no" ) ) {                   // none
1327                                rtn = "";
1328                        }
1329                        else if( numberType.startsWith( "vi" ) ) {              // view
1330                                rtn = getRendererValue( row,numberTypeClm );
1331                        }
1332                        else if( numberType.startsWith( "sk" ) ) {              // skip
1333                                rtn = numberTypeData[row];
1334                        }
1335                }
1336
1337                return rtn ;
1338        }
1339
1340        /**
1341         * No カラムのヘッダー文字列を取得します。
1342         * setNumberType で指定した、(sequence / none / skip=カラム名 / view=カラム名)に
1343         * 応じた値(ラベル)を返します。
1344         * 具体的には、none 以外は、"No" という文字を、none の時は、""(ゼロストリング)を返します。
1345         *
1346         * @og.rev 3.5.4.6 (2004/01/30) 新規作成
1347         *
1348         * @return       Noカラムのヘッダー文字列
1349         */
1350        protected String getNumberHeader() {
1351                String rtn = NO_HEADER;
1352
1353                if( numberType.startsWith( "no" ) ) {                   // none
1354                        rtn = "";
1355                }
1356
1357                return rtn ;
1358        }
1359
1360        /**
1361         * テーブル等のチェックボックスに属性を付加します
1362         * JavaScript などの HTML基本タグ以外の属性を、そのまま
1363         * チェックボックス/ラジオボタン等に使用します。
1364         *
1365         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
1366         *
1367         * @param       option オプション属性文字列
1368         */
1369        public void setOptionTypeAttributes( final String option ) {
1370                optTypeAttri = option;
1371        }
1372
1373        /**
1374         * テーブル等のチェックボックスに属性を付加します
1375         * JavaScript などの HTML基本タグ以外の属性を、そのまま
1376         * チェックボックス/ラジオボタン等に使用します。
1377         *
1378         * @return      オプション属性
1379         */
1380        protected String getOptionTypeAttributes() {
1381                return optTypeAttri ;
1382        }
1383
1384        /**
1385         * 最終表示番号を取得します。
1386         * 最終表示番号は、表示開始位置 + 表示件数 で求まります。
1387         * lastNo = startNo +  pageSize;
1388         *
1389         * ただし、最終表示番号 > データ件数 の場合は、 最終表示番号 = データ件数
1390         * とします。
1391         * なお、表示件数 が -1 の場合は、デフォルトの表示件数を使用します。
1392         *
1393         * @param       startNo    表示開始位置
1394         * @param       pageSize   表示件数
1395         *
1396         * @return      最終表示番号
1397         */
1398        protected int getLastNo( final int startNo, final int pageSize ) {
1399                int lastNo = startNo + ( pageSize < 0 ? getPageSize() : pageSize );
1400                if( lastNo > rowCount ) {
1401                        lastNo = rowCount ;
1402                }
1403
1404                if( rowCount < 0 || startNo < 0 || lastNo < 0 ) {
1405                        final String errMsg = "startNo lastNo の範囲が不正です。" + CR
1406                                                + " startNo=" + startNo + " , lastNo=" + lastNo + " , RowCount=" + rowCount;
1407                        throw new HybsSystemException( errMsg );
1408                }
1409
1410                return lastNo ;
1411        }
1412
1413        /**
1414         * ビューフォームのタイプを返します。
1415         * これは、ViewFormFactory で、org.opengion.hayabusa.html.ViewForm_ + 『type』
1416         * で作成されるサブクラスの 『type』 部分を返します。
1417         *
1418         * @og.rev 3.5.4.3 (2004/01/05) viewFormID を使用するように変更します。
1419         *
1420         * @return      ビューフォームのタイプ
1421         */
1422        public String getViewFormType() {
1423                return viewFormID ;
1424        }
1425
1426        /**
1427         * ビューリンクオブジェクトを設定します。
1428         * これは、ViewLink タグで作成された キー(カラム名)とリンク文字列を
1429         * 持っている Attributes オブジェクトを受け取り、内部でリンク表示に
1430         * 使用します。
1431         *
1432         * @og.rev 3.5.6.4 (2004/07/16) table が null の場合は、セットしません。
1433         *
1434         * @param       link    ビューリンクオブジェクト
1435         */
1436        public void setViewLink( final ViewMarker link ) {
1437                viewLink = link;
1438                if( viewLink != null && table != null ) {
1439                        viewLink.setDBTableModel( table ) ;
1440                }
1441        }
1442
1443        /**
1444         * ビューマーカーオブジェクトを設定します。
1445         * これは、ViewMarker タグで作成された キー(カラム名)とマーカー文字列を
1446         * 持っている Attributes オブジェクトを受け取り、内部でマーカー表示に
1447         * 使用します。
1448         *
1449         * @og.rev 3.5.6.4 (2004/07/16) table が null の場合は、セットしません。
1450         *
1451         * @param       marker  ビューマーカーオブジェクト
1452         */
1453        public void setViewMarker( final ViewMarker marker ) {
1454                viewMarker = marker;
1455                if( viewMarker != null && table != null ) {
1456                        viewMarker.setDBTableModel( table ) ;
1457                }
1458        }
1459
1460        /**
1461         * 編集マーカーオブジェクトを設定します。
1462         * これは、ViewMarker タグで、isRendere="false" で作成された 編集キー(カラム名)と
1463         * マーカー文字列を持っている Attributes オブジェクトを受け取り、内部でマーカー表示に
1464         * 使用します。
1465         *
1466         * @og.rev 3.8.6.1 (2006/10/20) 新規追加
1467         *
1468         * @param       marker  ビューマーカーオブジェクト
1469         */
1470        public void setEditMarker( final ViewMarker marker ) {
1471                editMarker = marker;
1472                if( editMarker != null && table != null ) {
1473                        editMarker.setDBTableModel( table ) ;
1474                }
1475        }
1476
1477        /**
1478         * 検索結果メッセージを表示する/しないを設定します
1479         * 初期値は、表示する(false)です。
1480         *
1481         * @param       noMessage [true:表示しない/false:表示する]
1482         */
1483        public void setNoMessage( final boolean noMessage ) {
1484                this.noMessage = noMessage;
1485        }
1486
1487        /**
1488         * DBColumn オブジェクトを返します。
1489         *
1490         * @og.rev 3.1.8.0 (2003/05/16) DBColumn オブジェクト取得用のメソッド追加
1491         *
1492         * @param       column カラム番号
1493         *
1494         * @return  DBColumnオブジェクト
1495         */
1496        protected DBColumn getDBColumn( final int column ) {
1497                return dbColumn[column];
1498        }
1499
1500        /**
1501         * カラム(列)にカラムオブジェクトを割り当てます。
1502         * カラムオブジェクトは,ラベルやネームなど,そのカラム情報を
1503         * 保持したオブジェクトです。
1504         *
1505         * @og.rev 5.6.2.3 (2013/03/22) 新規追加
1506         *
1507         * @param   column  カラムオブジェクト
1508         * @param   clm       ヘッダーを適応するカラム(列)
1509         */
1510        protected void setDBColumn( final int column, final DBColumn clm ) {
1511                dbColumn[column] = clm;
1512        }
1513
1514        /**
1515         * チェックの入った行のみを表示させるかどうか指定します。
1516         *
1517         * "true" で、チェックの入った行のみを表示させます。
1518         * 従来は、TextField系のViewに対して、NEXT,PREVでチェックの
1519         * 入った行のみを表示させる機能でしたが、Table系のViewに対しても、
1520         * 同様に機能するように、しました。
1521         * 初期値は、ViewForm.DEFAULT_SKIP です。
1522         *
1523         * @og.rev 3.5.3.1 (2003/10/31) 新規追加
1524         *
1525         * @param       skp チェックの入った行のみを表示させるかどうか(true:のみ表示/false:前件表示)
1526         */
1527        public void setSkip( final boolean skp ) {
1528                skip = skp;
1529        }
1530
1531        /**
1532         * チェックの入った行のみを表示させるかどうか(スキップするかどうか)を返します。
1533         *
1534         * skip=true で、かつ、チェックの入っていない行の場合に、trueを返します。
1535         * つまり、skip=trueの場合は、チェックの入っていない行は、スキップするという
1536         * 判断を行います。
1537         * skip属性の初期値は、ViewForm.DEFAULT_SKIP です。
1538         *
1539         * @og.rev 3.5.3.1 (2003/10/31) 新規追加
1540         *
1541         * @param       row     行番号
1542         *
1543         * @return      スキップする(true)/スキップしない(false)
1544         */
1545        protected boolean isSkip( final int row ) {
1546                return skip && ! isChecked( row );
1547        }
1548
1549        /**
1550         * チェックボックスの全チェックを選択するJavaScript の機能を使用するかどうかを指定します。
1551         *
1552         * 1 で、コントロール用のチェックボックスが現れて、この機能を使用することができるようになります。
1553         * 0 は、従来どおりです。
1554         * 使用するにあたり、jsp/commpn/default.js にJavaScriptを設定しておきます。(設定済み)
1555//       * 初期値は、システムパラメータ の VIEW_USE_CHECK_CONTROL です。(0:使用しない)
1556         *
1557         * @og.rev 3.5.4.3 (2004/01/05) 新規追加
1558         * @og.rev 3.7.0.1 (2005/01/31) 全件チェックコントロール変更( boolean ⇒ int )
1559         *
1560         * @param       chCtrl チェックボックスの全チェックを選択する機能を使用するかどうか
1561         *                      (1:使用する/0:使用しない/2:初期値チェック済み)
1562         */
1563        public void setUseCheckControl( final int chCtrl ) {
1564                useCheckControl = chCtrl;
1565        }
1566
1567        /**
1568         * チェックボックスの全チェックを選択するJavaScript の機能を使用するかどうかを返します。
1569         *
1570         * 内部的には、(1:使用する/0:使用しない/2:初期値チェック済み)の値を保持していますが、
1571         * タグを作成する場合には、まず、使用するかどうかを指定する必要があるため、
1572         * 1:使用する/2:初期値チェック済み は、true:使用する、0 は、false:使用しない
1573         * を返します。
1574         *
1575         * @og.rev 3.5.4.3 (2004/01/05) 新規追加
1576         *
1577         * @return      チェックボックスの全チェックを選択する機能を使用するかどうか(true:使用する/false:使用しない)
1578         */
1579        protected boolean isUseCheckControl() {
1580                return useCheckControl > 0;
1581        }
1582
1583        /**
1584         * チェックボックスの全チェックを選択する タグ文字列を返します。
1585         *
1586         * 内部的には、(1:使用する/0:使用しない/2:初期値チェック済み)の値を
1587         * 保持していますので、それに対応した文字列を返します。
1588         *
1589         * @og.rev 3.7.0.1 (2005/01/31) 新規追加
1590         * @og.rev 5.1.8.0 (2010/07/01) 全チェックを押した状態で画面遷移した場合にチェック状態を保持する。
1591         *
1592         * @return      チェックボックスの全チェックを選択する機能を使用するかどうか
1593         *                      (1:使用する/0:使用しない/2:初期値チェック済み)
1594         */
1595        protected String getAllCheckControl() {
1596                final String rtn;
1597                switch( useCheckControl ) {
1598                        case 1: rtn = "<input type=\"checkbox\" name=\"ALL_CHECK\" value=\"2\" onClick=\"checkbox(this);\" />" ;
1599                                        break;
1600                        case 2: rtn = "<input type=\"checkbox\" name=\"ALL_CHECK\" value=\"2\" onClick=\"checkbox(this);\" checked=\"checked\" />" ;
1601                                        break;
1602                        default : rtn = "" ;
1603                                        break;          // 6.0.2.5 (2014/10/31) break追記
1604                }
1605                return rtn ;
1606        }
1607
1608        /**
1609         * ヘッダーにソート用リンクを作成するかどうかを指定します。
1610         *
1611         * "true" で、ヘッダーにソート用リンクを作成します。
1612         * false は、作成しません。
1613         *
1614         * @og.rev 3.5.4.7 (2004/02/06) 新規追加
1615         *
1616         * @param       flag ヘッダーにソート用リンクを作成するかどうか(true:作成する/false:作成しない)
1617         */
1618        public void setUseTableSorter( final boolean flag ) {
1619                useTableSorter = flag;
1620        }
1621
1622        /**
1623         * ヘッダーにソート用リンクを作成する時の、リクエスト引数のMapを設定します。
1624         *
1625         * ソート用URLに、リクエスト時の引数を設定する必要があります。
1626         * そのため、リクエスト時のキーと値のセットをMapで指定します。
1627         * このMap は、リクエストキャッシュより取り出します。
1628         * 実装では、このMapを元に、URLのQuery部文字列を作成します。処理過程において、
1629         * このMap を書き換えることは行いません。
1630         *
1631         * @og.rev 3.6.0.0 (2004/09/17) 新規作成
1632         * @og.rev 3.6.0.0 (2004/09/22) 引数が null の時の処理追加
1633         * @og.rev 4.0.0.0 (2005/01/31) Map.keySet より Map.entrySet を使用するように変更
1634         * @og.rev 5.10.1.1 (2018/07/13) keyのマルチバイト文字エンコード対応
1635         *
1636         * @param       map ヘッダーソート時のリンクに追加するリクエスト変数のキャッシュMap
1637         */
1638        public void makeTableSorterQuery( final Map<?,?> map ) {                                // 4.3.3.6 (2008/11/15) Generics警告対応
1639                if( map == null ) { return; }                                                                           // 3.6.0.0 (2004/09/22)
1640
1641                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
1642                final Iterator<?> ite = map.entrySet().iterator() ;                                                     // 4.0.0 (2005/01/31)
1643                while( ite.hasNext() ) {
1644                        final Map.Entry<?,?> entry = (Map.Entry<?,?>)ite.next();                                // 4.3.3.6 (2008/11/15) Generics警告対応
1645                        final String key = (String)entry.getKey();
1646                        if( key != null
1647                                         &&     ! key.equalsIgnoreCase( "command" )
1648                                         &&     ! key.equalsIgnoreCase( HybsSystem.SORT_COLUMNS ) ) {
1649                                final String[] vals = (String[])entry.getValue();                                       // 4.0.0 (2005/01/31)
1650                                if( vals != null ) {
1651                                        for( int i=0; i<vals.length; i++ ) {
1652//                                              buf.append( '&' ).append( key ).append( '=' );                          // 6.0.2.5 (2014/10/31) char を append する。
1653                                                buf.append( "&" ).append( StringUtil.urlEncode(key) ).append( "=" )     // 5.10.1.1 (2018/07/13)
1654                                                        .append( StringUtil.urlEncode( vals[i] ) );
1655                                        }
1656                                }
1657                        }
1658                }
1659
1660                if( buf.length() > 0 ) {
1661                        sorterQuery = buf.toString();
1662                }
1663        }
1664
1665        /**
1666         * カラムソート機能(リンク)の付いたラベル名を返します。
1667         * カラムの項目名に対して,見える形の文字列を返します。
1668         * 一般には,リソースバンドルと組合せて,各国ロケール毎にラベルを
1669         * 切替えます。
1670         *
1671         * @og.rev 3.5.4.7 (2004/02/06) 新規追加
1672         * @og.rev 3.6.0.0 (2004/09/17) sortKeys の使用によるカラム個別のリンク有無追加
1673         * @og.rev 5.2.1.0 (2010/10/01) 一括入力カラムのアシスト機能を利用する場合の処理を追加
1674         * @og.rev 5.2.3.0 (2010/12/01) チェックボックスでは、onChange ではなく、onClick でイベントを発生させます。
1675         * @og.rev 5.6.9.1 (2013/10/11) カラム長にカンマが入った場合の対応
1676         * @og.rev 5.7.8.1 (2014/07/18) カラム長が 1000 では、少ない為。(HTML5ではエラーになる為)
1677         * @og.rev 6.0.2.0 (2014/09/19) Bulkset エラー回避
1678         * @og.rev 6.1.1.0 (2015/01/17) Bulkset関係( ViewLength を使用、左寄せ、SLABEL設定 )
1679         * @og.rev 6.2.0.0 (2015/02/27) class="W100" を追加することで、テーブル幅いっぱいの入力枠にする。
1680         * @og.rev 6.2.1.0 (2015/03/13) 動的カラム(COLUMN)は、TEXT に置き換える。
1681         * @og.rev 6.2.2.2 (2015/04/03) NO_MAXLEN キーの値が、"true" の場合、maxlength を強制削除する。
1682         * @og.rev 6.2.2.4 (2015/04/24) class="W100"の追加条件に、dbType 制限をかけます。
1683         * @og.rev 5.9.23.0 (2017/08/10) useSorterKeysが無い場合でもspanは外側に付ける
1684         * @og.rev 6.8.1.4 (2017/08/25) must の取り消し。これは、config.setEditorAttributes( attri ); の副作用で、config から、must をremoveする必要が出てきました。
1685         * @og.rev 6.9.9.2 (2018/09/18) ソートキーのマルチバイト文字エンコード対応
1686         *
1687         * @param       column カラム番号
1688         *
1689         * @return      ソート機能(リンク)の付いたラベル名
1690         */
1691        protected String getSortedColumnLabel( final int column ) {
1692                // 6.4.2.1 (2016/02/05) PMD refactoring. Prefer StringBuffer over += for concatenating strings
1693                final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE );
1694
1695                final String clmLbl = getColumnLabel( column ) ;
1696
1697                if( useSorterKeys && sortKeys[column] || ! useSorterKeys && useTableSorter ) {  // 6.9.7.0 (2018/05/14) PMD Useless parentheses.
1698                        rtn.append( "<a href=\"?command=VIEW&" )
1699                                .append( HybsSystem.SORT_COLUMNS ).append( '=' )
1700        //                      .append( dbColumn[column].getName() )
1701                                .append( StringUtil.urlEncode( dbColumn[column].getName() ) )                   // 6.9.9.2 (2018/09/18) ソートキーのマルチバイト文字エンコード対応
1702                                .append( sorterQuery ).append( "\">" )
1703                                .append( clmLbl ).append( "</a>" );
1704                }
1705                else {
1706                        rtn.append( "<span>" ).append( clmLbl ).append( "</span>" );    // 5.9.23.0 (2017/08/10)
1707                }
1708
1709                // 5.2.1.0 (2010/10/01) 一括入力カラムのアシスト機能対応(bulkSet)
1710                if( isClmBulkSet( column ) ) {
1711                        final DBColumnConfig config = dbColumn[column].getConfig();
1712                        config.setAddNoValue( true );
1713                        // 6.2.2.2 (2015/04/03) NO_MAXLEN キーの値が、"true" の場合、maxlength を強制削除する。
1714                        final String editor = config.getEditor();
1715                        if( "RADIO".equals( editor ) ) {                        // 6.2.2.2 (2015/04/03)
1716                                config.setEditor( "MENU" );
1717                        }
1718                        // 6.2.1.0 (2015/03/13) 動的カラム(COLUMN)は、TEXT に置き換える。
1719                        else if( "COLUMN".equals( editor ) ) {          // 6.2.2.2 (2015/04/03)
1720                                config.setEditor( "TEXT" );
1721                        }
1722
1723                        final Attributes attri = new Attributes();
1724                        // 5.2.3.0 (2010/12/01) チェックボックスでは、onChange ではなく、onClick でイベントを発生させます。
1725                        if( "CHBOX".equals( editor ) ) {                        // 6.2.2.2 (2015/04/03)
1726                                attri.add( "onClick",  "bulkSet(this);" );
1727                        }
1728                        else {
1729                                attri.add( "onChange",  "bulkSet(this);" );
1730                                attri.add( "ondblclick","bulkPaste(this);" );
1731                                // 6.2.2.2 (2015/04/03) NO_MAXLEN キーの値が、"true" の場合、maxlength を強制削除する。
1732                                attri.set( "NO_MAXLEN", "true" );                               // W100 と連動
1733                                attri.add( "style",             "float:left;" );                // 6.1.1.0 (2015/01/17) CHBOX以外は左寄せ
1734
1735        //                      // 6.2.2.4 (2015/04/24) class="W100"の追加条件に、dbType 制限をかけます。
1736                                final String dbType = "," + config.getDbType() + ",";
1737                                if( ",X,K,KX,XK,ALL,".contains( dbType ) ) {
1738                                        attri.add( "class", "W100" );                           // 6.2.0.0 (2015/02/27) テーブル幅いっぱいの入力枠にする。
1739                                        config.setFieldSize( "1" );                                     // 6.2.2.2 (2015/04/03) ここで設定しないと、後付けされる。
1740                                }
1741                        }
1742                        attri.add( "onkeydown", "ctrlCV(this);" );
1743
1744                        config.setEditorAttributes( attri );
1745                        config.removeEditorAttributes( "class" , "must" );      // 6.8.1.4 (2017/08/25) must の取り消し
1746                        config.setUseSLabel( "true" );                                          // 6.1.1.0 (2015/01/17) SLABEL設定。ほんとはMENU系のみでよい。
1747
1748                        final String key = config.getName();
1749                        config.setName( "h_" + key );
1750
1751                        final DBColumn clm = new DBColumn( config );
1752
1753                        // 6.0.2.0 (2014/09/19) Bulkset エラー回避
1754                        try {
1755                                // 6.4.2.1 (2016/02/05) PMD refactoring. Prefer StringBuffer over += for concatenating strings
1756                                rtn.append( "<br />" ).append( clm.getEditorValue( null ) );    // 注意:検索用のEditorが呼ばれる。
1757                        }
1758                        catch( final RuntimeException ex ) {
1759                                final String errMsg = "bulkSet でエラーが発生しました。" + CR
1760                                                        + " Label=" + rtn + " , Column=" + key + " , Editor=" + editor          // 6.2.2.2 (2015/04/03)
1761                                                        + CR
1762                                                        + ex.getMessage();
1763                                System.err.println( errMsg );
1764                        }
1765                }
1766
1767                return rtn.toString();                  // 6.4.2.1 (2016/02/05)
1768        }
1769
1770        /**
1771         * 指定カラムNoがmust指定されているかどうか。
1772         *
1773         * @og.rev 5.5.4.2 (2012/07/13)
1774         *
1775         * @param       column カラムNO
1776         * @return must指定されているかどうか[true:されている/false:されていない]
1777         */
1778        protected boolean isMustColumn( final int column){
1779                if( nullCheck != null && nullCheck.length > 0 ){
1780                        for( int i=0; i<nullCheck.length; i++ ){
1781                                if( nullCheck[i].equals( dbColumn[column].getName() ) ){
1782                                        return true;
1783                                }
1784                        }
1785                }
1786                return false;
1787        }
1788
1789        /**
1790         * 指定カラムNoがmustAny指定されているかどうか。
1791         *
1792         * @og.rev 5.5.4.2 (2012/07/13)
1793         *
1794         * @param       column カラムNO
1795         * @return mustAny指定されているかどうか[true:されている/false:されていない]
1796         */
1797        protected boolean isMustAnyColumn( final int column){
1798                if( mustAnyCheck != null && mustAnyCheck.length > 0 ){
1799                        for( int i=0; i<mustAnyCheck.length; i++ ){
1800                                if( mustAnyCheck[i].equals( dbColumn[column].getName() ) ){
1801                                        return true;
1802                                }
1803                        }
1804                }
1805                return false;
1806        }
1807
1808        /**
1809         * ViewForm のサブクラスに渡すパラメータマップを設定します。
1810         *
1811         * @og.rev 3.5.4.8 (2004/02/23) ViewParamTag のパラメータを追加します。
1812         * @og.rev 6.4.3.3 (2016/03/04) ConcurrentHashMap を受け取ることを明確にするため、I/FをConcurrentMapに変更します。
1813         *
1814         * @param       map パラメータマップ
1815         */
1816        public void setParam( final ConcurrentMap<String,String> map ) {
1817                viewParam = map ;
1818        }
1819
1820        /**
1821         * ViewForm のサブクラスに渡すパラメータマップの値を返します。
1822         * パラメータが 存在しない(null)か、値が 存在しない(null)の場合は、
1823         * 初期値を返します。
1824         *
1825         * @og.rev 3.5.5.9 (2004/06/07) 新規追加
1826         *
1827         * @param       key     パラメータの取り出すキー
1828         * @param       def     パラメータが存在しない場合の初期値
1829         *
1830         * @return      パラメータ値
1831         */
1832        protected String getParam( final String key, final String def ) {
1833                if( viewParam == null ) { return def; }
1834                final String rtn = viewParam.get( key );                // 4.3.3.6 (2008/11/15) Generics警告対応
1835
1836                // 6.4.1.1 (2016/01/16) 条件反転
1837                return ( rtn == null ) ? def : rtn ;
1838
1839        }
1840
1841        /**
1842         * ViewForm のサブクラスに渡すパラメータマップの値を返します。
1843         * パラメータは、初期値が設定されているものとし、そのまま、値を返します。
1844         *
1845         * @og.rev 5.5.5.6 (2012/08/31) 新規追加
1846         *
1847         * @param       key     パラメータの取り出すキー
1848         *
1849         * @return      パラメータ値
1850         */
1851        protected String getParam( final String key ) {
1852                return (viewParam == null) ? null : viewParam.get( key );
1853        }
1854
1855        /**
1856         * ViewForm のサブクラスに渡すパラメータマップの値を int で返します。
1857         * パラメータは、初期値が設定されているものとし、null の場合は、-1 を返します。
1858         *
1859         * @og.rev 5.5.5.6 (2012/08/31) 新規追加
1860         *
1861         * @param       key     パラメータの取り出すキー
1862         *
1863         * @return      パラメータ値(未設定時は、-1)
1864         */
1865        protected int getIntParam( final String key ) {
1866                final String rtn = (viewParam == null) ? null : viewParam.get( key );
1867                return (rtn == null) ? -1 : Integer.parseInt( rtn );
1868        }
1869
1870        /**
1871         * ViewForm のサブクラスに渡すパラメータマップの値を boolean で返します。
1872         * パラメータは、初期値が設定されているものとし、null の場合は、false を返します。
1873         *
1874         * @og.rev 5.5.5.6 (2012/08/31) 新規追加
1875         * @og.rev 6.3.9.1 (2015/11/27) 3項演算子を || or &amp;&amp; で簡素化できる(PMD)。
1876         *
1877         * @param       key     パラメータの取り出すキー
1878         *
1879         * @return      パラメータ値(未設定時は、false)
1880         */
1881        protected boolean getBoolParam( final String key ) {
1882                // 6.3.9.1 (2015/11/27) Boolean#parseBoolean(String) は、引数が null の場合、false を返す(引数のnullチェックは不要)。
1883                return viewParam != null && Boolean.parseBoolean( viewParam.get( key ) );
1884        }
1885
1886        /**
1887         * ViewForm のサブクラスに渡すパラメータ(文字列配列のArrayList)を設定します。
1888         *
1889         * @og.rev 5.5.8.3 (2012/11/17) ViewParamTag のパラメータを追加します。
1890         * @og.rev 5.5.9.0 (2012/12/03) ArrayListに変更
1891         *
1892         * @param       list 文字列配列のArrayList
1893         */
1894        public void setViewArrayList( final List<String[]> list ) {
1895                viewArrayList = list ;
1896        }
1897
1898        /**
1899         * ViewForm のサブクラスに渡すパラメータ(文字列配列のArrayList)の値を返します。
1900         * パラメータは、初期値が設定されているものとし、そのまま、値を返します。
1901         *
1902         * @og.rev 5.5.8.3 (2012/11/17) 新規追加
1903         * @og.rev 5.5.9.0 (2012/12/03) ArrayListに変更
1904         *
1905         * @return      パラメータ値
1906         */
1907        protected List<String[]> getViewArrayList() {
1908                return viewArrayList;
1909        }
1910
1911        /**
1912         * No 欄そのものを作成するかどうかを返します。
1913         *
1914         * numberType 属性に、"delete" という値を設定した場合は、No 欄そのものを
1915         * 作成しません。それ以外は、作成します。
1916         * 初期値は、作成する(true)です。
1917         *
1918         * @og.rev 3.5.5.0 (2004/03/12) 新規追加
1919         *
1920         * @return      No欄そのものを作成するかどうか(true:作成する/false:作成しない)
1921         */
1922        protected boolean isNumberDisplay() {
1923                return numberDisplay;
1924        }
1925
1926        /**
1927         * マーカーオブジェクト(リンク、マーカー)を設定します。
1928         * ここでは、旧 ViewForm 属性を 新ViewForm に直接セットします。
1929         *
1930         * @og.rev 3.5.6.1 (2004/06/25) 新規追加
1931         * @og.rev 3.8.6.1 (2006/10/20) editMarker 追加
1932         *
1933         * @param       view ViewFormオブジェクト
1934         */
1935        public void markerSet( final ViewForm view ) {
1936                if( view instanceof AbstractViewForm ) {
1937                        viewLink   = ((AbstractViewForm)view).viewLink ;
1938                        if( viewLink != null ) { viewLink.setDBTableModel( table ); }
1939                        viewMarker = ((AbstractViewForm)view).viewMarker;
1940                        if( viewMarker != null ) { viewMarker.setDBTableModel( table ); }
1941                        editMarker = ((AbstractViewForm)view).editMarker;
1942                        if( editMarker != null ) { editMarker.setDBTableModel( table ); }
1943                }
1944                else {
1945                        final String errMsg = "AbstractViewForm 以外の view は、サポートしていません。"
1946                                        + " view=[" + view + "]" ;
1947                        throw new HybsSystemException( errMsg );
1948                }
1949        }
1950
1951        /**
1952         * テーブルのバックグラウンドカラーの入れ替えのサイクルをセットします。
1953         * 0(ゼブラなし)、-1(ワーニング)、-2以下(エラー)、1(ゼブラ)、2以上(行数まとめ)
1954         * 初期値は、1(ゼブラ)です。
1955         *
1956         * @og.rev 3.5.6.2 (2004/07/05) ViewForm_HTMLTable より移動
1957         *
1958         * @param  sycle  0(ゼブラなし)、-1(ワーニング)、-2以下(エラー)、1(ゼブラ)、2以上(行数まとめ)
1959         */
1960        public void setBgColorCycle( final int sycle ) {
1961                bgColorCycle    = 1;            // 強制的に設定
1962
1963                if( sycle > 0 ) {                                               // 1(ゼブラ)、2以上(行数まとめ)
1964                        colorRow0               = BG_COLOR_ROW0 ;
1965                        colorRow1               = BG_COLOR_ROW1 ;
1966                        bgColorCycle    = sycle;                        // このケースのみ引数を設定
1967                }
1968                else if( sycle == -1 ) {                                        // -1(ワーニング)
1969                        colorRow0               = BG_WARNING_COLOR_ROW0 ;
1970                        colorRow1               = BG_WARNING_COLOR_ROW1 ;
1971                }
1972                else if( sycle < -1 ) {                                 // -2以下(エラー)
1973                        colorRow0               = BG_ERROR_COLOR_ROW0 ;
1974                        colorRow1               = BG_ERROR_COLOR_ROW1 ;
1975                }
1976                else {                                                                                  // 0(ゼブラなし)
1977                        colorRow0               = "" ;
1978                        colorRow1               = "" ;
1979                }
1980        }
1981
1982        /**
1983         * テーブルのバックグラウンドカラーのクラスに指定するカラム名を指定します。
1984         *
1985         * 通常のゼブラ模様は、tr 属性のクラス指定として、row_0、row_1 が指定されます。
1986         * その代わりに、ここで指定されたカラムの値がクラス属性として設定されます。
1987         * (指定するのはカラム名です。行単位にクラス属性の値を変えることが可能です。)
1988         * 選択行(row_sel)は、優先して使用されます。
1989         * 出力されるクラス名は、"row_" + 属性値 になります。
1990         *
1991         * @og.rev 5.1.8.0 (2010/07/01) 新規追加
1992         *
1993         * @param  clsClm ゼブラ模様の替わりに指定するクラスを格納したカラム名
1994         */
1995        public void setBgColorClsClm( final String clsClm ) {
1996                if( clsClm != null ) {
1997                        bgColorClsClmNo = table.getColumnNo( clsClm );
1998                }
1999        }
2000
2001        /**
2002         * テーブルのバックグラウンドカラーの値をセットします。
2003         * これは、DBTableModele が指定の行番号の時に、BG_COLOR_ROWSEL を
2004         * 返します。それ以外は、通常の getBgColorCycleClass( int )と
2005         * 同じ結果を返します。
2006         * BG_COLOR_ROWSEL の使用有無は、システムパラメータの
2007         * VIEW_USE_SELROW_COLOR 属性で指定できます。
2008         *
2009         * @og.rev 3.7.0.3 (2005/03/01) 新規追加
2010         * @og.rev 3.7.1.1 (2005/05/31) SEL_ROW機能使用時に、BG_COLOR_ROWSEL の使用 有/無を指定
2011         *
2012         * @param       indx 先頭からの連番( 0から始める )
2013         * @param       row 行番号
2014         *
2015         * @return      行の色を指定する class 属性( cssファイルで指定 )
2016         * @see #getBgColorCycleClass( int )
2017         */
2018        protected String getBgColorCycleClass( final int indx,final int row ) {
2019                return useSelRowColor && scrollRowNo == row ? BG_COLOR_ROWSEL : getBgColorCycleClass( indx ) ;          // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
2020        }
2021
2022        /**
2023         * テーブルのバックグラウンドカラーの値をセットします。
2024         * 行番号は, 0から始まるので、偶数を HTML_BG_COLOR_ROW0 、
2025         * 奇数行を HTML_BG_COLOR_ROW1 とします。
2026         * setBgColorCycle で、設定値変換しています。
2027         * bgColorClsClm が指定されている場合は、その値を利用したクラス属性を返します。
2028         * クラス名は、"row_" + 指定カラムの値 です。
2029         * 指定カラムの値 が、null または、空文字列の場合は、従来のゼブラ模様が優先されます。
2030         * また、行選択があれば、そちらが最優先されます。
2031         *
2032         * @og.rev 3.5.6.2 (2004/07/05) ViewForm_HTMLTable より移動
2033         * @og.rev 5.1.8.0 (2010/07/01) bgColorClsClmNo 対応
2034         *
2035         * @param       row 行番号( 0から始める )
2036         *
2037         * @return      行の色を指定する class 属性( cssファイルで指定 )
2038         * @see         #setBgColorClsClm( String )
2039         */
2040        protected String getBgColorCycleClass( final int row ) {
2041                String rtn = null ;
2042
2043                // 5.1.8.0 (2010/07/01) bgColorClsClmNo 対応
2044                if( bgColorClsClmNo >= 0 ) {
2045                        final String val = table.getValue( row,bgColorClsClmNo );
2046                        if( val != null && val.length() > 0 ) {
2047                                rtn = " class=\"row_" + val + "\"";
2048                        }
2049                }
2050
2051                if( rtn == null ) {
2052                        if( (row/bgColorCycle) % 2 == 0 ) {
2053                                rtn = colorRow0;                // 偶数の場合
2054                        }
2055                        else {
2056                                rtn = colorRow1;                // 奇数の場合
2057                        }
2058                }
2059
2060                return rtn ;
2061        }
2062
2063        /**
2064         * スクロールバー用のDIV要素を出力するかどうか(初期値はシステムパラメータ)
2065         *
2066         * スクロールバー対応する為、テーブルの先頭に、DIV要素を出力します。
2067         * 初期値は、システムパラメータ の VIEW_USE_SCROLLBAR です。
2068         * ※ 互換性の関係より、false になっています。
2069         * ※ 互換性の関係より、新しいタイプのヘッダー固定を、TYPE2 とします。
2070         *
2071         * @og.rev 3.5.6.4 (2004/07/16) 新規追加
2072         * @og.rev 3.8.0.3 (2005/07/15) barType 変数の追加
2073         * @og.rev 4.0.0.0 (2007/04/10) ヘッダー固定のスクロールタイプは、TYPE2 のみにする。
2074         *
2075         * @param  useBar  スクロールバー用のDIV要素の出力 [true:出力する/false:出力しない]
2076         */
2077        public void setUseScrollBar( final boolean useBar ) {
2078                useScrollBar  = useBar;
2079        }
2080
2081        /**
2082         * スクロールバー用の開始DIV要素返します。
2083         *
2084         * スクロールバー対応する為、テーブルの先頭に、DIV要素を出力します。
2085         * 初期値は、システムパラメータ の VIEW_USE_SCROLLBAR で指定されたDIV要素です。
2086         * DIV要素の開始タグになります。
2087         *
2088         * @og.rev 3.8.0.3 (2005/07/15) 新規追加
2089         * @og.rev 4.2.0.0 (2008/03/18) outerにwidthとheightを出すように修正
2090         *
2091         * @return  LAYER_ST スクロールバー用の開始DIV要素
2092         */
2093        protected String getScrollBarStartDiv() {
2094                final String layerStart ;
2095                if( useScrollBar ) {
2096                        // 6.1.0.0 (2014/12/26) refactoring:Prefer StringBuffer over += for concatenating strings
2097                        final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE )
2098                                .append( "<div id=\"divPos\" style=\"" );
2099                        if( height != null ){
2100                                buf.append( "height:" ).append( height ).append( ';' );
2101                        }
2102                        if( width != null ){
2103                                buf.append( "width:" ).append( width ).append( ';' );
2104                        }
2105                        buf.append( "\" ><div id=\"outer\"><div id=\"layer\" onscroll=\"SetScrollHeader(this);\"><div id=\"divHide\">" );
2106
2107                        layerStart = buf.toString();
2108                }
2109                else {
2110                        layerStart = LAYER_ST0;
2111                }
2112
2113                return layerStart;
2114        }
2115
2116        /**
2117         * スクロールバー用の終了DIV要素返します。
2118         *
2119         * スクロールバー対応する為、テーブルの終了に、DIV要素を出力します。
2120         * 初期値は、システムパラメータ の VIEW_USE_SCROLLBAR で指定されたDIV要素です。
2121         * DIV要素の終了タグになります。
2122         *
2123         * @og.rev 3.8.0.3 (2005/07/15) 新規追加
2124         *
2125         * @return  スクロールバー用の終了DIV要素
2126         */
2127        protected String getScrollBarEndDiv() {
2128                String layerEnd = LAYER_END0 ;
2129                if( useScrollBar ) {
2130                        layerEnd = LAYER_END2 ;
2131                }
2132                return layerEnd;
2133        }
2134
2135        /**
2136         * 指定の行番号まで画面をスクロールさせる場合の行番号を設定します。
2137         *
2138         * 画面をスクロール後、リンク等で他画面を表示後、戻ってきた場合に、
2139         * 先のスクロール位置まで戻します。
2140         * ただし、厳密に戻すことはできないため、大体のあたりに戻します。
2141         * 指定しない場合(クリアする場合)は、-1 をセットしてください。
2142         * useSelRowColor は、選択行に色づけするかどうかを指定します。
2143         *
2144         * @og.rev 3.7.0.3 (2005/03/01) 新規追加
2145         * @og.rev 3.7.1.1 (2005/05/31) 選択行マーカーの使用有無
2146         *
2147         * @param       rowNo   指定の行番号まで画面をスクロールさせる場合の行番号
2148         * @param       useSelRowColor  選択行マーカーの使用有無
2149         */
2150        public void setScrollRowNo( final int rowNo, final boolean useSelRowColor ) {
2151                scrollRowNo = rowNo;
2152                firstChecked = false;
2153                this.useSelRowColor = useSelRowColor;
2154        }
2155
2156        /**
2157         * 設定値に "_" が含まれている場合にレンデラーを使用するカラムをCSV形式で指定します。
2158         *
2159         * これは、従来の カラム定義の WRITABLE エディターと同等の働きを行うように
2160         * カラム属性を指定します。
2161         * WRITABLE エディターは、設定値にアンダーバー "_" が含まれている場合に、
2162         * その値を書込み禁止にする機能です。これは、エディター自身が値を判断して
2163         * 書き込み許可か禁止かを判断しています。
2164         * この動きを汎用的にするため、指定のカラムをCSV形式(CSV)で指定
2165         * することにより、レンデラーとエディターを設定値によって動的に切り替える
2166         * 機能を実現します。
2167         * その場合、表示/編集ともに、先頭のアンダーバーは削除されます。
2168         * また、全カラムについて、有効にする場合は、writableControl="*" を設定します。
2169         *
2170         * @og.rev 3.8.0.9 (2005/10/17) 新規追加
2171         * @og.rev 5.1.8.0 (2010/07/01) 内部ロジック変更(setBooleanArray)
2172         *
2173         * @param  wrtCtrl 書き込み制御を行いたいカラムをCSV形式で指定
2174         */
2175        public void setWritableControl( final String wrtCtrl ) {
2176                setBooleanArray( wrtCtrl,true,writeCtrl );
2177        }
2178
2179        /**
2180         * CSV形式で指定されたカラムに、true/false の初期設定を行います。
2181         *
2182         * 従来は、各クラスで実装されていた処理を、一箇所にまとめます。
2183         * これにより、各種機能をあらかじめ実装しておきます。
2184         * 指定のカラムが、null の場合は、何も処理を行いません。(つまり、初期値のまま)
2185         * 指定のカラムが、* の場合は、すべてのカラムが指定されたとみなし、配列に値を設定します。
2186         * 指定のカラムが、""(ゼロ文字列)と、"-" の場合は、なにもカラムが指定されていないものとみなされ、
2187         * 初期値の逆で埋められます。
2188         *
2189         * @og.rev 5.1.8.0 (2010/07/01) 新規追加
2190         * @og.rev 6.2.1.0 (2015/03/13) カラム名のゼロ文字列と、"-" も除外する。
2191         * @og.rev 5.9.27.0 (2017/12/01) protectedにして子クラスでも使えるようにしておく
2192         *
2193         * @param  clsm    指定のカラムをCSV形式で指定
2194         * @param  def     設定する値
2195         * @param       arrays  設定するboolean配列
2196         */
2197        protected void setBooleanArray( final String clsm , final boolean def , final boolean[] arrays ) {
2198                if( clsm != null ) {
2199                        // 書き込み制御の許可 をカラム単位で設定。* の場合は、全カラム許可
2200                        if( "*".equals( clsm ) ) {
2201                                Arrays.fill( arrays,def );              // 全部埋める
2202                        }
2203                        // 6.2.1.0 (2015/03/13) カラム名のゼロ文字列と、"-" も除外する。
2204                        else if( "-".equals( clsm ) || clsm.isEmpty() ) {
2205                                Arrays.fill( arrays,!def );             // 全部逆で埋める
2206                        }
2207                        else {
2208                                Arrays.fill( arrays,!def );             // 一旦、全部逆で埋める
2209                                final String[] clmNames = StringUtil.csv2Array( clsm );
2210                                for( int i=0; i<clmNames.length; i++ ) {
2211                                        if( clmNames[i] != null && clmNames[i].length() > 0 ) {
2212                                                final int no = table.getColumnNo( clmNames[i] );
2213                                                if( no >= 0 ) { arrays[no] = def; }
2214                                        }
2215                                }
2216                        }
2217                }
2218        }
2219
2220        /**
2221         * ogPopup で検索結果の値を返すキーを、CSV形式で指定します。
2222         *
2223         * popup の検索結果を返す画面で、結果のラジオボタンにイベントセットします。
2224         * この場合、オープンもとのwindow に値を返しますが、そのキーをCSV形式で
2225         * 指定します。
2226         * なお、このメソッドは、一覧表示(HTMLTable)関係のビューのみでサポートして
2227         * いますが、チェックメソッドの関係で、それ以外のビューに適用しても素通り
2228         * するようにします。(エラーにしません)
2229         *
2230         * @og.rev 3.8.6.1 (2006/10/20) 新規追加
2231         *
2232         * @param  rtnKeys ogPopupで値を返すカラム文字列(CSV形式)
2233         */
2234        public void setPopupReturnKeys( final String rtnKeys ) {
2235                // このメソッドは、一覧表示(HTMLTable)関係のビューのみでサポートして
2236                // いますが、チェックメソッドの関係で、それ以外のビューに適用しても素通り
2237                // するようにします。(エラーにしません)
2238        }
2239
2240        /**
2241         * table要素に対して class 属性を設定します。
2242         *
2243         * 従来の システムリソースでのテーブルレイアウトの設定を廃止し、
2244         * CSSファイルで、指定するように変更しています。
2245         * これに伴い、CSSファイルのキーとして、クラス属性を出力します。
2246         * view(または、出力されるtableタグ)のレイアウトは、このクラス属性で
2247         * 指定することが可能になります。
2248         * 初期値は、viewTable です。
2249         *
2250         * @og.rev 4.0.0.0 (2007/04/16) 新規追加
2251         *
2252         * @param       cls     class属性を表す文字列
2253         */
2254        public void setTableClass( final String cls ) {
2255                if( cls != null ) {
2256                        clazz = cls;
2257                }
2258        }
2259
2260        /**
2261         * table要素に対して class 属性を返します。
2262         *
2263         * @og.rev 4.0.0.0 (2007/04/16) 新規追加
2264         * @og.rev 5.9.5.3 (2016/02/26) classにtableIdを付加して返す
2265         * @og.rev 6.4.6.1 (2016/06/03) tableId 廃止(利用目的を明確にするため、パラメータ名をviewClassに変更)
2266         *
2267         * @return      class属性を表す文字列
2268         */
2269        protected String getTableClass() {
2270                return clazz + " " + viewClass;                         // 6.4.6.1 (2016/06/03)
2271        }
2272
2273        /**
2274         * outerのIDを持つDIV要素にheightを指定します。
2275         *
2276         * ビューの高さ、幅を指定できるようにします。
2277         * 内部的には、useScrollBar="true" 時に、div id="divPos" に、
2278         * style 属性を設定しています。(実際は、もう少し複雑)
2279         * これによって1画面に2つのビューを出力する事も可能となります。
2280         * セットする場合は、単位(pt,% など)を付けてください。
2281         * 初期値はnullです。
2282         *
2283         * @og.rev 4.2.0.0 (2008/03/18) 新規追加
2284         *
2285         * @param       high    ビューの高さ
2286         */
2287        public void setHeight( final String high ) {
2288                height = high;
2289        }
2290
2291        /**
2292         * 設定されたheightを返します。
2293         *
2294         * テーブル以外に、高さ、幅を使用する場合に、値を取得できるようにしています。
2295         * これは、セットされた文字列そのものを返しますので、
2296         * 単位(pt,% など)が付いています。
2297         * 初期値はnullです。
2298         *
2299         * @og.rev 6.9.7.0 (2018/05/14) 新規追加
2300         *
2301         * @return      ビューの高さ(未設定の場合は、null)
2302         */
2303        protected String getHeight() {
2304                return height;
2305        }
2306
2307        /**
2308         * outerのIDを持つDIV要素にwidthを指定します。
2309         *
2310         * ビューの高さ、幅を指定できるようにします。
2311         * 内部的には、useScrollBar="true" 時に、div id="divPos" に、
2312         * style 属性を設定しています。(実際は、もう少し複雑)
2313         * これによって1画面に2つのビューを出力する事も可能となります。
2314         * セットする場合は、単位(pt,% など)を付けてください。
2315         * 初期値はnullです。
2316         *
2317         * @og.rev 4.2.0.0 (2008/03/18) 新規追加
2318         *
2319         * @param       wide    ビューの高さ
2320         */
2321        public void setWidth( final String wide ) {
2322                width = wide;
2323        }
2324
2325        /**
2326         * 設定されたwidthを返します。
2327         *
2328         * テーブル以外に、高さ、幅を使用する場合に、値を取得できるようにしています。
2329         * これは、セットされた文字列そのものを返しますので、
2330         * 単位(pt,% など)が付いています。
2331         *
2332         * @og.rev 6.9.7.0 (2018/05/14) 新規追加
2333         *
2334         * @return      ビューの高さ(未設定の場合は、null)
2335         */
2336        protected String getWidth() {
2337                return width;
2338        }
2339
2340        /**
2341         * リソースマネージャを設定します。
2342         * クロス集計時に、useColumnHeader="true"とした場合のみ設定されます。
2343         *
2344         * @og.rev 4.0.0.0 新規作成
2345         *
2346         * @param       res リソースマネージャー
2347         */
2348        public void setResourceManager( final ResourceManager res ) {
2349                resourceManager = res;
2350        }
2351
2352        /**
2353         * リソースマネージャを取得します。
2354         *
2355         * @og.rev 4.0.0.0 新規作成
2356         *
2357         * @return      ResourceManagerリソースマネージャー
2358         */
2359        protected ResourceManager getResourceManager() {
2360                return resourceManager;
2361        }
2362
2363        /**
2364         * 改廃Cのついていない行をスキップするかどうか指定します。
2365         *
2366         * "true" で、改廃Cのついた行をスキップします。
2367         * 初期値はfalseです。
2368         *
2369         * @og.rev 4.3.1.0 (2008/09/08) 新規追加
2370         *
2371         * @param       sne 改廃Cのついていない行をスキップするかどうか(true:スキップする/false:スキップしない)
2372         */
2373        public void setSkipNoEdit( final boolean sne ) {
2374                skipNoEdit = sne;
2375        }
2376
2377        /**
2378         * 改廃Cのついていない行をスキップするかどうか指定します。
2379         *
2380         * skipNoEdit="true"でかつ、編集されていない(改廃Cがついていない)場合のみ
2381         * trueを返します。
2382         *
2383         * @og.rev 4.3.1.0 (2008/09/08) 新規追加
2384         *
2385         * @param       row     行番号
2386         *
2387         * @return      スキップ対象行か
2388         */
2389        protected boolean isSkipNoEdit( final int row ) {
2390                return skipNoEdit && ( table.getModifyType( row ) == null || table.getModifyType( row ).isEmpty() );
2391        }
2392
2393        /**
2394         * 画面遷移なしモードに対応した形で処理を行うかを指定します。
2395         *
2396         * "true" で、画面遷移なしモードに対応します。
2397         * 初期値はfalseです。
2398         *
2399         * @og.rev 4.3.3.0 (2008/10/01) 新規追加
2400         *
2401         * @param       flag 画面遷移なしモードに対応するかどうか(true:対応する/false:対応しない)
2402         */
2403        public void setNoTransition( final boolean flag ) {
2404                noTransition = flag;
2405        }
2406
2407        /**
2408         * 画面遷移なしモードに対応した形で処理を行うかを返します。
2409         *
2410         * "true" で、画面遷移なしモードに対応します。
2411         * 初期値はfalseです。
2412         *
2413         * @og.rev 4.3.3.0 (2008/10/01) 新規追加
2414         *
2415         * @return      画面遷移なしモードに対応するかどうか(true:対応する/false:対応しない)
2416         */
2417        protected boolean isNoTransition() {
2418                return noTransition;
2419        }
2420
2421        /**
2422         * 該当行の行番号と改廃Cを出力します。
2423         * 出力形式は、 rid="[行番号]" kh="[改廃C]" です。
2424         * 改廃Cが付加されていない場合は、改廃Cがnullの場合は、kh属性は出力されません。
2425         * (画面遷移なしモードで使用します)
2426         *
2427         * @og.rev 4.3.3.0 (2008/10/01) 新規作成
2428         *
2429         * @param       row 行番号( 0から始める )
2430         *
2431         * @return      該当行の行番号と改廃C
2432         * @og.rtnNotNull
2433         */
2434        protected String getHiddenRowValue( final int row ) {
2435                String kh = "";
2436                if( table.getModifyType( row ) != null && table.getModifyType( row ).length() > 0 ) {
2437                        kh = " " + HIDDEN_CDKH_KEY + "=\"" + table.getModifyType( row ) + "\"";
2438                }
2439                return " " + HIDDEN_ROW_KEY + "=\"" + row + "\"" + kh;
2440        }
2441
2442        /**
2443         * ビューで表示したカラムの一覧をCSV形式で返します。
2444         *
2445         * @og.rev 5.1.6.0 (2010/05/01) 新規追加
2446         *
2447         * @return      ビューで表示したカラムの一覧
2448         * @og.rtnNotNull
2449         */
2450        public String getViewClms() {
2451                final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE );
2452                for( int i=0; i<clmDisplay.length; i++ ) {
2453                        if( clmDisplay[i] && !( rowWritableFlag && i==0 ) ) {
2454                                if( buf.length() > 0 ) { buf.append( ',' ); }
2455                                buf.append( dbColumn[i].getName() );
2456                        }
2457                }
2458                return buf.toString();
2459        }
2460
2461        /**
2462         * ビューで表示したカラムの一覧をCSV形式で返します。
2463         *
2464         * このメソッドでは、TableFormatter を使用して表示されたカラム一覧を求めます。
2465         *
2466         * @og.rev 6.4.3.4 (2016/03/11) TableFormatter を使用して表示されたカラム一覧を求めます。
2467         *
2468         * @param       format TableFormatterオブジェクト
2469         * @return      ビューで表示したカラムの一覧
2470         * @og.rtnNotNull
2471         */
2472        protected String getViewClms( final TableFormatter format ) {
2473                return format.getLocationStream()                                                                               // IntStream の取得
2474                                                .filter(   loc -> loc >= 0 )                                                    // 処理条件
2475                                                .mapToObj( loc -> table.getColumnName( loc ) )                  // int から String へStreamの変換
2476                                                .collect( Collectors.joining( "," ) );                                  // CSV連結
2477
2478        }
2479
2480        /**
2481         * 表示項目の編集(並び替え)が可能かどうかを返します。
2482         *
2483         * @og.rev 5.1.6.0 (2010/05/01) 新規追加
2484         *
2485         * @return      表示項目の編集(並び替え)が可能かどうか(true:可能)
2486         */
2487        public boolean isEditable() {
2488                return true;
2489        }
2490
2491        /**
2492         * このViewFormが作成された画面IDをセットします。
2493         *
2494         * @og.rev 5.1.7.0 (2010/06/01) 新規追加
2495         *
2496         * @param gamenId 画面ID
2497         */
2498        public void setGamenId( final String gamenId ) {
2499                this.gamenId = gamenId;
2500        }
2501
2502        /**
2503         * このViewFormが作成された画面IDを返します。
2504         *
2505         * @og.rev 5.1.7.0 (2010/06/01) 新規追加
2506         *
2507         * @return      画面ID
2508         */
2509        public String getGamenId() {
2510                return gamenId;
2511        }
2512
2513        /**
2514         * カラムが一括入力アシスト機能を利用するかどうかを返します。
2515         *
2516         * 条件は、一括入力アシストカラムで、かつ、書き込み許可(isColumnWritable(clm)==true)の場合とする。
2517         *
2518         * @og.rev 5.2.1.0 (2010/10/01) 新規作成
2519         *
2520         * @param       column カラム番号
2521         *
2522         * @return      利用する(true)/しない(false)
2523         */
2524        protected boolean isClmBulkSet( final int column ) {
2525                return clmBulkSet[column] && clmWritable[column];
2526        }
2527
2528        /**
2529         * 一括入力カラムのアシスト機能を利用するカラム名を、CSV形式で与えます。
2530         *
2531         * これは、カラムの書き込み時に、一括入力可能なカラムをヘッダーに表示し、
2532         * 一括登録できる機能を提供します。
2533         * この機能は、jsp/common/bulkSet.js JavaScript とともに提供されます。
2534         * IE については、クリップボードも利用できます。Ctrl-C と Ctrl-V でそれぞれ
2535         * 一連のカラムの値の取り出しと書き込みが可能になります。
2536         * "*" を指定すると、すべてのカラムを(columnBulkSet)指定したことになります。
2537         *
2538         * @og.rev 5.2.1.0 (2010/10/01) 新規作成
2539         * @og.rev 6.2.0.0 (2015/02/27) Popup(isRenderer=false のviewMarker)のBuikSet Off化対応
2540         *
2541         * @param       columnName      例:"OYA,KO,HJO,SU,DYSET,DYUPD"
2542         */
2543        public void setColumnBulkSet( final String columnName ) {
2544                setBooleanArray( columnName,true,clmBulkSet );
2545
2546                // 6.2.0.0 (2015/02/27) Popup(isRenderer=false のviewMarker)のBuikSet Off化対応
2547                // result.jsp から update.jsp に画面遷移するときに、再セットされるので、
2548                // 旧のView属性のコピーが必要。(コピーのタイミングでは、早すぎて、ここで書き換えられてしまう。)
2549                if( editMarker != null ) {
2550                        final int[] clmNos = editMarker.getColumnNos();
2551                        if( clmNos != null ) {
2552                                for( int i=0; i<clmNos.length; i++ ) {
2553                                        clmBulkSet[clmNos[i]] = false ; // 6.2.0.0 (2015/02/27) BulkSetしない
2554                                }
2555                        }
2556                }
2557        }
2558
2559        /**
2560         * 引数のフォーマッターに、noDisplayカラムのロケーションをクリアします。
2561         *
2562         * フォーマッター系の noDisplay 処理になります。
2563         *
2564         * @og.rev 6.2.0.0 (2015/02/27) フォーマット系の noDisplay 対応
2565         * @og.rev 6.2.0.1 (2015/03/06) 非表示のマーカーに、Formatter#NO_DISPLAY を使用する。
2566         *
2567         * @param       format  フォーマッター
2568         */
2569        protected void setFormatNoDisplay( final TableFormatter format ) {
2570                final int size = format.getLocationSize();
2571                for( int cl=0; cl<size; cl++ ) {
2572                        final int loc = format.getLocation( cl );
2573                        if( loc >= 0 && !isColumnDisplay( loc ) ) {     // 6.2.0.1 (2015/03/06) 非表示のマーカー
2574                                format.setNoDisplay( cl );                              // 6.2.0.1 (2015/03/06) 非表示のマーカー
2575                        }
2576                }
2577        }
2578
2579        /**
2580         * このViewFormを作成するにあたり、区別するためのクラス属性をセットします。
2581         *
2582         * 通常は、viewForm より tableId を設定します。
2583         * SplitViewTag を使用する場合は、左右分割のため、同じtableId になるため、
2584         * 左右で異なるclassを設定してください。
2585         *
2586         * @og.rev 6.4.6.1 (2016/06/03) 新規追加
2587         *
2588         * @param clazz Viewのクラス属性
2589         */
2590        public void setViewClass( final String clazz ) {
2591                if( clazz != null ) {
2592                        this.viewClass = clazz;
2593                }
2594        }
2595
2596        /**
2597         * このViewFormを作成するにあたり、区別するためのクラス属性を取得します。
2598         *
2599         * 通常は、viewForm より tableId を設定します。
2600         * SplitViewTag を使用する場合は、左右分割のため、同じtableId になるため、
2601         * 左右で異なるclassを設定してください。
2602         *
2603         * @og.rev 6.4.6.1 (2016/06/03) 新規追加
2604         *
2605         * @return Viewのクラス属性
2606         */
2607        protected String getViewClass() {
2608                return viewClass;
2609        }
2610}