View Javadoc

1   /*
2    * $Id: ExDate.java [Apr 6, 2004]
3    *
4    * Copyright (c) 2004, Ben Fortuna
5    * All rights reserved.
6    *
7    * Redistribution and use in source and binary forms, with or without
8    * modification, are permitted provided that the following conditions
9    * are met:
10   *
11   * 	o Redistributions of source code must retain the above copyright
12   * notice, this list of conditions and the following disclaimer.
13   *
14   * 	o Redistributions in binary form must reproduce the above copyright
15   * notice, this list of conditions and the following disclaimer in the
16   * documentation and/or other materials provided with the distribution.
17   *
18   * 	o Neither the name of Ben Fortuna nor the names of any other contributors
19   * may be used to endorse or promote products derived from this software
20   * without specific prior written permission.
21   *
22   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25   * A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR
26   * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
27   * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
28   * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
29   * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
30   * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
31   * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
32   * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33   */
34  package net.fortuna.ical4j.model.property;
35  
36  import java.text.ParseException;
37  
38  import net.fortuna.ical4j.model.DateList;
39  import net.fortuna.ical4j.model.Parameter;
40  import net.fortuna.ical4j.model.ParameterList;
41  import net.fortuna.ical4j.model.Property;
42  import net.fortuna.ical4j.model.ValidationException;
43  import net.fortuna.ical4j.model.parameter.Value;
44  import net.fortuna.ical4j.util.ParameterValidator;
45  
46  /***
47   * Defines a EXDATE iCalendar component property.
48   *
49   * @author benf
50   */
51  public class ExDate extends Property {
52  
53      private DateList dates;
54  
55      /***
56       * @param aList
57       *            a list of parameters for this component
58       * @param aValue
59       *            a value string for this component
60       * @throws ParseException
61       *             where the specified value string is not a valid
62       *             date-time/date representation
63       */
64      public ExDate(final ParameterList aList, final String aValue)
65              throws ParseException {
66          this(aList, new DateList(aValue, (Value) aList
67                  .getParameter(Parameter.VALUE)));
68      }
69  
70      /***
71       * @param aList
72       *            a list of parameters for this component
73       * @param dList
74       *            a list of dates
75       */
76      public ExDate(final ParameterList aList, final DateList dList) {
77          super(EXDATE, aList);
78  
79          dates = dList;
80      }
81  
82      /***
83       * @return Returns the dates.
84       */
85      public final DateList getDates() {
86          return dates;
87      }
88  
89      /***
90       * @see net.fortuna.ical4j.model.Property#validate()
91       */
92      public final void validate() throws ValidationException {
93  
94          /*
95           * ; the following are optional, ; but MUST NOT occur more than once
96           *
97           * (";" "VALUE" "=" ("DATE-TIME" / "DATE")) / (";" tzidparam) /
98           */
99          ParameterValidator.getInstance().validateOneOrLess(Parameter.VALUE,
100                 getParameters());
101 
102         Parameter valueParam = getParameters().getParameter(Parameter.VALUE);
103 
104         if (valueParam != null
105                 && !Value.DATE_TIME.equals(valueParam.getValue())
106                 && !Value.DATE.equals(valueParam.getValue())) { throw new ValidationException(
107                 "Parameter [" + Parameter.VALUE + "] is invalid"); }
108 
109         ParameterValidator.getInstance().validateOneOrLess(Parameter.TZID,
110                 getParameters());
111 
112         /*
113          * ; the following is optional, ; and MAY occur more than once
114          *
115          * (";" xparam)
116          */
117     }
118 
119     /*
120      * (non-Javadoc)
121      *
122      * @see net.fortuna.ical4j.model.Property#getValue()
123      */
124     public String getValue() {
125         return getDates().toString();
126     }
127 }