001    package ezvcard.parameters;
002    
003    /*
004     Copyright (c) 2012, 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     The views and conclusions contained in the software and documentation are those
028     of the authors and should not be interpreted as representing official policies, 
029     either expressed or implied, of the FreeBSD Project.
030     */
031    
032    /**
033     * Represents the TYPE parameter of the ADR and LABEL types.
034     * <p>
035     * vCard versions: 2.1, 3.0, 4.0
036     * </p>
037     * @author Michael Angstadt
038     */
039    public class AddressTypeParameter extends TypeParameter {
040            /**
041             * vCard versions: 2.1, 3.0, 4.0
042             */
043            public static final AddressTypeParameter HOME = new AddressTypeParameter("home");
044    
045            /**
046             * vCard versions: 2.1, 3.0, 4.0
047             */
048            public static final AddressTypeParameter WORK = new AddressTypeParameter("work");
049    
050            /**
051             * vCard versions: 2.1, 3.0
052             */
053            public static final AddressTypeParameter DOM = new AddressTypeParameter("dom");
054    
055            /**
056             * vCard versions: 2.1, 3.0
057             */
058            public static final AddressTypeParameter INTL = new AddressTypeParameter("intl");
059    
060            /**
061             * vCard versions: 2.1, 3.0
062             */
063            public static final AddressTypeParameter POSTAL = new AddressTypeParameter("postal");
064    
065            /**
066             * vCard versions: 2.1, 3.0
067             */
068            public static final AddressTypeParameter PARCEL = new AddressTypeParameter("parcel");
069    
070            /**
071             * vCard versions: 2.1, 3.0
072             */
073            public static final AddressTypeParameter PREF = new AddressTypeParameter("pref");
074    
075            /**
076             * Use of this constructor is discouraged and should only be used for
077             * defining non-standard TYPEs. Please use one of the predefined static
078             * objects.
079             * @param value the type value (e.g. "home")
080             */
081            public AddressTypeParameter(String value) {
082                    super(value);
083            }
084    
085            /**
086             * Searches the static objects in this class for one that has a certain type
087             * value.
088             * @param value the type value to search for (e.g. "home")
089             * @return the object or null if not found
090             */
091            public static AddressTypeParameter valueOf(String value) {
092                    return findByValue(value, AddressTypeParameter.class);
093            }
094    }