android.pim
Class RecurrenceSet

java.lang.Object
  android.pim.RecurrenceSet

public class RecurrenceSet
extends Object

Basic information about a recurrence, following RFC 2445 Section 4.8.5. Contains the RRULEs, RDATE, EXRULEs, and EXDATE properties.

Field Summary

long[]	exdates
EventRecurrence[]	exrules
long[]	rdates
EventRecurrence[]	rrules

Constructor Summary

RecurrenceSet(ContentValues values)
Creates a new RecurrenceSet from information stored in the events table in the CalendarProvider.

RecurrenceSet(Cursor cursor)
Creates a new RecurrenceSet from information stored in a database Cursor pointing to the events table in the CalendarProvider.

RecurrenceSet(String rruleStr, String rdateStr, String exruleStr, String exdateStr)

Method Summary

boolean	hasRecurrence() Returns whether or not a recurrence is defined in this RecurrenceSet.
static long[]	parseRecurrenceDates(String recurrence) Parses the provided RDATE or EXDATE string into an array of longs representing each date/time in the recurrence.
static boolean	populateComponent(Cursor cursor, ICalendar.Component component)
static boolean	populateContentValues(ICalendar.Component component, ContentValues values) Populates the database map of values with the appropriate RRULE, RDATE, EXRULE, and EXDATE values extracted from the parsed iCalendar component.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

rrules

public EventRecurrence[] rrules

rdates

public long[] rdates

exrules

public EventRecurrence[] exrules

exdates

public long[] exdates

Constructor Detail

RecurrenceSet

public RecurrenceSet(ContentValues values)

Creates a new RecurrenceSet from information stored in the events table in the CalendarProvider.

Parameters:

values - The values retrieved from the Events table.

RecurrenceSet

public RecurrenceSet(Cursor cursor)

Creates a new RecurrenceSet from information stored in a database Cursor pointing to the events table in the CalendarProvider. The cursor must contain the RRULE, RDATE, EXRULE, and EXDATE columns.

Parameters:

cursor - The cursor containing the RRULE, RDATE, EXRULE, and EXDATE columns.

RecurrenceSet

public RecurrenceSet(String rruleStr,
                     String rdateStr,
                     String exruleStr,
                     String exdateStr)

Method Detail

hasRecurrence

public boolean hasRecurrence()

Returns whether or not a recurrence is defined in this RecurrenceSet.

Returns:

Whether or not a recurrence is defined in this RecurrenceSet.

parseRecurrenceDates

public static long[] parseRecurrenceDates(String recurrence)

Parses the provided RDATE or EXDATE string into an array of longs representing each date/time in the recurrence.

Parameters:

recurrence - The recurrence to be parsed.

Returns:

The list of date/times.

populateContentValues

public static boolean populateContentValues(ICalendar.Component component,
                                            ContentValues values)

Populates the database map of values with the appropriate RRULE, RDATE, EXRULE, and EXDATE values extracted from the parsed iCalendar component.

Parameters:

component - The iCalendar component containing the desired recurrence specification.

values - The db values that should be updated.

Returns:

true if the component contained the necessary information to specify a recurrence. The required fields are DTSTART, one of DTEND/DURATION, and one of RRULE/RDATE. Returns false if there was an error, including if the date is out of range.

populateComponent

public static boolean populateComponent(Cursor cursor,
                                        ICalendar.Component component)