1 /*
2 * $Id: LocaleConverter.java,v 1.1 2004/04/04 18:27:45 eelco12 Exp $
3 * $Revision: 1.1 $
4 * $Date: 2004/04/04 18:27:45 $
5 *
6 * ====================================================================
7 * Copyright (c) 2003, Open Edge B.V.
8 * All rights reserved.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions are met:
11 * Redistributions of source code must retain the above copyright notice,
12 * this list of conditions and the following disclaimer. Redistributions
13 * in binary form must reproduce the above copyright notice, this list of
14 * conditions and the following disclaimer in the documentation and/or other
15 * materials provided with the distribution. Neither the name of OpenEdge B.V.
16 * nor the names of its contributors may be used to endorse or promote products
17 * derived from this software without specific prior written permission.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
29 * THE POSSIBILITY OF SUCH DAMAGE.
30 */
31 package nl.openedge.baritus.converters;
32
33 /***
34 * General purpose data type converter.
35 * For this interface has the same signature of the BeanUtils package,
36 * so it's easy to convert/ re-use converters.
37 *
38 * @author Eelco Hillenius
39 */
40 public interface LocaleConverter extends Converter {
41
42
43 /***
44 * Convert the specified locale-sensitive input object into an output object of the
45 * specified type.
46 *
47 * @param type Data type to which this value should be converted
48 * @param value The input value to be converted
49 * @param pattern The user-defined pattern is used for the input object formatting.
50 *
51 * @exception ConversionException if conversion cannot be performed
52 * successfully
53 */
54 public Object convert(Class type, Object value, String pattern);
55 }