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.resource;
017
018import org.opengion.hayabusa.common.HybsSystem;
019import org.opengion.hayabusa.common.HybsSystemException;
020
021import java.util.Calendar;
022import java.util.Map;
023import java.util.SortedMap;
024import java.util.TreeMap ;
025import java.util.BitSet ;
026
027/**
028 * 事業所(CDJGS) 毎の休日カレンダデータオブジェクトです。
029 *
030 * カレンダデータは、指定の事業所に関して、すべての休日情報を持っています。
031 * 元のカレンダテーブル(GE13)の 1日(DY1)〜31日(DY31)までの日付け欄に対して、
032 * 休日日付けの 年月日 に対する、休日かどうかを判断できるだけの情報を保持します。
033 * 具体的には、休日の年月日に対する List を持つことになります。
034 * このクラスは、パッケージプライベートになっています。このオブジェクトを作成するのは、
035 * CalendarFactory#getCalendarData( String ) で行います。引数は、事業所コード(cdjgs)です。
036 * このカレンダオブジェクトを使用するには、事業所カレンダテーブル(GE13) を使用する
037 * ことを許可しておく必要があります。
038 * 許可は、システムパラメータ の USE_CALENDAR_DATABASE 属性を true に
039 * 設定します(初期値は、互換性優先の false です。)
040 * この、カレンダテーブルは、GE13 固定です。他のテーブルを使用する場合は、
041 * ビュー等を作成する必要があります。
042 * カレンダテーブル は、通常 DEFAULT DBIDを使用しますが、RESOURCE_CALENDAR_DBID
043 * を設定することで、他のデータベースから読み取ることが可能になります。
044 *
045 * @og.rev 3.6.0.0 (2004/09/17) 新規作成
046 * @og.group リソース管理
047 *
048 * @version  4.0
049 * @author   Kazuhiko Hasegawa
050 * @since    JDK5.0,
051 */
052class CalendarDBData implements CalendarData {
053        private final SortedMap<String,BitSet> ymMap  = new TreeMap<String,BitSet>() ;      // 休日日付けデータを年月をキーに持ちます。
054//      private final Calendar today = Calendar.getInstance();  // 3.8.8.6 (2007/04/20) 廃止
055
056        /**
057         * コンストラクタ
058         *
059         * 配列文字列のデータを元に、CalendarDBDataオブジェクトを構築します。
060         * このコンストラクタは、他のパッケージから呼び出せないように、
061         * パッケージプライベートにしておきます。
062         * 年月データは、連続である必要があります。
063         * 途中に抜けがあるかどうかのチェックを行います。
064         *
065         * @param       data    データベース検索データ
066         * @param       isFlat  縦持ち(false)か横持ち(true)の区別
067         */
068        CalendarDBData( final String[][] data,final boolean isFlat ) {
069                if( isFlat ) {
070                        callFlatTable( data );
071                }
072                else {
073                        callVerticalTable( data );
074                }
075
076                // 3.7.1.1 (2005/05/31)
077//              today.set( Calendar.HOUR_OF_DAY ,12 );  // 昼にセット
078//              today.set( Calendar.MINUTE ,0 );
079//              today.set( Calendar.SECOND ,0 );
080        }
081
082        /**
083         * 横持ち(フラット)配列文字列のデータを元に、日付情報を構築します。
084         * 年月データは、連続である必要があります。
085         * 途中に抜けがあるかどうかのチェックを行います。
086         *
087         * @og.rev 3.8.8.0 (2007/12/22) 休日が全くない場合でも、日付設定する。
088         *
089         * @param data String[][]
090         *                     [0]:年月(YYYYMM) 200406 という形式
091         *                     [1]〜[31] 1日〜31日のデータ
092         *                           0:平日 / その他:休日
093         */
094        private void callFlatTable( final String[][] data ) {
095                for( int ym=0; ym<data.length; ym++ ) {
096                        String yyyymm = data[ym][0] ;
097                        if( yyyymm.length() != 6 ) {
098                                String errMsg = "年月(YYYYMM)は、YYYYMM(例:200406) という形式で指定して下さい。"
099                                                        + " YYYYMM [" + yyyymm + "]" ;
100                                throw new HybsSystemException( errMsg );
101                        }
102
103                        Calendar month = HybsSystem.getCalendar( yyyymm + "01" );       // 当月
104                        int lastDay = month.getActualMaximum( Calendar.DAY_OF_MONTH );  // 月末日
105
106                        BitSet ymData = new BitSet( lastDay+1 );
107                        for( int d=1; d<=lastDay; d++ ) {
108                                if( ! "0".equals( data[ym][d] ) ) {
109                                        // 日付けのビットを立てます。
110                                        ymData.set( d );
111                                }
112                        }
113
114                        // 日付けのキーがあり、休日設定があれば、有効月とみなし、セットします。
115                        // 3.8.8.0 (2007/12/22) 休日が全くない場合でも、日付設定する。
116                        ymMap.put( yyyymm,ymData );
117                }
118        }
119
120        /**
121         * 縦持ち(バーティカル)配列文字列のデータを元に、日付情報を構築します。
122         * 年月データは、連続である必要があります。
123         * 途中に抜けがあるかどうかのチェックを行います。
124         *
125         * @og.rev 3.8.8.0 (2007/12/22) 休日が全くない場合でも、日付設定する。
126         *
127         * @param data String[][]
128         *                     [0]:年月(YYYYMMDD) 20040601 という形式
129         *                     [1] 0:平日 / その他:休日
130         */
131        private void callVerticalTable( final String[][] data ) {
132                String bk_yyyymm = null;
133                BitSet ymData = null;
134                for( int ymd=0; ymd<data.length; ymd++ ) {
135                        if( data[ymd][0].length() != 8 ) {
136                                String errMsg = "年月日(YYYYMMDD)は、YYYYMMDD(例:20040601) という形式で指定して下さい。"
137                                                        + " YYYYMMDD [" + data[ymd][0] + "]" ;
138                                throw new HybsSystemException( errMsg );
139                        }
140
141                        String yyyymm = data[ymd][0].substring( 0,6 ) ;
142                        if( ! yyyymm.equals( bk_yyyymm ) ) {    // 月のブレイク
143                                // 日付けのキーがあり、休日設定があれば、有効月とみなし、セットします。
144                                // 3.8.8.0 (2007/12/22) 休日が全くない場合でも、日付設定する。
145                                if( ymData != null && bk_yyyymm != null ) {
146                                        ymMap.put( bk_yyyymm,ymData );
147                                }
148                                bk_yyyymm = yyyymm;
149
150                                Calendar month = HybsSystem.getCalendar( yyyymm + "01" );       // 当月
151                                int lastDay = month.getActualMaximum( Calendar.DAY_OF_MONTH );  // 月末日
152
153                                ymData = new BitSet( lastDay+1 );
154                        }
155
156                        if( ! "0".equals( data[ymd][1] ) ) {
157                                // 日付けのビットを立てます。
158                                int dt = Integer.parseInt( data[ymd][0].substring( 6 ) );
159                                ymData.set( dt );
160                        }
161                }
162                // 日付けのキーがあり、休日設定があれば、有効月とみなし、セットします。
163                // 3.8.8.0 (2007/12/22) 休日が全くない場合でも、日付設定する。
164                if( ymData != null && bk_yyyymm != null ) {
165                        ymMap.put( bk_yyyymm,ymData );
166                }
167        }
168
169        /**
170         * 指定の日付けが、休日かどうかを返します。
171         * 指定の日付けが、データベースに設定されていない場合は、すべて休日を
172         * 返すことで、存在しない事を示します。
173         *
174         * @param  day Calendar 指定の日付け
175         *
176         * @return      休日:true それ以外:false
177         *
178         */
179        public boolean isHoliday( final Calendar day ) {
180                String yyyymm = cal2YM( day );
181                BitSet ymData = ymMap.get( yyyymm );
182
183                if( ymData != null ) {
184                        return ymData.get( day.get( Calendar.DATE ) );
185                }
186                else {
187                        return true;    // DB 上に登録されていない場合は、すべて休日とする。
188                }
189        }
190
191        /**
192         * 指定の日付けから、範囲の間に、本日を含むかどうかを返します。
193         * 指定の日付けが、キャッシュしているデータの最大と最小の間に
194         * 存在しない場合は、常に false になります。
195         * 判定は、年月日の項目のみで比較し、時分秒は無視します。
196         *
197         * @og.rev 3.7.1.1 (2005/05/31) 新規追加
198         * @og.rev 3.8.8.6 (2007/04/20) today を毎回求めます。(キャッシュ対策)
199         *
200         * @param  day Calendar 指定の開始日付け
201         * @param       scope   範囲の日数
202         *
203         * @return      本日:true それ以外:false
204         */
205        public boolean isContainedToday( final Calendar day,final int scope ) {
206                final boolean rtnFlag;
207
208                Calendar today = Calendar.getInstance();
209                today.set( Calendar.HOUR_OF_DAY ,12 );  // 昼にセット
210                today.set( Calendar.MINUTE ,0 );
211                today.set( Calendar.SECOND ,0 );
212
213                if( scope == 1 ) {
214                        // false の確率の高い方から、比較します。
215                        rtnFlag = day.get( Calendar.DATE )  == today.get( Calendar.DATE  ) &&
216                                                day.get( Calendar.MONTH ) == today.get( Calendar.MONTH ) &&
217                                                day.get( Calendar.YEAR )  == today.get( Calendar.YEAR  ) ;
218                }
219                else {
220                        Calendar next = (Calendar)day.clone();
221                        next.add( Calendar.DATE,scope );
222                        rtnFlag = day.before( today ) && next.after( today ) ;
223                }
224                return rtnFlag ;
225        }
226
227        /**
228         * 指定の開始、終了日の期間に、平日(稼働日)が何日あるか求めます。
229         * 調査月が、データベース上に存在していない場合は、エラーとします。
230         * 開始と終了が同じ日の場合は、1を返します。
231         *
232         * @param  start Calendar 開始日付け(稼働日に含めます)
233         * @param  end   Calendar 終了日付け(稼働日に含めます)
234         *
235         * @return      稼働日数
236         *
237         */
238        public int getKadoubisu( final Calendar start,final Calendar end ) {
239
240                String stYM = cal2YM( start );
241                String edYM = cal2YM( end );
242
243                SortedMap<String,BitSet> subMap = ymMap.subMap( stYM,edYM+"\0" ) ;        // 終了キーはそのままでは含まれないため。
244
245                @SuppressWarnings("rawtypes")
246                Map.Entry[] entrys = (subMap.entrySet()).toArray( new Map.Entry[subMap.size()] );
247
248                int holidaySu = 0;
249                for( int i=0; i<entrys.length; i++ ) {
250                        String ym = (String)entrys[i].getKey();
251                        BitSet bt ;
252                        if( stYM.equals( ym ) ) {
253                                bt = ((BitSet)entrys[i].getValue()).get( start.get( Calendar.DATE ),31 );
254                        }
255                        else if( edYM.equals( ym ) ) {
256                                bt = ((BitSet)entrys[i].getValue()).get( 1,end.get( Calendar.DATE )+1 );
257                        }
258                        else {
259                                bt = (BitSet)entrys[i].getValue();
260                        }
261                        holidaySu += bt.cardinality() ;
262                }
263
264                long diff = start.getTimeInMillis() - end.getTimeInMillis() ;
265                int dayCount = (int)(diff/(1000*60*60*24)) + 1; // end も含むので+1必要
266
267                return dayCount - holidaySu ;
268        }
269
270        /**
271         * 指定の開始日に平日のみ期間を加算して求められる日付けを返します。
272         * これは、実稼働日計算に使用します。
273         * 例えば、start=20040810 , span=5 で、休日がなければ、10,11,12,13,14 となり、
274         * 20040815 を返します。
275         * 指定の日付けや、期間加算後の日付けが、キャッシュしているデータの
276         * 最大と最小の間に存在しない場合は、エラーとします。
277         *
278         * @param  start Calendar   開始日付け(YYYYMMDD 形式)
279         * @param       span    稼動期間
280         *
281         * @return Calendar 開始日から稼動期間を加算した日付け(当日を含む)
282         *
283         */
284        public Calendar getAfterDay( final Calendar start,final int span ) {
285                Calendar today = (Calendar)(start.clone());
286                int suSpan = span ;
287                while( suSpan > 0 ) {
288                        if( ! isHoliday( today ) ) { suSpan--; }
289                        today.add(Calendar.DATE, 1);            // 日にちを進める。
290                }
291                return today ;
292        }
293
294        /**
295         * カレンダオブジェクトより、年月を YYYYMM 形式にした 文字列を返します。
296         *
297         * @return  カレンダのYYYYMM 文字列
298         */
299        private String cal2YM( final Calendar cal ) {
300                return String.valueOf(
301                                        cal.get( Calendar.YEAR ) * 100 +
302                                        cal.get( Calendar.MONTH ) + 1 );
303        }
304
305        /**
306         * オブジェクトの識別子として,詳細なカレンダ情報を返します。
307         *
308         * @return  詳細なカレンダ情報
309         */
310        public String toString() {
311                StringBuilder rtn = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
312                rtn.append( "CLASS   : ").append( getClass().getName() ).append( HybsSystem.CR );       // クラス名
313
314                @SuppressWarnings("rawtypes")
315                Map.Entry[] entrys = (ymMap.entrySet()).toArray( new Map.Entry[ymMap.size()] );
316
317                for( int i=0; i<entrys.length; i++ ) {
318                        String yyyymm = (String)entrys[i].getKey();
319
320                        rtn.append( yyyymm );
321                        rtn.append( ":" );
322                        rtn.append( (BitSet)entrys[i].getValue() );
323                        rtn.append( HybsSystem.CR );
324                }
325
326                return rtn.toString();
327        }
328}