com.moyosoft.exchange.task
Interface TaskRecurrencePattern

public interface TaskRecurrencePattern

Represents a recurrence pattern of a task. Based on the type of recurrence, the following methods are used to configure the recurrence:

• RecurrenceType.RecursDaily:

getInterval setInterval

Indicates the number of days between occurrences. The value 1 (one) means the task occurs every day.

• RecurrenceType.RecursWeekly:

getInterval setInterval	Indicates the number of weeks between occurrences. The value 1 (one) means the task occurs every week.
getDaysOfWeek setDaysOfWeek setDayOfWeek	Indicates the days of week when the task occurs.

• RecurrenceType.RecursMonthly:

getInterval setInterval	Indicates the number of months between occurrences. The value 1 (one) means the task occurs every month.
getDayOfWeek setDayOfWeek	Indicates the day of week when the task occurs.

• RecurrenceType.RecursMonthNth:

getInterval setInterval	Indicates the number of months between occurrences. The value 1 (one) means the task occurs every month.
getDayOfMonth setDayOfMonth	Indicates the month's day on which the task occurs. Accepted values are in the range from 1 to 31.

• RecurrenceType.RecursYearly:

getDayOfWeek setDayOfWeek	Indicates the day of week when the task occurs.
getMonthOfYear setMonthOfYear	Indicates the month during which the task occurs. Accepted values are in the range from 1 to 12.

• RecurrenceType.RecursYearNth:

getDayOfMonth setDayOfMonth	Indicates the month's day on which the task occurs. Accepted values are in the range from 1 to 31.
getMonthOfYear setMonthOfYear	Indicates the month during which the task occurs. Accepted values are in the range from 1 to 12.

Example code:

Exchange exchange = new Exchange("hostname", "username", "password");
ExchangeTask task = exchange.getTasksFolder().createTask();
RecurrencePattern recurrencePattern = task.getRecurrencePattern();

// Recurs 4 times every 2 months:
recurrencePattern.setRecurrenceType(RecurrenceType.RecursMonthly);
recurrencePattern.setInterval(2);
recurrencePattern.setOccurrences(4);
task.save();


Method Summary

int	getDayOfMonth() Returns the month's day on which the task occurs.
DayOfWeek	getDayOfWeek() Returns the day of week when the task occurs.
int	getDayOfWeekIndex() Returns on which week in a month the task occurs.
java.util.List<DayOfWeek>	getDaysOfWeek() Returns the days of week when the task occurs.
int	getInterval() Returns the interval between two occurrences in days, weeks or months depending on the type of recurrence.
int	getMonthOfYear() Returns the month during which the task occurs.
int	getOccurrences() Returns the occurrences count of the recurring task indicating how many times the task recurs.
ExchangeTask	getParent() Returns the parent task of this recurrence pattern.
java.util.Date	getPatternEndDate() Returns the end date until which the task recurs.
java.util.Date	getPatternStartDate() Returns the start date on which the task starts recurring.
RecurrenceType	getRecurrenceType() Returns the type of this recurrence pattern.
boolean	hasNoEndDate() Returns true if the task recurs indefinitely without an end date specified, false otherwise.
boolean	isEmpty() Returns true if no recurrence pattern is defined for the parent task item.
void	setDayOfMonth(int value) Sets the month's day on which the task occurs.
void	setDayOfWeek(DayOfWeek value) Sets the day of week when the task occurs.
void	setDayOfWeekIndex(int index) Sets the week in a month the task occurs on.
void	setDaysOfWeek(DayOfWeek... value) Sets the days of week when the task occurs.
void	setHasNoEndDate(boolean value) When set to true, the task will recur indefinitely.
void	setInterval(int value) Returns the interval between two occurrences of the recurring task.
void	setMonthOfYear(int value) Sets the month during which the task occurs.
void	setOccurrences(int value) Sets the occurrences count of the recurring task.
void	setPatternEndDate(java.util.Date value) Sets the end date until which the task recurs.
void	setPatternStartDate(java.util.Date value) Sets the start date when the task starts recurring.
void	setRecurrenceType(RecurrenceType value) Sets the type of this recurrence pattern.

Method Detail

isEmpty

boolean isEmpty()
                throws ExchangeServiceException

Returns true if no recurrence pattern is defined for the parent task item.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getDayOfMonth

int getDayOfMonth()
                  throws ExchangeServiceException

Returns the month's day on which the task occurs. Accepted values are in the range from 1 to 31.

Only applicable if the RecurrenceType is RecursMonthNth or RecursYearNth.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setDayOfMonth

void setDayOfMonth(int value)
                   throws ExchangeServiceException

