001 package biweekly.property;
002
003 import java.util.Date;
004 import java.util.List;
005
006 import biweekly.component.ICalComponent;
007 import biweekly.component.VTimezone;
008 import biweekly.util.ICalDateFormatter;
009
010 /*
011 Copyright (c) 2013, Michael Angstadt
012 All rights reserved.
013
014 Redistribution and use in source and binary forms, with or without
015 modification, are permitted provided that the following conditions are met:
016
017 1. Redistributions of source code must retain the above copyright notice, this
018 list of conditions and the following disclaimer.
019 2. Redistributions in binary form must reproduce the above copyright notice,
020 this list of conditions and the following disclaimer in the documentation
021 and/or other materials provided with the distribution.
022
023 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
024 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
025 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
026 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
027 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
028 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
029 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
030 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
031 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
032 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
033 */
034
035 /**
036 * <p>
037 * Defines a list of exceptions to the recurrence rule defined in a component.
038 * </p>
039 * <p>
040 * <b>Examples:</b>
041 *
042 * <pre class="brush:java">
043 * //date and times
044 * ExceptionDates exdate = new ExceptionDates(true);
045 * Date datetime1 = ...;
046 * exdate.addValue(datetime1);
047 * Date datetime2 = ...;
048 * exdate.addValue(datetime2);
049 *
050 * //dates
051 * ExceptionDates exdate = new ExceptionDates(false);
052 * Date date1 = ...;
053 * exdate.addValue(date1);
054 * Date date2 = ...;
055 * exdate.addValue(date2);
056 * </pre>
057 *
058 * </p>
059 * @author Michael Angstadt
060 * @rfc 5545 p.118-20
061 */
062 public class ExceptionDates extends ListProperty<Date> {
063 private boolean hasTime = true;
064
065 /**
066 * Creates an exception dates property.
067 * @param hasTime true if the dates have a time component, false if they are
068 * strictly dates
069 */
070 public ExceptionDates(boolean hasTime) {
071 setHasTime(hasTime);
072 }
073
074 /**
075 * Gets whether the dates have time components.
076 * @return true if the dates have time components, false if they are
077 * strictly dates
078 */
079 public boolean hasTime() {
080 return hasTime;
081 }
082
083 /**
084 * Sets whether the dates have time components.
085 * @param hasTime true if the dates have time components, false if they are
086 * strictly dates
087 */
088 public void setHasTime(boolean hasTime) {
089 this.hasTime = hasTime;
090 }
091
092 @Override
093 public String getTimezoneId() {
094 return super.getTimezoneId();
095 }
096
097 @Override
098 public void setTimezoneId(String timezoneId) {
099 super.setTimezoneId(timezoneId);
100 }
101
102 @Override
103 public void setTimezone(VTimezone timezone) {
104 super.setTimezone(timezone);
105 }
106
107 @Override
108 protected void validate(List<ICalComponent> components, List<String> warnings) {
109 String tzid = getTimezoneId();
110 if (tzid != null && tzid.contains("/") && ICalDateFormatter.parseTimeZoneId(tzid) == null) {
111 warnings.add("Unrecognized timezone ID: " + tzid);
112 }
113 }
114 }