001 package ezvcard.io.scribe; 002 003 import java.util.List; 004 005 import ezvcard.VCardDataType; 006 import ezvcard.VCardVersion; 007 import ezvcard.io.json.JCardValue; 008 import ezvcard.io.xml.XCardElement; 009 import ezvcard.parameter.VCardParameters; 010 import ezvcard.property.TextListProperty; 011 012 /* 013 Copyright (c) 2013, Michael Angstadt 014 All rights reserved. 015 016 Redistribution and use in source and binary forms, with or without 017 modification, are permitted provided that the following conditions are met: 018 019 1. Redistributions of source code must retain the above copyright notice, this 020 list of conditions and the following disclaimer. 021 2. Redistributions in binary form must reproduce the above copyright notice, 022 this list of conditions and the following disclaimer in the documentation 023 and/or other materials provided with the distribution. 024 025 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 026 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 027 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 028 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR 029 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 030 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 031 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 032 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 033 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 034 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 035 */ 036 037 /** 038 * Marshals properties that contain a list of values. 039 * @param <T> the property class 040 * @author Michael Angstadt 041 */ 042 public abstract class ListPropertyScribe<T extends TextListProperty> extends VCardPropertyScribe<T> { 043 public ListPropertyScribe(Class<T> clazz, String propertyName) { 044 super(clazz, propertyName); 045 } 046 047 @Override 048 protected VCardDataType _defaultDataType(VCardVersion version) { 049 return VCardDataType.TEXT; 050 } 051 052 @Override 053 protected String _writeText(T property, VCardVersion version) { 054 return list(property.getValues()); 055 } 056 057 @Override 058 protected T _parseText(String value, VCardDataType dataType, VCardVersion version, VCardParameters parameters, List<String> warnings) { 059 List<String> values = list(value); 060 return parse(values); 061 } 062 063 @Override 064 protected void _writeXml(T property, XCardElement parent) { 065 parent.append(VCardDataType.TEXT.getName().toLowerCase(), property.getValues()); 066 } 067 068 @Override 069 protected T _parseXml(XCardElement element, VCardParameters parameters, List<String> warnings) { 070 List<String> values = element.all(VCardDataType.TEXT); 071 if (!values.isEmpty()) { 072 return parse(values); 073 } 074 075 throw missingXmlElements(VCardDataType.TEXT); 076 } 077 078 @Override 079 protected JCardValue _writeJson(T property) { 080 List<String> values = property.getValues(); 081 if (values.isEmpty()) { 082 return JCardValue.single(""); 083 } 084 085 return JCardValue.multi(values); 086 } 087 088 @Override 089 protected T _parseJson(JCardValue value, VCardDataType dataType, VCardParameters parameters, List<String> warnings) { 090 List<String> values = value.asMulti(); 091 return parse(values); 092 } 093 094 private T parse(List<String> values) { 095 T property = _newInstance(); 096 property.getValues().addAll(values); 097 return property; 098 } 099 100 protected abstract T _newInstance(); 101 }