Sets the month's day on which the task occurs. Accepted values are in the range from 1 to 31.

Only applicable if the RecurrenceType is RecursMonthNth or RecursYearNth. If other RecurrenceType is set, this method will throw an exception.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getDayOfWeek

DayOfWeek getDayOfWeek()
                       throws ExchangeServiceException

Returns the day of week when the task occurs.

Only applicable if the RecurrenceType is RecursWeekly, RecursMonthly or RecursYearly.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setDayOfWeek

void setDayOfWeek(DayOfWeek value)
                  throws ExchangeServiceException

Sets the day of week when the task occurs.

Only applicable if the RecurrenceType is RecursWeekly, RecursMonthly or RecursYearly. If other RecurrenceType is set, this method will throw an exception.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getDaysOfWeek

java.util.List<DayOfWeek> getDaysOfWeek()
                                        throws ExchangeServiceException

Returns the days of week when the task occurs.

Only applicable if the RecurrenceType is RecursWeekly.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setDaysOfWeek

void setDaysOfWeek(DayOfWeek... value)
                   throws ExchangeServiceException

Sets the days of week when the task occurs.

Only applicable if the RecurrenceType is RecursWeekly. If other RecurrenceType is set, this method will throw an exception.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getDayOfWeekIndex

int getDayOfWeekIndex()
                      throws ExchangeServiceException

Returns on which week in a month the task occurs. Possible values are -1 (last week), 1 (first week), 2 (second week), 3 (third week) and 4 (fourth week).

Only applicable if the RecurrenceType is RecursMonthly or RecursYearly.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setDayOfWeekIndex

void setDayOfWeekIndex(int index)
                       throws ExchangeServiceException

Sets the week in a month the task occurs on. Possible values are -1 (last week), 1 (first week), 2 (second week), 3 (third week) and 4 (fourth week).

Only applicable if the RecurrenceType is RecursMonthly or RecursYearly.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getInterval

int getInterval()
                throws ExchangeServiceException

Returns the interval between two occurrences in days, weeks or months depending on the type of recurrence.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setInterval

void setInterval(int value)
                 throws ExchangeServiceException

Returns the interval between two occurrences of the recurring task.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getMonthOfYear

int getMonthOfYear()
                   throws ExchangeServiceException

Returns the month during which the task occurs. Accepted values are in the range from 1 to 12.

Only applicable if the RecurrenceType is RecursYearly or RecursYearNth.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setMonthOfYear

void setMonthOfYear(int value)
                    throws ExchangeServiceException

Sets the month during which the task occurs. Accepted values are in the range from 1 to 12.

Only applicable if the RecurrenceType is RecursYearly or RecursYearNth. If other RecurrenceType is set, this method will throw an exception.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

hasNoEndDate

boolean hasNoEndDate()
                     throws ExchangeServiceException

Returns true if the task recurs indefinitely without an end date specified, false otherwise.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setHasNoEndDate

void setHasNoEndDate(boolean value)
                     throws ExchangeServiceException

When set to true, the task will recur indefinitely.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getOccurrences

int getOccurrences()
                   throws ExchangeServiceException

Returns the occurrences count of the recurring task indicating how many times the task recurs.

Returns:

occurrences count or -1 if the task recurs indefinitely (hasNoEndDate) or is limited by an end date (getPatternEndDate)

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setOccurrences

void setOccurrences(int value)
                    throws ExchangeServiceException

Sets the occurrences count of the recurring task.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getPatternEndDate

java.util.Date getPatternEndDate()
                                 throws ExchangeServiceException

Returns the end date until which the task recurs.

Returns:

the end date or null if the task recurs indefinitely (hasNoEndDate) or is limited by an occurrences count (getOccurrences)

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setPatternEndDate

void setPatternEndDate(java.util.Date value)
                       throws ExchangeServiceException

Sets the end date until which the task recurs.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getPatternStartDate

java.util.Date getPatternStartDate()
                                   throws ExchangeServiceException

Returns the start date on which the task starts recurring.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setPatternStartDate

void setPatternStartDate(java.util.Date value)
                         throws ExchangeServiceException

Sets the start date when the task starts recurring.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getRecurrenceType

RecurrenceType getRecurrenceType()
                                 throws ExchangeServiceException

Returns the type of this recurrence pattern.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

setRecurrenceType

void setRecurrenceType(RecurrenceType value)
                       throws ExchangeServiceException

Sets the type of this recurrence pattern.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.

getParent

ExchangeTask getParent()
                       throws ExchangeServiceException

Returns the parent task of this recurrence pattern.

Throws:

ExchangeServiceException - if any errors occur during the communication with Exchange.