Tue, 10 Feb 2015 18:12:00 +0100
Import initial revisions of existing project AndroidCaldavSyncAdapater,
forked from upstream repository at 27e8a0f8495c92e0780d450bdf0c7cec77a03a55.
1 /**
2 * Copyright (c) 2012, Ben Fortuna
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * o Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 *
12 * o Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * o Neither the name of Ben Fortuna nor the names of any other contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
24 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
27 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
28 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 */
32 package net.fortuna.ical4j.util;
34 import java.io.UnsupportedEncodingException;
36 import net.fortuna.ical4j.model.parameter.Encoding;
38 import org.apache.commons.codec.BinaryEncoder;
39 import org.apache.commons.codec.StringEncoder;
41 /**
42 * Abstract base class for encoder factory implementations.
43 *
44 * $Id$
45 *
46 * Created on 13/05/2006
47 *
48 * @author Ben Fortuna
49 */
50 public abstract class EncoderFactory {
52 /**
53 * The system property used to specify an alternate
54 * <code>EncoderFactory</code> implementation.
55 */
56 public static final String KEY_FACTORY_CLASS = "net.fortuna.ical4j.factory.encoder";
58 private static EncoderFactory instance;
59 static {
60 try {
61 final Class factoryClass = Class.forName(Configurator.getProperty(KEY_FACTORY_CLASS));
62 instance = (EncoderFactory) factoryClass.newInstance();
63 }
64 catch (Exception e) {
65 instance = new DefaultEncoderFactory();
66 }
67 }
69 /**
70 * @return Returns the instance.
71 */
72 public static final EncoderFactory getInstance() {
73 return instance;
74 }
76 /**
77 * Returns a new {@link BinaryEncoder} for the specified encoding.
78 * @param encoding an encoding type
79 * @return a {@link BinaryEncoder} instance
80 * @throws UnsupportedEncodingException where an encoder supporting the
81 * specified encoding is not available.
82 */
83 public abstract BinaryEncoder createBinaryEncoder(Encoding encoding)
84 throws UnsupportedEncodingException;
86 /**
87 * Returns a new {@link StringEncoder} for the specified encoding.
88 * @param encoding an encoding type
89 * @return a {@link StringEncoder} instance
90 * @throws UnsupportedEncodingException where an encoder supporting the
91 * specified encoding is not available.
92 */
93 public abstract StringEncoder createStringEncoder(Encoding encoding)
94 throws UnsupportedEncodingException;
95 }