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