001 package biweekly.property;
002
003 import java.util.List;
004
005 import biweekly.component.ICalComponent;
006
007 /*
008 Copyright (c) 2013, Michael Angstadt
009 All rights reserved.
010
011 Redistribution and use in source and binary forms, with or without
012 modification, are permitted provided that the following conditions are met:
013
014 1. Redistributions of source code must retain the above copyright notice, this
015 list of conditions and the following disclaimer.
016 2. Redistributions in binary form must reproduce the above copyright notice,
017 this list of conditions and the following disclaimer in the documentation
018 and/or other materials provided with the distribution.
019
020 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
021 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
022 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
023 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
024 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
025 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
026 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
027 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
028 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
029 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
030 */
031
032 /**
033 * <p>
034 * Specifies the min/max versions a consumer must support in order to
035 * successfully parse the iCalendar object.
036 * </p>
037 * <p>
038 * <b>Examples:</b>
039 *
040 * <pre>
041 * //gets the default iCal version
042 * Version version = Version.v2_0();
043 *
044 * if (verison.isV2_0()) {
045 * ...
046 * }
047 * </pre>
048 *
049 * </p>
050 * @author Michael Angstadt
051 * @see <a href="http://tools.ietf.org/html/rfc5545#page-79">RFC 5545
052 * p.79-80</a>
053 */
054 public class Version extends ICalProperty {
055 private static final String DEFAULT = "2.0";
056
057 private String minVersion, maxVersion;
058
059 /**
060 * Creates a new version property.
061 * @param version the version that a consumer must support in order to
062 * successfully parse the iCalendar object
063 */
064 public Version(String version) {
065 this(null, version);
066 }
067
068 /**
069 * Creates a new version property.
070 * @param minVersion the minimum version that a consumer must support in
071 * order to successfully parse the iCalendar object
072 * @param maxVersion the maximum version that a consumer must support in
073 * order to successfully parse the iCalendar object
074 */
075 public Version(String minVersion, String maxVersion) {
076 this.minVersion = minVersion;
077 this.maxVersion = maxVersion;
078 }
079
080 /**
081 * Creates a version property that is set to the default iCalendar version
082 * (2.0).
083 * @return the property instance
084 */
085 public static Version v2_0() {
086 return new Version(DEFAULT);
087 }
088
089 /**
090 * Determines if this version is the default iCalendar version.
091 * @return true if the version is "2.0", false if not
092 */
093 public boolean isV2_0() {
094 return DEFAULT.equalsIgnoreCase(maxVersion);
095 }
096
097 /**
098 * Gets the minimum version that a consumer must support in order to
099 * successfully parse the iCalendar object.
100 * @return the minimum version or null if not set
101 */
102 public String getMinVersion() {
103 return minVersion;
104 }
105
106 /**
107 * Sets the minimum version that a consumer must support in order to
108 * successfully parse the iCalendar object.
109 * @param minVersion the minimum version or null to remove
110 */
111 public void setMinVersion(String minVersion) {
112 this.minVersion = minVersion;
113 }
114
115 /**
116 * Gets the maximum version that a consumer must support in order to
117 * successfully parse the iCalendar object.
118 * @return the maximum version or null if not set
119 */
120 public String getMaxVersion() {
121 return maxVersion;
122 }
123
124 /**
125 * Sets the maximum version that a consumer must support in order to
126 * successfully parse the iCalendar object.
127 * @param maxVersion the maximum version (this field is <b>required</b>)
128 */
129 public void setMaxVersion(String maxVersion) {
130 this.maxVersion = maxVersion;
131 }
132
133 @Override
134 protected void validate(List<ICalComponent> components, List<String> warnings) {
135 if (maxVersion == null) {
136 warnings.add("A maximum version must be specified.");
137 }
138 }
139 }