1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/src/net/fortuna/ical4j/data/CalendarParserFactory.java Tue Feb 10 18:12:00 2015 +0100 1.3 @@ -0,0 +1,84 @@ 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.data; 1.36 + 1.37 +import net.fortuna.ical4j.util.Configurator; 1.38 + 1.39 +/** 1.40 + * <pre> 1.41 + * $Id$ 1.42 + * 1.43 + * Created on 08/02/2007 1.44 + * </pre> 1.45 + * 1.46 + * Provides access to the configured {@link CalendarParser} instance. Alternative factory implementations may be 1.47 + * specified via the following system property: 1.48 + * 1.49 + * <pre> 1.50 + * net.fortuna.ical4j.parser=<factory_class_name> 1.51 + * </pre> 1.52 + * 1.53 + * @author Ben Fortuna 1.54 + */ 1.55 +public abstract class CalendarParserFactory { 1.56 + 1.57 + /** 1.58 + * The system property used to specify an alternate {@link CalendarParser} implementation. 1.59 + */ 1.60 + public static final String KEY_FACTORY_CLASS = "net.fortuna.ical4j.parser"; 1.61 + 1.62 + private static CalendarParserFactory instance; 1.63 + static { 1.64 + try { 1.65 + final Class factoryClass = Class.forName( 1.66 + Configurator.getProperty(KEY_FACTORY_CLASS)); 1.67 + instance = (CalendarParserFactory) factoryClass.newInstance(); 1.68 + } 1.69 + catch (Exception e) { 1.70 + instance = new DefaultCalendarParserFactory(); 1.71 + } 1.72 + } 1.73 + 1.74 + /** 1.75 + * @return a shared factory instance 1.76 + */ 1.77 + public static CalendarParserFactory getInstance() { 1.78 + return instance; 1.79 + } 1.80 + 1.81 + /** 1.82 + * Returns a new instance of the configured {@link CalendarParser}. 1.83 + * @return a calendar parser instance 1.84 + */ 1.85 + public abstract CalendarParser createParser(); 1.86 + 1.87 +}