|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.fortuna.ical4j.model.Component
net.fortuna.ical4j.model.component.CalendarComponent
net.fortuna.ical4j.model.component.VAlarm
public class VAlarm
$Id: VAlarm.java,v 1.21 2009/01/08 14:18:32 fortuna Exp $ [Apr 5, 2004] Defines an iCalendar VALARM component.
4.6.6 Alarm Component Component Name: VALARM Purpose: Provide a grouping of component properties that define an alarm. Formal Definition: A "VALARM" calendar component is defined by the following notation: alarmc = "BEGIN" ":" "VALARM" CRLF (audioprop / dispprop / emailprop / procprop) "END" ":" "VALARM" CRLF audioprop = 2*( ; 'action' and 'trigger' are both REQUIRED, ; but MUST NOT occur more than once action / trigger / ; 'duration' and 'repeat' are both optional, ; and MUST NOT occur more than once each, ; but if one occurs, so MUST the other duration / repeat / ; the following is optional, ; but MUST NOT occur more than once attach / ; the following is optional, ; and MAY occur more than once x-prop ) dispprop = 3*( ; the following are all REQUIRED, ; but MUST NOT occur more than once action / description / trigger / ; 'duration' and 'repeat' are both optional, ; and MUST NOT occur more than once each, ; but if one occurs, so MUST the other duration / repeat / ; the following is optional, ; and MAY occur more than once *x-prop ) emailprop = 5*( ; the following are all REQUIRED, ; but MUST NOT occur more than once action / description / trigger / summary ; the following is REQUIRED, ; and MAY occur more than once attendee / ; 'duration' and 'repeat' are both optional, ; and MUST NOT occur more than once each, ; but if one occurs, so MUST the other duration / repeat / ; the following are optional, ; and MAY occur more than once attach / x-prop ) procprop = 3*( ; the following are all REQUIRED, ; but MUST NOT occur more than once action / attach / trigger / ; 'duration' and 'repeat' are both optional, ; and MUST NOT occur more than once each, ; but if one occurs, so MUST the other duration / repeat / ; 'description' is optional, ; and MUST NOT occur more than once description / ; the following is optional, ; and MAY occur more than once x-prop )Example 1 - Creating an alarm to trigger at a specific time:
java.util.Calendar cal = java.util.Calendar.getInstance();
cal.set(java.util.Calendar.MONTH, java.util.Calendar.DECEMBER);
cal.set(java.util.Calendar.DAY_OF_MONTH, 25);
VAlarm christmas = new VAlarm(cal.getTime());
Example 2 - Creating an alarm to trigger one (1) hour before the scheduled start of the parent event/the parent todo
is due:
VAlarm reminder = new VAlarm(-1000 * 60 * 60);
// repeat reminder four (4) more times every fifteen (15) minutes..
reminder.getProperties().add(new Repeat(4));
reminder.getProperties().add(new Duration(1000 * 60 * 15));
// display a message..
reminder.getProperties().add(Action.DISPLAY);
reminder.getProperties().add(new Description("Progress Meeting at 9:30am"));
Field Summary |
---|
Fields inherited from class net.fortuna.ical4j.model.Component |
---|
AVAILABLE, BEGIN, END, EXPERIMENTAL_PREFIX, VALARM, VAVAILABILITY, VEVENT, VFREEBUSY, VJOURNAL, VTIMEZONE, VTODO, VVENUE |
Constructor Summary | |
---|---|
VAlarm()
Default constructor. |
|
VAlarm(DateTime trigger)
Constructs a new VALARM instance that will trigger at the specified time. |
|
VAlarm(Dur trigger)
Constructs a new VALARM instance that will trigger at the specified time relative to the event/todo component. |
|
VAlarm(PropertyList properties)
Constructor. |
Method Summary | |
---|---|
Action |
getAction()
Returns the mandatory action property. |
Attach |
getAttachment()
Returns the optional attachment property. |
Description |
getDescription()
Returns the optional description property. |
Duration |
getDuration()
Returns the optional duration property. |
Repeat |
getRepeat()
Returns the optional repeat property. |
Summary |
getSummary()
Returns the optional summary property. |
Trigger |
getTrigger()
Returns the mandatory trigger property. |
void |
validate(boolean recurse)
Perform validation on a component. |
void |
validateAdd()
Apply validation for METHOD=ADD. |
void |
validateCancel()
Apply validation for METHOD=CANCEL. |
void |
validateCounter()
Apply validation for METHOD=COUNTER. |
void |
validateDeclineCounter()
Apply validation for METHOD=DECLINE-COUNTER. |
void |
validatePublish()
Apply validation for METHOD=PUBLISH. |
void |
validateRefresh()
Apply validation for METHOD=REFRESH. |
void |
validateReply()
Apply validation for METHOD=REPLY. |
void |
validateRequest()
Apply validation for METHOD=REQUEST. |
Methods inherited from class net.fortuna.ical4j.model.Component |
---|
calculateRecurrenceSet, copy, equals, getName, getProperties, getProperties, getProperty, hashCode, toString, validate, validateProperties |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public VAlarm()
public VAlarm(PropertyList properties)
properties
- a list of propertiespublic VAlarm(DateTime trigger)
trigger
- the time the alarm will triggerpublic VAlarm(Dur trigger)
trigger
- a duration of time relative to the parent component that the alarm will trigger atMethod Detail |
---|
public final void validate(boolean recurse) throws ValidationException
Component
validate
in class Component
recurse
- indicates whether to validate the component's properties
ValidationException
- where the component is not in a valid statepublic void validatePublish() throws ValidationException
CalendarComponent
validatePublish
in class CalendarComponent
ValidationException
public void validateAdd() throws ValidationException
CalendarComponent
validateAdd
in class CalendarComponent
ValidationException
public void validateCancel() throws ValidationException
CalendarComponent
validateCancel
in class CalendarComponent
ValidationException
public void validateCounter() throws ValidationException
CalendarComponent
validateCounter
in class CalendarComponent
ValidationException
public void validateDeclineCounter() throws ValidationException
CalendarComponent
validateDeclineCounter
in class CalendarComponent
ValidationException
public void validateRefresh() throws ValidationException
CalendarComponent
validateRefresh
in class CalendarComponent
ValidationException
public void validateReply() throws ValidationException
CalendarComponent
validateReply
in class CalendarComponent
ValidationException
public void validateRequest() throws ValidationException
CalendarComponent
validateRequest
in class CalendarComponent
ValidationException
public final Action getAction()
public final Trigger getTrigger()
public final Duration getDuration()
public final Repeat getRepeat()
public final Attach getAttachment()
public final Description getDescription()
public final Summary getSummary()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |