// Copyright (C) 2006 Google Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package com.google.ical.compat.jodatime;
import com.google.ical.iter.RecurrenceIterable;
import com.google.ical.iter.RecurrenceIterator;
import com.google.ical.iter.RecurrenceIteratorFactory;
import com.google.ical.values.DateTimeValueImpl;
import com.google.ical.values.DateValue;
import com.google.ical.values.TimeValue;
import java.text.ParseException;
import org.joda.time.DateTime;
import org.joda.time.DateTimeZone;
import org.joda.time.ReadableDateTime;
/**
* a factory for converting RRULEs and RDATEs into
* <code>Iterator<DateTime></code> and
* <code>Iterable<DateTime></code>.
*
* @see RecurrenceIteratorFactory
*
* @author mikesamuel+svn@gmail.com (Mike Samuel)
*/
public class DateTimeIteratorFactory {
/**
* given a block of RRULE, EXRULE, RDATE, and EXDATE content lines, parse
* them into a single date time iterator.
* @param rdata RRULE, EXRULE, RDATE, and EXDATE lines.
* @param start the first occurrence of the series.
* @param tzid the local timezone -- used to interpret start and any dates in
* RDATE and EXDATE lines that don't have TZID params.
* @param strict true if any failure to parse should result in a
* ParseException. false causes bad content lines to be logged and ignored.
*/
public static DateTimeIterator createDateTimeIterator(
String rdata, ReadableDateTime start, DateTimeZone tzid, boolean strict)
throws ParseException {
return new RecurrenceIteratorWrapper(
RecurrenceIteratorFactory.createRecurrenceIterator(
rdata, dateTimeToDateValue(start.toDateTime().withZone(tzid)),
TimeZoneConverter.toTimeZone(tzid), strict));
}
/**
* given a block of RRULE, EXRULE, RDATE, and EXDATE content lines, parse
* them into a single date time iterable.
* @param rdata RRULE, EXRULE, RDATE, and EXDATE lines.
* @param start the first occurrence of the series.
* @param tzid the local timezone -- used to interpret start and any dates in
* RDATE and EXDATE lines that don't have TZID params.
* @param strict true if any failure to parse should result in a
* ParseException. false causes bad content lines to be logged and ignored.
*/
public static DateTimeIterable createDateTimeIterable(
String rdata, ReadableDateTime start, DateTimeZone tzid, boolean strict)
throws ParseException {
return new RecurrenceIterableWrapper(
RecurrenceIteratorFactory.createRecurrenceIterable(
rdata, dateTimeToDateValue(start.toDateTime().withZone(tzid)),
TimeZoneConverter.toTimeZone(tzid), strict));
}
/**
* creates a date-time iterator given a recurrence iterator from
* {@link com.google.ical.iter.RecurrenceIteratorFactory}.
*/
public static DateTimeIterator createDateTimeIterator(
RecurrenceIterator rit) {
return new RecurrenceIteratorWrapper(rit);
}
private static final class RecurrenceIterableWrapper
implements DateTimeIterable {
private final RecurrenceIterable it;
public RecurrenceIterableWrapper(RecurrenceIterable it) { this.it = it; }
public DateTimeIterator iterator() {
return new RecurrenceIteratorWrapper(it.iterator());
}
}
private static final class RecurrenceIteratorWrapper
implements DateTimeIterator {
private final RecurrenceIterator it;
RecurrenceIteratorWrapper(RecurrenceIterator it) { this.it = it; }
public boolean hasNext() { return it.hasNext(); }
public DateTime next() { return dateValueToDateTime(it.next()); }
public void remove() { throw new UnsupportedOperationException(); }
public void advanceTo(ReadableDateTime d) {
DateTime dUtc = d.toDateTime().withZone(DateTimeZone.UTC);
it.advanceTo(dateTimeToDateValue(dUtc));
}
}
static DateTime dateValueToDateTime(DateValue dvUtc) {
if (dvUtc instanceof TimeValue) {
TimeValue tvUtc = (TimeValue) dvUtc;
return new DateTime(
dvUtc.year(),
dvUtc.month(), // java.util's dates are zero-indexed
dvUtc.day(),
tvUtc.hour(),
tvUtc.minute(),
tvUtc.second(),
0,
DateTimeZone.UTC);
} else {
return new DateTime(
dvUtc.year(),
dvUtc.month(), // java.util's dates are zero-indexed
dvUtc.day(),
0,
0,
0,
0,
DateTimeZone.UTC);
}
}
static DateValue dateTimeToDateValue(ReadableDateTime dt) {
return new DateTimeValueImpl(
dt.getYear(), dt.getMonthOfYear(), dt.getDayOfMonth(),
dt.getHourOfDay(), dt.getMinuteOfHour(), dt.getSecondOfMinute());
}
private DateTimeIteratorFactory() {
// uninstantiable
}
}