1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/src/net/fortuna/ical4j/model/PropertyFactory.java Tue Feb 10 18:12:00 2015 +0100 1.3 @@ -0,0 +1,70 @@ 1.4 +/** 1.5 + * Copyright (c) 2012, Ben Fortuna 1.6 + * All rights reserved. 1.7 + * 1.8 + * Redistribution and use in source and binary forms, with or without 1.9 + * modification, are permitted provided that the following conditions 1.10 + * are met: 1.11 + * 1.12 + * o Redistributions of source code must retain the above copyright 1.13 + * notice, this list of conditions and the following disclaimer. 1.14 + * 1.15 + * o Redistributions in binary form must reproduce the above copyright 1.16 + * notice, this list of conditions and the following disclaimer in the 1.17 + * documentation and/or other materials provided with the distribution. 1.18 + * 1.19 + * o Neither the name of Ben Fortuna nor the names of any other contributors 1.20 + * may be used to endorse or promote products derived from this software 1.21 + * without specific prior written permission. 1.22 + * 1.23 + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 1.24 + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 1.25 + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 1.26 + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 1.27 + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 1.28 + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 1.29 + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 1.30 + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 1.31 + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 1.32 + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 1.33 + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 1.34 + */ 1.35 +package net.fortuna.ical4j.model; 1.36 + 1.37 +import java.io.IOException; 1.38 +import java.io.Serializable; 1.39 +import java.net.URISyntaxException; 1.40 +import java.text.ParseException; 1.41 + 1.42 +/** 1.43 + * A factory for creating iCalendar properties. 1.44 + * 1.45 + * @author Ben Fortuna 1.46 + * 1.47 + * Note that implementations must be {@link Serializable} to support referencing 1.48 + * from {@link Property} instances. 1.49 + * 1.50 + * $Id$ 1.51 + * 1.52 + * Created on 16/06/2005 1.53 + */ 1.54 +public interface PropertyFactory extends Serializable { 1.55 + 1.56 + /** 1.57 + * @param name a property name 1.58 + * @return a new instance of the specified property 1.59 + */ 1.60 + Property createProperty(String name); 1.61 + 1.62 + /** 1.63 + * @param name a property name 1.64 + * @param parameters a list of property parameters 1.65 + * @param value a property value 1.66 + * @return a new instance of the specified property 1.67 + * @throws IOException where an unexpected error occurs reading data 1.68 + * @throws URISyntaxException where data contains an invalid URI 1.69 + * @throws ParseException where data is unable to be parsed correctly 1.70 + */ 1.71 + Property createProperty(String name, ParameterList parameters, String value) throws IOException, 1.72 + URISyntaxException, ParseException; 1.73 +}