001 package ezvcard.io.scribe;
002
003 import java.util.Date;
004 import java.util.List;
005
006 import ezvcard.VCardDataType;
007 import ezvcard.VCardVersion;
008 import ezvcard.io.CannotParseException;
009 import ezvcard.io.html.HCardElement;
010 import ezvcard.io.json.JCardValue;
011 import ezvcard.io.xml.XCardElement;
012 import ezvcard.parameter.VCardParameters;
013 import ezvcard.property.Revision;
014
015 /*
016 Copyright (c) 2013, Michael Angstadt
017 All rights reserved.
018
019 Redistribution and use in source and binary forms, with or without
020 modification, are permitted provided that the following conditions are met:
021
022 1. Redistributions of source code must retain the above copyright notice, this
023 list of conditions and the following disclaimer.
024 2. Redistributions in binary form must reproduce the above copyright notice,
025 this list of conditions and the following disclaimer in the documentation
026 and/or other materials provided with the distribution.
027
028 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
029 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
030 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
031 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
032 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
033 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
034 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
035 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
036 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
037 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
038 */
039
040 /**
041 * Marshals {@link Revision} properties.
042 * @author Michael Angstadt
043 */
044 public class RevisionScribe extends VCardPropertyScribe<Revision> {
045 public RevisionScribe() {
046 super(Revision.class, "REV");
047 }
048
049 @Override
050 protected VCardDataType _defaultDataType(VCardVersion version) {
051 return VCardDataType.TIMESTAMP;
052 }
053
054 @Override
055 protected String _writeText(Revision property, VCardVersion version) {
056 return write(property, false);
057 }
058
059 @Override
060 protected Revision _parseText(String value, VCardDataType dataType, VCardVersion version, VCardParameters parameters, List<String> warnings) {
061 return parse(value);
062 }
063
064 @Override
065 protected void _writeXml(Revision property, XCardElement parent) {
066 parent.append(VCardDataType.TIMESTAMP, write(property, false));
067 }
068
069 @Override
070 protected Revision _parseXml(XCardElement element, VCardParameters parameters, List<String> warnings) {
071 String value = element.first(VCardDataType.TIMESTAMP);
072 if (value != null) {
073 return parse(value);
074 }
075
076 throw missingXmlElements(VCardDataType.TIMESTAMP);
077 }
078
079 @Override
080 protected Revision _parseHtml(HCardElement element, List<String> warnings) {
081 String value = null;
082 if ("time".equals(element.tagName())) {
083 String datetime = element.attr("datetime");
084 if (datetime.length() > 0) {
085 value = datetime;
086 }
087 }
088 if (value == null) {
089 value = element.value();
090 }
091
092 return parse(value);
093 }
094
095 @Override
096 protected JCardValue _writeJson(Revision property) {
097 return JCardValue.single(write(property, true));
098 }
099
100 @Override
101 protected Revision _parseJson(JCardValue value, VCardDataType dataType, VCardParameters parameters, List<String> warnings) {
102 String valueStr = value.asSingle();
103 return parse(valueStr);
104 }
105
106 private String write(Revision property, boolean extended) {
107 Date timestamp = property.getValue();
108 if (timestamp == null) {
109 return "";
110 }
111
112 return date(timestamp).time(true).utc(true).extended(extended).write();
113 }
114
115 private Revision parse(String value) {
116 if (value == null || value.length() == 0) {
117 return new Revision(null);
118 }
119
120 try {
121 return new Revision(date(value));
122 } catch (IllegalArgumentException e) {
123 throw new CannotParseException(5);
124 }
125 }
126 }