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}