diff -r 5ae3e5665a0b -r cc93757aeca3 src/net/fortuna/ical4j/model/component/VFreeBusy.java
--- a/src/net/fortuna/ical4j/model/component/VFreeBusy.java Thu Feb 12 18:02:00 2015 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,805 +0,0 @@
-/**
- * Copyright (c) 2012, Ben Fortuna
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * o Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * o Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in the
- * documentation and/or other materials provided with the distribution.
- *
- * o Neither the name of Ben Fortuna nor the names of any other contributors
- * may be used to endorse or promote products derived from this software
- * without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-package net.fortuna.ical4j.model.component;
-
-import java.util.HashMap;
-import java.util.Iterator;
-import java.util.Map;
-
-import net.fortuna.ical4j.model.Component;
-import net.fortuna.ical4j.model.ComponentList;
-import net.fortuna.ical4j.model.DateRange;
-import net.fortuna.ical4j.model.DateTime;
-import net.fortuna.ical4j.model.Dur;
-import net.fortuna.ical4j.model.Period;
-import net.fortuna.ical4j.model.PeriodList;
-import net.fortuna.ical4j.model.Property;
-import net.fortuna.ical4j.model.PropertyList;
-import net.fortuna.ical4j.model.ValidationException;
-import net.fortuna.ical4j.model.Validator;
-import net.fortuna.ical4j.model.parameter.FbType;
-import net.fortuna.ical4j.model.property.Contact;
-import net.fortuna.ical4j.model.property.DtEnd;
-import net.fortuna.ical4j.model.property.DtStamp;
-import net.fortuna.ical4j.model.property.DtStart;
-import net.fortuna.ical4j.model.property.Duration;
-import net.fortuna.ical4j.model.property.FreeBusy;
-import net.fortuna.ical4j.model.property.Method;
-import net.fortuna.ical4j.model.property.Organizer;
-import net.fortuna.ical4j.model.property.Uid;
-import net.fortuna.ical4j.model.property.Url;
-import net.fortuna.ical4j.util.CompatibilityHints;
-import net.fortuna.ical4j.util.PropertyValidator;
-
-/**
- * $Id$ [Apr 5, 2004]
- *
- * Defines an iCalendar VFREEBUSY component.
- *
- *
- * 4.6.4 Free/Busy Component
- *
- * Component Name: VFREEBUSY
- *
- * Purpose: Provide a grouping of component properties that describe
- * either a request for free/busy time, describe a response to a request
- * for free/busy time or describe a published set of busy time.
- *
- * Formal Definition: A "VFREEBUSY" calendar component is defined by the
- * following notation:
- *
- * freebusyc = "BEGIN" ":" "VFREEBUSY" CRLF
- * fbprop
- * "END" ":" "VFREEBUSY" CRLF
- *
- * fbprop = *(
- *
- * ; the following are optional,
- * ; but MUST NOT occur more than once
- *
- * contact / dtstart / dtend / duration / dtstamp /
- * organizer / uid / url /
- *
- * ; the following are optional,
- * ; and MAY occur more than once
- *
- * attendee / comment / freebusy / rstatus / x-prop
- *
- * )
- *
- * Description: A "VFREEBUSY" calendar component is a grouping of
- * component properties that represents either a request for, a reply to
- * a request for free or busy time information or a published set of
- * busy time information.
- *
- * When used to request free/busy time information, the "ATTENDEE"
- * property specifies the calendar users whose free/busy time is being
- * requested; the "ORGANIZER" property specifies the calendar user who
- * is requesting the free/busy time; the "DTSTART" and "DTEND"
- * properties specify the window of time for which the free/busy time is
- * being requested; the "UID" and "DTSTAMP" properties are specified to
- * assist in proper sequencing of multiple free/busy time requests.
- *
- * When used to reply to a request for free/busy time, the "ATTENDEE"
- * property specifies the calendar user responding to the free/busy time
- * request; the "ORGANIZER" property specifies the calendar user that
- * originally requested the free/busy time; the "FREEBUSY" property
- * specifies the free/busy time information (if it exists); and the
- * "UID" and "DTSTAMP" properties are specified to assist in proper
- * sequencing of multiple free/busy time replies.
- *
- * When used to publish busy time, the "ORGANIZER" property specifies
- * the calendar user associated with the published busy time; the
- * "DTSTART" and "DTEND" properties specify an inclusive time window
- * that surrounds the busy time information; the "FREEBUSY" property
- * specifies the published busy time information; and the "DTSTAMP"
- * property specifies the date/time that iCalendar object was created.
- *
- * The "VFREEBUSY" calendar component cannot be nested within another
- * calendar component. Multiple "VFREEBUSY" calendar components can be
- * specified within an iCalendar object. This permits the grouping of
- * Free/Busy information into logical collections, such as monthly
- * groups of busy time information.
- *
- * The "VFREEBUSY" calendar component is intended for use in iCalendar
- * object methods involving requests for free time, requests for busy
- * time, requests for both free and busy, and the associated replies.
- *
- * Free/Busy information is represented with the "FREEBUSY" property.
- * This property provides a terse representation of time periods. One or
- * more "FREEBUSY" properties can be specified in the "VFREEBUSY"
- * calendar component.
- *
- * When present in a "VFREEBUSY" calendar component, the "DTSTART" and
- * "DTEND" properties SHOULD be specified prior to any "FREEBUSY"
- * properties. In a free time request, these properties can be used in
- * combination with the "DURATION" property to represent a request for a
- * duration of free time within a specified window of time.
- *
- * The recurrence properties ("RRULE", "EXRULE", "RDATE", "EXDATE") are
- * not permitted within a "VFREEBUSY" calendar component. Any recurring
- * events are resolved into their individual busy time periods using the
- * "FREEBUSY" property.
- *
- * Example: The following is an example of a "VFREEBUSY" calendar
- * component used to request free or busy time information:
- *
- * BEGIN:VFREEBUSY
- * ORGANIZER:MAILTO:jane_doe@host1.com
- * ATTENDEE:MAILTO:john_public@host2.com
- * DTSTART:19971015T050000Z
- * DTEND:19971016T050000Z
- * DTSTAMP:19970901T083000Z
- * END:VFREEBUSY
- *
- * The following is an example of a "VFREEBUSY" calendar component used
- * to reply to the request with busy time information:
- *
- * BEGIN:VFREEBUSY
- * ORGANIZER:MAILTO:jane_doe@host1.com
- * ATTENDEE:MAILTO:john_public@host2.com
- * DTSTAMP:19970901T100000Z
- * FREEBUSY;VALUE=PERIOD:19971015T050000Z/PT8H30M,
- * 19971015T160000Z/PT5H30M,19971015T223000Z/PT6H30M
- * URL:http://host2.com/pub/busy/jpublic-01.ifb
- * COMMENT:This iCalendar file contains busy time information for
- * the next three months.
- * END:VFREEBUSY
- *
- * The following is an example of a "VFREEBUSY" calendar component used
- * to publish busy time information.
- *
- * BEGIN:VFREEBUSY
- * ORGANIZER:jsmith@host.com
- * DTSTART:19980313T141711Z
- * DTEND:19980410T141711Z
- * FREEBUSY:19980314T233000Z/19980315T003000Z
- * FREEBUSY:19980316T153000Z/19980316T163000Z
- * FREEBUSY:19980318T030000Z/19980318T040000Z
- * URL:http://www.host.com/calendar/busytime/jsmith.ifb
- * END:VFREEBUSY
- *
- *
- * Example 1 - Requesting all busy time slots for a given period:
- *
- *
- * // request all busy times between today and 1 week from now..
- * DateTime start = new DateTime();
- * DateTime end = new DateTime(start.getTime() + 1000 * 60 * 60 * 24 * 7);
- *
- * VFreeBusy request = new VFreeBusy(start, end);
- *
- * VFreeBusy reply = new VFreeBusy(request, calendar.getComponents());
- *
- *
- * Example 2 - Requesting all free time slots for a given period of at least the specified duration:
- *
- *
- * // request all free time between today and 1 week from now of
- * // duration 2 hours or more..
- * DateTime start = new DateTime();
- * DateTime end = new DateTime(start.getTime() + 1000 * 60 * 60 * 24 * 7);
- *
- * VFreeBusy request = new VFreeBusy(start, end, new Dur(0, 2, 0, 0));
- *
- * VFreeBusy response = new VFreeBusy(request, myCalendar.getComponents());
- *
- *
- * @author Ben Fortuna
- */
-public class VFreeBusy extends CalendarComponent {
-
- private static final long serialVersionUID = 1046534053331139832L;
-
- private final Map methodValidators = new HashMap();
- {
- methodValidators.put(Method.PUBLISH, new PublishValidator());
- methodValidators.put(Method.REPLY, new ReplyValidator());
- methodValidators.put(Method.REQUEST, new RequestValidator());
- }
-
- /**
- * Default constructor.
- */
- public VFreeBusy() {
- super(VFREEBUSY);
- getProperties().add(new DtStamp());
- }
-
- /**
- * Constructor.
- * @param properties a list of properties
- */
- public VFreeBusy(final PropertyList properties) {
- super(VFREEBUSY, properties);
- }
-
- /**
- * Constructs a new VFreeBusy instance with the specified start and end boundaries. This constructor should be used
- * for requesting busy time for a specified period.
- * @param start the starting boundary for the VFreeBusy
- * @param end the ending boundary for the VFreeBusy
- */
- public VFreeBusy(final DateTime start, final DateTime end) {
- this();
-
- // 4.8.2.4 Date/Time Start:
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // start date and time for the free or busy time information. The time
- // MUST be specified in UTC time.
- getProperties().add(new DtStart(start, true));
-
- // 4.8.2.2 Date/Time End
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // end date and time for the free or busy time information. The time
- // MUST be specified in the UTC time format. The value MUST be later in
- // time than the value of the "DTSTART" property.
- getProperties().add(new DtEnd(end, true));
- }
-
- /**
- * Constructs a new VFreeBusy instance with the specified start and end boundaries. This constructor should be used
- * for requesting free time for a specified duration in given period defined by the start date and end date.
- * @param start the starting boundary for the VFreeBusy
- * @param end the ending boundary for the VFreeBusy
- * @param duration the length of the period being requested
- */
- public VFreeBusy(final DateTime start, final DateTime end, final Dur duration) {
- this();
-
- // 4.8.2.4 Date/Time Start:
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // start date and time for the free or busy time information. The time
- // MUST be specified in UTC time.
- getProperties().add(new DtStart(start, true));
-
- // 4.8.2.2 Date/Time End
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // end date and time for the free or busy time information. The time
- // MUST be specified in the UTC time format. The value MUST be later in
- // time than the value of the "DTSTART" property.
- getProperties().add(new DtEnd(end, true));
-
- getProperties().add(new Duration(duration));
- }
-
- /**
- * Constructs a new VFreeBusy instance representing a reply to the specified VFREEBUSY request according to the
- * specified list of components.
- * If the request argument has its duration set, then the result
- * represents a list of free times (that is, parameter FBTYPE
- * is set to FbType.FREE).
- * If the request argument does not have its duration set, then the result
- * represents a list of busy times.
- * @param request a VFREEBUSY request
- * @param components a component list used to initialise busy time
- * @throws ValidationException
- */
- public VFreeBusy(final VFreeBusy request, final ComponentList components) {
- this();
-
- final DtStart start = (DtStart) request.getProperty(Property.DTSTART);
-
- final DtEnd end = (DtEnd) request.getProperty(Property.DTEND);
-
- final Duration duration = (Duration) request.getProperty(Property.DURATION);
-
- // 4.8.2.4 Date/Time Start:
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // start date and time for the free or busy time information. The time
- // MUST be specified in UTC time.
- getProperties().add(new DtStart(start.getDate(), true));
-
- // 4.8.2.2 Date/Time End
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // end date and time for the free or busy time information. The time
- // MUST be specified in the UTC time format. The value MUST be later in
- // time than the value of the "DTSTART" property.
- getProperties().add(new DtEnd(end.getDate(), true));
-
- if (duration != null) {
- getProperties().add(new Duration(duration.getDuration()));
- // Initialise with all free time of at least the specified duration..
- final DateTime freeStart = new DateTime(start.getDate());
- final DateTime freeEnd = new DateTime(end.getDate());
- final FreeBusy fb = new FreeTimeBuilder().start(freeStart)
- .end(freeEnd)
- .duration(duration.getDuration())
- .components(components)
- .build();
- if (fb != null && !fb.getPeriods().isEmpty()) {
- getProperties().add(fb);
- }
- }
- else {
- // initialise with all busy time for the specified period..
- final DateTime busyStart = new DateTime(start.getDate());
- final DateTime busyEnd = new DateTime(end.getDate());
- final FreeBusy fb = new BusyTimeBuilder().start(busyStart)
- .end(busyEnd)
- .components(components)
- .build();
- if (fb != null && !fb.getPeriods().isEmpty()) {
- getProperties().add(fb);
- }
- }
- }
-
- /**
- * Create a FREEBUSY property representing the busy time for the specified component list. If the component is not
- * applicable to FREEBUSY time, or if the component is outside the bounds of the start and end dates, null is
- * returned. If no valid busy periods are identified in the component an empty FREEBUSY property is returned (i.e.
- * empty period list).
- */
- private class BusyTimeBuilder {
-
- private DateTime start;
-
- private DateTime end;
-
- private ComponentList components;
-
- public BusyTimeBuilder start(DateTime start) {
- this.start = start;
- return this;
- }
-
- public BusyTimeBuilder end(DateTime end) {
- this.end = end;
- return this;
- }
-
- public BusyTimeBuilder components(ComponentList components) {
- this.components = components;
- return this;
- }
-
- public FreeBusy build() {
- final PeriodList periods = getConsumedTime(components, start, end);
- final DateRange range = new DateRange(start, end);
- // periods must be in UTC time for freebusy..
- periods.setUtc(true);
- for (final Iterator i = periods.iterator(); i.hasNext();) {
- final Period period = (Period) i.next();
- // check if period outside bounds..
- if (!range.intersects(period)) {
- i.remove();
- }
- }
- return new FreeBusy(periods);
- }
- }
-
- /**
- * Create a FREEBUSY property representing the free time available of the specified duration for the given list of
- * components. component. If the component is not applicable to FREEBUSY time, or if the component is outside the
- * bounds of the start and end dates, null is returned. If no valid busy periods are identified in the component an
- * empty FREEBUSY property is returned (i.e. empty period list).
- */
- private class FreeTimeBuilder {
-
- private DateTime start;
-
- private DateTime end;
-
- private Dur duration;
-
- private ComponentList components;
-
- public FreeTimeBuilder start(DateTime start) {
- this.start = start;
- return this;
- }
-
- public FreeTimeBuilder end(DateTime end) {
- this.end = end;
- return this;
- }
-
- private FreeTimeBuilder duration(Dur duration) {
- this.duration = duration;
- return this;
- }
-
- public FreeTimeBuilder components(ComponentList components) {
- this.components = components;
- return this;
- }
-
- public FreeBusy build() {
- final FreeBusy fb = new FreeBusy();
- fb.getParameters().add(FbType.FREE);
- final PeriodList periods = getConsumedTime(components, start, end);
- final DateRange range = new DateRange(start, end);
- // Add final consumed time to avoid special-case end-of-list processing
- periods.add(new Period(end, end));
- DateTime lastPeriodEnd = new DateTime(start);
- // where no time is consumed set the last period end as the range start..
- for (final Iterator i = periods.iterator(); i.hasNext();) {
- final Period period = (Period) i.next();
-
- // check if period outside bounds.. or period intersects with the end of the range..
- if (range.contains(period) ||
- (range.intersects(period) && period.getStart().after(range.getRangeStart()))) {
-
- // calculate duration between this period start and last period end..
- final Duration freeDuration = new Duration(lastPeriodEnd, period.getStart());
- if (freeDuration.getDuration().compareTo(duration) >= 0) {
- fb.getPeriods().add(new Period(lastPeriodEnd, freeDuration.getDuration()));
- }
- }
-
- if (period.getEnd().after(lastPeriodEnd)) {
- lastPeriodEnd = period.getEnd();
- }
- }
- return fb;
- }
- }
-
- /**
- * Creates a list of periods representing the time consumed by the specified list of components.
- * @param components
- * @return
- */
- private PeriodList getConsumedTime(final ComponentList components, final DateTime rangeStart,
- final DateTime rangeEnd) {
-
- final PeriodList periods = new PeriodList();
- // only events consume time..
- for (final Iterator i = components.getComponents(Component.VEVENT).iterator(); i.hasNext();) {
- final Component component = (Component) i.next();
- periods.addAll(((VEvent) component).getConsumedTime(rangeStart, rangeEnd, false));
- }
- return periods.normalise();
- }
-
- /**
- * {@inheritDoc}
- */
- public final void validate(final boolean recurse) throws ValidationException {
-
- if (!CompatibilityHints.isHintEnabled(CompatibilityHints.KEY_RELAXED_VALIDATION)) {
-
- // From "4.8.4.7 Unique Identifier":
- // Conformance: The property MUST be specified in the "VEVENT", "VTODO",
- // "VJOURNAL" or "VFREEBUSY" calendar components.
- PropertyValidator.getInstance().assertOne(Property.UID,
- getProperties());
-
- // From "4.8.7.2 Date/Time Stamp":
- // Conformance: This property MUST be included in the "VEVENT", "VTODO",
- // "VJOURNAL" or "VFREEBUSY" calendar components.
- PropertyValidator.getInstance().assertOne(Property.DTSTAMP,
- getProperties());
- }
-
- final PropertyValidator validator = PropertyValidator.getInstance();
-
- /*
- * ; the following are optional, ; but MUST NOT occur more than once contact / dtstart / dtend / duration /
- * dtstamp / organizer / uid / url /
- */
- validator.assertOneOrLess(Property.CONTACT, getProperties());
- validator.assertOneOrLess(Property.DTSTART, getProperties());
- validator.assertOneOrLess(Property.DTEND, getProperties());
- validator.assertOneOrLess(Property.DURATION, getProperties());
- validator.assertOneOrLess(Property.DTSTAMP, getProperties());
- validator.assertOneOrLess(Property.ORGANIZER, getProperties());
- validator.assertOneOrLess(Property.UID, getProperties());
- validator.assertOneOrLess(Property.URL, getProperties());
-
- /*
- * ; the following are optional, ; and MAY occur more than once attendee / comment / freebusy / rstatus / x-prop
- */
-
- /*
- * The recurrence properties ("RRULE", "EXRULE", "RDATE", "EXDATE") are not permitted within a "VFREEBUSY"
- * calendar component. Any recurring events are resolved into their individual busy time periods using the
- * "FREEBUSY" property.
- */
- validator.assertNone(Property.RRULE, getProperties());
- validator.assertNone(Property.EXRULE, getProperties());
- validator.assertNone(Property.RDATE, getProperties());
- validator.assertNone(Property.EXDATE, getProperties());
-
- // DtEnd value must be later in time that DtStart..
- final DtStart dtStart = (DtStart) getProperty(Property.DTSTART);
-
- // 4.8.2.4 Date/Time Start:
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // start date and time for the free or busy time information. The time
- // MUST be specified in UTC time.
- if (dtStart != null && !dtStart.isUtc()) {
- throw new ValidationException("DTSTART must be specified in UTC time");
- }
-
- final DtEnd dtEnd = (DtEnd) getProperty(Property.DTEND);
-
- // 4.8.2.2 Date/Time End
- //
- // Within the "VFREEBUSY" calendar component, this property defines the
- // end date and time for the free or busy time information. The time
- // MUST be specified in the UTC time format. The value MUST be later in
- // time than the value of the "DTSTART" property.
- if (dtEnd != null && !dtEnd.isUtc()) {
- throw new ValidationException("DTEND must be specified in UTC time");
- }
-
- if (dtStart != null && dtEnd != null
- && !dtStart.getDate().before(dtEnd.getDate())) {
- throw new ValidationException("Property [" + Property.DTEND
- + "] must be later in time than [" + Property.DTSTART + "]");
- }
-
- if (recurse) {
- validateProperties();
- }
- }
-
- /**
- * {@inheritDoc}
- */
- protected Validator getValidator(Method method) {
- return (Validator) methodValidators.get(method);
- }
-
- /**
- *
- * Component/Property Presence
- * ------------------- ----------------------------------------------
- * METHOD 1 MUST be "PUBLISH"
- *
- * VFREEBUSY 1+
- * DTSTAMP 1
- * DTSTART 1 DateTime values must be in UTC
- * DTEND 1 DateTime values must be in UTC
- * FREEBUSY 1+ MUST be BUSYTIME. Multiple instances are
- * allowed. Multiple instances must be sorted
- * in ascending order
- * ORGANIZER 1 MUST contain the address of originator of
- * busy time data.
- * UID 1
- * COMMENT 0 or 1
- * CONTACT 0+
- * X-PROPERTY 0+
- * URL 0 or 1 Specifies busy time URL
- *
- * ATTENDEE 0
- * DURATION 0
- * REQUEST-STATUS 0
- *
- * X-COMPONENT 0+
- *
- * VEVENT 0
- * VTODO 0
- * VJOURNAL 0
- * VTIMEZONE 0
- * VALARM 0
- *
- *
- */
- private class PublishValidator implements Validator {
-
- private static final long serialVersionUID = 1L;
-
- public void validate() throws ValidationException {
- PropertyValidator.getInstance().assertOneOrMore(Property.FREEBUSY, getProperties());
-
- PropertyValidator.getInstance().assertOne(Property.DTSTAMP, getProperties());
- PropertyValidator.getInstance().assertOne(Property.DTSTART, getProperties());
- PropertyValidator.getInstance().assertOne(Property.DTEND, getProperties());
- PropertyValidator.getInstance().assertOne(Property.ORGANIZER, getProperties());
- PropertyValidator.getInstance().assertOne(Property.UID, getProperties());
-
- PropertyValidator.getInstance().assertOneOrLess(Property.URL, getProperties());
-
- PropertyValidator.getInstance().assertNone(Property.ATTENDEE, getProperties());
- PropertyValidator.getInstance().assertNone(Property.DURATION, getProperties());
- PropertyValidator.getInstance().assertNone(Property.REQUEST_STATUS, getProperties());
- }
- }
-
- /**
- *
- * Component/Property Presence
- * ------------------- ----------------------------------------------
- * METHOD 1 MUST be "REPLY"
- *
- * VFREEBUSY 1
- * ATTENDEE 1 (address of recipient replying)
- * DTSTAMP 1
- * DTEND 1 DateTime values must be in UTC
- * DTSTART 1 DateTime values must be in UTC
- * FREEBUSY 0+ (values MUST all be of the same data
- * type. Multiple instances are allowed.
- * Multiple instances MUST be sorted in
- * ascending order. Values MAY NOT overlap)
- * ORGANIZER 1 MUST be the request originator's address
- * UID 1
- *
- * COMMENT 0 or 1
- * CONTACT 0+
- * REQUEST-STATUS 0+
- * URL 0 or 1 (specifies busy time URL)
- * X-PROPERTY 0+
- * DURATION 0
- * SEQUENCE 0
- *
- * X-COMPONENT 0+
- * VALARM 0
- * VEVENT 0
- * VTODO 0
- * VJOURNAL 0
- * VTIMEZONE 0
- *
- *
- */
- private class ReplyValidator implements Validator {
-
- private static final long serialVersionUID = 1L;
-
- public void validate() throws ValidationException {
-
- // FREEBUSY is 1+ in RFC2446 but 0+ in Calsify
-
- PropertyValidator.getInstance().assertOne(Property.ATTENDEE, getProperties());
- PropertyValidator.getInstance().assertOne(Property.DTSTAMP, getProperties());
- PropertyValidator.getInstance().assertOne(Property.DTEND, getProperties());
- PropertyValidator.getInstance().assertOne(Property.DTSTART, getProperties());
- PropertyValidator.getInstance().assertOne(Property.ORGANIZER, getProperties());
- PropertyValidator.getInstance().assertOne(Property.UID, getProperties());
-
- PropertyValidator.getInstance().assertOneOrLess(Property.URL, getProperties());
-
- PropertyValidator.getInstance().assertNone(Property.DURATION, getProperties());
- PropertyValidator.getInstance().assertNone(Property.SEQUENCE, getProperties());
- }
- }
-
- /**
- * METHOD:REQUEST Validator.
- *
- *
- * Component/Property Presence
- * ------------------- ----------------------------------------------
- * METHOD 1 MUST be "REQUEST"
- *
- * VFREEBUSY 1
- * ATTENDEE 1+ contain the address of the calendar store
- * DTEND 1 DateTime values must be in UTC
- * DTSTAMP 1
- * DTSTART 1 DateTime values must be in UTC
- * ORGANIZER 1 MUST be the request originator's address
- * UID 1
- * COMMENT 0 or 1
- * CONTACT 0+
- * X-PROPERTY 0+
- *
- * FREEBUSY 0
- * DURATION 0
- * REQUEST-STATUS 0
- * URL 0
- *
- * X-COMPONENT 0+
- * VALARM 0
- * VEVENT 0
- * VTODO 0
- * VJOURNAL 0
- * VTIMEZONE 0
- *
- *
- */
- private class RequestValidator implements Validator {
-
- private static final long serialVersionUID = 1L;
-
- public void validate() throws ValidationException {
- PropertyValidator.getInstance().assertOneOrMore(Property.ATTENDEE, getProperties());
-
- PropertyValidator.getInstance().assertOne(Property.DTEND, getProperties());
- PropertyValidator.getInstance().assertOne(Property.DTSTAMP, getProperties());
- PropertyValidator.getInstance().assertOne(Property.DTSTART, getProperties());
- PropertyValidator.getInstance().assertOne(Property.ORGANIZER, getProperties());
- PropertyValidator.getInstance().assertOne(Property.UID, getProperties());
-
- PropertyValidator.getInstance().assertNone(Property.FREEBUSY, getProperties());
- PropertyValidator.getInstance().assertNone(Property.DURATION, getProperties());
- PropertyValidator.getInstance().assertNone(Property.REQUEST_STATUS, getProperties());
- PropertyValidator.getInstance().assertNone(Property.URL, getProperties());
- }
- }
-
- /**
- * @return the CONTACT property or null if not specified
- */
- public final Contact getContact() {
- return (Contact) getProperty(Property.CONTACT);
- }
-
- /**
- * @return the DTSTART propery or null if not specified
- */
- public final DtStart getStartDate() {
- return (DtStart) getProperty(Property.DTSTART);
- }
-
- /**
- * @return the DTEND property or null if not specified
- */
- public final DtEnd getEndDate() {
- return (DtEnd) getProperty(Property.DTEND);
- }
-
- /**
- * @return the DURATION property or null if not specified
- */
- public final Duration getDuration() {
- return (Duration) getProperty(Property.DURATION);
- }
-
- /**
- * @return the DTSTAMP property or null if not specified
- */
- public final DtStamp getDateStamp() {
- return (DtStamp) getProperty(Property.DTSTAMP);
- }
-
- /**
- * @return the ORGANIZER property or null if not specified
- */
- public final Organizer getOrganizer() {
- return (Organizer) getProperty(Property.ORGANIZER);
- }
-
- /**
- * @return the URL property or null if not specified
- */
- public final Url getUrl() {
- return (Url) getProperty(Property.URL);
- }
-
- /**
- * Returns the UID property of this component if available.
- * @return a Uid instance, or null if no UID property exists
- */
- public final Uid getUid() {
- return (Uid) getProperty(Property.UID);
- }
-}