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}