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.db; 017 018import java.util.Date; // 8.5.4.2 (2024/01/12) PMD 7.0.0 AvoidCalendarDateCreation 対応 019import java.util.Calendar; 020import java.util.Locale; 021import java.text.DateFormat; 022import java.text.SimpleDateFormat; 023 024// import org.opengion.fukurou.system.LogWriter; 025import org.opengion.fukurou.util.HybsDateUtil; 026import static org.opengion.fukurou.system.HybsConst.CR ; // 6.1.0.0 (2014/12/26) 027import static org.opengion.fukurou.system.HybsConst.BUFFER_MIDDLE; // 6.1.0.0 (2014/12/26) refactoring 028 029/** 030 * データのコード情報を取り扱うクラスです。 031 * 032 * パラメータで指定した、開始、終了、ステップ、フォーマット、titleフォーマットの情報から、 033 * HTMLのメニューやリストを作成するための オプション 034 * タグを作成したり、与えられたキーをもとに、チェック済みのオプションタグを作成したりします。 035 * パラメータの初期値は、開始(0)、終了(14)、ステップ(1)、フォーマット(MM/dd)、titleフォーマット(null) です。 036 * 037 * ここでは、日付(年/月/日)の自動生成を行います。 038 * 基準は、実行日に対して、+-の数字を指定します。 039 * 例:20130206 に対して、-2,3,1 を指定すると、20130204,20130205,20130206,20130207,20130208,20130209 となります。 040 * 041 * 開始、終了に、特殊なコマンドを指定する事も可能です。 042 * ・SD :当月の最初の日付にセットします。(当月1日) 043 * ・ED :当月の最後の日付にセットします。(当月月末) 044 * ・SW :日付処理の週初め(月曜日)にセットします。日付は当日より前に移動します。 045 * ・EW :日付処理の週末(日曜日)にセットします。日付は当日より後ろに移動します。 046 * ・D1 ~ DXXX :日を指定の分だけ進めます。D1なら翌日、D200 なら200日後 047 * ・M1 ~ MXXX :月を指定の分だけ進めます。M1なら翌月、M6 なら半年後 048 * ・BSD :先月の最初の日付にセットします。(先月1日) 049 * ・BED :先月の最後の日付にセットします。(先月月末) 050 * ・ASD :翌月の最初の日付にセットします。(翌月1日) 051 * ・AED :翌月の最後の日付にセットします。(翌月月末) 052 * ・M1 :1か月先。数字部分は、任意に指定できるため、M5 とすれば、5か月先。M-2 は、2か月前 053 * 054 * ステップは、無指定の場合は、1日単位です。例えば、SW,M6,7 とすれば、毎週月曜日を6か月先まで作成します。 055 * また、M1 は、1か月単位になります。ただし、開始日を SD などにしないと、大の月と小の月で、おかしくなるので 056 * ご注意ください。 057 * 058 * キーは、8文字の yyyyMMdd 形式で与えられます。ラベルは、フォーマットの指定に準拠します。 059 * フォーマットを指定する場合は、ステップは、必須となります。 060 * フォーマットの初期値は、MM/dd です。 061 * titleフォーマット は、tips表示する場合のフォーマットになります。初期値は、ありません。 062 * 063 * @og.group 選択データ制御 064 * @og.rev 5.6.1.1 (2013/02/08) 新規追加 065 * @og.rev 8.5.6.1 (2024/03/29) 継承で使えるように、一部修正します。 066 * 067 * @version 4.0 068 * @author Kazuhiko Hasegawa 069 * @since JDK5.0, 070 */ 071public class Selection_YMD extends Selection_NULL { 072// private final String CACHE ; // 8.5.6.1 (2024/03/29) 親クラスで定義 073// private final String ST_ED_STEP ; // 8.5.6.1 (2024/03/29) 未使用なので削除 074 075 private final DateFormat lblFmt ; 076 private final DateFormat tipsFmt ; 077 078 private final long maxCacheTime ; // キャッシュの破棄タイミングを計るための最大有効時間 079 080 /** 081 * コンストラクター 082 * 083 * 引数は、開始、終了、ステップ、フォーマット、titleフォーマットです。 084 * パラメータの初期値は、開始(0)、終了(14)、ステップ(1)、フォーマット(MM/dd)、titleフォーマット(null) です。 085 * 086 * @og.rev 6.2.6.0 (2015/06/19) type別Selectionの場合、ラベルリソースを使用する為、言語を引数で渡す。 087 * @og.rev 6.3.4.0 (2015/08/01) Selection_NUM の引数から、lang 属性を削除します。 088 * @og.rev 8.5.4.2 (2024/01/12) Calendar インスタンスの作成方法変更( HybsDateUtil.newCalendar( String ) に移行 ) 089 * 090 * @param editPrm 開始、終了、ステップ、フォーマット、titleフォーマットを表す引数(-2,3,1) 091 */ 092 public Selection_YMD( final String editPrm ) { 093// super(); // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor 094 super( editPrm ); // 8.5.6.1 (2024/03/29) 継承親で、引数付きコンストラクタで初期設定されます。 095 // if( param.length < 2 ) { 096 // final String errMsg = "引数は、開始、終了、[ステップ]、[フォーマット]、[titleフォーマット]です。最低でも2個必要です。"; 097 // throw new IllegalArgumentException( errMsg ); 098 // } 099 100 final String[] param = editPrm == null ? new String[0] : editPrm.split( "," ) ; 101 102 final String start = param.length > 0 ? param[0].trim() : "0" ; 103 final String end = param.length > 1 ? param[1].trim() : "14" ; 104 105 final String step = param.length > 2 ? param[2].trim() : "1" ; 106 final String lblPrm = param.length > 3 ? param[3].trim() : "MM/dd" ; 107 final String tipsPrm = param.length > 4 ? param[4].trim() : "MM月dd日(EEE)" ; 108 109 // 8.5.4.2 (2024/01/12) Calendar インスタンスの作成方法変更( HybsDateUtil.newCalendar( String ) に移行 ) 110 // 8.5.5.0 (2024/02/02) prmB の処理がうまくできていないので、一旦元に戻します。 111 final Calendar cal = Calendar.getInstance(); 112 HybsDateUtil.calendarCalc( cal , start ); 113 // final Calendar cal = HybsDateUtil.newCalendar( start ); 114 115 // 8.5.5.0 (2024/02/02) prmB の処理がうまくできていないので、一旦元に戻します。 116 final Calendar endCal = Calendar.getInstance(); 117 HybsDateUtil.calendarCalc( endCal , end ); 118 // final Calendar endCal = HybsDateUtil.newCalendar( end ); 119 120 final DateFormat keyFmt = new SimpleDateFormat( "yyyyMMdd",Locale.JAPAN ); // キーとなるフォーマット。yyyyMMdd 固定 121 lblFmt = new SimpleDateFormat( lblPrm,Locale.JAPAN ); // ラベルのフォーマット 122 // 6.0.2.5 (2014/10/31) null でないことがわかっている値の冗長な null チェックがあります。 123 tipsFmt = new SimpleDateFormat( tipsPrm,Locale.JAPAN ); // titleフォーマット 124 125// // 8.5.6.1 (2024/03/29) 未使用なので削除 126// ST_ED_STEP = "Start=" + lblFmt.format( cal.getTime() ) + 127// " , End=" + lblFmt.format( endCal.getTime() ) + " , Step=" + step ; 128 129 final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE ); 130 131 // cal.before( endCal ) では、同一時刻の場合に false になる為、ここの判定では使えません。 132 // sign を掛け算しているのは、逆順対応 133 final int sign = step.indexOf( '-' ) < 0 ? 1 : -1 ; // ステップの符号。 134 while( endCal.compareTo( cal ) * sign >= 0 ) { 135 // 8.5.4.2 (2024/01/12) PMD 7.0.0 AvoidCalendarDateCreation 対応 136 final Date time = cal.getTime(); 137 138// final String key = keyFmt.format( cal.getTime() ); 139// final String val = lblFmt.format( cal.getTime() ); 140 final String key = keyFmt.format( time ); // 8.5.4.2 (2024/01/12) PMD 7.0.0 AvoidCalendarDateCreation 対応 141 final String val = lblFmt.format( time ); // 8.5.4.2 (2024/01/12) PMD 7.0.0 AvoidCalendarDateCreation 対応 142 143 buf.append( '>' ).append( val ) // 6.0.2.5 (2014/10/31) char を append する。 144 .append( "</option><option value=\"" ).append( key ) 145// .append("\" title=\"").append( tipsFmt.format( cal.getTime() ) ) 146 .append("\" title=\"").append( tipsFmt.format( time ) ) // 8.5.4.2 (2024/01/12) PMD 7.0.0 AvoidCalendarDateCreation 対応 147 .append( "\">" ).append( val ).append( "</option>" ); 148 149 HybsDateUtil.calendarCalc( cal , step ); 150 } 151 152 cache = buf.toString(); // 8.5.6.1 (2024/03/29) super.cache 153 154 // キャシュの有効期間を求めるための時刻を作成します。キャッシュは、当日のみ有効です。 155 final Calendar now = Calendar.getInstance(); 156 now.set( Calendar.HOUR , 0 ); // 時、分、秒 をリセットします。 157 now.set( Calendar.MINUTE , 0 ); 158 now.set( Calendar.SECOND , 0 ); 159 now.add( Calendar.DAY_OF_MONTH , 1 ); // 1日進めます。 160 161 maxCacheTime = now.getTimeInMillis() ; 162 } 163 164// /** 165// * 初期値が選択済みの 選択肢(オプション)を返します。 166// * このオプションは、引数の値を初期値とするオプションタグを返します。 167// * このメソッドでは、引数のuseShortLabelがtrueに指定された場合に、ラベル(短)をベースとした 168// * ツールチップ表示を行います。 169// * 170// * @og.rev 8.5.6.1 (2024/03/29) 継承元と同じなので削除 171// * 172// * @param selectValue 選択されている値 173// * @param seqFlag シーケンスアクセス機能 [true:ON/false:OFF] 174// * @param useShortLabel ラベル(短)をベースとしたオプション表示を行うかどうか。(未使用) 175// * 176// * @return オプションタグ 177// * @og.rtnNotNull 178// */ 179// @Override 180// public String getOption( final String selectValue,final boolean seqFlag, final boolean useShortLabel ) { 181// // マッチするアドレスを探す。 182// final int selected = CACHE.indexOf( "\"" + selectValue + "\"" ); 183// 184// // 8.5.5.1 (2024/02/29) PMD 7.0.0 OnlyOneReturn メソッドには終了ポイントが 1 つだけ必要 185// final String rtn; 186// if( selected < 0 ) { 187// if( selectValue != null && selectValue.length() > 0 ) { 188// final String errMsg = "年月日範囲に存在しない値が指定されました。" 189// + " value=[" + selectValue + "]" 190// + CR + ST_ED_STEP ; 191// LogWriter.log( errMsg ); 192// } 193//// return CACHE; 194// rtn = CACHE; 195// } 196// else { 197// // "年月日" 文字列の位置が、selected なので、年月日の文字数+2までが、前半部分になる。(年月日の文字数は8固定のはず) 198// final int indx = selected + selectValue.length() + 2 ; 199// 200// final StringBuilder buf = new StringBuilder( BUFFER_MIDDLE ); 201// // 3.6.0.6 (2004/10/22) シーケンスアクセス機能を指定する seqFlag を導入 202// if( seqFlag ) { 203// buf.append( "<option value=\"" ).append( selectValue ).append( '"' ); // 6.0.2.5 (2014/10/31) char を append する。 204// } 205// else { 206// buf.append( CACHE.substring( 0,indx ) ); 207// } 208// buf.append( " selected=\"selected\"" ) 209// .append( CACHE.substring( indx ) ); 210//// return buf.toString() ; 211// rtn = buf.toString() ; 212// } 213// return rtn; 214// } 215 216 /** 217 * 選択肢(value)に対するラベルを返します。 218 * 選択肢(value)が、存在しなかった場合は、選択肢そのものを返します。 219 * このメソッドでは、短縮ラベルを返すかどうかを指定するフラグを指定します。 220 * getValueLabel( XX,false ) は、getValueLabel( XX ) と同じです。 221 * 222 * @og.rev 4.0.0.0 (2005/11/30) を追加 223 * 224 * @param selectValue 選択肢の値 225 * @param isSLbl 短縮ラベルを [true:使用する/false:しない] 226 * 227 * @return 選択肢のラベル 228 * @og.rtnNotNull 229 * @see #getValueLabel( String ) 230 */ 231 @Override 232 public String getValueLabel( final String selectValue,final boolean isSLbl ) { 233 // 選択肢があろうとなかろうと、フォーマット変換して値を返す。 234 235 final Calendar cal = HybsDateUtil.getCalendar( selectValue ); 236 237 // 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 238 return isSLbl && tipsFmt != null 239 ? ( "<span title=\"" + tipsFmt.format( cal.getTime() ) + "\">" + lblFmt.format( cal.getTime() ) + "</span>" ) 240 : lblFmt.format( cal.getTime() ); 241 } 242 243 /** 244 * オブジェクトのキャッシュが時間切れかどうかを返します。 245 * キャッシュが時間切れ(無効)であれば、true を、有効であれば、 246 * false を返します。 247 * 248 * @og.rev 4.0.0.0 (2005/01/31) 新規作成 249 * 250 * @return キャッシュが時間切れなら true 251 */ 252 @Override 253 public boolean isTimeOver() { 254 return System.currentTimeMillis() > maxCacheTime ; 255 } 256}