001package biweekly;
002
003/*
004 Copyright (c) 2013-2015, Michael Angstadt
005 All rights reserved.
006
007 Redistribution and use in source and binary forms, with or without
008 modification, are permitted provided that the following conditions are met: 
009
010 1. Redistributions of source code must retain the above copyright notice, this
011 list of conditions and the following disclaimer. 
012 2. Redistributions in binary form must reproduce the above copyright notice,
013 this list of conditions and the following disclaimer in the documentation
014 and/or other materials provided with the distribution. 
015
016 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
017 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
018 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
019 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
020 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
021 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
022 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
023 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
024 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
025 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
026 */
027
028/**
029 * Defines all supported versions of the iCalendar standard.
030 * @author Michael Angstadt
031 */
032public enum ICalVersion {
033        /**
034         * Represents the original vCalendar specification.
035         * @see <a
036         * href="http://www.imc.org/pdi/pdiproddev.html">http://www.imc.org/pdi/pdiproddev.html</a>
037         */
038        V1_0("1.0"),
039
040        /**
041         * Represents an older, deprecated version of the iCalendar specification
042         * (very similar to {@link #V2_0}).
043         * @see <a
044         * href="https://tools.ietf.org/html/rfc2445">https://tools.ietf.org/html/rfc2445</a>
045         */
046        V2_0_DEPRECATED("2.0"),
047
048        /**
049         * Represents the latest iCalendar specification.
050         * @see <a
051         * href="https://tools.ietf.org/html/rfc5545">https://tools.ietf.org/html/rfc5545</a>
052         */
053        V2_0("2.0");
054
055        private final String version;
056
057        /**
058         * @param version the version number
059         */
060        private ICalVersion(String version) {
061                this.version = version;
062        }
063
064        /**
065         * Gets the text representation of this version.
066         * @return the text representation
067         */
068        public String getVersion() {
069                return version;
070        }
071
072        /**
073         * Gets a {@link ICalVersion} instance based on the given version number.
074         * @param version the version number (e.g. "2.0")
075         * @return the object or null if not found
076         */
077        public static ICalVersion get(String version) {
078                if (V1_0.version.equals(version)) {
079                        return V1_0;
080                }
081                if (V2_0.version.equals(version)) {
082                        return V2_0;
083                }
084                return null;
085        }
086
087        @Override
088        public String toString() {
089                if (this == V2_0_DEPRECATED) {
090                        return version + " (obsoleted)";
091                }
092                return version;
093        }
094}